https://github.com/toby/onair
shariport-sync metadata display and control client/server
https://github.com/toby/onair
airport daap music shairport-sync shairport-sync-metadata-reader
Last synced: 4 months ago
JSON representation
shariport-sync metadata display and control client/server
- Host: GitHub
- URL: https://github.com/toby/onair
- Owner: toby
- Created: 2018-09-18T20:55:22.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-02-25T00:35:41.000Z (over 2 years ago)
- Last Synced: 2025-04-13T11:46:37.523Z (6 months ago)
- Topics: airport, daap, music, shairport-sync, shairport-sync-metadata-reader
- Language: Go
- Homepage:
- Size: 32.2 KB
- Stars: 18
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# On Air
[](http://godoc.org/github.com/toby/onair)
`onair` manages music playback, metadata storage and display. It currently
supports shairport-sync as a playback source.
## Requirements
* [shairport-sync](https://github.com/mikebrady/shairport-sync) (compiled `--with-metadata`)
* Go 1.11+
## Installing
```
go get github.com/toby/onair/cmd/onair
```
## Usage
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
```
## Server Mode
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.
## Client Mode
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.