MyFavMirrors/owntone-server
1
0
Fork 0
mirror of https://github.com/owntone/owntone-server.git synced 2024-12-27 15:45:56 -05:00
Code Issues Packages Projects Releases Wiki Activity
8ae25aaf3e
owntone-server/docs/control-clients/cli-api.md
ejurgensen 7da811e3b3 [docs] Brush up the documentation 
* Try to organize after expected user need
* Update mkdocs stuff and fix a broken link
* Move web building info to building.md
* Add info about Roku Soundbridge
* Add note about Google Nest not working
2024-10-11 19:29:49 +02:00

1.5 KiB
Raw Blame History

API and Command Line

You can choose between:

The JSON API is the most versatile and the recommended method, but for simple command line operations, mpc is easier. DAAP/DACP is only for masochists.

JSON API

See the JSON API docs

mpc

mpc is easy to use for simple operations like enabling speakers, changing volume and getting status.

Due to differences in implementation between OwnTone and MPD, some mpc commands will work differently or not at all.

DAAP/DACP

Here is an example of how to use curl with DAAP/DACP. Say you have a playlist with a radio station, and you want to make a script that starts playback of that station:

  1. Run sqlite3 [your OwnTone db]. Use select id,title from files to get the id of the radio station, and use select id,title from playlists to get the id of the playlist.
  2. Convert the two ids to hex.
  3. Put the following lines in the script with the relevant ids inserted (also observe that you must use a session-id < 100, and that you must login and logout):
curl "http://localhost:3689/login?pairing-guid=0x1&request-session-id=50"
curl "http://localhost:3689/ctrl-int/1/playspec?database-spec='dmap.persistentid:0x1'&container-spec='dmap.persistentid:0x[PLAYLIST-ID]'&container-item-spec='dmap.containeritemid:0x[FILE ID]'&session-id=50"
curl "http://localhost:3689/logout?session-id=50"