purrr.chat/purrr-client
3
0
Fork 0
Code Issues Pull requests Projects Releases 4 Packages Wiki Activity Actions
Native desktop client for purrr, a cozy self-hosted Discord alternative. A thin Tauri 2 shell with tray, autostart and global voice hotkeys. https://purrr.chat
12 commits 1 branch 4 tags 734 KiB
  • Rust 67%
  • Shell 21.9%
  • Dockerfile 11.1%
Find a file
Exact
ashley 5bea17ebd1
All checks were successful
release / release (push) Successful in 21m35s
Details
ci: single release job (fixes 409); bump 0.1.5
2026-07-23 21:13:17 +02:00
.forgejo/workflows ci: single release job (fixes 409); bump 0.1.5 2026-07-23 21:13:17 +02:00
ci ci: prebaked purrr-ci base image + build caching; bump 0.1.3 2026-07-23 02:13:42 +02:00
dist initial public release: purrr desktop client shell (Tauri 2) 2026-07-22 21:39:36 +02:00
packaging manual-setup tutorial 2026-07-22 23:11:11 +02:00
src-tauri ci: single release job (fixes 409); bump 0.1.5 2026-07-23 21:13:17 +02:00
.gitignore initial public release: purrr desktop client shell (Tauri 2) 2026-07-22 21:39:36 +02:00
LICENSE initial public release: purrr desktop client shell (Tauri 2) 2026-07-22 21:39:36 +02:00
README.md updater signing config + signed appimage build + README install section 2026-07-22 22:18:32 +02:00

README.md

purrr desktop client

The native desktop client for purrr — a cozy, self-hosted Discord alternative.

This is a thin, native shell (built with Tauri 2) around a purrr instance. It opens a window onto https://purrr.chat (or your own instance) and adds native niceties:

  • System tray — close to tray, keep running in the background
  • Autostart — optionally launch on login (toggle in the tray menu)
  • Global voice hotkeys — Ctrl+Shift+M mute, Ctrl+Shift+D deafen, even when the window isn't focused

The actual chat UI is served by the instance at runtime, so this repository only contains the native wrapper — no server or web-app source.

Install

Arch Linux (AUR):

# stable, prebuilt (fastest, recommended once releases exist)
yay -S purrr-client-bin
# stable, built from source
yay -S purrr-client
# latest dev, built from source
yay -S purrr-client-git

Other distros / Windows: .deb, .rpm, .AppImage and .exe come from the releases. See packaging/DISTRIBUTION.md for the apt/dnf repos and the full release story.

Point it at your own instance

PURRR_URL=http://127.0.0.1:8080 purrr

Build from source

Needs a Rust toolchain and the usual WebKitGTK dev packages on Linux (webkit2gtk-4.1, gtk3, libayatana-appindicator):

cargo build --release --manifest-path src-tauri/Cargo.toml

Or, with the Tauri CLI, to produce installers:

cargo tauri build          # .deb / .rpm / .AppImage (Linux), .exe (Windows)

License

AGPL-3.0-or-later.