Bedrud Dokumentation

Der Bedrud-Desktop-Client ist eine native Windows- und Linux-Anwendung, die mit Rust und dem Slint-UI-Toolkit erstellt wurde. Er bietet das gleiche Kern-Meeting-Erlebnis wie die Web- und Mobile-Clients, kompiliert zu einem einzelnen Binary ohne Laufzeitabhängigkeiten.

Technologie-Stack

KomponenteTechnologie
SpracheRust (stable)
UI-ToolkitSlint 1.x
HTTP-Clientreqwest (async, TLS)
MedienLiveKit Rust SDK
Speicherungserde_json + OS-Keyring (libsecret / Windows Credential Store)
Build-SystemCargo Workspace

Plattformunterstützung

PlattformRendererBinary
Windows 10/11Direct3D 11bedrud-desktop.exe
Linux x86_64OpenGL / Vulkan (über EGL/Wayland/X11)bedrud-desktop
macOS(noch nicht verfügbar - Web-App verwenden)-

Quellcode-Struktur

apps/desktop/
├── Cargo.toml              # Crate definition
├── build.rs                # Slint compile step
├── src/
│   ├── main.rs             # Entry point - initialises app + event loop
│   ├── app.rs              # Top-level AppState and startup logic
│   ├── api/
│   │   ├── client.rs       # Shared HTTP client (base URL, JWT injection)
│   │   ├── auth.rs         # Login, register, refresh
│   │   ├── rooms.rs        # Room list, join, create
│   │   └── admin.rs        # Admin endpoints
│   ├── auth/
│   │   ├── session.rs      # JWT storage and refresh loop
│   │   └── passkey.rs      # FIDO2 passkey stub
│   ├── livekit/
│   │   ├── room.rs         # Room connection lifecycle
│   │   ├── tracks.rs       # Audio/video track management
│   │   └── devices.rs      # Microphone / camera enumeration
│   ├── store/
│   │   ├── instance.rs     # Multi-instance persistence
│   │   └── settings.rs     # User preferences
│   └── ui/
│       ├── mod.rs
│       └── bridge.rs       # Slint ↔ Rust callback wiring
└── ui/
    ├── app.slint            # Root component, page router
    ├── theme.slint          # Colours, typography, spacing tokens
    ├── components/          # Button, Input, Card, Avatar
    ├── auth/                # Login and Register screens
    ├── dashboard/           # Room list, Create-room dialog
    ├── meeting/             # Controls bar, participant tiles, chat
    ├── admin/               # Admin panel, user table
    └── settings.slint       # Settings screen

Architektur

flowchart TB
    subgraph UI ["Slint UI Layer"]
        direction TB
        SLINT[app.slint<br/>theme.slint<br/>components/ + screens]
    end
 
    subgraph Bridge ["Bridge Layer"]
        BRIDGE[ui/bridge.rs<br/>Slint ↔ Rust wiring]
    end
 
    subgraph Core ["Core Modules"]
        direction TB
        API[api/<br/>client.rs • auth.rs • rooms.rs • admin.rs]
        LIVEKIT[livekit/<br/>room.rs • tracks.rs • devices.rs]
        AUTH[auth/<br/>session.rs • passkey.rs]
        STORE[store/<br/>instance.rs • settings.rs]
    end
 
    SLINT -->|"callbacks /<br/>property bindings"| BRIDGE
    BRIDGE <-->|"async tasks<br/>+ Weak&lt;AppWindow&gt;"| Core
    API <--> LIVEKIT
    AUTH <--> STORE

Wichtige Designentscheidungen

  • Slints Kompilierzeit-UI - .slint-Dateien werden zur Build-Zeit über build.rs in Rust kompiliert. Es gibt keine Layout-Engine zur Laufzeit; die UI ist vollständig nativ.
  • bridge.rs als einzige UI↔Logik-Grenze - Alle Slint-Callbacks werden an einer Stelle verdrahtet, was die Geschäftslogik aus der UI-Schicht heraushält und die Brücke leicht zu prüfen macht.
  • Weak<AppWindow> in Callbacks - Slint-UI-Handles sind !Send, daher aktualisieren Hintergrund-Tasks eine gespeicherte Weak-Referenz im UI-Thread, um Eigenschaften zu setzen, anstatt das Handle über Threads hinweg zu teilen.
  • Multi-Instance über store/instance.rs - Identisch zu den Mobile-Apps: Instanzen werden als JSON-Datei im OS-Konfigurationsverzeichnis serialisiert; jede Instanz hat ihren eigenen APIClient und AuthSession.

Lokaler Build

Voraussetzungen

  • Rust Stable-Toolchain (rustup toolchain install stable)

  • Linux: libfontconfig, libxkbcommon, libwayland, libgles2, libdbus, libsecret

    sudo apt-get install -y \
      libfontconfig1-dev libxkbcommon-dev libxkbcommon-x11-dev \
      libwayland-dev libgles2-mesa-dev libegl1-mesa-dev \
      libdbus-1-dev libsecret-1-dev \
      libasound2-dev
  • Windows: Visual Studio Build Tools (MSVC) mit der C++-Workload

Build

# Debug build (fast compile, no optimisations)
make dev-desktop          # runs the app immediately after build
 
# Release build
make build-desktop        # → target/release/bedrud-desktop (Linux)
                           # → target/release/bedrud-desktop.exe (Windows)

Oder direkt mit Cargo:

cargo build -p bedrud-desktop                          # debug
cargo build -p bedrud-desktop --release                # optimised
cargo run   -p bedrud-desktop                          # run immediately

CI

Die Desktop-App wird in der CI bei jedem Push auf main und bei Pull Requests gebaut:

JobRunnerWas geprüft wird
Desktop – Build & Testubuntu-latestcargo build, cargo test

Release-Builds erzeugen zwei Artefakte:

ArtefaktRunnerFormat
bedrud-desktop-linux-x86_64.tar.xzubuntu-latesttar.xz
bedrud-desktop-windows-x86_64.zipwindows-latestzip