MPTOGGLE(1)

🎀 NAME 🎀

mptoggle — single button control for mpd

---

✨ SYNOPSIS ✨

mptoggle [host] [playlist ...]

---

💅 DESCRIPTION 💅

okay so bestie, mptoggle is literally the moment when you want to control mpd with one single physical button. no keyboard, no screen, no vibe-ruining complexity. one button. that's it. that's the whole aesthetic. 💖

it was designed for a linksys nslu2 running mpd, because on that thing the only physical control you get is a power button — and you can remap that button to run whatever program you want. so like. we're making it count. 🔥

every time you run mptoggle, it toggles playback. so press the button once to start, press it a second time to stop. and every single time it starts playing, it picks a playlist to play. by default it grabs a new, different playlist — at random — because surprise is the main character energy we deserve. 🦋

but if you pass playlist names on the command line, it'll choose between those at random instead. your playlists, your rules, no cap. 👑

---

🫶 how to actually wire this up on the nslu2

here's the example of how to make the nslu2's power button run mptoggle, living in /etc/inittab:

ca:12345:ctrlaltdel:/usr/bin/mptoggle localhost

---

🌈 SEE ALSO 🌈

• mprompt(1)
• mpd(1)

---

👑 AUTHOR 👑

Copyright 2007 Joey Hess <joey@kitenet.net>

Licensed under the GNU GPL version 2 or higher.

http://kitenet.net/~joey/code/mpdtoys

---

and that's the whole page, bestie 💖 this one shipped as perl v5.36.0, dated 2023-02-01, and honestly it ate. go press a button. 🎀✨