Skip to content
Sona

Command Line

sona <command> controls the Sona that is running: playback, the volume, favourites, lyrics, search, links and private listening. It prints text for people and, with --json, one line of JSON for scripts and status bars. Commands never start Sona.

Terminal window
sona status                 # what's playing
sona toggle                 # play/pause
sona next; sona prev
sona volume +10             # 0 to 100, or +N/-N
sona like                   # favourite the playing song
sona lyrics                 # the playing song's lyrics (--lrc for an LRC file)
sona search abbey road      # results with their links
sona open https://music.apple.com/gb/album/abbey-road/1441164426
sona private on
sona help [command]         # sona(1) has the same

Started without a command, sona opens Sona, or hands its Apple Music links to the Sona already running. sona --hidden starts without a window and sona --version prints the version.

sona status --follow and sona lyrics --follow keep printing as things change, which suits Waybar, Polybar and similar bars. Shell completions for bash, zsh and fish come from sona completion.

Every command, option, exit status and JSON schema is in the command line reference.