YouTube Bot

Status: Planned — not yet implemented

The YouTube bot is currently a scaffold only. platform/youtube_bot/src/main.rs is a placeholder (Hello, world!), the crate has no dependencies wired up yet, and the locale files are empty. There are no commands, no chat client, and no data sync at this time.

This page documents what actually exists today (config scaffolding) and the planned direction. It will be expanded as the bot is implemented.

What exists today

• Crate: platform/youtube_bot/ (binary package youtube_bot) — placeholder main.rs, empty [dependencies].
• Config scaffolding: platform/youtube_bot/config/default.toml + local.toml.
• Locale scaffolding: platform/youtube_bot/locales/{en,de}.yml (currently empty).
• Build: BUILD.bazel target present.

YouTube OAuth integration is separate and already implemented

The connection/OAuth layer for YouTube (channel + bot account linking, scopes, token refresh — platform slug google) already lives in the API via heimdall-integrations and is documented under Platform Integrations → YouTube. That is independent of this bot runtime — linking a YouTube account works today; the standalone bot process does not yet exist.

Configuration scaffolding

The committed config/default.toml defines these sections (values shown are the defaults):

Section	Key	Default	Notes
(root)	environment	development
[bot]	prefix	!	Text command prefix
[bot]	default_locale	en	Fallback locale (en, de)
[api]	graphql_endpoint	http://localhost:3000/v1/gql	Heimdall GraphQL
[api]	rest_endpoint	http://localhost:3000/v1	Heimdall REST
[api]	websocket_endpoint	ws://localhost:3000/v1/ws	Heimdall WebSocket
[api]	key	""	System API key — set via YOUTUBE_BOT_API_KEY
[api]	bind_address	127.0.0.1	Health endpoint bind
[api]	bind_port	3006	Health endpoint port
[apps]	id_url / policies_url / console_url / docs_url / main_url	localhost:3002–3005	App link targets
[sentry]	dsn	""	Set via YOUTUBE_BOT_SENTRY_DSN
[sentry]	traces_sample_rate	1.0
[logging]	level	debug	trace/debug/info/warn/error

Environment-variable overrides use the YOUTUBE_BOT_ prefix (e.g. YOUTUBE_BOT_API_KEY, YOUTUBE_BOT_SENTRY_DSN).

Planned direction

When implemented, the YouTube bot is expected to follow the same architecture as the Discord Bot: a standalone Rust service that talks to the Heimdall API over GraphQL/REST/WebSocket (protobuf), with i18n locales, RBAC permission checks, and data sync. This page will be expanded with commands, configuration, permissions, and data-sync details once that code lands.