GMERLIN_REMOTE(1)

✨ NAME ✨

gmerlin_remote — Remote control for the Gmerlin GUI Player 🎛️💖

Yes bestie, this is the one from the User Manuals, section 1, so you already know it's giving official. It's a whole separate little program whose entire job is to boss the Gmerlin GUI Player around from somewhere else. Iconic behavior, honestly.

🎀 SYNOPSIS 🎀

gmerlin_remote [options] command

💖 DESCRIPTION 💖

It's a remote control command for the Gmerlin GUI Player. That's it, that's the whole vibe — you run it, you hand it a command, and the player out there somewhere actually does the thing. No cap, it's just a messenger with main character energy. 🌈

👑 GLOBAL OPTIONS 👑

These are the ones that apply no matter which command you're sending, so like, they go before the vibe check:

• -host <hostname> — The host you're connecting to. Default is localhost, so if your player lives on your own machine you can just skip this one entirely. 🏠
• -port <port> — The port you're connecting to. 🚪
• -launch — Launch a new player if necessary. Lowkey the "if nobody's home, just wake them up" option. 🫶

🌈 COMMANDS 🌈

Okay this is the main event, the whole reason we're here. Pick ONE and send it:

• -play — Play the current track. ▶️
• -next — Switch to the next track. ⏭️
• -prev — Switch to the previous track. ⏮️
• -stop — Stop playback. ⏹️
• -pause — Pause playback. ⏸️
• -mute — Toggle mute. 🔇
• -add <gml> — Add <gml> to the incoming album. 📥
• -addplay <gml> — Add <gml> to the incoming album and play it. Because why add it if you're not gonna immediately bop. 🎶
• -open <device> — Open the album for <device>. Heads up: the device has to be a GML, like dvd:///dev/hdd. 📀
• -openplay <device> — Open the album for <device> and play the first track. Again, <device> must be a GML, e.g. dvd:///dev/hdd. 🍿
• -volume <volume> — Set the player volume. <volume> is in dB, and 0.0 is max. 🔊
• -volume-rel <diff> — In- or decrease the player volume. <diff> is in dB, so it's a relative nudge, not a whole new setting. 🎚️
• -seek-rel <diff> — Seek relative. <diff> is in seconds. ⏩
• -chapter [num|+|-] — Go to the specified chapter. Use '+' and '-' to go to the next or previous chapter respectively. 📖
• -get-name — Print the name of the current track. 🏷️
• -get-metadata — Print the metadata of the current track. 📋
• -get-time — Print the time of the current track. ⏱️

🧚 GENERIC OPTIONS 🧚

These ones are available for all gmerlin applications, so they're like the universal bestie starter pack:

• -help — Print this help message and exit. 🙋
• -help-man — Print this help message as a manual page and exit. 📜
• -help-texi — Print this help message in texinfo format and exit. 📚
• -version — Print version info and exit. 🔖

🍓 ENVIRONMENT VARIABLES 🍓

• GMERLIN_PLAYER_REMOTE_PORT — Default port for the remote control. So if you don't wanna pass -port every single time, this is your girl. 💜

Friendly lil reminder bestie: <gml>, <device>, <volume>, <diff> and <num> are placeholders — swap in your actual values, don't type the angle brackets literally. 🙈

And that's the whole page, slay. This one's from Gmerlin, dated June 2012, and honestly? Still serving. 🫶✨