feat: Linux release packaging

Tarball, .deb and AppImage from tool/bundle-linux.sh, and an Arch PKGBUILD.
The window carries the dev.musyx.Musyx app id so desktops match it to the
installed desktop entry and icons.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yuriy.pandClaude Opus 5.5 committed 2026-10-16 12:27:50 +06:00
1 parent 28e273c31e
commit f80de805c2
9 files changed
+303 -2

No files matched your search

+25 -2
View File
@@ -42,11 +42,34 @@ This builds a release `Musyx.app` into `target/release/bundle/`, signed with the
`MUSYX_SIGN_IDENTITY` to sign with another identity, or to `-` for an ad-hoc signature
(each ad-hoc build is a new code identity, so macOS asks again for keychain access).
## Install on Linux
```sh
tool/bundle-linux.sh # tarball, .deb and AppImage into target/release/bundle/
tool/bundle-linux.sh tar deb # only the formats named
tool/bundle-linux.sh --install # install into ~/.local (PREFIX picks another prefix)
```
On Arch, `makepkg -si` in `packaging/arch` builds and installs the committed `HEAD`.
Building needs `pkg-config` and the ALSA and D-Bus development files (`alsa-lib` and `dbus`
on Arch, `libasound2-dev` and `libdbus-1-dev` on Debian/Ubuntu). The AppImage also needs
[`appimagetool`](https://github.com/AppImage/appimagetool/releases) on `PATH` (or
`APPIMAGETOOL`). A binary runs only on a glibc at least as new as the one it was built
against, so build release packages on the oldest distro you want to support.
The desktop entry, metainfo and icons are installed as `dev.musyx.Musyx`, which is also the
window's Wayland app id. The token goes to the Secret Service (GNOME Keyring, KWallet,
KeePassXC), and media keys and the desktop's player widget work through MPRIS. The menu bar
mini player is macOS-only.
## Settings
Settings (streaming quality, appearance, language, volume) are kept in
`~/Library/Application Support/Musyx/settings.json`. Covers are cached under
`~/Library/Caches/Musyx/covers` and can be cleared from Settings.
`~/Library/Application Support/Musyx/settings.json` on macOS and
`~/.config/musyx/settings.json` on Linux. Covers are cached under
`~/Library/Caches/Musyx/covers` (`~/.cache/musyx/covers` on Linux) and can be cleared from
Settings.
Streaming quality **Lossless** asks Yandex for FLAC (through the signed `/get-file-info`
endpoint, decrypting its AES-CTR stream in memory). Yandex decides what to grant by