Tumult
Table of Contents
About
Tumult is an oh-my-zsh-compatible plugin that adds macOS-specific functions and scripts to your ZSH environment.
Some of these are mine, and have an Apache 2.0 license, some of them were written by other people and just colllected by me - the authors and licenses are embedded in those scripts.
Tumult will check to see if you're running on macOS and not add aliases or inject its bin into your $PATH if you aren't. This was done to enable you to use the same plugin list in all your environments without polluting your $PATH with incompatible functions and scripts on your non-Apple machines.
You may also find the git-extra-commands collection useful, or my zsh-quickstart-kit
License
The Tumult collection is Apache 2.0 licensed. Some scripts in the bin directory have different licenses - if so, they have those other license statements embedded inline in their source.
Included scripts
| Script | Description |
|---|---|
720p |
Resets an application's window to 720p (1280x720) for better screencasting. Doesn't work with apps that don't support window resizing in their AppleScript dictionary. Copied from Derrick Bailey's blog |
autocorrect-disable |
Disable macOS trying to autocorrect your typing. |
autocorrect-enable |
Re-enable macOS trying to autocorrect your typing. |
battery-percentage |
Show the percentage of battery charge |
battery-prompt |
Prints battery status as a string suitable for embedding in a prompt. |
battery-time |
Show the estimated battery life. |
bundle-id |
Print the bundle id of a given application |
change-wallpaper |
If you have your desktop wallpaper set to rotate through a folder of images at intervals, this will force an immediate switch |
charger-wattage |
Shows the wattage of your charger. Useful for detecting bad USB-C charge cables |
chrome-tabs |
Outputs the URLs for all your open Chrome tabs so you can snapshot them |
chrome |
Force opening a URL with Chrome |
clean-clipboard |
Converts contents of clipboard to plain text. |
clean-file-context-menu |
Zaps extra entries from the file context menu. |
clean-xml-clip |
Clean up the XML on the clipboard |
clear-macos-font-cache |
Clears the macOS font cache, originally from awesome-osx-command-line |
column-view |
Set the current directory to column view in the Finder |
diceware-password |
Generate a random but memorable passphrase using the Diceware Passphrase Algorithm. See http://world.std.com/~reinhold/diceware.html |
disable-bouncing-dock-icons |
Disable icons bouncing in your Dock |
disable-ftp-server |
Disable the ftp server on a Mac |
disable-network-ds-store-files |
Disable writing .DS_Store files to network shares |
disable-ssh-server |
Disable the ssh server on a Mac |
disable-startup-chime |
Disable the boot chime |
disturb |
Re-enable notifications in Notification Center |
dns-resolvers |
macOS doesn't respect /etc/resolve.conf, add a helper to print what it's actually using |
do-not-disturb |
Stifle notifications in Notification Center |
dump-entitlements |
Dumps the entitlements a given macOS binary has assigned to it |
eject-all |
Eject all removable disks |
enable-bouncing-dock-icons |
Enable icons bouncing in your Dock |
enable-ftp-server |
Enable the ftp server on a Mac |
enable-network-ds-store-files |
Enable writing .DS_Store files to network shares (the default behavior) |
enable-ssh-server |
Enable the ssh server on a Mac |
enable-startup-chime |
Re-enable the boot chime |
evernote |
Create a new Evernote note from stdin or a file |
finder-path |
Show the path to the frontmost finder window |
finder-selection |
Show the paths to all items selected in the Finder, quoted so it copes with spaces in your directory or filenames |
firefox |
Force opening a URL with Firefox |
fix-airplay |
Kick coreaudiod when AirPlay stops responding |
focusmode-disable |
Turn off single-app mode |
focusmode-enable |
Turn on single-app mode |
get-iterm2-buffer |
Gets the current iterm2 window's scrollback contents |
get-wifi-password |
Helper script to print the password for the Wi-Fi network you're connected to. |
google |
Does a google search from the command-line |
hide-desktop-icons |
Hide desktop icons in Finder to have a clean screen for presentations |
hide-dotfiles |
Hide dotfiles in Finder windows to return to Apple default behavior |
hide-file |
Use chflags to mark a file as hidden |
icon-view |
Set the current directory to icon view in the Finder |
imgcat |
Display an image directly in your terminal. Only works with iTerm 2 |
iterm |
Open a new iTerm 2 session with the argument given |
itunesctl |
Play/Pause iTunes from terminal. |
keychainctl |
CRUD for secrets in your macOS keychain - from AriaFallah's gist |
kick-afp |
Restart file sharing from the CLI. I got tired of having to remote desktop in to kick the fileserver via the GUI every time Apple's file sharing got wedged, now it can be fixed over ssh |
kick-screensharing |
Sometimes screen sharing just hangs on my Mini running 10.11. This is not new to 10.11, it was exhibiting the same annoying behavior on 10.10 and 10.9. The mini is headless and it's a pain in the ass to plug it into the TV just long enough to restart screen sharing, so I wrote this so I can fix it over an ssh connection. |
kill-screensaver |
Kill the screensaver when it locks up |
kill-sophos-dead |
From a slack, but won't name names lest their employer find out they kill sophos. Kill Sophos' useless scanner when it gobbles up all your CPU. People wouldn't hate antivirus software so much on macOS if it restricted itself to using one CPU core. |
list-view |
Set the current directory to column view in the Finder |
lockscreen |
Start the screen saver - this only locks if your System Preferences have been set to lock the screensaver |
mac-alert |
Display a GUI alert with osascript |
mac-hibernate |
Set a Mac to use hibernate mode when sleeping |
mac-notification |
Display a notification using the macOS notification manager with osascript |
mac-safesleep |
Set a Mac to use safesleep mode when sleeping |
mac-sleep |
Set a Mac to use the default sleep mode when sleeping |
macos-consoleuser |
Show user logged into the GUI |
macos-dialog |
Display a GUI dialog with osascript and return the user's input |
macos-frontmost-app |
Shows what application is Frontmost. |
manpreview |
Renders a man page to PDF and opens it in Preview.app. |
markdown-open |
Converts a Markdown file to HTML and opens it in your browser |
menubar-dark |
Set the menubar to be white text on black background |
menubar-light |
Set the menubar to the default black text on white background style |
mkdmg |
Makes a .dmg file from a directory |
mkicns |
Creates an .icns file from an image file |
mute |
Mutes sound |
naptime |
Put the machine to sleep |
nitenite |
Make a Mac go to sleep |
pb-clean-ansi |
Clean ansi codes out of the clipboard |
pb-curl |
curl the address in the clipboard. Originally from Ryan Tomayko's dotfiles |
pb-indent |
Indent the contents of the clipboard 4 spaces. With -o, write result to standard output instead of to the clipboard. Originally from Ryan Tomayko's dotfiles |
pb-sed |
Run sed(1) on the contents of the clipboard and put the result back on the clipboard. All sed options and arguments are supported. Originally from Ryan Tomayko's dotfiles |
pb-sort |
Sorts the contents of the clipboard |
pledit |
Convert a plist to XML, run ${EDITOR} on it, then convert it back. |
power-source |
Reports if laptop is running on battery or charger power. Has --emoji and --json options. |
pubkey |
Quick script to load an ssh public key onto your clipboard by name without you having to specify the full path to it. |
quicklook |
Triggers quicklook on files so you can see what they are. |
restart-audio |
This fixes the "no sound" issue that happens occasionally by restarting coreaudiod |
safari |
Force opening a URL with Safari |
screen-resolution |
Display the screen resolution |
screencap-stream |
Captures your screen every N seconds, and if ffmpeg is installed, renders it to a mp4 |
set-cursor-size |
Set the macOS cursor's size |
set-macos-hostname |
Set the macOS name of your machine. macOS may be UNIX-based, but the Apple eccentricities mean that no, sudo hostname newname isn't enough if you want the new name to be visible on the network for things like File and Screen sharing. |
set-mojave-disk-warning-threshold |
Mojave now pops up a warning when you're running low on disk space. Unfortunately the threshold they pick triggers a warning every couple of minutes on my MacBook Air. This script lets you set a different number of free gigabytes to warn at. |
show-desktop-icons |
Display desktop icons in Finder |
show-dotfiles |
Display dotfiles in Finder windows |
smart-quote-disable |
Disable smart quote substitution |
smart-quote-enable |
Enable smart quote substitution |
speedup-apple-mail |
Speeds up Mail.app by vaccuuming the indexes - Originally from http://www.hawkwings.net/2007/03/03/scripts-to-automate-the-mailapp-envelope-speed-trick/ |
stfu |
Mutes sound |
time-machine-log-viewer |
Dump the Time Machine logs |
time-machine-throttle |
Restore default Time Machine throttle setting |
time-machine-unthrottle |
Disable throttling Time Machine backups - I am having issues with very slow Time Machine backups to an SMB share. No guarantees that this will not cause other subtle issues. |
toggle-finder-show-dotfiles |
Toggle whether Finder shows dotfiles |
unfuck-captive-portal |
Cope when macOS fails to render the captive portal page for joining a Wi-Fi network by directly opening Apple's captive portal detection page with Safari. |
unhide-file |
Use chflags to restore a file's visibility |
unmute |
Unmutes sound |
unquarantine |
Unquarantine a file |
volume |
Get/set the system volume |
wifi-name |
Returns the name of the Wi-Fi network you're connected to |
wifi |
Usage: wifi on or wifi off - toggles your Wi-Fi power |
Other Useful macOS tools
- apple-touchbar - ZSH plugin that adds support for the MacBook Pro's touchbar to iTerm2.
- awesome-osx-command-line documents many ways to manipulate macOS settings and applications from the command-line.
- bash-snippets -
brew-installable set of handy command-line tools. - complete-mac - Adds ZSH tab completions for
ioreg,lsmp,scselect,system_profilerandtmutilcommands. - desktoppr - A command-line tool which can read and set the desktop picture.
- Platypus - Allows you to wrap a script inside a Mac GUI wrapper.
- sekey - Allows you to use Touch ID / Secure Enclave for SSH Authentication.
Installation
Tumult is packaged as a ZSH plugin to make it easier to use if you're already using a ZSH framework. If you don't already use a framework, I recommend Zgenom, because it is wicked fast and also supports using oh-my-zsh's internal plugins.
Bash / not using a framework
If you're using bash, or aren't using a framework, you can install it by cloning this repository and adding its bin directory to your $PATH.
Antigen
Add antigen bundle unixorn/tumult.plugin.zsh to your .zshrc with your other bundle commands.
Antigen will handle cloning the plugin for you automatically the next time you start zsh. You can also add the plugin to a running ZSH with antigen bundle unixorn/tumult.plugin.zsh for testing before adding it to your .zshrc.
Oh-My-Zsh
cd ~/.oh-my-zsh/custom/pluginsgit clone [email protected]:unixorn/tumult.plugin.zsh.git tumult- Add tumult to your plugin list - edit
~/.zshrcand changeplugins=(...)toplugins=(... tumult)
Zgenom
Add zgenom load unixorn/tumult.plugin.zsh to your .zshrc file in the same function you're doing your other zgenom load calls in. Zgenom will handle automatically cloning the plugin for you the next time you do a zgenom save.