internal/

directory
v0.4.5 Latest Latest
Warning

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

Go to latest
Published: Aug 21, 2026 License: AGPL-3.0

Directories

Path Synopsis
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.
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.
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.
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.
Package cache provides a generic TTL cache with singleflight coalescing.
Package cache provides a generic TTL cache with singleflight coalescing.
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.
Package config loads, validates, and hot-reloads the subflux YAML configuration.
Package config loads, validates, and hot-reloads the subflux YAML configuration.
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/.
schema
Package schema generates the UI configuration schema for the web frontend.
Package schema generates the UI configuration schema for the web frontend.
Package embedded detects embedded subtitle tracks in video files.
Package embedded detects embedded subtitle tracks in video files.
Package epmarker is the single authority for reading S##E## episode markers out of release names and archive member filenames.
Package epmarker is the single authority for reading S##E## episode markers out of release names and archive member filenames.
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.
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.
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.
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.
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.
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.
Package provider contains the provider registry and retry wrappers.
Package provider contains the provider registry and retry wrappers.
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.
animetosho
Package animetosho implements the AnimeTosho subtitle provider.
Package animetosho implements the AnimeTosho subtitle provider.
archive
Package archive provides subtitle extraction from ZIP and RAR archives.
Package archive provides subtitle extraction from ZIP and RAR archives.
betaseries
Package betaseries implements the BetaSeries subtitle provider.
Package betaseries implements the BetaSeries subtitle 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.
gestdown
Package gestdown implements the Gestdown subtitle provider.
Package gestdown implements the Gestdown subtitle provider.
hdbits
Package hdbits implements the HDBits.org subtitle provider.
Package hdbits implements the HDBits.org subtitle provider.
opensubtitles
Package opensubtitles implements the OpenSubtitles.com REST API provider.
Package opensubtitles implements the OpenSubtitles.com REST API provider.
subdl
Package subdl implements the SubDL subtitle provider.
Package subdl implements the SubDL subtitle provider.
subsource
Package subsource implements the SubSource subtitle provider.
Package subsource implements the SubSource subtitle 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.
yifysubtitles
Package yifysubtitles implements the YIFY Subtitles provider.
Package yifysubtitles implements the YIFY Subtitles provider.
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.
Package search implements the subtitle search engine.
Package search implements the subtitle search engine.
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.
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.
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.
syncing
Package syncing provides subtitle timing synchronization for the search engine.
Package syncing provides subtitle timing synchronization for the search engine.
Package server — Content-Security-Policy construction.
Package server — Content-Security-Policy construction.
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.
activityhandlers
Package activityhandlers serves the activity log, the alert list, and the SSE event stream: the HTTP surface over the three 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: the HTTP surface over the three in-memory registries that record what the server is doing and what went wrong.
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.
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).
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.
coverage
Package coverage provides pure computation functions for subtitle coverage analysis.
Package coverage provides pure computation functions for subtitle coverage analysis.
coveragehandlers
Package coveragehandlers provides HTTP handlers for the /api/coverage/* endpoints.
Package coveragehandlers provides HTTP handlers for the /api/coverage/* endpoints.
events
Package events is subflux's typed server-sent-events layer: the sealed Event/EventData types the app publishes, marshaled onto the shared webhttp/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 webhttp/sse broadcast hub.
filehandlers
Package filehandlers provides HTTP handlers for the /api/files/* endpoints.
Package filehandlers provides HTTP handlers for the /api/files/* endpoints.
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.
mediahandlers
Package mediahandlers provides HTTP handlers for the /api/media/* endpoints.
Package mediahandlers provides HTTP handlers for the /api/media/* endpoints.
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.
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.
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.
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.
scanning
Package scanning implements the full-scan orchestration engine.
Package scanning implements the full-scan orchestration engine.
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.
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.
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.
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).
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.
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).
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.
Package subflux is the application's wire and domain type vocabulary.
Package subflux is the application's wire and domain type vocabulary.
Package subsync provides subtitle timing synchronization.
Package subsync provides subtitle timing synchronization.
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.
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.
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.
framerate
Package framerate provides framerate drift detection for subtitle alignment.
Package framerate provides framerate drift detection for subtitle alignment.
vad
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.
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.
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).
Package testsupport provides shared test helpers used across multiple packages.
Package testsupport provides shared test helpers used across multiple packages.
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).
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