GTK QQ

Unofficial Linux QQ client, based on GTK4 and libadwaita, developed with Rust and Relm4.

This app uses ricq as the rust bindings of QQ APIs.

Screenshots

Light	Dark

Note

The two screenshots have been a little outdated. The UI now has been adjusted and improved compared to them.

Installation

AUR

For Arch users, you can install via the AUR package gtk-qq-git:

paru -S gtk-qq-git

Manual Build

Requirements

You will need to install Rust and Meson to build this project, and the neccessary libraries below:

Ubuntu (>= 22.04)

sudo apt install gcc libssl-dev libsqlite3-dev libgtk-4-dev libadwaita-1-dev

Fedora

sudo dnf install gtk4-devel libadwaita-devel

Arch

sudo pacman -S pkgconf gtk4 libadwaita

Windows & MacOS

GTK4 projects would be more complex to compile on Windows/MacOS. Nevertheless, considering some special reasons that you know, we shall not offer the Windows/MacOS release or even build scripts.

Warning

You can try to build it still if you are just for personal use. At the same time, you should also promise that you will not distribute the Windows/MacOS build to the public in order to ensure the maintenance of this project.

The user builds, uses or distributes this project at the user's own risk. This project and its contributors assume no responsibility.

Setup

You only need to run the commands below once unless you change the related codes.

# In the root directory of project
meson setup builddir
meson compile -C builddir

Build

Switch to nightly toolchain before building.

# In the root directory of project
rustup override set nightly
cargo build --release

Contributing

You can feel free to use English or Chinese to open an issue or pull request.
The commit message should follow the Conventional Commits.
If you want make changes to the UI part, read the GNOME Human Interface Guidelines before it.

License

This repository is under the AGPL-3.0 license .

JamzumSum/gtk-qq