# Lumio Docs

> Documentation for Lumio, a multi-platform streaming management application
> for Twitch, YouTube, Kick, Discord and Spotify. Covers the dashboard and
> user guide, platform features, the REST / GraphQL / WebSocket API, RBAC
> permissions, the admin panel, and self-hosted installation.
>
> Lumio is a Rust + TypeScript monorepo. The API (Actix Web) exposes every
> feature over three protocols at once: GraphQL (POST /v1/gql), REST
> (everything under /v1/) and WebSocket (/v1/ws).

- [Welcome to Lumio Docs](https://docs.lumio.vision/intro): Lumio is a multi-platform streaming management application for Twitch, YouTube, Kick, Discord, and Spotify.

## Getting Started

- [Installation](https://docs.lumio.vision/getting-started/installation): Setting up a local Lumio development environment with the dev stack, database migrations, app ports, TOML configuration and required auth secrets.
- [OAuth Provider Setup](https://docs.lumio.vision/getting-started/oauth-setup): Configure provider login, channel and bot OAuth applications, callbacks, credentials, and sign-in behavior.
- [Create Your First Overlay](https://docs.lumio.vision/getting-started/first-overlay): Creating an overlay in the Lumio dashboard, adding layers, understanding the overlay URL and its token types, and adding it to OBS as a browser source.
- [Connecting Platforms](https://docs.lumio.vision/getting-started/connecting-platforms): Connect your streaming platforms and services to Lumio from Settings → Connections in the dashboard (/dashboard/settings/channel/connections).

## User Guide

- [Dashboard](https://docs.lumio.vision/user-guide/dashboard): The dashboard home page, including live status, stream metrics, activity, calendar, test events, popouts, and access rules.
- [Settings](https://docs.lumio.vision/user-guide/settings): Find your profile, appearance, notification, privacy, and account settings in the dashboard.
- [Preferences](https://docs.lumio.vision/user-guide/preferences): Choose your language, timezone, date and time formats, currency, color scheme, motion, and seasonal look.
- [Account Security](https://docs.lumio.vision/user-guide/account-security): Manage email and platform sign-ins, two-factor authentication, recovery codes, trusted devices, sessions, and recent activity.
- [Data & Privacy](https://docs.lumio.vision/user-guide/privacy-and-export): Request personal or channel data exports, download them after confirmation, and delete your profile now, in 7 days or in 30 days, or cancel a scheduled deletion.
- [Overlays](https://docs.lumio.vision/user-guide/overlays): Overlays are the visual layers you composite on top of your stream in OBS (or any browser-source-capable encoder).
- [Connections](https://docs.lumio.vision/user-guide/connections): Use the Connections group of the settings window to manage channels, chat bots, Discord servers, OAuth apps, OBS, StreamElements and your Shopify store.
- [Channel settings](https://docs.lumio.vision/user-guide/channel-settings): Channel-wide settings for identity, members, roles, bots, tracked chat keywords, stream-history revenue, audit events and dissolution.
- [Events](https://docs.lumio.vision/user-guide/events): Events are the heartbeat of your stream. Every follow, sub, cheer, raid, channel-point redemption, super chat, tip, and Spotify track change flows through Lumio's event pipeline in real time.
- [Music (Spotify)](https://docs.lumio.vision/user-guide/music): The Spotify integration in Lumio, covering connecting an account, the now-playing header, playlists, devices, the queue, the popout and its permissions.
- [Multichat](https://docs.lumio.vision/user-guide/chat): The Multichat feed across Twitch, YouTube and Kick, covering message rows, inline event lines, filters, moderation actions and the OBS popout.
- [Viewer List](https://docs.lumio.vision/user-guide/viewer-list): The live viewer list in Multichat — who is in your chat right now, grouped by role, on the chat page and in the chat popout.
- [Members](https://docs.lumio.vision/user-guide/members): The Members tab of the channel settings for inviting teammates, changing member roles and revoking invitations, including the four-step invite wizard and the accept flow.
- [Roles & Permissions](https://docs.lumio.vision/user-guide/roles-and-permissions): Lumio uses role-based access control (RBAC) to decide exactly what every team member can see and do inside your account.
- [Automation Templates](https://docs.lumio.vision/user-guide/automation-templates): Template variables let you weave live data - the viewer's name, the current song, the stream title, a custom variable you set - into an automation action or a bot command response.
- [Bot Modules](https://docs.lumio.vision/user-guide/bot-modules): Bot modules automate chat moderation and messaging. Every bot module - including the four that ship with Lumio - is an extension.
- [Channel Status](https://docs.lumio.vision/user-guide/channel-status): How Lumio detects whether a channel is live on Twitch, YouTube and Kick, what the dashboard cards show, and the Spotify manual connect window.
- [Tokens](https://docs.lumio.vision/user-guide/tokens): Generate popout tokens for browser sources, dashboards, and other unattended views that need access to your channel without a logged-in browser session.
- [API Keys](https://docs.lumio.vision/user-guide/api-keys): Personal, service and developer API keys in Lumio, covering ownership, assignable scopes, the one-time secret reveal, regeneration and revocation.
- [Audit Log](https://docs.lumio.vision/user-guide/audit-log): Read and export personal security activity or account-wide audit events with filters and expandable details.
- [Developer Limits](https://docs.lumio.vision/user-guide/developer-limits): Open Settings → You → Developer → Limits (/dashboard/settings/developer/limits) to see the resource limits that apply to your developer account and its extensions.
- [Developer Payouts](https://docs.lumio.vision/user-guide/developer-payouts): Request payouts of your extension revenue, enter the tax details your self-billed credit notes need, and download every credit note as a PDF.
- [Notifications](https://docs.lumio.vision/user-guide/notifications): The notification bell dropdown, the notification types Lumio sends, delivery preferences for in-app and email, and the actions available on each item.
- [Billing & Subscription](https://docs.lumio.vision/user-guide/billing): Manage the active channel's subscription, payment method, cancellation, and invoices as its owner.
- [Withdrawal & Cancellation](https://docs.lumio.vision/user-guide/withdrawal-and-cancellation): Submit a withdrawal or cancel a plan or paid extension, with or without signing in.
- [Ideas Hub](https://docs.lumio.vision/user-guide/ideas-hub): The Ideas Hub is where you can share feature requests and feedback directly with the Lumio team - and vote on suggestions from other community members.
- [Stream History](https://docs.lumio.vision/user-guide/stream-history): The Stream History page in the webapp, covering the session list, filters and sorting, the report page, sharing, exporting and the stream summary email.
- [Public Stats](https://docs.lumio.vision/user-guide/public-stats): Browse public channel statistics, understand search visibility, share images and change history, and manage a channel opt-out.
- [Streamer Mode](https://docs.lumio.vision/user-guide/streamer-mode): Streamer Mode hides sensitive data across your Lumio dashboard - platform IDs, email addresses, credential hints, and similar identifiers are replaced with dots (••••••••).
- [Cookie Preferences](https://docs.lumio.vision/user-guide/cookie-preferences): Cookie consent categories in Lumio, the essential preference cookies, changing or revoking a choice, clearing cookies and dashboard data, and where the consent dialog appears.
- [Legal Pages](https://docs.lumio.vision/user-guide/legal-pages): Find Lumio's legal information and use the contact, withdrawal, cancellation, and abuse report forms.

## API Reference

- [REST API](https://docs.lumio.vision/api-reference/rest-api): All declaration endpoints have GraphQL twins at POST /v1/gql. JSON fields are snake_case. Public requests are rate limited (10 per IP per hour, 200 per hour globally) and require a Turnstile token...
- [GraphQL](https://docs.lumio.vision/api-reference/graphql): Reference for the Lumio GraphQL endpoint, covering base URLs, the GraphiQL explorer, schema download, error codes, and the queries and mutations per feature area.
- [WebSocket](https://docs.lumio.vision/api-reference/websocket): Real-time communication via WebSocket using a channel-based pub/sub protocol.
- [Authentication](https://docs.lumio.vision/api-reference/authentication): Reference for the eleven authentication contexts Lumio resolves, covering token prefixes, accepted transports, rate limits, and the RBAC each context carries.
- [Permissions](https://docs.lumio.vision/api-reference/permissions): Lumio uses role-based access control (RBAC) to manage what each team member can do within an account.

## Developer Guide

- [RBAC & Permissions](https://docs.lumio.vision/developer-guide/rbac-permissions): Lumio uses a role-based access control (RBAC) system with granular permissions. Every authenticated action is checked against the user's assigned role for the active account.
- [Roles and Permissions Guide](https://docs.lumio.vision/developer-guide/roles-permissions-guide): This guide covers everything you need to know when adding new permissions or modifying the roles system in Lumio.
- [Frontend Permission System](https://docs.lumio.vision/developer-guide/frontend-permissions): This guide explains how the frontend permission system works and how to use it when developing new features.
- [Frontend Overlays: Dialogs and Full-Screen Panels](https://docs.lumio.vision/developer-guide/frontend-overlays): How Lumio dialogs, full-screen panels, and toasts stack, and how overlays handle Escape and scroll locking.
- [Dashboard UI Primitives](https://docs.lumio.vision/developer-guide/frontend-ui-primitives): Shared @lumio/ui primitives for dashboard trend lines, statistic tiles, activity calendars, toolbar controls, badges, platform buttons, the Lumio mark, the mobile text-field size and the self-hosted Roboto typeface.
- [Seasonal Look — Code and Artwork](https://docs.lumio.vision/developer-guide/seasonal-look): How the seasonal dashboard look works: registry, pre-paint resolver, profile-backed preferences, popout writes and artwork sources.
- [Motion](https://docs.lumio.vision/developer-guide/motion): Motion preferences and animation rules for the signed-in dashboard, Chat, Events, Music and popouts.
- [Loading states](https://docs.lumio.vision/developer-guide/loading-states): Use layout-matched skeletons for loading content and reserve spinners for action and hand-off waits.
- [User Roles](https://docs.lumio.vision/developer-guide/user-roles): The user-scope RBAC layer covering default and custom user roles, per-user and per-account permission overrides, Redis-cached resolution, and the admin API.
- [Audit Events (Developer Guide)](https://docs.lumio.vision/developer-guide/audit-events): This guide covers the write side of the audit log: when a change must emit an audit event, and how to emit it correctly.
- [OAuth & Credentials Architecture](https://docs.lumio.vision/developer-guide/oauth-credentials-architecture): Lumio credential stores for login, channel, bot, and operator integrations, covering system versus account pinning, AES-256-GCM encryption, and token refresh.
- [PKCE and Native App Auth](https://docs.lumio.vision/developer-guide/pkce-native-auth): Native desktop and mobile sign-in through the ID app, including PKCE codes, two-factor challenges, and the return-to-app page.
- [Passkeys and Authenticator Apps](https://docs.lumio.vision/developer-guide/passkeys): Passkey data flow, relying-party boundaries, provider name and logo updates, and authentication parity for Lumio engineers.
- [Email templates](https://docs.lumio.vision/developer-guide/email-templates): How Lumio builds, localizes, previews, and delivers email with the C · Brief layout.
- [Channel Connections & OAuth Scopes](https://docs.lumio.vision/developer-guide/channel-connections-oauth-scopes): Channel connections are the mechanism by which Lumio accesses platform APIs on behalf of a user's channel.
- [ProfileService](https://docs.lumio.vision/developer-guide/profile-service): The ProfileService is a unified profile enrichment system that combines local database records with live platform API data.
- [Emote Catalog](https://docs.lumio.vision/developer-guide/emote-catalog): The emote catalog is the durable store behind every emote lookup: the chat_emotes table in the primary PostgreSQL, with Redis and an in-process LRU demoted to caches in front of it.
- [Editor Live Sync](https://docs.lumio.vision/developer-guide/editor-live-sync): The editor live sync system keeps widget and overlay editors in real-time sync across all connected sessions.
- [Channel Status](https://docs.lumio.vision/developer-guide/channel-status): Design of the channel status system, covering the PostgreSQL state anchor, Redis snapshot and pub/sub keys, the Rust service API, and its GraphQL and REST reads.
- [Data design standard](https://docs.lumio.vision/developer-guide/data-design): Data design review rules for Lumio stores, schemas, indexes, retention, TimescaleDB, Redis, object storage, and migrations.
- [Chat and event durability](https://docs.lumio.vision/developer-guide/ingest-durability): How ingested chat messages and platform events reach TimescaleDB without loss: the Redis chat buffer, the platform-event dead-letter list and replay, graceful SIGTERM shutdown, and the statement/lock timeouts on the database pools.
- [Volume tests (pinned query plans)](https://docs.lumio.vision/developer-guide/volume-tests): Volume tests for the TimescaleDB data layer: the synthetic small/large data sets, the pinned query plans P1–P12, and the rule to assert plan counters instead of milliseconds.
- [Stream History: adding a platform](https://docs.lumio.vision/developer-guide/stream-history-platforms): Stream History records each stream session (a session may span several simultaneous platform broadcasts = multistream) and its aggregate metrics.
- [Stream History: storage, rollups & retention](https://docs.lumio.vision/developer-guide/stream-history-storage): Stream History storage in TimescaleDB, covering session summaries, raw 60-second samples, continuous aggregate rollups, and the retention window for each layer.
- [Bot Modules](https://docs.lumio.vision/developer-guide/bot-modules): Architecture of bot modules as V8 handler functions, covering the Bot Module Worker HTTP surface, trigger compilation, Redis channels, and the handler context.
- [Automation](https://docs.lumio.vision/developer-guide/automation): Configuration reference for the automation engine, covering its permissions, template variable categories, rule structure, REST and GraphQL surfaces, and extension nodes.
- [Automation Template Engine](https://docs.lumio.vision/developer-guide/automation-templates): This guide documents the internals of the automation template engine in crates/lo-automation/src/template.rs.
- [Plugins (removed)](https://docs.lumio.vision/developer-guide/plugins): The plugin system (lo-plugins crate, PluginRegistry, GET /v1/plugins endpoints) has been removed. All built-in widgets and bot modules are now system extensions in the Extension Store.
- [Copyright Manager](https://docs.lumio.vision/developer-guide/copyright-detection): Copyright Manager data model, on-demand song status lookup, community reports, operator moderation, and the GraphQL surface.
- [Feature Flags (Developer Guide)](https://docs.lumio.vision/developer-guide/feature-flags): This guide covers the feature-flag system from a developer perspective: the flag taxonomy, resolution order, backend service, and frontend primitives used to gate pages, actions, and UI elements.
- [Extension Supervisor](https://docs.lumio.vision/developer-guide/extension-supervisor): The Extension Supervisor is a 3-layer isolation system that sandboxes extension code using cross-origin iframes and a Web Worker.
- [Web Content-Security-Policy](https://docs.lumio.vision/developer-guide/web-content-security-policy): The application-level Content-Security-Policy in the webapp covering the Report-Only rollout, the directive sources, violation report collection and the enforce-flip checklist.
- [Extension Sounds](https://docs.lumio.vision/developer-guide/extension-sounds): Extensions can bundle audio files that are automatically added to the user's sound library when the extension is installed.
- [YouTube API Quota](https://docs.lumio.vision/developer-guide/youtube-api-quota): How YouTube broadcast discovery, chat reception, and chat ID lookup use Data API quota.
- [InnerTube Proxy](https://docs.lumio.vision/developer-guide/innertube-proxy): YouTube's InnerTube player and updated_metadata endpoints return LOGIN_REQUIRED from certain datacenter IPs.
- [Kick Webhook Public Key](https://docs.lumio.vision/developer-guide/kick-webhook-public-key): Kick signs every webhook delivery with one RSA key. It publishes that key without authentication at https://api.kick.com/public/v1/public-key, in the shape {"data":{"public_key":""},"message":"OK"}.
- [Kick Chat-Moderation Listener](https://docs.lumio.vision/developer-guide/kick-chat-listener): Kick sends no webhook when a message is deleted on kick.com or when a user is unbanned there. Kick declined to add one (KickEngineering/KickDevDocs#310, closed 2025-12-14).
- [7TV Event Listener](https://docs.lumio.vision/developer-guide/seventv-event-listener): How the API watches 7TV emote-set changes, stores stream events, and refreshes emote caches.
- [Chatter List Providers](https://docs.lumio.vision/developer-guide/chatter-list-providers): The chatter list knows no platform. Every platform is a provider that implements ChatterProvider (apps/api/src/services/chatters/provider.rs) and is registered in the ProviderRegistry built by...
- [Public Stats Crawler (Twitch)](https://docs.lumio.vision/developer-guide/public-stats-crawler): The Twitch public stats crawler, covering its architecture, crawl scope modes and admin controls, aggregate-only capture, opt-out enforcement, and configuration.
- [Operational Metrics (Prometheus)](https://docs.lumio.vision/developer-guide/metrics): Every Rust service exposes a Prometheus /metrics endpoint backed by the shared crates/lo-metrics crate.
- [Platform Stream Debuggers](https://docs.lumio.vision/developer-guide/platform-stream-debuggers): Command-line debuggers for the YouTube gRPC live chat stream and the Twitch EventSub WebSocket, covering usage, shared options, event types, and troubleshooting.
- [npm Package Publishing](https://docs.lumio.vision/developer-guide/npm-publishing): Publishing the six public Lumio npm packages, covering independent versioning, tag and manual dispatch workflows, dependency order, and common publish errors.
- [Deployment](https://docs.lumio.vision/developer-guide/deployment): Release-driven container deployment for Lumio, covering release tags, image tags and channels, the verification gate, signing, and the other release pipelines.
- [Bazel Build System](https://docs.lumio.vision/developer-guide/bazel): Lumio uses a dual build system: Cargo for local development, Bazel for CI and container images. Developers write and test code with standard Cargo commands locally.
- [CI Runner](https://docs.lumio.vision/developer-guide/ci-runner): Self-hosted CI runner zcloud-runner-ex44 — runner selection and CI_RUNNER rollback, hosted vs. self-hosted Bazel behaviour, and the host prerequisites.
- [Logging](https://docs.lumio.vision/developer-guide/logging): Lumio's frontend apps share a single env-aware structured logger from the @lumio/logger workspace package.
- [Error Tracking (Sentry)](https://docs.lumio.vision/developer-guide/error-tracking): Lumio's four Next.js apps - apps/web, apps/admin, apps/id, apps/shopify - each ship with a @sentry/nextjs integration. apps/stats has none.
- [Observability - Prometheus + Grafana (Staging)](https://docs.lumio.vision/developer-guide/observability-staging): Single-node Prometheus, Alertmanager, and Grafana for staging, covering retention sizing, scrape targets, recording rules, alert routing, and the deploy runbook.
- [Access log for protected customer data](https://docs.lumio.vision/developer-guide/protected-data-access-log): How operator access to protected customer data is logged on the hosts that hold it: pgaudit on TimescaleDB and a statement log on the main and extensions PostgreSQL for every session except the apps, SSH, sudo and docker CLI logs, 12-month retention, the monthly review and its record.
- [Data layer - PostgreSQL, TimescaleDB, extensions PostgreSQL, Redis (Staging)](https://docs.lumio.vision/developer-guide/data-layer-staging): How PostgreSQL, TimescaleDB, the extensions PostgreSQL and Redis are configured on staging: memory sizing, the extensions-database connection budget and roles, Redis noeviction and its alarms, TimescaleDB job workers, pg_stat_statements, data directories, backups and the host runbook.
- [Backups (production and staging)](https://docs.lumio.vision/developer-guide/backups): Encrypted off-host backups of PostgreSQL, TimescaleDB, the extensions PostgreSQL and Redis for the production and staging hosts: restic tool, daily schedule, AES-256 encryption and key handling, S3-compatible EU target (Cloudflare R2, Hetzner, DigitalOcean, AWS or self-hosted MinIO), 14-day retention, the restore test with row-count comparison, the production restore script, and the restore log.
- [Cookies Consent Library](https://docs.lumio.vision/developer-guide/cookies-consent): The @lumio/cookies-consent package - provider, banner, pre-paint script, exempt paths, storage format and how apps mount it.
- [Image Proxy](https://docs.lumio.vision/developer-guide/image-proxy): The same-origin image proxy (/img/*) of Lumio Stats and the lumio.vision public pages - provider allow-list, URL rewrite, upstream fetch rules, response headers, 24-hour HTTP cache and where it is used.
- [MDX Content Pipeline](https://docs.lumio.vision/developer-guide/mdx-content): apps/web uses @next/mdx to render long-form content (currently: legal pages) from MDX files in apps/web/content/.
- [SEO Foundation](https://docs.lumio.vision/developer-guide/seo-foundation): How Lumio's web, ID and Stats apps resolve page metadata, language URLs, crawler rules, structured data and share images.
- [GraphQL Schema ↔ Proxy Drift Check](https://docs.lumio.vision/developer-guide/graphql-proxy-drift-check): CI gate that fails when a frontend GraphQL operation selects a field apps/api/schema.graphql does not define.
- [Platform Name Drift Check](https://docs.lumio.vision/developer-guide/platform-name-drift-check): Fail-closed CI gate that forbids new raw display-name/login collapse expressions, steering every render site onto the shared @lumio/ui platform-name helper.
- [Reporting an Issue](https://docs.lumio.vision/developer-guide/reporting-an-issue): Where to file a bug, feature request, idea, or security vulnerability for Lumio, and how an accepted fix travels from branch to staging and on to production.
- [Contributing](https://docs.lumio.vision/developer-guide/contributing): Contribution guidelines for Lumio covering dev stack setup, code style, the sequential local verification gate, and draft-first pull requests into next.

## Features

- [Chat](https://docs.lumio.vision/features/chat): The Chat module provides a unified, multi-platform chat system that aggregates messages from Twitch, YouTube, and Kick into a single real-time stream.
- [Chatter List](https://docs.lumio.vision/features/chatter-list): The chatter list shows who is in the chat right now, grouped as Broadcaster → Moderators → Bots → VIPs → Viewers, each with avatar, display name and how long they have been in the chat...
- [Events](https://docs.lumio.vision/features/events): The Events module handles platform event logging and alerting for streaming events such as followers, subscribers, cheers, raids, channel point redemptions, and tips.
- [Setting Presets](https://docs.lumio.vision/features/setting-presets): Named snapshots of Multichat, Events and Music display settings covering default presets, account sharing, plan quota, export and import, popout access and operator deletion.
- [Overlays](https://docs.lumio.vision/features/overlays): The Overlays module provides a custom streaming overlay editor where users can create, configure, and manage overlays with layered widgets.
- [Automations](https://docs.lumio.vision/features/automations): The Automations module provides a visual workflow automation engine with a node-based editor. Users create automations composed of trigger nodes, condition nodes, and action nodes connected by edges.
- [Spotify / Music](https://docs.lumio.vision/features/spotify): The Spotify module integrates with the Spotify Web API to provide "Now Playing" overlays and a full dashboard music player.
- [Members & Invites](https://docs.lumio.vision/features/members): The Members & Invites module provides team management for Lumio accounts. Account owners and administrators can invite users to their account, assign roles to members, and manage the team roster.
- [YouTube Member Badges](https://docs.lumio.vision/features/memberships): Lumio renders YouTube custom-member-tier badges in the multichat - the artwork that shows up next to a member's name (e.g.
- [Roles & Permissions](https://docs.lumio.vision/features/roles): The account RBAC system with its three default roles, the account, admin and user permission registries, role CRUD on GraphQL and REST, and the plan-based limits.
- [Connections](https://docs.lumio.vision/features/connections): Platform OAuth connections for an account covering app credentials, credential modes, login assignments, reconnect-required handling and the unified OAuth callback.
- [OBS Integration](https://docs.lumio.vision/features/obs): Lumio integrates with OBS Studio for remote control (scenes, stream/recording start-stop, status monitoring). Three distinct paths exist, and they do not share a transport:
- [Copyright Manager](https://docs.lumio.vision/features/copyright): Manage song status lists, on-demand checks, community reports, and operator review in Copyright Manager.
- [Bot Modules](https://docs.lumio.vision/features/bot-modules): The Bot Modules system provides configurable chat bot modules for automated moderation and messaging.
- [Bot Commands](https://docs.lumio.vision/features/bot-commands): Cross-platform custom command system. Users create commands in the dashboard, assign them to platforms, and bots execute them with template variable support, cooldowns, and automation triggers.
- [Bot Connections](https://docs.lumio.vision/features/bot-connections): Global and account bot identities per platform with their OAuth credential resolution, bot scopes, GraphQL and REST surfaces, permissions, token refresh and feature gating.
- [Bot Control](https://docs.lumio.vision/features/bot-control): Bot runtime status, Discord server settings and the APIs used to manage them.
- [Tokens](https://docs.lumio.vision/features/tokens): The Tokens module manages popout tokens for dashboard popout pages and other browser-source contexts where cookie-based authentication is not practical.
- [Uploads](https://docs.lumio.vision/features/uploads): Account file uploads with multipart REST transfer, presigned download URLs, the storage key format, upload permissions, the per-file size limit, the plan storage quota, deletion with the channel and deletion of extension uploads with the install or extension.
- [Sounds](https://docs.lumio.vision/features/sounds): The Sounds module provides a per-account audio library. Sounds are uploaded once and can be played directly in browser sources without leaving the dashboard.
- [Stream History](https://docs.lumio.vision/features/stream-history): Per-session stream records and reports covering filtering and sorting, report metrics and chart markers, exports, the summary email, shareable links and live updates.
- [Public Stats](https://docs.lumio.vision/features/public-stats): Public Stats pages, indexing, channel and stream data, opt-out controls, and the public read model.
- [Rewards](https://docs.lumio.vision/features/rewards): Account-scoped channel rewards with their GraphQL CRUD operations, the action JSONB payload, the missing REST and WebSocket surfaces, permissions and the reward table.
- [Notifications](https://docs.lumio.vision/features/notifications): The notification system delivers in-app notifications to users with read/unread tracking and actionable items.
- [StreamElements Tokens](https://docs.lumio.vision/features/se-tokens): The SE Tokens module manages StreamElements JWT tokens used for receiving tip/donation events via the StreamElements WebSocket API.
- [Sessions](https://docs.lumio.vision/features/sessions): User session management covering the session lifecycle, the JWT revocation gate, listing and revoking sessions on GraphQL and REST, and the sessions table.
- [Audit Log](https://docs.lumio.vision/features/audit-log): The audit event record with its user, account and system scopes, the three read surfaces, filtering and pagination, the event type catalog and the 12/24/36-month retention rule.
- [Accounts](https://docs.lumio.vision/features/accounts): The accounts module manages the full account lifecycle: creation (with automatic JWT re-issue), name editing, account dissolution (immediately or after a 7- or 30-day grace period, with the channel...
- [Integrations](https://docs.lumio.vision/features/integrations): The integrations module provides a generic configuration framework for platform-specific integrations (e.g., OBS, Discord bots).
- [Shopify](https://docs.lumio.vision/features/shopify): Shopify connection: embedded app with Shopify-managed install, link to a Lumio account, token exchange, one store per account, expiring tokens, customer label setting, cart and checkout consent blocks, disconnect and uninstall, mandatory compliance webhooks, GraphQL and REST surface.
- [Auth](https://docs.lumio.vision/features/auth): Lumio supports email/password and platform sign-in through the ID app. The API resolves eleven auth contexts (including developer keys and Anonymous), handles sessions and 2FA, and enforces RBAC...
- [Billing](https://docs.lumio.vision/features/billing): The Billing module manages everything related to paid subscriptions: plans, per-account limits, feature gating, Stripe Checkout, the Stripe Customer Portal, invoices, and coupon validation.
- [Withdrawal & Cancellation](https://docs.lumio.vision/features/contract-declarations): How plan and paid-extension withdrawal and cancellation declarations are received, confirmed, and handled.
- [Developer Credit Notes](https://docs.lumio.vision/features/developer-credit-notes): How every developer payout is documented by a self-billed credit note (Gutschrift): numbering, VAT treatment, PDF and mail, cancellation, objection and retention.
- [Developer Payouts](https://docs.lumio.vision/features/developer-payouts): How developer revenue is paid out: the monthly payout cycle, sending Stripe and PayPal payouts at most once, SEPA and unclear payouts settled by an operator, configuration and audit events.
- [ProfileService](https://docs.lumio.vision/features/profile-service): The ProfileService is a unified platform user enrichment system that combines database records with real-time platform API data.
- [Channel Status](https://docs.lumio.vision/features/channel-status): Per-platform live stream status tracking for an account, the Spotify manual connect flow, the channel-status relay, and the queries, permissions and table behind them.
- [Emotes](https://docs.lumio.vision/features/emotes): Chat emote fetching, caching and parsing across Twitch, 7TV, FFZ, BTTV, YouTube and Kick, including the durable emote catalog and the outage fallback.
- [Emote Directory](https://docs.lumio.vision/features/emote-directory): The Emote Directory is a public, unauthenticated, edge-cacheable browse of Lumio's durable cross-platform emote catalog (chat_emotes).
- [Webhooks](https://docs.lumio.vision/features/webhooks): Inbound webhook endpoints for YouTube, Kick, Shopify and Stripe, covering signature verification, mapped event types, configuration keys and troubleshooting.
- [Ideas Hub](https://docs.lumio.vision/features/ideas-hub): The global community idea and feedback hub with its feature flags, voting, comments and mentions, status timeline, WebSocket channels, Atom feed and user-scope permissions.
- [Provider Management](https://docs.lumio.vision/features/provider-management): Provider Management allows admins to globally enable or disable platform providers (Twitch, YouTube, Kick, Discord, Spotify) with granular controls per connection type.
- [Token Refresh](https://docs.lumio.vision/features/token-refresh): The Token Refresh Worker is the single, authoritative component responsible for refreshing OAuth access tokens for all platform connections.
- [YouTube Live Chat Streaming](https://docs.lumio.vision/features/youtube-streaming): Lumio receives YouTube live chat messages via InnerTube - YouTube's own internal polling endpoint (youtubei/v1/live_chat/get_live_chat).
- [Extensions](https://docs.lumio.vision/features/extensions): How extension visibility, installation, system identity, and bundle delivery work.

## Admin

- [Abuse Reports](https://docs.lumio.vision/admin/abuse-reports): The Abuse Reports queue collects copyright abuse reports submitted by end users against a specific track.
- [Accounts](https://docs.lumio.vision/admin/accounts): The admin Accounts view for browsing accounts and inspecting a single account, with plan changes, limit overrides, feature and permission overrides, and connection removal.
- [Admin Roles](https://docs.lumio.vision/admin/admin-roles): Create and manage admin roles, assign permissions to them, and control which admin users hold each role.
- [API Keys](https://docs.lumio.vision/admin/api-keys): Operator view for inspecting, editing, rotating, and revoking personal and service API keys across accounts, with the admin-scope permissions each action requires.
- [Audit Log](https://docs.lumio.vision/admin/audit-log): Reference for the admin audit log covering event types, the user, account and system scopes, metadata payloads, GeoIP location fields, and read permissions.
- [Billing](https://docs.lumio.vision/admin/billing): Read-only admin dashboard showing plan distribution counts and active subscription totals, with Stripe remaining the source of truth for subscription changes.
- [Contract Declarations](https://docs.lumio.vision/admin/contract-declarations): Review and process withdrawal and cancellation declarations across accounts in the admin queue.
- [Credit Notes](https://docs.lumio.vision/admin/credit-notes): List developer self-billed credit notes and cancellations, download their PDFs, and record a developer objection or a correction in the admin app.
- [Developer Payouts](https://docs.lumio.vision/admin/developer-payouts): List developer payouts in the admin app, find the SEPA transfers and unclear provider payouts that wait for an operator, and mark them paid or failed.
- [Bot Commands](https://docs.lumio.vision/admin/bot-commands): Admin surface for creating and editing global chat commands, inspecting account-scoped commands and overrides, and the permissions and endpoints behind them.
- [Bot Control](https://docs.lumio.vision/admin/bot-control): Runtime switchboard for pausing and resuming account bots per platform, covering status badges, filters, permissions, and the toggle endpoints behind them.
- [Curated Playlists](https://docs.lumio.vision/admin/copyright-playlists): Curated Playlists are system-managed Spotify playlists of verified copyright-safe songs, grouped by genre (lofi, edm, ncs, …). Lumio streamers can pull from them via the end-user safe-songs UI.
- [Copyright Recommendations](https://docs.lumio.vision/admin/copyright-recommendations): Copyright Recommendations are user-submitted suggestions that a specific track is copyright-safe and should be added to the curated safe-songs catalog.
- [Copyright Reports](https://docs.lumio.vision/admin/copyright-reports): Copyright Reports are user submissions flagging that a specific track is not copyright-safe and should be removed from the safe catalog (or never added).
- [Copyright Review](https://docs.lumio.vision/admin/copyright-review): Triage queue for pending copyright and recommendation submissions, covering the blocked and safe candidate tabs, approve and dismiss actions, and moderation permissions.
- [Coupons](https://docs.lumio.vision/admin/coupons): Admin CRUD surface for Stripe checkout discount codes, covering coupon creation fields, redemption counts, soft deactivation, permissions, and endpoints.
- [Developer Limits](https://docs.lumio.vision/admin/developer-limits): Admins can configure per-developer and per-extension limits to control resource usage on the extension platform.
- [Extension Purchases: payment without delivery](https://docs.lumio.vision/admin/extension-purchases): Admin safety-net list of paid extension checkouts that were never delivered, and how to resolve them.
- [Discord Guilds](https://docs.lumio.vision/admin/discord-guilds): Admin registry of Discord servers linked to Lumio accounts, including bot removal status and deletion.
- [Feature Flags](https://docs.lumio.vision/admin/feature-flags): Manage feature flags to control feature availability across the platform.
- [Ideas (Admin)](https://docs.lumio.vision/admin/ideas): Moderation tools for the Ideas Hub, covering the ideas list and detail pages, status changes, comment removal, category and tag management, and permission gates.
- [OAuth Clients](https://docs.lumio.vision/admin/oauth-clients): Admin surface for registering third-party OAuth 2.0 applications against Lumio, covering client types, scopes, grant types, secret reveal, and permissions.
- [Plans](https://docs.lumio.vision/admin/plans): The Plans view is where operators define the subscription tiers Lumio offers - their pricing, the numeric limits they impose, and the feature grid that maps plan tier to feature availability.
- [Privacy Erasure](https://docs.lumio.vision/admin/privacy-erasure): Support tools to erase a person in one channel, a person on Lumio's own surfaces only, or a single record in one channel, on a documented request.
- [Providers](https://docs.lumio.vision/admin/providers): The Providers view is the top-level kill-switch dashboard for the streaming platforms Lumio integrates with. Five providers are listed: Twitch, YouTube, Kick, Discord, and Spotify.
- [Stats Crawler Control](https://docs.lumio.vision/admin/stats-crawler): Steer the public stats crawler - which live channels it discovers, and the curated list of channels to crawl.
- [Subscriptions](https://docs.lumio.vision/admin/subscriptions): The Subscriptions view is an operational overview of every Lumio account and its current plan - effectively a read-only "who is paying for what" list.
- [System Connections](https://docs.lumio.vision/admin/system-connections): Manage system-level platform OAuth credentials (client ID / client secret pairs) used by Lumio's services.
- [System Keys](https://docs.lumio.vision/admin/system-keys): System Keys are long-lived API keys used for service-to-service authentication against the Lumio API.
- [User Roles (Admin)](https://docs.lumio.vision/admin/user-roles): The User Roles section lets admins manage the third RBAC layer in Lumio - the set of user-scope permissions that controls what authenticated users can do across community features like the Ideas Hub.
- [Users](https://docs.lumio.vision/admin/users): Admin view of every registered user, covering profile edits, login connections, account memberships, creation and account-limit overrides, roles, and deletion.

## Optional

- [llms-full.txt](https://docs.lumio.vision/llms-full.txt): Every page above concatenated into a single file, for pasting into an LLM context window.
- [Lumio for Developers](https://developers.lumio.vision/llms.txt): Extension platform documentation - build widgets, overlays, bot modules and themes with @zaflun/lumio-sdk.