KOTONOHA(1)

📦 version 0.3.1, in nixpkgs unstable

🌸 kotonoha(1) — the manual page bestie 💅

okay so real talk, this is kotonoha from section 1 (User Commands), and it's genuinely one of my fave little tools, so let me put you on ✨

🎀 NAME 🎀

kotonoha — a Wayland desktop lyrics overlay for MPRIS media players. yes. it puts the lyrics on your screen. ur welcome 💖

🦋 SYNOPSIS 🦋

kotonoha [--port PORT] [-v]

that's it, that's the whole vibe check 🫶

✨ DESCRIPTION ✨

so basically kotonoha displays an overlay — and listen, not just any overlay — it's translucent, it's click-through, and it's always-on-top 🔥 and what's on it? word-by-word synchronized lyrics for the current track, no cap. it reads them from any MPRIS player over D-Bus, which is lowkey iconic of it tbh.

now here's the part where the compositor you're running matters, and the way that it matters is very much giving "know ur audience" 👑

  • on wlr-layer-shell compositors (that's KDE Plasma and wlroots), the overlay floats above fullscreen. main character energy, it does not get buried. 👑
  • on GNOME/Mutter and any other compositor that doesn't have wlr-layer-shell, it falls back to being a normal top-most window instead. still cute, still on top, just... a regular window about it 🙈

💅 OPTIONS 💅

  • --port PORT, -p PORT — overrides the external adapter WebSocket receiver port. the default is 28745, and like, if that number ain't it for you, this is your moment ✨
  • -v, --verbose — turns on verbose logging. for when u simply must know everything 🔍💀

🌈 SEE ALSO 🌈

project homepage, go show it some love fr fr: https://github.com/locez/kotonoha 💜

👑 AUTHOR 👑

Locez — <locez@locez.com> 🫶

aaaand that's the whole page!! this was kotonoha version 0.1.0, dated 2026-07-11 — mwah, stan, periodt 🍓🧚💖

📦 where this page comes from