Remus owns org.mpris.MediaPlayer2.remus on the session bus and serves
the root and player interfaces: play, pause, play-pause, stop, next,
previous and quit, with the playback status, track metadata, position
and volume. Desktops route media keys to the active MPRIS player, and
headphone buttons arrive as media keys, so this is how they reach remus.
Reading the headphones' input devices directly was ruled out: keyboard
type devices, AVRCP included, are root:input, and only gamepads are
opened up to the logged-in user. Seeking is not offered (CanSeek false).
The Flatpak gets --own-name for the bus name.
Settings has a Show controls bar toggle, on by default and saved as
show_hint_bar. Off, the hint bar goes from the browse and now-playing
screens and the content takes its height. The login screen keeps it,
since the controls are not known yet there and Settings is out of reach.
The bar is where the version shows, so while it is off Settings lists
the version instead.
On now playing it is centred under the progress bar. The bottom bar on
the other screens shows it too, at the right after the time and play
state. Its number has a fixed width: with only a minimum, the row gave
it the spare space and pushed the time into the middle.
Right stick up and down change the volume in steps of 5 and clicking it
mutes; + (or =), - and m do the same on a keyboard, on every screen. The
stick's dominant axis wins, so a diagonal push does not seek and change
the volume at once. Any step unmutes.
The level goes to playbin's volume on a cubic scale, so steps sound
even, and to its mute. A pill shows the level for a moment after each
change, the now-playing screen shows it under the times, and it is
saved in settings.toml once the changes stop and on quit.
Hint icons for the right stick and the keys are from Kenney's Input
Prompts 1.5, like the others.
A PlayState component draws the triangle and the two bars as vectors in
the highlight colour. The mini player uses it too, in place of the ▶
and ❚❚ glyphs, which a font fallback could draw as emoji or at
different weights.
The first range setting: its row draws a slider, and left and right
change it in steps of 10 while confirm still flips the toggles. Saved
as cover_backdrop in settings.toml, defaulting to the old fixed look.
Up to the default the cover fades in under the old overlay. Above it
the overlay thins as well, down to 0.55 on the left where the title and
progress sit, which kept them readable over a bright cover.
The cover turns edge-on, swaps, and turns back with an overshooting
curve. Slint has no perspective, so the turn squashes the width.
Whether to flip is decided by a hash of the decoded pixels, not by the
cover id: Navidrome gives every track its own id even when the whole
album shares one image. While the new cover loads the old one stays up,
and the next track's cover is fetched ahead so a skip decides at once.
The tile now starts 2 units from the edge instead of 8 and the mark is
100 tall instead of 74, nudged up 1 unit because its base reads heavier
than the R.
The login screen could only be left with Ctrl+Q, which a gamepad cannot
press. Exit sits below Connect as the last focus stop and goes through
Action::Quit.
Holds org.freedesktop.ScreenSaver.Inhibit, the call Electron apps
such as VacuumTube use to stay awake in Steam's Game Mode, and the
XDG portal's idle inhibit, from play until pause, stop or quit.
zbus 6 cannot connect through Flatpak's D-Bus proxy, so this uses
zbus 5.
Releases on Gitea had nothing to install, so getting remus onto a Steam
machine meant building the bundle and copying it across by hand. After
a bump and a push with tags, make publish builds the Flatpak bundle for
the tagged commit and creates the release, with the changelog entry as
its notes and remus-X.Y.Z.flatpak attached.
Every check runs before the slow build: a clean tree, HEAD tagged with
the Cargo.toml version, a token, the same tag on the remote and no
release for it yet. The token is read from GITEA_TOKEN or
~/.config/gitea/token and passed to curl in a header file, so it is
never on a command line. If the upload fails, the release is deleted
so the next run starts clean.
Quitting, a crash or SteamOS restarting the app lost the queue and how
far into the track playback was, which hurts most for long items. The
queue is now saved to queue.json in the state directory, one queue per
user and server, on a track change, on pause, when songs are queued,
every 15 seconds while playing and on quit. It holds song metadata,
never a stream URL, since those carry the token or the password.
On start the saved track is loaded paused and seeked to once it has
prerolled. Nothing plays, and the server is not told about the track,
until play is pressed. An unreadable file is logged and ignored.
Two player bugs had to go for this. A failing source posts several
errors, and the later ones counted against the next track, so one
missing song skipped two tracks or stopped the queue. Play pressed
while a track was still loading was dropped.
The hint bar always named Xbox buttons, so someone at a keyboard was
told to press buttons they did not have, and owners of other pads got
the wrong letters. Hints now name an action, and the keys or button
icons come from the input used last: keyboard, or an Xbox, PlayStation,
Switch or Steam Deck controller.
Behind Steam, every pad is Steam's virtual one. remus reads the file
Steam names in SteamVirtualGamepadInfo to find the physical controller,
matching the slot in the pad's name, as SDL does. Icons are Kenney's
Input Prompts (CC0), with the licence beside them.
The player reported a track only when the queue index changed, to drop
the repeat stream-start messages playbin posts for one track. Starting
another album at the same index (track 1 after track 1) therefore sent
no event: the app kept the old track on screen, and pause said nothing
was playing, because it had cleared the current track while waiting
for that event.
A stream-start that begins a track the player was asked to start is now
always reported. Only repeats within one track are dropped, and the app
treats every report as a new play, so replaying the current track
resets its position and scrobbles again.
A bump amends and tags the last commit, so made on a feature branch it
tags a commit that master may never contain. The targets now refuse any
branch but master, and a detached HEAD.
The version had never moved from 0.1.0, so a build on the Deck could not
be matched to what it contains. The bump targets follow frig and
worklane: write the new version, amend it into the last commit and tag
it. Here they also add a release to the Flatpak metainfo, and refuse a
version that CHANGELOG.md, new in this commit, has no entry for.
The version is shown at the bottom left of every screen, the login
screen included.
A new Settings section in the sidebar turns it on and off. It is saved
in settings.toml, apart from the login, so logging out keeps it.
Each theme colour keeps the lightness it has in the brand palette and
only takes the cover's dominant hue, so text stays readable on any
cover. Covers with too little colour, and nothing playing, use the
brand palette. Slint cannot animate a global, so a timer in Rust fades
the Theme colours to the new palette over 800 ms.
Warm maroon backgrounds with cream text replace the cool blue theme.
The accent splits in two: a maroon fill for the current section and
buttons, and a lighter red for text and thin lines, where the fill is
too dark to read. Focus rings are cream.
Headings use Noto Serif SemiBold, the wordmark's font, bundled with its
licence so they look the same whatever the machine has installed. The
sidebar and login card show the logo instead of plain text.
The mark (R on a column flanked by sound bars) is traced from the
design artwork and generated from one script, so every variant stays
in sync. The Flatpak icon replaces the placeholder disc. Run
`make branding` to regenerate the SVGs and render the PNGs.
Nextcloud Music answers a token login with Subsonic error 41, so remus
could not log in to it at all. Login now retries with the password,
hex-encoded as the spec allows, when the server returns 41, and saves
which method worked. Servers that accept tokens are unaffected, and
existing login files still load.
Server errors now keep their code. A wrong password on Nextcloud adds a
line about the API password from the Music app's settings, which is not
the Nextcloud login password.
SteamOS has a read-only root filesystem, so a Flatpak is the way to
install it. The build is offline from vendored crates. make
flatpak-bundle writes one file to copy to a Steam machine, and
make sdk-check runs the checks inside the SDK for hosts without the
GStreamer development files.
A Flatpak cannot run the host's mpv, and SteamOS does not ship one.
GStreamer comes with the Flatpak runtime, so the player now drives
playbin in-process. The next track is handed over in about-to-finish,
which keeps playback gapless as it was with mpv. GStreamer's HTTP
errors quote the stream URL, so its query string, which carries the
auth token, is stripped before logging.
On a Steam machine remus can start before the network is up, so the
first page load fails even though the saved login is fine. An empty
page now retries with backoff (2 s doubling to 30 s) and fills in once
the server is reachable, without anyone pressing a button.
make check runs what has to pass before a commit: rustfmt, clippy with
warnings as errors, and the unit tests. make shots screenshots the
main screens against the Navidrome demo server using a scratch config.
Browses a Subsonic library and plays it through mpv, driven by a
gamepad or keyboard. The UI scales from the window's physical height
rather than the compositor's scale factor, so it keeps its proportions
on a Steam Deck and on a 4K TV, where other players open small or
scale badly.