sayonara-ctl(1)

📦
version 1.12.0 · 11 versions
, in fedora 43, fedora 44

💖 sayonara-ctl(1) — the Sayonara Control Tool 💖

okay bestie, so this is sayonara-ctl, a little command-line bestie that lets you boss Sayonara around from your terminal. section 1 of the manual, iconic behaviour, no notes. ✨

🌸 NAME 🌸

sayonara-ctl — control sayonara via dbus

🦋 SYNOPSIS 🦋

sayonara-ctl command [parameter]

✨ DESCRIPTION ✨

so sayonara-ctl is literally made to control sayonara through its dbus interface. and it's highkey perfect for desktop environments where you get to map keyboard shortcuts to commands — like, you press a key combo and boom, music does the thing. it's giving remote control energy. 👑

💅 OPTIONS 💅

one bullet per command, bestie, we don't skip. periodt.

  • play — start playback. music go brrr. ▶️
  • play-pause — toggle between playing and pause state. the flip-flop of it all. 🔁
  • pause — pause playback. take a lil breather. ⏸️
  • stop — stop playback. full halt, no crumbs. ⏹️
  • seek-us microseconds — jump to a position in the track, measured in microseconds. tiny units, big moves. ⏩
  • set-shuffle 1 — enable shuffling playback. chaos mode: ON. 🔀
  • set-shuffle 0 — disable shuffling playback. chaos mode: OFF. 🧘
  • next — jump to the next track. skip, slay, next. ⏭️
  • previous — jump to the previous track. go back, babe. ⏮️
  • set-volume <volume> — adjust the volume. lowkey important detail: if the volume is greater than 1 it gets divided by 100. check the examples below, iykyk. 🔊
  • inc-volume — increase the volume. louder, obviously. 📈
  • dec-volume — decrease the volume. quieter, respectfully. 📉
  • raise — show Sayonara if it's hidden. come out come out wherever you are. 🪟
  • quit — quit Sayonara. bye bestie, love you, mean it. 💔

🌈 EXAMPLES 🌈

Start playback

sayonara-ctl play

Jump to 1min 30sec

sayonara-ctl seek-us 90000000

Set volume to 75%

sayonara-ctl set-volume 75

see? 75 is bigger than 1, so it gets divided by 100 → that's your 75%. the math is mathing. 🧮✨

💀 BUGS 💀

found something cursed? please file in new bug reports at

https://gitlab.com/luciocarreras/sayonara-player

do NOT suffer in silence, bestie. drop the report. 🫶

👑 AUTHOR 👑

Michael Lugmair (sayonara-player@posteo.org)

and that's the whole page, fr fr. this was 1.12.0-stable1, dated 07 August 2026 — go forth and control your music like the main character you are. mwah. 💋🎀

📦 where this page comes from