setup macos
This guide shows how to install and set up bluefin-cli on macOS.
Install
-
Homebrew:
brew tap ublue-os/homebrew-experimental-tapbrew install bluefin-cli -
Install script:
curl -fsSL https://raw.githubusercontent.com/tuna-os/bluefin-cli/main/install.sh | sh -
Archive: get the Darwin archive from the GitHub releases page.
Homebrew is in /opt/homebrew on Apple silicon and in /usr/local on Intel.
Put brew shellenv in your shell startup file:
eval "$(/opt/homebrew/bin/brew shellenv)"
Terminal
The bluefin-cli terminal setup command sets up Ghostty. It also adds Ghostty
to the Dock. It uses dockutil if it is available.
When the tool sets a terminal font, it changes these terminals:
- Terminal.app: the tool writes the font to
com.apple.Terminalwithdefaults write. Start Terminal.app again to see the change. - iTerm2: the tool writes a dynamic profile to
DynamicProfiles/bluefin-cli-font.plist.
Wallpaper
The bluefin-cli wallpaper command uses the wallpaper CLI if it is
available. If not, it uses osascript. Then macOS can ask you one time for
permission.
The wallpaper picker looks for images in these folders:
/opt/homebrew/Caskroomand/usr/local/Caskroom(wallpaper casks)~/.local/share/backgrounds~/Pictures/Wallpapers/usr/share/backgrounds
Shell
macOS uses Zsh by default. To turn on the shell tools, run this command:
bluefin-cli shell zsh on
Check your setup
bluefin-cli doctor
If the tool cannot find Homebrew programs, make sure that your shell startup
file runs brew shellenv. For more help, see
the help page.