Qcm

Material You cloud music player.

To use Qcm, you'll need to run it with a compatible local backend.

The backend process is managed by Qcm, you can use --backend <path> to set the backend executable path.

Backend Support

A backend implementation can be found at QcmBackend, which supports the following music services:

• Jellyfin
• Netease Cloud Music(wip)

Screenshots

Installation

Flathub

Arch Linux

AUR

[yay/paru] -S qcm

archlinuxcn repository

sudo pacman -S qcm

Require:

• Compiler: clang 19+
• OS: linux

Separated Libraries

The following libraries were extracted and modularized during Qcm's development.

• QmlMaterial
• MetaModel
• ncrequest
• rstd

Third Libraries

• Qt
• ffmpeg
• curl
• openssl
• asio
• cubeb
• PEGTL
• ctre

Build

git clone --recursive https://github.com/hypengw/Qcm.git

cmake -S Qcm -B build -GNinja -DCMAKE_BUILD_TYPE=Release
cmake --build build

# run without install
export QML_IMPORT_PATH=$PWD/build/qml_modules
./build/app/Qcm --backend <backend executable>

# install
cmake --install build

FAQ

• Desktop lyrics

  use waylyrics

• How to debug in flatpak

  flatpak install io.github.hypengw.Qcm.Debug
  flatpak run --devel --command=bash io.github.hypengw.Qcm
  # 1. run directly
  [📦 io.github.hypengw.Qcm ~]$ gdb Qcm
  (gdb) run
  Enable debuginfod for this session? (y or [n]) n
  ...
  # get the stacktrace
  (gdb) bt
  
  # 2. or use coredump file
  coredumpctl dump <id> -o core.save
  flatpak run --devel --filesystem=host --command=bash io.github.hypengw.Qcm
  [📦 io.github.hypengw.Qcm ~]$ gdb Qcm core.save
  ...

Todo:

• mac/win
• offline mode
• playing page colorpick
• playing page blur
• android