onair manages music playback, metadata storage and display. It currently
supports shairport-sync as a playback source.
- shairport-sync (compiled
--with-metadata) - Go 1.11+
go get github.com/toby/onair/cmd/onair
On Air will run continuously to print out metadata and act as a control for shairport-sync.
onair [flags] [COMMAND]
FLAGS:
-h Help
-m PATH Path to shairport-sync-metadata file (default "/tmp/shairport-sync-metadata")
-p onair control port (default: 22212)
-u shairport-sync metadata receive udp port (default: disabled)
-a Display album name
-s Print a blank newline when playback stops
-v Verbose
COMMANDS
display Display the currently playing track
play Start playback
pause Pause playback
playpause Toggle between play and pause
skip, next, nextitem Play next item in playlist
back, previous, previtem Play previous item in playlist
stop Stop playback
shuffle, shuffle_songs Shuffle playlist
ff, fastforward, beginff Begin fast forward
rew, rewind, beginrew Begin rewind
playresume Play after fast forward or rewind
up, volup, volumeup Turn audio volume down
down, voldown, volumedown Turn audio volume up
mute, mutetoggle Toggle mute status
Running onair with no commands prints each new track to standard out. If the
-s flag is supplied, onair will output a blank newline when there is a
stop in playback. This can be useful if you want to track your listening
sessions or for updating a UI to clear now playing information.
When run with a command argument, onair will connect to an already running
onair server and tell it to issue the given command to the connected playback
device. If no server is running, you'll need to launch one. If the server has
not yet seen the required playback ids from the source, you may need to
reconnect your Airplay device.