Qcm

Material You cloud music player.

Backend

• Jellyfin
• Subsonic(WIP)
• Netease Cloud Music

Screenshots

Installation

Flathub

Arch Linux

AUR

[yay/paru] -S qcm

archlinuxcn repository

sudo pacman -S qcm

Require:

• Compiler: clang 19+
• OS: linux, win(libc++)

Separated Libraries

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

• QmlMaterial
• kstore
• ncrequest
• rstd

Third Libraries

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

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
• android
• offline mode