Skip to content
MAKHMUDuzPublic

About

Ultra-lightweight native YouTube Music desktop client in C++20 and Rust

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

18 stars

Watchers

1 watching

Forks

Melyar

Ultra-lightweight native desktop client for YouTube Music

CI Release License Discussions

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 desktop music player

Why Melyar

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

Highlights

  • Search, browse, and play YouTube Music content
  • Playback with libmpv and 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

Screenshots

Melyar player

Melyar library

Melyar settings

Architecture

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.

Install

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.deb

Arch (dependencies come from the official repos):

sudo pacman -U melyar-*.pkg.tar.zst

Arch: 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 build

CMake 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.

Build from source

Requirements

  • 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-config
  • yt-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 mpv

Debian / 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-dlp

Install Rust 1.88 or newer with rustup before building.

Build and run

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/melyar

Desktop integration

MPRIS

Melyar registers itself on the session bus as org.mpris.MediaPlayer2.melyar, so Linux desktops can discover playback state without any manual configuration.

Waybar / status bar

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.

Local data

Data Location
Database ~/.local/share/melyar/melyar.db
IPC socket $XDG_RUNTIME_DIR/melyar.sock

Roadmap

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.

Help wanted: Windows, macOS, Android and iOS

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

Contributing

Contributions, bug reports, and focused pull requests are welcome.

License

Melyar is dual-licensed under:

SPDX-License-Identifier: MIT OR Apache-2.0


Built with Rust, Qt 6, React, and a lot of care for the details.

About

Ultra-lightweight native YouTube Music desktop client in C++20 and Rust

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

18 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages