Installation

Undertone is a macOS app for Apple Silicon (macOS 15 or later).

brew install --cask mpdreamz/tap/undertone

or, without Homebrew:

		curl -fsSL https://raw.githubusercontent.com/mpdreamz/undertone/main/install.sh | sh
		
	

Homebrew also puts the undertone command on your PATH; brew uninstall --zap undertone removes its settings and pictures too. The install script downloads the latest release, checks its sha256, and puts Undertone.app in /Applications (or ~/Applications when /Applications is not writable). Run it again to update. UNDERTONE_VERSION=0.1.0 installs a given version and UNDERTONE_APP_DIR another folder.

Or download Undertone-arm64.zip, unzip it, and move Undertone.app to Applications. Releases are signed with a Developer ID and notarized by Apple, so it opens without a warning.

Open it once: a half-filled circle appears in the menu bar, and the desktop changes. Undertone also adds itself to your login items that first time (macOS says so in a notification), since it keeps the picture set only while it runs. Turn Open at login off on the General page of Settings…, or in System Settings › General › Login Items, and it stays off.

From source

Xcode, selected with xcode-select.
mise, which brings in swiftformat and swiftlint.

		git clone https://github.com/mpdreamz/undertone.git
cd undertone
mise run bundle
open build/Undertone.app
		
	

release build: build/Undertone.app