No description
  • Rust 98.7%
  • JavaScript 1%
  • PowerShell 0.2%
  • Shell 0.1%
Find a file
Charles Daoust 1cd9adc7c4
All checks were successful
ci / Linux (x86_64) (push) Successful in 15m32s
ci / Windows (x64) (push) Successful in 16m17s
Merge user profile popout (PR #219)
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-12 00:19:19 -05:00
.cargo build: package voice dependencies 2026-11-11 19:37:06 -05:00
.forgejo/workflows ci: build integration branches only 2026-11-12 00:16:04 -05:00
apps/fluxer Merge user profile popout (PR #219) 2026-11-12 00:19:19 -05:00
crates Merge user profile popout (PR #219) 2026-11-12 00:19:19 -05:00
docs Merge user profile popout (PR #219) 2026-11-12 00:19:19 -05:00
fixtures Open a user's profile popout with their banner 2026-11-12 00:18:10 -05:00
packaging build: package voice dependencies 2026-11-11 19:37:06 -05:00
tools chore(workflow): finalizers gate on local ci only; runners build integration branches 2026-11-12 00:16:04 -05:00
xtask fix(voice): fast joins with the connect chime, and a voice log 2026-11-11 23:57:58 -05:00
.gitattributes feat(audio): clip decoding, cache and chimes 2026-11-11 14:40:59 -05:00
.gitignore chore: workspace scaffold, xtask ci and Forgejo CI 2026-11-11 03:02:00 -05:00
Cargo.lock Merge voice join fixes: warm WebRTC runtime, self-join chimes, voice logging (PR #215) 2026-11-12 00:16:18 -05:00
Cargo.toml fix(voice): fast joins with the connect chime, and a voice log 2026-11-11 23:57:58 -05:00
CLAUDE.md docs: Foundation acceptance record 2026-11-11 08:59:01 -05:00
clippy.toml chore: workspace scaffold, xtask ci and Forgejo CI 2026-11-11 03:02:00 -05:00
deny.toml Merge remote-tracking branch 'origin/task/25-packaging-release' into task/26-acceptance 2026-11-11 08:48:27 -05:00
README.md build: package voice dependencies 2026-11-11 19:37:06 -05:00
rust-toolchain.toml chore: workspace scaffold, xtask ci and Forgejo CI 2026-11-11 03:02:00 -05:00
rustfmt.toml chore: workspace scaffold, xtask ci and Forgejo CI 2026-11-11 03:02:00 -05:00

Fluxer Native

A native Rust desktop client (Linux, Windows) for the Fluxer instance at fluxer.forked.io, built with iced and wgpu to replace the Electron app.

Status: sub-project 1, Foundation, is built and under acceptance: login (password and TOTP), guilds, channels, DMs, the message view with Markdown, sending, unread and mention badges, desktop notifications, the settings skeleton, packaging. What is verified and what is still open is in docs/acceptance/2026-11-foundation.md. Voice, video and the rest of the Electron app's features belong to the later sub-projects listed in the program overview.

Install

Releases are published on the Forgejo repository, https://git.forked.io/charles/fluxer-native/releases, as native-<version> with three files (none is published yet; see the acceptance record):

  • Linux: Fluxer-Native-<version>-linux-x86_64.AppImage. chmod +x it and run it. It needs glibc 2.35 or newer, ALSA's libasound.so.2 (libasound2 on Debian and Ubuntu 22.04, libasound2t64 on Ubuntu 24.04+, alsa-lib on Fedora and Arch; PipeWire and PulseAudio serve it), a Vulkan driver, Wayland or X11, and for notifications and the stored login a session D-Bus with a notification service and a Secret Service (KWallet, GNOME Keyring). Without FUSE, run it with APPIMAGE_EXTRACT_AND_RUN=1.
  • Windows: Fluxer-Native-<version>-win-x64.exe, a portable executable; no installer and no Visual C++ redistributable needed (Windows 10 or newer).
  • SHA256SUMS for both (sha256sum --check SHA256SUMS).

The client stores its settings in the platform's configuration directory (~/.config/fluxer-native/settings.toml on Linux), a message cache in the cache directory, logs in the state directory and the session token in the OS keyring, never in a file. fluxer --debug-info prints the version, the GPU adapters it found and every path it uses.

Run

fluxer                                  # log in to https://fluxer.forked.io
fluxer --instance https://fluxer.example
FLUXER_LOG=fluxer_gateway=debug,info fluxer
fluxer --debug-info

All options, logging and --record are described in apps/fluxer/README.md.

Build from source

Rust 1.98.1 (pinned in rust-toolchain.toml; rustup installs it on first use). On Debian or Ubuntu the build needs:

sudo apt-get install build-essential pkg-config curl git file libssl-dev libdbus-1-dev \
  libwayland-dev libxkbcommon-dev libvulkan-dev libasound2-dev libpipewire-0.3-dev \
  libfontconfig1-dev libglib2.0-dev

The LiveKit SDK's webrtc-sys compiles its C++ glue with clang 21 or newer (GCC is refused): set CXX=clang++-21 (on Ubuntu 22.04 from apt.llvm.org, as CI does).

On Windows: the MSVC toolchain and the Windows SDK (its rc.exe embeds the icon).

cargo run -p fluxer                     # the client
cargo run -p fluxer -- --devserver      # against recorded fixtures: no account, no network
cargo xtask ci                          # what CI runs: fmt, clippy, deny, parity, tests
cargo xtask package --target linux      # dist/Fluxer-Native-<version>-linux-x86_64.AppImage

--devserver logs in as a demo user on an in-process fixture server and touches neither your settings, your keyring nor your cache; it is how every task is developed and tested. The other xtask commands (gen-theme, vendor-spec, extract-parity, parity-check) are described in xtask/README.md.

Layout

Path What
apps/fluxer the binary: effect runtime, configuration, logging
crates/fluxer-proto wire types (REST models, gateway events), pure data
crates/fluxer-api REST client
crates/fluxer-gateway gateway state machine and WebSocket transport
crates/fluxer-core application state and reducers; no I/O, no UI
crates/fluxer-ui iced views and widgets; no I/O
crates/fluxer-platform OS adapters: paths, settings file, keyring, cache, images, notifications
crates/fluxer-status-api the companion-apps status server (127.0.0.1:21863)
crates/fluxer-devserver fixture server for development and tests
xtask repository tasks (cargo xtask ...)
fixtures recorded REST and gateway data, scenarios, golden images
docs specs and plans (superpowers/), acceptance records, the settings and voice parity lists, screenshots

Every crate has a README.md saying what it does, how to use it and what it depends on.

Documents

  • docs/superpowers/specs/2026-11-11-fluxer-native-program-overview.md: the sub-projects and their order.
  • docs/superpowers/specs/2026-11-11-fluxer-native-foundation-design.md: the Foundation design.
  • docs/superpowers/plans/2026-11-11-foundation.md: the Foundation tasks and follow-ups.
  • docs/acceptance/2026-11-foundation.md: the Foundation acceptance record.

Agents and contributors: read CLAUDE.md first.