Melyar is a Linux-first, local-first desktop music client for YouTube Music. It combines a fast Rust core, a native Qt/C++ shell, and a polished React + TypeScript interface to deliver a clean, responsive listening experience without the overhead of heavier desktop frameworks.
Melyar is built for people who want a music player that feels native on Linux:
- Small runtime footprint
- Fast startup and responsive controls
- Deep desktop integration with MPRIS and Waybar
- No account requirement to launch the app
- Local-first behavior with personal library data stored on disk
- Search, browse, and play YouTube Music content
- Playback with
libmpvand gapless streaming behavior - Queue management, shuffle, repeat, volume, and seek controls
- Synced LRC lyrics with plain-text fallback
- Favorites, history, albums, artists, and library views
- Library import from a Spotify export, JSON or CSV — Import & Transfer 2.0 (demo/active stage)
- Ten band graphic equaliser (31 Hz - 16 kHz)
- Liquid Glass-inspired interface with light/dark theming
- Fifteen interface languages, switched at runtime
- Native Linux media integration via MPRIS and Unix socket IPC
React + TypeScript UI
│
│ QWebChannel
▼
Qt / C++ bridge
│
▼
Rust core ── playback, library, provider logic, IPC
│
▼
mpv audio playback
The C++ ↔ Rust boundary is connected via the cxx bridge, while the UI communicates with the core through Qt/WebChannel.
Arch and Debian/Ubuntu packages are attached to the latest release. No build toolchain is needed:
Debian / Ubuntu (Ubuntu 24.04 or newer):
sudo apt install ./melyar_*_amd64.debArch (dependencies come from the official repos):
sudo pacman -U melyar-*.pkg.tar.zstArch: pacman -S rust veya rustup default stable ile araç zinciri eksik oluşabilir.
Sorun yaorsa rustup shim'i (pacman -S rustup) tam Rust toolchain'i içermez.
Tam Rust için sudo pacman -S rust kullanın.
For other distributions, build from source below so the binary links against the Qt and system libraries available on that machine.
You can also install from source once it is built:
sudo cmake --install buildCMake installs to /usr/local by default (bin/melyar,
share/melyar/web/, share/applications/melyar.desktop,
share/icons/.../melyar.svg). Configure with -DCMAKE_INSTALL_PREFIX=/usr
to install into the system directory instead. A PKGBUILD (makepkg -si)
and a debian/ recipe (dpkg-buildpackage -us -uc -b) are included in the
repository. CI builds and validates both packages on every push; version tags
publish the validated packages to GitHub Releases.
- Rust ≥ 1.88 (install with rustup; Ubuntu 24.04's packaged Rust is too old)
- CMake ≥ 3.25
- Qt 6 (
Core,Gui,Quick,Qml,WebEngineQuick,WebChannel) - Node.js ≥ 20
- pnpm ≥ 10
- mpv ≥ 2.x with development files
pkg-configyt-dlp(optional, used when installed)
Distribution examples (Arch / Manjaro, Debian / Ubuntu)
Arch / Manjaro
sudo pacman -S base-devel cmake rust pkgconf \
qt6-base qt6-declarative qt6-webengine qt6-webchannel qt6-svg mpvDebian / Ubuntu
sudo apt install build-essential cmake pkg-config \
qt6-base-dev qt6-declarative-dev qt6-webengine-dev qt6-webchannel-dev \
qml6-module-qtquick qml6-module-qtquick-controls \
qml6-module-qtquick-dialogs qml6-module-qtquick-layouts \
qml6-module-qtquick-templates qml6-module-qtquick-window \
qml6-module-qtqml-workerscript qml6-module-qtwebchannel \
qml6-module-qtwebengine libqt6svg6 libmpv-dev yt-dlpInstall Rust 1.88 or newer with rustup before building.
git clone https://github.com/MAKHMUDuz/melyar.git
cd melyar
cd ui_web
pnpm install
pnpm build
cd ..
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j"$(nproc)"
./build/melyarMelyar registers itself on the session bus as org.mpris.MediaPlayer2.melyar, so Linux desktops can discover playback state without any manual configuration.
Melyar also exposes a zero-latency Unix socket at $XDG_RUNTIME_DIR/melyar.sock for tools such as Waybar, Polybar, and i3status.
Full setup, CSS and Hyprland/Sway keybinding examples: docs/WAYBAR.md.
| Data | Location |
|---|---|
| Database | ~/.local/share/melyar/melyar.db |
| IPC socket | $XDG_RUNTIME_DIR/melyar.sock |
Melyar is actively under development. The project aims to improve Linux desktop integration, library workflows, provider breadth, and reliability over time.
See ROADMAP.md for the detailed project plan and upcoming work.
Melyar is Linux-first. Four ports are now open, each with a checklist, a verified toolchain matrix, and an entry point that does not require knowing the whole codebase:
| Port | Issue |
|---|---|
| Windows | #28 |
| macOS (Apple Silicon + Intel) | #27 |
| Android (APK) | #29 |
| iOS / iPadOS | #30 |
- Live status board: #31
- No code needed: #33 packaging and store manifests, #34 store policy research, #35 playback resilience
- Call for contributors: Discussion #32
Contributions, bug reports, and focused pull requests are welcome.
Melyar is dual-licensed under:
- MIT — LICENSE-MIT
- Apache 2.0 — LICENSE-APACHE
SPDX-License-Identifier: MIT OR Apache-2.0



