README.md (1189B)
1 # mpd 2 3 A collection of C utilities for controlling [MPD](https://www.musicpd.org/) via libmpdclient. 4 5 ## Tools 6 7 ### mpd_add_to_queue 8 9 Adds tracks to the MPD play queue. Reads a list of paths from a file or stdin. 10 11 ```sh 12 mpd_add_to_queue [file] 13 ``` 14 15 ### mpd_add_to_playlist 16 17 Adds tracks to a named MPD playlist. Reads a list of paths from a file or stdin. 18 19 ```sh 20 mpd_add_to_playlist [file] 21 ``` 22 23 ### mpd_edit_queue 24 25 Opens the current MPD queue in `$EDITOR` as a list of file paths. Saves and replaces the queue with the edited result, preserving the currently playing track's position where possible. 26 27 ```sh 28 mpd_edit_queue 29 ``` 30 31 ### mpd_update_library 32 33 Triggers an MPD library update and waits for it to complete, retrying on connection errors with exponential backoff. 34 35 ```sh 36 mpd_update_library 37 ``` 38 39 ### mpd_update_queue 40 41 Replaces the current MPD queue with a new list of tracks read from a file or stdin. 42 43 ```sh 44 mpd_update_queue [file] 45 ``` 46 47 ## Configuration 48 49 All tools read connection settings from environment variables. 50 51 | Variable | Default | Description | 52 |----------|---------|-------------| 53 | `MPD_HOST` | `localhost` | MPD server hostname | 54 | `MPD_PORT` | `6600` | MPD server port |