purrr.chat/purrr-client
Watch
4
0
Fork
You've already forked purrr-client
 0
Code Issues Pull requests Projects Releases 5 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
18 commits 1 branch 6 tags 848 KiB
  • Rust 73.2%
  • Shell 16.7%
  • Dockerfile 10.1%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
MeIsGaming d168429ee8
All checks were successful
mirror-github / push (push) Successful in 14s
Details
ci: libbz2-dev — trixie's freetype2.pc requires bzip2.pc, breaking gdk-3.0 pkg-config
2026-09-28 01:29:07 +02:00
.forgejo/workflows Sync from the monorepo's desktop/: IPC pinned to the instance, links open in the browser 2026-09-27 15:21:28 +00:00
.github/workflows Add GitHub mirror sync workflows (replace force-push+prune push mirror) 2026-09-27 16:38:59 +02:00
ci ci: libbz2-dev — trixie's freetype2.pc requires bzip2.pc, breaking gdk-3.0 pkg-config 2026-09-28 01:29:07 +02:00
dist initial public release: purrr desktop client shell (Tauri 2) 2026-07-22 21:39:36 +02:00
packaging Sync from the monorepo's desktop/: IPC pinned to the instance, links open in the browser 2026-09-27 15:21:28 +00:00
src-tauri bump version to 0.1.6 2026-09-27 23:57:45 +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 Sync from the monorepo's desktop/: IPC pinned to the instance, links open in the browser 2026-09-27 15:21:28 +00: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. The AppImage and .exe carry the self-updater (signed, fed by latest.json from the same release); .deb/.rpm update through the package manager. 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.