Home

Awesome

<h1 align="center"> <a name="top" title="dotfiles">~/.&nbsp;πŸ“‚</a><br/>Cross-platform, cross-shell dotfiles<br/> <sup><sub>powered by <a href="https://www.chezmoi.io/">chezmoi</a> 🏠</sub></sup> </h1>

Codacy rating CodeFactor rating License Repo analytics Tweet

Universal command set and colourful shell configurations for Bash, Zsh and Powershell, compatible with macOS, Windows and (partially) Linux, all managed easily using chezmoi.

<div align="center"> <p><strong>Be sure to <a href="#" title="star">⭐️</a> or <a href="#" title="fork">πŸ”±</a> this repo if you find it useful! πŸ˜ƒ</strong></p> </div>

Project goals ⚽

<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

Supported toolset πŸ› οΈ

Use either one or many of these, the config files will be in place and ready to provide a familiar interface.

🐚 Shells

πŸ’» Terminals

πŸ“¦ Package managers

πŸ’Ύ Universal apps <sup><sub><b title="Linux">🐧</b></sub></sup><b title="macOS">ο£Ώ</b><b title="Windows">⊞</b>

<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

Cross-shell compatibility matrix 🏁

These are unified CLI commands available amongst different shells on all platforms. While some of their outputs may differ in style between different environments, their usage and behaviours remain universal.

Additional aliases are provided by Bash-It, Oh-My-Zsh and Powershell, and are listed by using the command alias.

System-specific aliases are marked with <b title="macOS"></b>, <b title="Windows">⊞</b>, or <sub><sup><b title="Linux">🐧</b></sup></sub>.

🧭 Easier navigation

BashPowerShellZshCommandDescription
βœ…βœ…βœ…~Navigates to user home directory.
βœ…βœ…βœ…cd-Navigates to last used directory.
βœ…βœ…βœ…..<br>cd..Navigates up a directory.
βœ…βœ…βœ…...Navigates up two directories.
βœ…βœ…βœ…....Navigates up three directories.
βœ…βœ…βœ….....Navigates up four directories.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ—‚οΈ Directory browsing

BashPowerShellZshCommandDescription
βœ…βœ…βœ…lLists visible files in long format.
βœ…βœ…βœ…llLists all files in long format, excluding . and ...
βœ…βœ…βœ…lsdLists only directories in long format.
βœ…βœ…βœ…lshLists only hidden files in long format.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ—„οΈ File management

BashPowerShellZshCommandDescription
βœ…βœ…βœ…cpvCopies a file securely.
βœ…βœ…βœ…fdFinds directories.
βœ…βœ…βœ…ffFinds files.
βŒβœ…βŒmirrorMirrors directories.
βœ…βœ…βœ…rgSearches recursively with ripgrep.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ’‘ General aliases

BashPowerShellZshCommandDescription
βœ…βœ…βœ…aliasLists aliases.
βœ…βœ…βœ…cClears the console screen.
βœ…βŒβœ…extract<br>xExtracts common file formats.<br>Usage: extract solarized.zip
βœ…βœ…βœ…hDisplays/Searches global history.<br>Usage: h<br>Usage: h cd
βœ…βœ…βš οΈhsDisplays/Searches session history.<br>Usage: hs<br>Usage: hs cd
βœ…βœ…βœ…mkcd<br>takeCreates directory and change to it.<br>Usage: mkcd foldername
βœ…βŒβœ…reloadReloads the shell.
βœ…βœ…βœ…repeat<br>rRepeats a command x times.<br>Usage: repeat 5 echo hello.
βœ…βŒβœ…resourceReloads configuration.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ•™ Time

BashPowerShellZshCommandDescription
βœ…βœ…βœ…now<br>unowGets local/UTC date and time in ISO 8601 format YYYY-MM-DDThh:mm:ss.
βœ…βœ…βœ…nowdate<br>unowdateGets local/UTC date in YYYY-MM-DD format.
βœ…βœ…βœ…nowtime<br>unowtimeGets local/UTC time in hh:mm:ss format.
βœ…βœ…βœ…timestampGets Unix time stamp.
βœ…βœ…βœ…weekGets week number in ISO 8601 format YYYY-Www.
βœ…βœ…βœ…weekdayGets weekday number.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

🌐 Networking

BashPowerShellZshCommandDescription
βœ…βœ…βœ…fastpingPings hostname(s) 30 times in quick succession.
βœ…βœ…βœ…flushdnsFlushes the DNS cache.
βœ…βœ…βœ…ipsGets all IP addresses.
βœ…βœ…βœ…localipGets local IP address.
βœ…βœ…βœ…publicipGets external IP address.
βœ…βœ…βœ…GET<br>HEAD<br>POST<br>PUT<br>DELETE<br>TRACE<br>OPTIONSSends HTTP requests.<br>_Usage: GET https://example.com
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

