subflux

command module
v0.9.0-dev.20 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 16, 2026 License: AGPL-3.0 Imports: 63 Imported by: 0

README

subflux

Image Size Platforms Mutation SBOM

subflux finds, downloads and times subtitles for the shows and movies in your Sonarr and Radarr library, and saves them next to each video. It works only through Sonarr and Radarr and does not scan folders on its own.

⚠️ Alpha software

subflux is under active development and has not reached version 1.0. Any update can change the config format, the saved state, the API or the behavior. Pin a specific image tag instead of latest, and read the release notes before you upgrade.

What it does

subflux gets subtitles in your languages onto your whole library:

  • Checks Sonarr and Radarr every 30 seconds and fetches subtitles for each new download.
  • Scans the library once a day to fill gaps and upgrade recent subtitles.
  • Fixes each download's timing to match a subtitle track in the video, or optionally its audio.
  • Shows coverage on a web page, where you can search, pick and re-time subtitles by hand.

Who it is for

subflux is built for people who run Sonarr, Radarr or both on a Docker host and want subtitles without picking them by hand. It picks languages from each file's audio track and can fetch forced and hearing-impaired versions. A 52,000-episode library runs in 1 GB of memory.

You need a Sonarr or Radarr instance with its API key, and your media mounted writable at the paths they use. subflux searches eight sites. Gestdown, AnimeTosho and YIFY Subtitles need no account. OpenSubtitles, SubDL, SubSource, BetaSeries and HDBits need an account or an API key.

Consider Bazarr if you want a native install on Windows, macOS or a Raspberry Pi, or a site such as Titlovi or Napiprojekt. It supports 184 subtitle languages and Whisper speech-to-text.

subflux is free software under the AGPL-3.0-or-later license.

Quick start

The image is on GitHub Container Registry and Docker Hub, for amd64 and arm64. This is the compose.yaml in this repository.

services:
  subflux:
    image: ghcr.io/cplieger/subflux:latest
    container_name: subflux
    restart: unless-stopped
    # Run "sudo install -d -o 1000 -g 1000 /opt/appdata/subflux" before the first start,
    # or the container restarts in a loop. If .env sets PUID and PGID, use those numbers.
    user: "${PUID:-1000}:${PGID:-1000}"

    ports:
      - "8374:8374"

    volumes:
      - "/opt/appdata/subflux:/config"  # settings and saved state
      # Put the path Sonarr and Radarr show for your media on the right, writable by the user above.
      - "/path/to/media:/media"
  1. Create the settings folder for user 1000 with sudo install -d -o 1000 -g 1000 /opt/appdata/subflux. If your .env sets PUID and PGID, use those numbers.
  2. Replace /path/to/media with your media folder, and /media with the root folder Sonarr and Radarr show under Settings, then Media Management. If they use two root folders, add one line for each.
  3. Run docker compose up -d.
  4. From another device on your network, open the host's address on port 8374 in a browser, for example http://192.0.2.10:8374.
  5. Create the admin account.
  6. In the setup wizard, enter Sonarr's address as you open it from another device, not localhost, and the API key from the General page of Sonarr's Settings. Do the same for Radarr.
  7. Enter the right-hand paths from step 2 as media roots, pick your subtitle sites and languages, then click Finish.

Run docker logs subflux. You should see HTTP server listening. If you see failed to write default config, the settings folder from step 1 is missing or belongs to another user.

Configuration reference

Every setting is in the web page's Settings dialog and is saved to /config/config.yaml. A save applies at once, with no restart. To write the file yourself, start from the annotated config.example.yaml.

