Skip to content

Shell Commands

unsecretised edited this page Mar 3, 2026 · 2 revisions

Shell Commands

A shell command can do as much as modes can, but they can have custom icons + different display names / search names

A shell command is configured slightly differently:

[[shells]] # note that its encased in double square brackets

command = "osascript -e 'tell application \"Spotify\" to play next track'"
icon_path = "/Applications/Spotify.app/Contents/Resources/AppIcon.icns"
alias = "Next Spotify Song" 
alias_lc = "next"

command is the shell command to run (can be a shell script as well, which is useful for longer scripts) icon_path can point to a png, jpg, or icns alias is the text displayed alias_lc is the text used to search

As seen in the below image: The spotify icon is loaded from icon_path The yellow rectangle is whats used to search, aka alias_lc (Ideally should be fully lowercased) The alias is the one in the dark red rectangle image

Clone this wiki locally