⚑ Power management

BashPowerShellZshCommandDescription
βœ…βœ…βœ…hibernateHibernates the system.
βœ…βœ…βœ…lockLocks the session.
βœ…βœ…βœ…poweroffShuts down the system.
βœ…βœ…βœ…rebootRestarts the system.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ€“ Sysadmin

BashPowerShellZshCommandDescription
βœ…βœ…βœ…mntLists drive mounts.
βœ…βœ…βœ…pathPrints each $PATH entry on a separate line.
βœ…βœ…βœ…sysinfoDisplays information about the system.<br><strong><sup>Uses either Winfetch, Neofetch, or Screenfetch.</sup></strong>
βœ…βœ…βœ…topMonitors processes and system resources.<br><strong><sup>Uses either atop, htop, ntop <b title="windows">⊞</b>, or native.</sup></strong>
βœ…βœ…βœ…updateKeeps all apps and packages up to date.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ–₯️ Applications

BashPowerShellZshCommandDescription
βœ…βœ…βœ…browseOpens file/URL in default browser.<br>Usage: browse https://example.com
βœ…βœ…βœ…chromeOpens file/URL in Chrome.
βœ…βœ…βœ…edgeOpens file/URL in Microsoft Edge.
βœ…βœ…βœ…firefoxOpens file/URL in Firefox.
β”βœ…β”iexploreOpens file/URL in Internet Explorer. <b title="Windows">⊞</b>
βœ…βœ…βœ…operaOpens file/URL in Opera.
βœ…βœ…βœ…safariOpens file/URL in Safari. <b title="macOS">ο£Ώ</b>
βœ…βœ…βœ…ssEnters the Starship πŸš€ cross-shell prompt.
βœ…βœ…βœ…subl<br>stOpens in Sublime Text.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ‘©β€πŸ’» Development

BashPowerShellZshCommandDescription
βœ…βœ…βœ…dk🐳 Alias for docker.
βœ…βœ…βœ…dco🐳 Alias for docker-compose.
βœ…βœ…βœ…g:octocat: Alias for git.
βœ…βœ…βœ…va🐍 Activates Python virtual environment venv.
βœ…βœ…βœ…ve🐍 Creates Python virtual environment venv.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

ο£Ώ macOS

BashPowerShellZshCommandDescription
βœ…βœ…βœ…hidedesktop<br>showdesktopToggles display of desktop icons.
βœ…βœ…βœ…hidefiles<br>showfilesToggles hidden files display in Finder.
βœ…βœ…βœ…spotoff<br>spotonToggles Spotlight.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

⊞ Windows

BashPowerShellZshCommandDescription
β”βœ…β”hidefiles<br>showfilesToggles hidden files display in File Explorer.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ“ Common paths

BashPowerShellZshCommandDescription
βœ…βœ…βœ…dlsNavigates to ~/Downloads.
βœ…βœ…βœ…docsNavigates to ~/Documents.
βœ…βœ…βœ…dtNavigates to ~/Desktop.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ“ Configuration paths

BashPowerShellZshCommandDescription
βœ…βœ…βœ…chezmoiconfNavigates to Chezmoi's local configuration repo.
βœ…βœ…βœ…powershellconfNavigates to Powershell's profile location.
βœ…βœ…βœ…sublimeconfNavigates to Sublime Text's local configuration repo.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

πŸ“ Custom paths

BashPowerShellZshCommandDescription
βœ…βœ…βœ…archivesNavigates to ~/Archives.
βœ…βœ…βœ…reposNavigates to ~/Code.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

🌱 Varia

BashPowerShellZshCommandDescription
βœ…βœ…βœ…cbπŸ“‹ Copies contents to the clipboard.
βœ…βœ…βœ…cbpasteπŸ“‹ Pastes the contents of the clipboard.
βœ…βœ…βœ…md5sum#️⃣ Calculates MD5 hashes.
βœ…βœ…βœ…sha1sum#️⃣ Calculates SHA1 hashes.
βœ…βœ…βœ…sha256sum#️⃣ Calculates SHA256 hashes.
βœ…βœ…βœ…forecast🌀️ Displays detailed weather and forecast.
βœ…βœ…βœ…weather🌀️ Displays current weather.
<p align="right"><a href="#top" title="Back to top">πŸ”</a></p>

Inspirations πŸ’‘

<p align="right"><a href="#top" title="Back to top">πŸ”</a></p> <p align="center"><strong>Don't forget to <a href="#" title="star">⭐️</a> or <a href="#" title="fork">πŸ”±</a> this repo! πŸ˜ƒ<br/><sub>Assembled with <b title="love">❀️</b> in MontrΓ©al.</sub></strong></p>