Administration

Subtitle settings

The three administration pages for subtitles, field by field - Subtitles, Subtitle providers and Subtitle activity.

In short

Three admin pages under Subtitles control how Fliks finds, downloads and translates subtitles. A watch-only setup needs none of them: embedded and sidecar subtitles play without. To get automatic downloads, add one provider under Subtitle providers. What a subtitle is and how to manage them per title is in Subtitles.

Subtitle providers#

Needed only for automatic search and downloads. The page has two cards: Download providers and Subtitle translation.

Open **Subtitles > Subtitle providers**
1Open Subtitles > Subtitle providers
Under **Download providers**, click **Add provider**
2Under Download providers, click Add provider
Choose the **Provider type**, fill its fields, press **Test**, then **Save**
3Choose the Provider type, fill its fields, press Test, then Save
1 / 3

Subsynchro, Supersubtitles, YIFY and Gestdown need no credentials. For OpenSubtitles enter Username and Password, for Subdl an API Key, then press Test: it answers Connection successful. or Connection failed.

Every field of the provider form and the list

The Subtitle providers page

Field Meaning
Name Filled with the provider type's name; rename it freely.
Provider type OpenSubtitles, Subdl, Subsynchro, Supersubtitles, YIFY (yts-subs.com) or Gestdown (Addic7ed mirror).
Username and Password OpenSubtitles only.
API Key Subdl only.
Test Checks the credentials.
Priority Default 25. Providers are asked in ascending order: the lowest number first.
Enabled On by default.

The OpenSubtitles form

The list has the columns Name, Type, Priority and Active (a switch). A provider that answered with a rate limit shows a Rate-limited badge with a delay: requests resume by themselves. Each row has Stats (the last 30 days: date, queries, average time, results, errors), Edit and Delete.

Translation#

Translation turns an existing text subtitle into another language and adds the Translate action in the subtitle dialog. See Translating a subtitle. It does nothing until Enable translation (off by default) is on and at least one translation provider is added and active.

The example below sets up LibreTranslate, an open-source engine you run yourself: no account, no key. Start it next to Fliks, for example as a Compose service:

yaml
  libretranslate:
    image: libretranslate/libretranslate:v1.9.6
    environment:
      LT_LOAD_ONLY: en,fr   # only the languages you need; each pair is a download
    ports: ["127.0.0.1:5000:5000"]

Both containers must share a Docker network, so that Fliks reaches it at http://libretranslate:5000. The first start downloads the language models and can take a few minutes.

Open **Settings > Subtitle providers** and turn on **Enable translation**
1Open Settings > Subtitle providers and turn on Enable translation
Press **Add provider** in the **Subtitle translation** block
2Press Add provider in the Subtitle translation block
In **New translation provider**, open the **Engine** list and choose **LibreTranslate**
3In New translation provider, open the Engine list and choose LibreTranslate
Name it, enter the **Server URL** and press **Test**
4Name it, enter the Server URL and press Test
**Connection successful** means a test sentence came back translated. Press **Save**
5Connection successful means a test sentence came back translated. Press Save
The provider is listed as **Default**, with its **Active** switch on
6The provider is listed as Default, with its Active switch on
1 / 6
Translation controls and every field of the provider dialog
Control Meaning
Enable translation Master switch. Off by default.
Max parallel How many translations run at once, at least 1. Default 1.
Add provider Opens New translation provider.
Field Meaning
Name, Engine Gemini, OpenAI-compatible (Groq, OpenRouter, Ollama and similar) or LibreTranslate (self-hosted).
Gemini API key, Model Gemini engine. The key is created in Google AI Studio. The model field is prefilled with gemini-3.5-flash-lite.
Base URL OpenAI-compatible engine. Examples are shown under the field for Groq (https://api.groq.com/openai/v1), OpenRouter (https://openrouter.ai/api/v1) and Ollama (http://host.docker.internal:11434/v1, when Ollama runs on the Docker host).
API key (optional) OpenAI-compatible engine: the key of the hosted service (Groq, OpenRouter and similar issue it in their dashboard), left empty for a local Ollama. LibreTranslate: only if your server was started with API keys.
Model OpenAI-compatible engine: the model name, suggested from the list the endpoint reports or typed in. After switching Engine from Gemini, the field may still hold gemini-3.5-flash-lite: replace it.
Server URL LibreTranslate, for example http://libretranslate:5000.
Max tokens per request Prompt and reserved answer together. 0 uses the model maximum; a value under 2048 is raised to 2048. Not shown for LibreTranslate.
Tokens per minute Requests wait so this budget is never exceeded. 0 turns pacing off. Not shown for LibreTranslate.
Enabled, Use as default The default engine is used when several are enabled.
Test Checks the engine before saving.

A Gemini translation provider

Subtitles#

Settings > Subtitles has two tabs, Settings and Statistics. One Save at the bottom saves the whole page. The defaults work: open it to change how often Fliks searches or how strict it is. Which languages are searched comes from the library's language profile, see Libraries.

Automatic search runs every 360 minutes and downloads a result that scores at least 70 (0 to 100).

Every setting: search, upgrade, post-processing and cleaning

The Search and Upgrade cards

Field Default What it does
Automatic subtitle search On Master switch for the scheduled search and the search after an import. Off: subtitles are only fetched by hand.
An image track counts as a present subtitle Off An embedded image track (PGS, VobSub) in a profile language counts as covering that language, so no download or OCR runs for it. Playback of that track then needs a burn-in, which re-encodes every session and rules out Direct Play.
Prefer OCR of embedded image tracks over a download Off When a profile language is missing and an image track exists in it, convert that track to text by OCR instead of downloading. Applies to automatic and manual missing-subtitle searches. OCR is CPU-heavy and runs in the background; if it fails, the language falls back to the providers.
Search interval (minutes) 360 How often missing subtitles are searched for (6 hours). Accepts 30 to 1440.
Minimum score 70 A result must reach this score (0 to 100) to be downloaded automatically.

Upgrade#

Field Default What it does
Upgrade interval (minutes) 720 How often Fliks looks for a better subtitle (12 hours). Accepts 60 to 2880.
Upgrade threshold 90 A subtitle scoring below this is replaced when a better one is found.

The Post-processing and Cleaning cards

Field Default What it does
Automatically sync subtitles (ffsubsync/alass) Off Runs the sync tool on each subtitle after it is downloaded, to line it up with the audio. See Fixing out-of-sync subtitles.
Remove HI tags ([music], (sigh), ♪, etc.) Off Strips hearing-impaired annotations from downloaded text.
Custom exclusions (regex) Empty One regular expression per line. A subtitle line matching one is removed, handy for advertisements.
The Statistics tab

The Statistics tab

It shows Total subtitles, Missing, a count per status (downloaded, synced, upgraded, failed, embedded) and, once providers have answered, By provider. Missing subtitles lists every file lacking a profile language, with a Forced badge where it applies and a magnifier button that searches for that one row now (a toast tells you whether a subtitle was found above the minimum score).

Subtitle activity#

Subtitles > Subtitle activity is a history of what Fliks did with subtitle files (needs the media read permission). It is empty (No subtitle history.) until the first search ran.

The Subtitle activity page

Filter by status (Downloaded, Upgraded, Synced, Failed) and language. A failed row carries the error behind the failure.

See also#

Edit this page on GitHub

Esc