Key Default Description
sonarr.url, radarr.url required The address subflux reaches Sonarr or Radarr at. Set at least one
sonarr.api_key, radarr.api_key required The API key from the General page of that app's Settings
media_roots (unset) The media folders, at the same paths Sonarr and Radarr use. The first-start file sets /media
languages required The subtitle languages to fetch for each audio language, plus a fallback list
providers.<name>.enabled Gestdown, AnimeTosho and YIFY Subtitles on in the first-start file Which subtitle sites to search, with their account settings
poll_interval 30s How often subflux checks Sonarr and Radarr for new imports
search.scan_interval 24h Time between the end of one full library scan and the start of the next
search.upgrade_window_days 7 How many days after a download subflux keeps looking for a better match
search.exclude_arr_tags no-subflux Sonarr or Radarr tags whose shows and movies subflux skips
post_processing.audio_sync_fallback false Re-time against the audio when the video has no subtitle track to compare with
post_processing.strip_hi false Remove hearing-impaired annotations such as [music]
trusted_proxies [] Your reverse proxy's address, so the real client address is logged and rate-limited
allowed_hosts [] The host names subflux answers for. Leave empty to accept any
logging.level info debug, info, warn or error

Every other setting, the command line and environment references in config.yaml are in Configuration.

Variable Description Default
PUID, PGID The user and group the container runs as, read by compose.yaml 1000
SUBFLUX_URL The server address the subflux command line talks to http://127.0.0.1:8374
SUBFLUX_API_KEY An API key for the command line, created on the web page (unset)
Mount Description
/config config.yaml and the subflux.bolt database
/media Your media, where subflux writes subtitle files next to each video
Port Description
8374 The web page, the API and /metrics

Security

Create the admin account right after the first start. Until one exists, the first visitor to the page creates it. Keep port 8374 on your own network, or put a reverse proxy with HTTPS in front of it and set trusted_proxies and allowed_hosts. /metrics and /api/health answer without a login.

Logins use passwords, passkeys or OIDC, and an admin can create API keys for the command line. Saved site passwords and API keys are never sent back to the browser. Passkeys cover your whole domain, so with subflux at subflux.example.com the browser offers them on every example.com host. Setting auth.disable_auth turns login off and treats every request as an admin.

The image has no shell and runs as the user in compose.yaml. subflux checks each subtitle site's address before it connects. Security covers reverse proxies, passkeys and what the image contains.

Troubleshooting

The healthcheck runs subflux health, which passes while the web server is running, set up or not. Docker checks every 30 seconds after a 15-second start period and marks the container unhealthy after 3 failures in a row. A wrong API key or an unreachable Sonarr instance keeps it healthy, so you can fix it on the web page.

  • The container restarts with failed to write default config. Create the settings folder for the container user, as in step 1.
  • An alert says subtitles cannot be written in a folder. subflux pauses work there and retries every 5 minutes. Make the folder writable for the container user.
  • Full scans do not start. A folder in media_roots is missing or not writable. Fix it or remove it from the list.
  • An alert says a subtitle site was disabled. The site rejected your credentials three times. Save new ones or press the site's Test button.
  • A share is unmounted. subflux keeps its records, shows an alert naming the path and holds new imports there until the share returns.

How subflux works explains each case in full.

Monitoring

subflux serves Prometheus metrics at /metrics and writes JSON logs. Eight Prometheus alert rules ship in alerts/promql.yaml. Monitoring and alerts lists the metrics and the rules and shows how to load them.

Documentation

Credits

  • FFmpeg and x264 are built into the image to read subtitle and audio tracks and to stream the preview in the timing editor.
  • The timing engine is a Go port of the alignment algorithm in alass by @kaegi.
  • The audio timing uses a port of the voice-activity detector from the WebRTC project, re-tuned for film audio.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md.

Disclaimer

This project is built with care and follows security best practices, but it is intended for personal / self-hosted use. No guarantees of fitness for production environments. Use at your own risk.

This project was built with AI-assisted tooling using Claude, GPT, and Kiro. The human maintainer defines architecture, supervises implementation, and makes all final decisions.

License

AGPL-3.0-or-later. See LICENSE. The image carries the license text of every bundled component under /usr/share/licenses/.

