Skip to content

ricercar 0.7.0

Choose a tag to compare

@github-actions github-actions released this 30 Sep 18:33
· 69 commits to main since this release

ricercar

ricercar 0.7.0 makes source plugins first-class: they bring their own settings, lyrics, favourites, playlists you edit on the service, artist biographies and radios. The app now speaks six languages and lets you choose the network it serves on.

Downloads

Your system File Install
Debian 12+, Ubuntu 22.04+, Mint, Pop!_OS, Zorin, elementary ricercar_0.7.0-1_amd64.deb / _arm64.deb sudo apt install ./ricercar_*.deb
Fedora, openSUSE Tumbleweed / Leap 16, RHEL / Alma / Rocky 10+ ricercar-0.7.0-1.x86_64.rpm / .aarch64.rpm sudo dnf install ./ricercar-*.rpm (zypper install on openSUSE)
Arch, Manjaro, EndeavourOS, CachyOS, Omarchy ricercar-0.7.0-1-x86_64.pkg.tar.zst sudo pacman -U ricercar-*.pkg.tar.zst
Any distribution (portable) ricercar-0.7.0-x86_64.AppImage / -aarch64.AppImage chmod +x ricercar-*.AppImage && ./ricercar-*.AppImage
Any distribution (plain binaries) ricercar-0.7.0-linux-x86_64.tar.gz / -aarch64 unpack, run bin/ricercar

The packages need glibc 2.35 or newer. Verify a download with
minisign and the project key:

minisign -Vm SHA256SUMS -P RWSLPLWZ/M4/9X1orGjyBkKYA7BmzgxxI8dveJ8YVcSQVrOpjinxS9fV
sha256sum --check --ignore-missing SHA256SUMS

What's new

  • Plugin settings. A plugin can declare its own options (switches, choices, numbers, text). A gear button on the Plugins page opens them; changes apply without restarting the plugin.
  • More from your plugins, for plugins that offer it:
    • Lyrics from the plugin, with lrclib.net as the fallback. The lyrics view says where they come from.
    • Favourites: filled or empty hearts on tracks, albums and artists, kept in sync with the service.
    • Go to album, artist or label from any plugin track: lists, the queue and the player bar.
    • Extra actions in the context menus, such as an artist's radio or similar albums.
    • Playlists on the service: create, rename, delete (with confirmation), add and remove tracks, reorder. Add to playlist lists them next to your local playlists.
    • Artist and album details: biography, facts, and shelves of related artists and albums.
    • Radio: Start radio from a track, album or artist. Continuous playback (Settings, off by default) keeps playing similar tracks when the queue ends on a plugin track.
    • A plugin that relays the stream says so in the signal path ("relayed locally, original codec unchanged").
  • Six languages. English, French, German, Spanish, Italian and Japanese. Plugins receive the language you pick, so their pages follow it.
  • Choose the network interface the renderer and media server use (Settings → Network, or --interface). With a VPN, Docker or virtual machines, ricercar announces itself on your home network only; if that interface goes away, sharing waits for it to come back.
  • Faster seeking in network streams. When the server allows it, a seek far ahead fetches from that point at once instead of downloading everything before it.
  • Fixes and polish.
    • The Lyrics tab opens on the current line.
    • The source line no longer overlaps the lyrics.
    • The queue's remove button is easier to hit.
    • Long playlist names in the sidebar show whole on hover.
    • Home names Bluetooth and other PipeWire outputs by their name.
    • Home's Lyrics button opens the Lyrics tab.

For plugin authors

Everything is additive to protocol 1: a plugin that uses none of it works as before. See docs/plugins.md.

  • Settings: settings in initialize, settings.changed, settings.declared.
  • New capabilities: lyrics (lyrics.get), details (item.details), radio (radio.next), playlist_edit (playlists.*).
  • New item fields: album_ref, artist_ref, label_ref, actions, favorite, entry_id, editable; delivery on track.resolve.
  • locale is now the language chosen in ricercar, and locale.changed follows switches.
  • Methods that change something (playlists.*, favorites.set) are never retried after a network error.
  • playback.ended now reports ended when the queue stops at the end of a track.

From 0.6.0, Update now in Settings → About installs this version, checked against the signed SHA256SUMS.

Plugins are written by third parties and are not reviewed by the ricercar project. They run with your permissions: install only plugins you trust, and check that they respect the terms of the service they use.

From source: cargo build --release with Rust 1.92 or newer (see the README for per-distro dependencies).