Codebase
Explorer

The spatial protocol that defines where windows appear in AR space. Manages zones (center, left/right peripheral, overlay), dimensions (Desktop, VR, AR, Tablet), and the assignment engine that maps windows to zones based on position and policy.

Thin Rust cdylib that bridges portal-spatial's zone management into Wayfire via C++ FFI shim. Loaded as a Wayfire plugin to manage spatial zones in the compositor.

Homography-based GLSL shaders for mapping compositor output onto AR glasses with head-tracking correction. Currently dead code — Wayfire's built-in perspective-warp is used instead.

Daemon that monitors Wayland toplevel windows and assigns them to spatial zones. Uses ext_foreign_toplevel_list_v1 to track windows and IPC to send zone assignments to portal-spatial.

Shared utilities used across all Portal crates — error types, test infrastructure, common traits.

Complete input pipeline for the Spaceboard: touch event normalization, multi-touch fusion engine (tracking → intent classification → action generation), QWERTY keyboard layout, and virtual keyboard/pointer via /dev/uinput. Includes portal-keyboardd, a standalone DRM/KMS binary that owns the eDP-1 display.

Complete voice interaction layer: wake word detection, VAD (Silero on QNN DSP), STT (Sherpa-onnx Zipformer on CPU), NLU (MiniLM sentence similarity), TTS (Elara VITS on QNN DSP), and voice state machine. Hosts portal-voiced daemon.

FFI bindings to the RNNoise C library for real-time noise suppression in the Portal voice pipeline.

FFI bindings to the Qualcomm QNN HTP API for loading .so model graphs and running inference on the Hexagon DSP.

On-device LLM daemon running Qwen3-0.6B on the Hexagon DSP via GenieX/llama.cpp. Serves generation requests via Unix socket IPC at /run/portal/llm.sock.

Safe Rust wrappers around the Qualcomm Hexagon CDSP FastRPC kernel interface. Provides DMA-BUF allocation and remote DSP invocation for voice, LLM, and other NPU consumers.

Rust network protocol wrapper for the streaming pipeline — RTP packet construction, H.265 NAL unit utilities, UDP streaming. The actual capture and encoding is done by the C-based portal_stream binary.

Core types, traits, and error definitions for the Portal Capability Protocol (PCP). Defines PcpServer trait, CapabilityManifest, Element model, and cross-cutting services (audit, permission, signing, rate limiting).

Capability registry with DashMap backend — tracks all registered apps, their capabilities, and serves capability lookups for the PCP daemon.

AT-SPI2 adapter for Tier 2 app detection — bridges non-Portal-native apps into the PCP via the Linux accessibility protocol.

Native Tier 1 adapter with .desktop file parsing — detects Portal-native apps via X-Portal-PCP-Manifest keys.

V4.1 push event bus with coalescing, backpressure handling, and persistent journal for capability state change events.

Binary framing protocol and Unix socket transport for PCP communication between apps and the daemon.

Hardware API implementations for PCP — audio playback, network status, compositor queries, display control.

Wine/MSAA bridge for PCP — types and traits for detecting Windows apps running under Wine via MSAA accessibility.

Input simulation fallback adapter (Tier 3) for apps that don't support native PCP or AT-SPI2 — simulates keyboard/mouse input.

Command-line tool for PCP testing and debugging — inspect capabilities, invoke actions, monitor events, manage app trust.

Provides PcpServerRunner for Tier 1 apps to expose their PcpServer over Unix socket, and the daemon-side client for invoking capabilities.

The PCP daemon that runs persistently, detects apps, verifies manifests, and routes capability invocations between Portal and apps.

PCP v4.2 Learning Runtime — tracks capability invocation history, suggests onboarding actions, and adapts to user behavior.

PCP v4.2 Recovery Runtime — per-app health monitoring, crash recovery, and automatic Tier degradation (Tier 1 → Tier 2 → Tier 3).

PCP v4.2 Multi-App Coordination — enables cross-app capability composition and workflow automation.

PCP v4.2 Deep Inspection — runtime capability introspection for debugging and monitoring.

Application launcher with action registry, fuzzy/acronym search engine, execution pipeline, plugin system, and voice bridge. Provides the central interface for launching apps and executing system actions.

Portal Launcher Daemon — universal action entry point for Portal OS

Shell layer providing the status bar, notification display, and window switcher for the Portal desktop environment.

Complete design token system for Portal UI: colors (with WCAG contrast), typography, spacing, shadows, border radius, transitions, theme management with hot-reload.

Event ingestion, workspace modeling, context extraction, template synthesis, and notification management. Builds a real-time model of what the user is doing and proactively surfaces relevant information.

Criterion benchmarks for Portal hot paths (IPC, RTP, TTS)