The image bundles two upstream programs built from source, both GPL-2.0-or-later: FFmpeg (the FFMPEG_VERSION pin in the Dockerfile, fetched as the n<version> tag archive of https://github.com/FFmpeg/FFmpeg) and x264 (the X264_COMMIT pin, cloned from https://code.videolan.org/videolan/x264.git). The build applies no patches; this repository's Dockerfile, together with those two pinned sources, is the complete build recipe, which is how the GPL source offer for the shipped binaries is met.

Two upstream projects are ported into internal/subsync rather than bundled: the alignment algorithms of alass (GPL-3.0-or-later, which section 13 of the GPLv3 lets an AGPL-3.0 program contain) and the voice activity detector of WebRTC (BSD-3-Clause). Both license texts, with the files that carry the ported code, are in THIRD_PARTY_NOTICES.md.

Documentation

Overview

providers.go is the single registration point for all subtitle providers. Each provider's factory function, settings schema and credential-check capability are registered here; adding a new provider requires one entry in providerEntries. No init(), no blank imports, no global state.

Directories

Path Synopsis
cmd
bundle command
Command bundle builds subflux's browser client: it bundles the SSE worker and the two page entrypoints (app.ts, login.ts) with esbuild, a Go library, so the builder needs no Node.
Command bundle builds subflux's browser client: it bundles the SSE worker and the two page entrypoints (app.ts, login.ts) with esbuild, a Go library, so the builder needs no Node.
wire-codegen command
Command wire-codegen generates the TypeScript wire surface and the Go path constants from the single wire contract in internal/wirespec, using the wiregen library (AST-based; github.com/cplieger/wiregen/v3).
Command wire-codegen generates the TypeScript wire surface and the Go path constants from the single wire contract in internal/wirespec, using the wiregen library (AST-based; github.com/cplieger/wiregen/v3).
internal
arrsvc
Package arrsvc composes the github.com/cplieger/arrapi Sonarr and Radarr clients with subflux's subtitle-specific operations: "wanted" iteration (which library items need a subtitle search), exclude-tag name resolution, and a fire-and-forget rescan.
Package arrsvc composes the github.com/cplieger/arrapi Sonarr and Radarr clients with subflux's subtitle-specific operations: "wanted" iteration (which library items need a subtitle search), exclude-tag name resolution, and a fire-and-forget rescan.
authstore
Package authstore is subflux's bbolt-backed implementation of the auth library's persistence SPI.
Package authstore is subflux's bbolt-backed implementation of the auth library's persistence SPI.
authstore/authstoretest
Package authstoretest provides a shared, engine-agnostic behavioral contract suite for subflux's auth store against the auth library's persistence SPI.
Package authstoretest provides a shared, engine-agnostic behavioral contract suite for subflux's auth store against the auth library's persistence SPI.
boltstore
Package boltstore is the bbolt-backed core store for subflux's search, subtitle, scan, sync-offset, and poll domains.
Package boltstore is the bbolt-backed core store for subflux's search, subtitle, scan, sync-offset, and poll domains.
cache
Package cache provides a generic TTL cache with singleflight coalescing.
Package cache provides a generic TTL cache with singleflight coalescing.
cliparse
Package cliparse implements subflux's flat CLI grammar: a single ParseAndValidate pass that splits "--key value" / "--key=value" tokens, rejects unknown flags (with typo suggestions) and stray positionals, parses bool flags from the spec table, validates typed values, enforces required flags, and applies spec defaults.
Package cliparse implements subflux's flat CLI grammar: a single ParseAndValidate pass that splits "--key value" / "--key=value" tokens, rejects unknown flags (with typo suggestions) and stray positionals, parses bool flags from the spec table, validates typed values, enforces required flags, and applies spec defaults.
config
Package config loads, validates, and hot-reloads the subflux YAML configuration.
Package config loads, validates, and hot-reloads the subflux YAML configuration.
config/defaults
Package defaults provides the shared configuration default values and validation thresholds used by both config/ and config/schema/.
Package defaults provides the shared configuration default values and validation thresholds used by both config/ and config/schema/.
config/schema
Package schema generates the UI configuration schema for the web frontend.
Package schema generates the UI configuration schema for the web frontend.
effectqueue
Package effectqueue runs the side effects a mutation decided under a state lock after that lock is released, in the order the mutations happened.
Package effectqueue runs the side effects a mutation decided under a state lock after that lock is released, in the order the mutations happened.
embedded
Package embedded detects embedded subtitle tracks in video files.
Package embedded detects embedded subtitle tracks in video files.
epmarker
Package epmarker is the single authority for reading episode markers out of release names and archive member filenames.
Package epmarker is the single authority for reading episode markers out of release names and archive member filenames.
httpapi
Package httpapi is the handler plumbing of subflux's own HTTP API: the prelude every handler opens with and the envelope every handler answers in.
Package httpapi is the handler plumbing of subflux's own HTTP API: the prelude every handler opens with and the envelope every handler answers in.
httpwire
Package httpwire holds subflux's own HTTP wire policy: the byte bounds it will read from a peer, and the vocabulary it classifies a peer's response with.
Package httpwire holds subflux's own HTTP wire policy: the byte bounds it will read from a peer, and the vocabulary it classifies a peer's response with.
langcode
Package langcode maps any language identifier subflux meets — a provider payload, an ffprobe stream tag, an arr API response, a config file — onto the one internal code space, and is the only place that mapping happens.
Package langcode maps any language identifier subflux meets — a provider payload, an ffprobe stream tag, an arr API response, a config file — onto the one internal code space, and is the only place that mapping happens.
logsafe
Package logsafe binds runesafe's single-line preset to Subflux's log surface, so every untrusted string reaches slog through one policy.
Package logsafe binds runesafe's single-line preset to Subflux's log surface, so every untrusted string reaches slog through one policy.
mediaid
Package mediaid builds the stable identifier subflux addresses one media item by: "tmdb-27205" for a movie, "tvdb-121361-s01e09" for an episode, plus the prefixes that select a whole season or series in one scan.
Package mediaid builds the stable identifier subflux addresses one media item by: "tmdb-27205" for a movie, "tvdb-121361-s01e09" for an episode, plus the prefixes that select a whole season or series in one scan.
mediapresence
Package mediapresence decides whether a media file is gone or only unreachable.
Package mediapresence decides whether a media file is gone or only unreachable.
mediawrite
Package mediawrite owns every subtitle write into the media tree and the process-wide record of which destination folders refuse writes.
Package mediawrite owns every subtitle write into the media tree and the process-wide record of which destination folders refuse writes.
obs
Package obs owns Subflux's observability surface: the Prometheus registry (exposition prefix "subflux_") and every counter, gauge and histogram it serves — searches, downloads, imports, scans, the HTTP transport, and the bbolt store.
Package obs owns Subflux's observability surface: the Prometheus registry (exposition prefix "subflux_") and every counter, gauge and histogram it serves — searches, downloads, imports, scans, the HTTP transport, and the bbolt store.
provider
Package provider contains the provider registry and retry wrappers.
Package provider contains the provider registry and retry wrappers.
provider/anidb
Package anidb provides TVDB → AniDB mapping using the community-maintained anime-list.xml from https://github.com/Anime-Lists/anime-lists.
Package anidb provides TVDB → AniDB mapping using the community-maintained anime-list.xml from https://github.com/Anime-Lists/anime-lists.
provider/animetosho
Package animetosho implements the AnimeTosho subtitle provider.
Package animetosho implements the AnimeTosho subtitle provider.
provider/archive
Package archive extracts a subtitle from a ZIP or RAR container.
Package archive extracts a subtitle from a ZIP or RAR container.
provider/betaseries
Package betaseries implements the BetaSeries subtitle provider.
Package betaseries implements the BetaSeries subtitle provider.
provider/classify
Package classify provides subtitle classification (forced/HI) and language resolution utilities consumed by provider sub-packages.
Package classify provides subtitle classification (forced/HI) and language resolution utilities consumed by provider sub-packages.
provider/gestdown
Package gestdown implements the Gestdown subtitle provider.
Package gestdown implements the Gestdown subtitle provider.
provider/hdbits
Package hdbits implements the HDBits.org subtitle provider.
Package hdbits implements the HDBits.org subtitle provider.
provider/opensubtitles
Package opensubtitles implements the OpenSubtitles.com REST API provider.
Package opensubtitles implements the OpenSubtitles.com REST API provider.
provider/subdl
Package subdl implements the SubDL subtitle provider.
Package subdl implements the SubDL subtitle provider.
provider/subsource
Package subsource implements the SubSource subtitle provider.
Package subsource implements the SubSource subtitle provider.
provider/synthetic
Package synthetic provides a subtitle provider that answers from generated data instead of an upstream service.
Package synthetic provides a subtitle provider that answers from generated data instead of an upstream service.
provider/yifysubtitles
Package yifysubtitles implements the YIFY Subtitles provider.
Package yifysubtitles implements the YIFY Subtitles provider.
required
Package required answers whether a required collaborator handed to a constructor is missing.
Package required answers whether a required collaborator handed to a constructor is missing.
rpid
Package rpid derives and validates the WebAuthn relying-party ID for the host subflux is reached on: the registrable domain (eTLD+1) from the public suffix list, never a label strip, so a host whose provider is itself a public suffix (foo.duckdns.org, nas.synology.me) collapses to the exact host instead of to an illegal bare suffix.
Package rpid derives and validates the WebAuthn relying-party ID for the host subflux is reached on: the registrable domain (eTLD+1) from the public suffix list, never a label strip, so a host whose provider is itself a public suffix (foo.duckdns.org, nas.synology.me) collapses to the exact host instead of to an illegal bare suffix.
scorer
Package scorer holds the CONFIGURED scoring engine: it carries the user's weight table and answers the two questions callers outside the search domain ask, what does this subtitle score and which tier is that score.
Package scorer holds the CONFIGURED scoring engine: it carries the user's weight table and answers the two questions callers outside the search domain ask, what does this subtitle score and which tier is that score.
search
Package search implements the subtitle search engine.
Package search implements the subtitle search engine.
search/providergate
Package providergate decides whether a subtitle provider may be called for one operation right now.
Package providergate decides whether a subtitle provider may be called for one operation right now.
search/providerhealth
Package providerhealth tracks how a provider is behaving and takes a failing one out of rotation: it counts failures in a sliding window and, past a threshold, times the provider out for a cooldown.
Package providerhealth tracks how a provider is behaving and takes a failing one out of rotation: it counts failures in a sliding window and, past a threshold, times the provider out for a cooldown.
search/release
Package release provides release name parsing via PCRE-compatible regex patterns sourced from TRaSH Guides and Sonarr/Radarr QualityParser.
Package release provides release name parsing via PCRE-compatible regex patterns sourced from TRaSH Guides and Sonarr/Radarr QualityParser.
search/scoring
Package scoring holds the pure matching and weighting rules the scan engine applies to a candidate: which subtitles identify as the requested item, which weight categories a release hits, and the title and episode comparisons under both.
Package scoring holds the pure matching and weighting rules the scan engine applies to a candidate: which subtitles identify as the requested item, which weight categories a release hits, and the title and episode comparisons under both.
search/syncing
Package syncing provides subtitle timing synchronization for the search engine.
Package syncing provides subtitle timing synchronization for the search engine.
server
Package server — Content-Security-Policy construction.
Package server — Content-Security-Policy construction.
server/activity
Package activity provides concurrent-safe activity and alert tracking for the subflux UI status indicator.
Package activity provides concurrent-safe activity and alert tracking for the subflux UI status indicator.
server/activityhandlers
Package activityhandlers serves the activity log, the alert list, and the SSE event stream with its digest and presence-acknowledgement routes: the HTTP surface over the in-memory registries that record what the server is doing and what went wrong.
Package activityhandlers serves the activity log, the alert list, and the SSE event stream with its digest and presence-acknowledgement routes: the HTTP surface over the in-memory registries that record what the server is doing and what went wrong.
server/adminsocket
Package adminsocket serves the out-of-band admin plane: the one route the CLI posts to for password reset and API-key generation.
Package adminsocket serves the out-of-band admin plane: the one route the CLI posts to for password reset and API-key generation.
server/authhandlers
Package authhandlers provides shared types and utilities for the server's authentication handler cluster: login, WebAuthn, OIDC, admin user management, and security management (password change, API keys, passkeys).
Package authhandlers provides shared types and utilities for the server's authentication handler cluster: login, WebAuthn, OIDC, admin user management, and security management (password change, API keys, passkeys).
server/confighandlers
Package confighandlers provides HTTP handlers for configuration CRUD operations: get, save, reset, schema, and path validation.
Package confighandlers provides HTTP handlers for configuration CRUD operations: get, save, reset, schema, and path validation.
server/coverage
Package coverage provides pure computation functions for subtitle coverage analysis.
Package coverage provides pure computation functions for subtitle coverage analysis.
server/coveragehandlers
Package coveragehandlers provides HTTP handlers for the /api/coverage/* endpoints.
Package coveragehandlers provides HTTP handlers for the /api/coverage/* endpoints.
server/events
Package events is subflux's typed server-sent-events layer: the sealed Event/EventData types the app publishes, marshaled onto the shared cplieger/sse broadcast hub.
Package events is subflux's typed server-sent-events layer: the sealed Event/EventData types the app publishes, marshaled onto the shared cplieger/sse broadcast hub.
server/filehandlers
Package filehandlers provides HTTP handlers for the /api/files/* endpoints.
Package filehandlers provides HTTP handlers for the /api/files/* endpoints.
server/manualops
Package manualops implements the business logic for manual subtitle search and download operations.
Package manualops implements the business logic for manual subtitle search and download operations.
server/mediahandlers
Package mediahandlers provides HTTP handlers for the /api/media/* endpoints.
Package mediahandlers provides HTTP handlers for the /api/media/* endpoints.
server/polling
Package polling provides the history-polling subsystem for Sonarr/Radarr import events and the write-through poll timestamp cache.
Package polling provides the history-polling subsystem for Sonarr/Radarr import events and the write-through poll timestamp cache.
server/previewhandlers
Package previewhandlers provides HTTP handlers for the video/subtitle preview and poster proxy endpoints.
Package previewhandlers provides HTTP handlers for the video/subtitle preview and poster proxy endpoints.
server/queryhandlers
Package queryhandlers provides read-only HTTP query handlers: subtitle state, backoff, manual locks, providers, parsed config, score simulation, and dashboard stats.
Package queryhandlers provides read-only HTTP query handlers: subtitle state, backoff, manual locks, providers, parsed config, score simulation, and dashboard stats.
server/resolve
Package resolve is the one home for typed-reference resolution (S7): it maps the wire references — FileRef (one stored subtitle file) and MediaRef (the arr-known video of a media item) — to absolute filesystem paths using server-derived facts only.
Package resolve is the one home for typed-reference resolution (S7): it maps the wire references — FileRef (one stored subtitle file) and MediaRef (the arr-known video of a media item) — to absolute filesystem paths using server-derived facts only.
server/scanning
Package scanning implements the full-scan orchestration engine.
Package scanning implements the full-scan orchestration engine.
server/scheduler
Package scheduler provides the periodic full-scan pipeline, DB maintenance, and auth cleanup scheduling for the subflux server.
Package scheduler provides the periodic full-scan pipeline, DB maintenance, and auth cleanup scheduling for the subflux server.
server/showskip
Package showskip provides a TTL-based cache for show-level subtitle pre-check results.
Package showskip provides a TTL-based cache for show-level subtitle pre-check results.
server/storeops
Package storeops runs the periodic operations that treat the bbolt file as an operational artifact rather than a set of rows: timestamped snapshots with retention pruning, and the file-size and freelist gauges.
Package storeops runs the periodic operations that treat the bbolt file as an operational artifact rather than a set of rows: timestamped snapshots with retention pruning, and the file-size and freelist gauges.
server/synchandlers
Package synchandlers provides HTTP handlers for subtitle sync operations (audio-based sync and manual offset adjustment).
Package synchandlers provides HTTP handlers for subtitle sync operations (audio-based sync and manual offset adjustment).
server/syncjobs
Package syncjobs owns the server-side async sync job machinery (D1, D2): a bounded FIFO dispatcher with an admission lease, the job record registry GET /api/sync/jobs serves, and the sync:done publication seam.
Package syncjobs owns the server-side async sync job machinery (D1, D2): a bounded FIFO dispatcher with an admission lease, the job record registry GET /api/sync/jobs serves, and the sync:done publication seam.
store/buckets
Package buckets is the single owner of the AUTH-domain bbolt bucket names shared by the two packages that operate on one database file: the core store (internal/boltstore) bootstraps every bucket in its schema, and the auth store (internal/authstore) builds keys inside these.
Package buckets is the single owner of the AUTH-domain bbolt bucket names shared by the two packages that operate on one database file: the core store (internal/boltstore) bootstraps every bucket in its schema, and the auth store (internal/authstore) builds keys inside these.
store/kv
Package kv holds the shared bbolt store primitives used by both the core subflux store (internal/store) and the auth store (internal/authstore).
Package kv holds the shared bbolt store primitives used by both the core subflux store (internal/store) and the auth store (internal/authstore).
store/storetest
Package storetest provides a shared, engine-agnostic behavioral contract suite for the core subtitle store.
Package storetest provides a shared, engine-agnostic behavioral contract suite for the core subtitle store.
subflux
Package subflux is the application's wire and domain type vocabulary.
Package subflux is the application's wire and domain type vocabulary.
subsync
Package subsync provides subtitle timing synchronization.
Package subsync provides subtitle timing synchronization.
subsync/crosslang
Package crosslang implements cross-language subtitle alignment using anchor-based matching and dynamic programming.
Package crosslang implements cross-language subtitle alignment using anchor-based matching and dynamic programming.
subsync/ffmpeg
Package ffmpeg provides low-level ffmpeg/ffprobe subprocess wrappers for stream probing, subtitle extraction, and PCM audio extraction.
Package ffmpeg provides low-level ffmpeg/ffprobe subprocess wrappers for stream probing, subtitle extraction, and PCM audio extraction.
subsync/fft
Package fft provides a radix-2 Cooley-Tukey FFT implementation for cross-correlation in the subsync package.
Package fft provides a radix-2 Cooley-Tukey FFT implementation for cross-correlation in the subsync package.
subsync/framerate
Package framerate provides framerate drift detection for subtitle alignment.
Package framerate provides framerate drift detection for subtitle alignment.
subtitleenc
Package subtitleenc is the single authority for what encoding a subtitle's bytes are in and how to read them as UTF-8.
Package subtitleenc is the single authority for what encoding a subtitle's bytes are in and how to read them as UTF-8.
subtitleext
Package subtitleext is the single authority for which file extensions count as subtitle files, exposed as capability-scoped views rather than one flat union.
Package subtitleext is the single authority for which file extensions count as subtitle files, exposed as capability-scoped views rather than one flat union.
subtitlefile
Package subtitlefile owns the subtitle file on disk: what subflux names it, and what it will accept as its contents.
Package subtitlefile owns the subtitle file on disk: what subflux names it, and what it will accept as its contents.
syncworker
Package syncworker isolates subtitle-sync computation in a supervised one-shot child process (P13).
Package syncworker isolates subtitle-sync computation in a supervised one-shot child process (P13).
testsupport
Package testsupport provides shared test helpers used across multiple packages.
Package testsupport provides shared test helpers used across multiple packages.
wirespec
Package wirespec is the single source of truth for subflux's HTTP wire contract: the registered wire types, enums, and the endpoint table that cmd/wire-codegen feeds into wiregen to emit the TS types, decoders, typed client, and the Go path constants (internal/apipaths).
Package wirespec is the single source of truth for subflux's HTTP wire contract: the registered wire types, enums, and the endpoint table that cmd/wire-codegen feeds into wiregen to emit the TS types, decoders, typed client, and the Go path constants (internal/apipaths).
wiring
Package wiring holds composition-root types that connect concrete implementations across the config, provider, scorer, search and embedded packages.
Package wiring holds composition-root types that connect concrete implementations across the config, provider, scorer, search and embedded packages.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL