mpd-scripts
Collection of scripts related to mpd & mpc.
| Name | Description |
|---|---|
| lastfm-love | Love or unlove tracks on lastfm |
| mpd-notifier | Notify users of playing track or mpd status with artwork |
| Tunein Radio Script | Fetches Tunein Radio station URLs and generates M3U playlists along with associated information. Uses StreamFinder::Tunein Perl module. |
| iHeartRadio Script | Fetches iHeartRadio station URLs and generates M3U playlists along with associated information. Uses StreamFinder::IHeartRadio Perl module. |
| volume | Scripts allowing you to control the volume. |
| mpd-queue-shuffle | This script generates a random playlist from a local music directory and saves it as an M3U playlist file in the specified playlist directory. |
| somafm | This script fetches the playlist URLs of SomaFM channels with the highest quality in MP3 format and creates separate playlists for each channel in extended M3U format with the channel name. |
| mpd-find-dup | Contains two scripts for deduplicating MPD queues: mpd-remove-duplicates-queue.sh interactively deletes duplicates from the current MPD playlist in-place, while mpd-deduplicate-save-and-reload.sh saves the current queue as a playlist, removes duplicates, then reloads the cleaned playlist. |
| mpd_rewind_daemon | A background daemon for MPD that automatically rewinds playback by a few seconds when resuming from pause, improving the experience for music, mixes, podcasts, and audiobooks. |
Listed in each scripts README.md.
Run ./setup-path.sh once to check whether a personal bin directory is already on your PATH, and, if not, create ~/bin and add it for you.
Most scripts in this repository are standalone and only need to be copied into a directory on your $PATH (e.g. ~/bin or ~/.local/bin) and marked executable:
cp <script-dir>/<script-name> ~/bin/
chmod +x ~/bin/<script-name>Check each script's own README for language-specific dependencies (Python, Perl, mpc/python-mpd2, etc.) before running it.
mpd_rewind_daemon ships its own installer instead:
cd mpd_rewind_daemon
./install.shSee mpd_rewind_daemon/README.md for details.
Contributions are welcome!
- Bug reports: Open an issue.
- Everything else (questions, feature requests, ideas, general discussion): Use Discussions.
- Pull requests are welcome for bug fixes or discussed features.
- The original setup of this repository is by William Jacoby. For a full list of all authors and contributors, see the contributors page.
- Documentation updates assisted by Claude.
This project is licensed under the GNU General Public License v3.0.
See LICENSE for more information.