README language:

⚠️ Notice: This is a hard vibe-coded fork of Cassette. This is my personal experiment and may contain experimental features, bugs, or incomplete implementations. Use at your own discretion.

Cassette

GTK4/Adwaita application that allows you to use Yandex Music service on Linux operating systems.

Install

Flathub:

flatpak install space.rirusha.Cassette

Distribution repositories:

ALT Linux

su -
apt-get install cassette

Arch Linux

Most AUR Helpers support Pacman-style flags, for example, yay.

yay

yay -S cassette

pamac

pamac install cassette

NixOS Unstable

nix-shell -p cassette

Building

Dependencies:

• gtk4, version: >= 4.14
• libadwaita-1, version: >= 1.5
• libsoup-3.0
• gdk-pixbuf-2.0
• json-glib-1.0
• sqlite3
• gee-0.8
• libxml-2.0
• gstreamer-1.0
• webkitgtk-6.0
• gio-2.0, version: >= 2.72
• git, only for devel

Building utilities:

• meson
• ninja
• cmake
• blueprint-compiler
• gcc
• valac
• pkg
• appstream-utils

PreRelease

Unstable features under development will not be available in this version.

meson setup _build

is_devel flag

In this version, all devel functions will be available.

meson setup _build -Dis_devel=true

Install

sudo ninja install -C _build

Flatpak (recommended for GNOME environments)

Builds Cassette inside the GNOME 47 SDK using flatpak-builder.

flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install --user -y org.gnome.Sdk//49 org.gnome.Platform//49
flatpak-builder --user --install --force-clean build-flatpak flatpak/space.rirusha.Cassette.yml
flatpak run space.rirusha.Cassette

Docker (multi-stage build)

Produces release artifacts (Meson dist tarballs, DEB/RPM packages) via the multi-stage Dockerfile.

docker build --target artifacts -t cassette-artifacts .
container_id=$(docker create cassette-artifacts)
docker cp "$container_id":/dist ./dist
docker rm "$container_id"
ls dist

Testing

ninja -C _build test

Uninstal

sudo ninja uninstall -C _build

Devel version

This version is built and updated with every commit, so it may be unstable.

You need to add cassette-nightly and gnome-nightly repositories:

flatpak remote-add --if-not-exists gnome-nightly https://nightly.gnome.org/gnome-nightly.flatpakrepo
flatpak remote-add --if-not-exists cassette-nightly https://rirusha.space/repos/cassette-nightly.flatpakrepo

Install application:

flatpak install cassette-nightly space.rirusha.Cassette.Devel

For developers

The repository has recommended extensions for developing with Visual Studio Code.

Dependencies

repository gnome-nightly:

flatpak remote-add --if-not-exists gnome-nightly https://nightly.gnome.org/gnome-nightly.flatpakrepo

To run

org.gnome.Platform//master

flatpak install org.gnome.Platform//master

To build

org.gnome.Sdk//master
org.freedesktop.Sdk.Extension.vala//23.08beta

flatpak install org.gnome.Sdk//master org.freedesktop.Sdk.Extension.vala//23.08beta

Support

You can support in several ways:

• Create an issue with a problem or a suggestion for improvement
• Submit a merge request with a fix or new functionality
• Support financially (Please include your nickname in the "Message to the recipient" when sending via T-Bank)

Gratitude

Thank you MarshalX. The yandex-music-api library was used as api documentation.

Attention! Cassette is an unofficial client, not affiliated with Yandex and not approved by it.