/dotfiles

~/. Cross-platform, cross-shell configuration files. βš™οΈπŸ’»

Primary LanguageShellMIT LicenseMIT

~/. πŸ“‚
Cross-platform, cross-shell dotfiles
powered by chezmoi 🏠

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.

Be sure to ⭐️ or πŸ”± this repo if you find it useful! πŸ˜ƒ

Project goals ⚽

  • Unified set of aliases and commands.
  • Familiar feel and creature comforts across environments.
  • Cross-platform file management toolset.
  • Easy access to common paths.
  • Shortcuts to popular cross-platform apps.
  • System-agnostic update and dotfiles install commands.
  • A pretty interface! πŸ’ƒ

πŸ”

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 🐧⊞

πŸ”

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 , ⊞, or 🐧.

🧭 Easier navigation

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… ~ Navigates to user home directory.
βœ… βœ… βœ… cd- Navigates to last used directory.
βœ… βœ… βœ… ..
cd..
Navigates up a directory.
βœ… βœ… βœ… ... Navigates up two directories.
βœ… βœ… βœ… .... Navigates up three directories.
βœ… βœ… βœ… ..... Navigates up four directories.

πŸ”

πŸ—‚οΈ Directory browsing

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… l Lists visible files in long format.
βœ… βœ… βœ… ll Lists all files in long format, excluding . and ...
βœ… βœ… βœ… lsd Lists only directories in long format.
βœ… βœ… βœ… lsh Lists only hidden files in long format.

πŸ”

πŸ—„οΈ File management

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… cpv Copies a file securely.
βœ… βœ… βœ… fd Finds directories.
βœ… βœ… βœ… ff Finds files.
❌ βœ… ❌ mirror Mirrors directories.
βœ… βœ… βœ… rg Searches recursively with ripgrep.

πŸ”

πŸ’‘ General aliases

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… alias Lists aliases.
βœ… βœ… βœ… c Clears the console screen.
βœ… ❌ βœ… extract
x
Extracts common file formats.
Usage: extract solarized.zip
βœ… βœ… βœ… h Displays/Searches global history.
Usage: h
Usage: h cd
βœ… βœ… ⚠️ hs Displays/Searches session history.
Usage: hs
Usage: hs cd
βœ… βœ… βœ… mkcd
take
Creates directory and change to it.
Usage: mkcd foldername
βœ… ❌ βœ… reload Reloads the shell.
βœ… βœ… βœ… repeat
r
Repeats a command x times.
Usage: repeat 5 echo hello.
βœ… ❌ βœ… resource Reloads configuration.

πŸ”

πŸ•™ Time

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… now
unow
Gets local/UTC date and time in ISO 8601 format YYYY-MM-DDThh:mm:ss.
βœ… βœ… βœ… nowdate
unowdate
Gets local/UTC date in YYYY-MM-DD format.
βœ… βœ… βœ… nowtime
unowtime
Gets local/UTC time in hh:mm:ss format.
βœ… βœ… βœ… timestamp Gets Unix time stamp.
βœ… βœ… βœ… week Gets week number in ISO 8601 format YYYY-Www.
βœ… βœ… βœ… weekday Gets weekday number.

πŸ”

🌐 Networking

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… fastping Pings hostname(s) 30 times in quick succession.
βœ… βœ… βœ… flushdns Flushes the DNS cache.
βœ… βœ… βœ… ips Gets all IP addresses.
βœ… βœ… βœ… localip Gets local IP address.
βœ… βœ… βœ… publicip Gets external IP address.
βœ… βœ… βœ… GET
HEAD
POST
PUT
DELETE
TRACE
OPTIONS
Sends HTTP requests.
_Usage: GET https://example.com

πŸ”

⚑ Power management

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… hibernate Hibernates the system.
βœ… βœ… βœ… lock Locks the session.
βœ… βœ… βœ… poweroff Shuts down the system.
βœ… βœ… βœ… reboot Restarts the system.

πŸ”

πŸ€“ Sysadmin

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… mnt Lists drive mounts.
βœ… βœ… βœ… path Prints each $PATH entry on a separate line.
βœ… βœ… βœ… sysinfo Displays information about the system.
Uses either Winfetch, Neofetch, or Screenfetch.
βœ… βœ… βœ… top Monitors processes and system resources.
Uses either atop, htop, ntop ⊞, or native.
βœ… βœ… βœ… update Keeps all apps and packages up to date.

πŸ”

πŸ–₯️ Applications

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… browse Opens file/URL in default browser.
Usage: browse https://example.com
βœ… βœ… βœ… chrome Opens file/URL in Chrome.
βœ… βœ… βœ… edge Opens file/URL in Microsoft Edge.
βœ… βœ… βœ… firefox Opens file/URL in Firefox.
❔ βœ… ❔ iexplore Opens file/URL in Internet Explorer. ⊞
βœ… βœ… βœ… opera Opens file/URL in Opera.
βœ… βœ… βœ… safari Opens file/URL in Safari. ο£Ώ
βœ… βœ… βœ… ss Enters the Starship πŸš€ cross-shell prompt.
βœ… βœ… βœ… subl
st
Opens in Sublime Text.

πŸ”

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

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… 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.

πŸ”

ο£Ώ macOS

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… hidedesktop
showdesktop
Toggles display of desktop icons.
βœ… βœ… βœ… hidefiles
showfiles
Toggles hidden files display in Finder.
βœ… βœ… βœ… spotoff
spoton
Toggles Spotlight.

πŸ”

⊞ Windows

Bash PowerShell Zsh Command Description
❔ βœ… ❔ hidefiles
showfiles
Toggles hidden files display in File Explorer.

πŸ”

πŸ“ Common paths

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… dls Navigates to ~/Downloads.
βœ… βœ… βœ… docs Navigates to ~/Documents.
βœ… βœ… βœ… dt Navigates to ~/Desktop.

πŸ”

πŸ“ Configuration paths

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… chezmoiconf Navigates to Chezmoi's local configuration repo.
βœ… βœ… βœ… powershellconf Navigates to Powershell's profile location.
βœ… βœ… βœ… sublimeconf Navigates to Sublime Text's local configuration repo.

πŸ”

πŸ“ Custom paths

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… archives Navigates to ~/Archives.
βœ… βœ… βœ… repos Navigates to ~/Code.

πŸ”

🌱 Varia

Bash PowerShell Zsh Command Description
βœ… βœ… βœ… 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.

πŸ”

Inspirations πŸ’‘

πŸ”

Don't forget to ⭐️ or πŸ”± this repo! πŸ˜ƒ
Assembled with ❀️ in Montréal.