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
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.
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 darktoggle Flip between dark and light mode 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-crash-reports Keep macOS from asking if you want to submit a crash report 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 sshd 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-crash-reports Re-enable crash report dialogs 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 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's 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 interface-style Show whether interface is set to dark or light mode 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 in the GUI. 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. set-software-update-interval Set the interval between software update checks. The current default as of Ventura is 7 days. 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/ spotlight-reindex Rebuilds/creates the spotlight index for a disk. Defaults to rebuilding the index for / 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 the 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
brew-installable set of handy command-line tools.ioreg, lsmp, scselect, system_profiler and tmutil commands.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.
Other shells / not using a frameworkIf you're using other shells like bash or fish, or aren't using a framework with zsh, you can install it by cloning this repository and adding its bin directory to your $PATH.
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.
cd ~/.oh-my-zsh/custom/pluginsgit clone git@github.com:unixorn/tumult.plugin.zsh.git tumult~/.zshrc and change plugins=(...) to plugins=(... tumult)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.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4