diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..9f43494
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,6 @@
+# FIX CRLF always when developer has not set
+# Linux/Mac: git config --global core.autocrlf input
+# Windows: git config --global core.autocrlf true
+# Auto detect text files and perform LF normalization
+* text=auto
+* eol=lf
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 0000000..e132445
--- /dev/null
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,59 @@
+name: Publish image
+
+# Build and push the feeder image to the GitHub Container Registry (ghcr.io):
+#   * every push to main  -> the moving `main` tag
+#   * every `v*` tag       -> semver tags (e.g. v1.0.0 -> 1.0.0, 1.0, 1)
+# The build context is the repo root (the workspace); meta-feeder-sdk is a git
+# dependency pinned by tag. The Dockerfile lives under
+# feeder-plugin/opensubtitles-feeder/.
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract image metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=sha,format=short
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: ./feeder-plugin/opensubtitles-feeder/Dockerfile
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..4a08bb9
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,4 @@
+/target
+**/target
+Cargo.lock.bak
+*.redb
diff --git a/Cargo.lock b/Cargo.lock
new file mode 100644
index 0000000..8fc4f76
--- /dev/null
+++ b/Cargo.lock
@@ -0,0 +1,1945 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c982642fa9e8606056828ee9a8505737230110bb1099153c79efe865c59d12ba"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "anyhow"
+version = "1.0.104"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "330a5ed07fa54e4702c9d6c4174f74427fc0ef6e214bbd677ae50a5099946470"
+
+[[package]]
+name = "assert-json-diff"
+version = "2.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "47e4f2b81832e72834d7518d8487a0396a28cc408186a2e8854c0f98011faf12"
+dependencies = [
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "async-trait"
+version = "0.1.92"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "82f6aeea286b8eb4dd3431a1be1b59d290ace00f5bfd8e2a159bc2a05e2c1667"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "atomic-waker"
+version = "1.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0"
+
+[[package]]
+name = "axum"
+version = "0.7.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "edca88bc138befd0323b20752846e6587272d3b03b0343c8ea28a6f819e6e71f"
+dependencies = [
+ "async-trait",
+ "axum-core",
+ "bytes",
+ "futures-util",
+ "http",
+ "http-body",
+ "http-body-util",
+ "hyper",
+ "hyper-util",
+ "itoa",
+ "matchit",
+ "memchr",
+ "mime",
+ "percent-encoding",
+ "pin-project-lite",
+ "rustversion",
+ "serde",
+ "serde_json",
+ "serde_path_to_error",
+ "serde_urlencoded",
+ "sync_wrapper",
+ "tokio",
+ "tower",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+
+[[package]]
+name = "axum-core"
+version = "0.4.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09f2bd6146b97ae3359fa0cc6d6b376d9539582c7b4220f041a33ec24c226199"
+dependencies = [
+ "async-trait",
+ "bytes",
+ "futures-util",
+ "http",
+ "http-body",
+ "http-body-util",
+ "mime",
+ "pin-project-lite",
+ "rustversion",
+ "sync_wrapper",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+
+[[package]]
+name = "base64"
+version = "0.22.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
+
+[[package]]
+name = "bitflags"
+version = "2.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ded4057c258ba199e2d26386d3af3780957ecaee6c4ef4041c6b4b8b97c0b06"
+
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "bumpalo"
+version = "3.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
+
+[[package]]
+name = "bytes"
+version = "1.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc652a48c352aef3ea3aed32080501cf3ef6ed5da78602a020c991775b0aff04"
+
+[[package]]
+name = "cc"
+version = "1.4.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "005ec2760ca554fae18df7a11195552ec576cd665632a881bc011d5bb2fd4d80"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "cfg_aliases"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f079e83a288787bcd14a6aea84cee5c87a67c5a3e660c30f557a3d24761b3527"
+
+[[package]]
+name = "chacha20"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65c35e4b699c7e15ccbe7ee35c005e4fc0a278d22238a2857e6ce2dadeda1b06"
+dependencies = [
+ "cfg-if",
+ "cpufeatures 0.3.1",
+ "rand_core",
+]
+
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "cpufeatures"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5ca28b0ae3115b884660db4118d803791fd6756b6e88f39c0f3f7859060d7566"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+
+[[package]]
+name = "deadpool"
+version = "0.12.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0be2b1d1d6ec8d846f05e137292d0b89133caf95ef33695424c09568bdd39b1b"
+dependencies = [
+ "deadpool-runtime",
+ "lazy_static",
+ "num_cpus",
+ "tokio",
+]
+
+[[package]]
+name = "deadpool-runtime"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "092966b41edc516079bdf31ec78a2e0588d1d0c08f78b91d8307215928642b2b"
+
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer",
+ "crypto-common",
+]
+
+[[package]]
+name = "displaydoc"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c6232dd377dcc64799954cbd3a9bb882e9cdc1308ccd87b1c098f1fb2eaf82a8"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "equivalent"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+
+[[package]]
+name = "errno"
+version = "0.3.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
+dependencies = [
+ "libc",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "fastrand"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da7c62ceae207dd37ea5b845da6a0696c799f85e97da1ab5b7910be3c1c80223"
+
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3e0f1c7c3a72c66fd80abe965175f7523475c0489a87d3ff9d6e8c87d87a9d2d"
+
+[[package]]
+name = "fnv"
+version = "1.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
+
+[[package]]
+name = "form_urlencoded"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf"
+dependencies = [
+ "percent-encoding",
+]
+
+[[package]]
+name = "futures"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a31d2a3fbaaeb2af2368bbdd904aa8e812d3c04a1ee10d3171f52d556e5d0a3"
+dependencies = [
+ "futures-channel",
+ "futures-core",
+ "futures-executor",
+ "futures-io",
+ "futures-sink",
+ "futures-task",
+ "futures-util",
+]
+
+[[package]]
+name = "futures-channel"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b1f9e3d69d39e4862ffed03ed071a76f9a13ba1d9109d355b0f0aa6b15e393c4"
+dependencies = [
+ "futures-core",
+ "futures-sink",
+]
+
+[[package]]
+name = "futures-core"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92d699e522242e69e3003b94ecc1f960f3a5e015aa7c5d7486e65ad01dd94f5e"
+
+[[package]]
+name = "futures-executor"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "031b47cf1a3c6cc8bc2fc76cd437f521619387907d469316e7c0bc278f1f5432"
+dependencies = [
+ "futures-core",
+ "futures-task",
+ "futures-util",
+]
+
+[[package]]
+name = "futures-io"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53c0fa8157de1303bfffdaa1cc2a673bfffb60102f76b0ef4441659124373fed"
+
+[[package]]
+name = "futures-macro"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9fb9654ba8355388abeb8dcb4fc62f511300867002afc858860463bdd9fe0c44"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "futures-sink"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1944426bf7d03f1d14f708785e4b33efd750b36d48a157b836b3efc15ede8e1d"
+
+[[package]]
+name = "futures-task"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cd417de3d1d015fc3bfd2b1ea46dfc7bab72ef86f1cc7cc9c78e728b34a6d1fd"
+
+[[package]]
+name = "futures-util"
+version = "0.3.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0d50a92467f8ba5dd6e3ee5d4bd04d73ab2e4e1c44474a0674821dfce14b79bc"
+dependencies = [
+ "futures-channel",
+ "futures-core",
+ "futures-io",
+ "futures-macro",
+ "futures-sink",
+ "futures-task",
+ "memchr",
+ "pin-project-lite",
+ "slab",
+]
+
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "libc",
+ "wasi",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "300e883d756b2e4ec94e02791f39b04b522276138852cfc41d9fb7e904106099"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "libc",
+ "r-efi",
+ "rand_core",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "h2"
+version = "0.4.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ef8e5e5a340588f4452631496976cf8636d4a7ecf600239fdc27615d2530bc16"
+dependencies = [
+ "atomic-waker",
+ "bytes",
+ "fnv",
+ "futures-core",
+ "futures-sink",
+ "http",
+ "indexmap",
+ "slab",
+ "tokio",
+ "tokio-util",
+ "tracing",
+]
+
+[[package]]
+name = "hashbrown"
+version = "0.17.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed5909b6e89a2db4456e54cd5f673791d7eca6732202bbf2a9cc504fe2f9b84a"
+
+[[package]]
+name = "hermit-abi"
+version = "0.5.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e17592d60ebacc7d5e169f4663c5f84f9161cc90328abcfe8456f41e4dfcb284"
+
+[[package]]
+name = "http"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "918d3568bebf352712bc2ef3d46a8bcf1a75b373be6539de198e9105cbbf9ce0"
+dependencies = [
+ "bytes",
+ "itoa",
+]
+
+[[package]]
+name = "http-body"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca2a8f2913ee65f60facd6a5905613afaa448497a0230cc41ce022d93290bc2c"
+dependencies = [
+ "bytes",
+ "http",
+]
+
+[[package]]
+name = "http-body-util"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "23169fe34a5fbcdd3f3862e78fb9b6fccd5f02a6dc6f732547005d45631ce71c"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "http",
+ "http-body",
+ "pin-project-lite",
+]
+
+[[package]]
+name = "httparse"
+version = "1.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87"
+
+[[package]]
+name = "httpdate"
+version = "1.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
+
+[[package]]
+name = "hyper"
+version = "1.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "27b501faa50e7a26c3d3560ca625132f4078a17771f4810baf70475ae48cbe43"
+dependencies = [
+ "atomic-waker",
+ "bytes",
+ "futures-channel",
+ "futures-core",
+ "h2",
+ "http",
+ "http-body",
+ "httparse",
+ "httpdate",
+ "itoa",
+ "pin-project-lite",
+ "smallvec",
+ "tokio",
+ "want",
+]
+
+[[package]]
+name = "hyper-rustls"
+version = "0.27.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "33ca68d021ef39cf6463ab54c1d0f5daf03377b70561305bb89a8f83aab66e0f"
+dependencies = [
+ "http",
+ "hyper",
+ "hyper-util",
+ "rustls",
+ "tokio",
+ "tokio-rustls",
+ "tower-service",
+ "webpki-roots",
+]
+
+[[package]]
+name = "hyper-util"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96547c2556ec9d12fb1578c4eaf448b04993e7fb79cbaad930a656880a6bdfa0"
+dependencies = [
+ "base64",
+ "bytes",
+ "futures-channel",
+ "futures-util",
+ "http",
+ "http-body",
+ "hyper",
+ "ipnet",
+ "libc",
+ "percent-encoding",
+ "pin-project-lite",
+ "socket2",
+ "tokio",
+ "tower-service",
+ "tracing",
+]
+
+[[package]]
+name = "icu_collections"
+version = "2.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fa68d21081c4a05d5a901a1c62add574c77048b6a1c67be3b50ce0b60d4ca513"
+dependencies = [
+ "displaydoc",
+ "potential_utf",
+ "utf8_iter",
+ "yoke",
+ "zerofrom",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_locale_core"
+version = "2.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d56e28588da92eee5c3201a6eff33fabdd49b62269c8938d4ff050ce4d900deb"
+dependencies = [
+ "displaydoc",
+ "litemap",
+ "tinystr",
+ "writeable",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_normalizer"
+version = "2.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "12f9cf5f235641ed274641dd81c3f28d870e276763d0797aeeab72317b1c646f"
+dependencies = [
+ "icu_collections",
+ "icu_normalizer_data",
+ "icu_properties",
+ "icu_provider",
+ "smallvec",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_normalizer_data"
+version = "2.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1563da1ed3e0b3bf3d74c9b85917ac9c56464d2f57242270c09c9e752f8021a0"
+
+[[package]]
+name = "icu_properties"
+version = "2.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7e7ca276ad3145661a65914e6daf131ca5120cd3dcee8f8f3214b8875184a148"
+dependencies = [
+ "displaydoc",
+ "icu_collections",
+ "icu_locale_core",
+ "icu_properties_data",
+ "icu_provider",
+ "zerotrie",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_properties_data"
+version = "2.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e590f038c1464a96894fd6d10127e90a8be4509f56ff7ecef851b15cee0b7caa"
+
+[[package]]
+name = "icu_provider"
+version = "2.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d27bbb9d3abbefac45d55f647c9de1d44aafcd1186eb91879afef17c396c3e73"
+dependencies = [
+ "displaydoc",
+ "icu_locale_core",
+ "writeable",
+ "yoke",
+ "zerofrom",
+ "zerotrie",
+ "zerovec",
+]
+
+[[package]]
+name = "idna"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"
+dependencies = [
+ "idna_adapter",
+ "smallvec",
+ "utf8_iter",
+]
+
+[[package]]
+name = "idna_adapter"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb68373c0d6620ef8105e855e7745e18b0d00d3bdb07fb532e434244cdb9a714"
+dependencies = [
+ "icu_normalizer",
+ "icu_properties",
+]
+
+[[package]]
+name = "indexmap"
+version = "2.14.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cc4e190f5d26ca7051642629da2c52fc03bde85a03197c99408dcd291734c855"
+dependencies = [
+ "equivalent",
+ "hashbrown",
+]
+
+[[package]]
+name = "ipnet"
+version = "2.12.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "791930b43c0d5973160d90a8f3894509f2b273430f5c5c73b668636d0287c5c0"
+
+[[package]]
+name = "itoa"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
+
+[[package]]
+name = "js-sys"
+version = "0.3.105"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ce57d20d1ea864ce2ac172ab472d409214f4fd359f0b2a2775abdf522e2af99e"
+dependencies = [
+ "cfg-if",
+ "futures-util",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "lazy_static"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+
+[[package]]
+name = "libc"
+version = "0.2.189"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
+
+[[package]]
+name = "linux-raw-sys"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a66949e030da00e8c7d4434b251670a91556f4144941d37452769c25d58a53"
+
+[[package]]
+name = "litemap"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "47d9d19d1d6efa0109d2f65ff4c85cddd50bd572e5a00127ab10987290bcefae"
+
+[[package]]
+name = "lock_api"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "224399e74b87b5f3557511d98dff8b14089b3dadafcab6bb93eab67d3aace965"
+dependencies = [
+ "scopeguard",
+]
+
+[[package]]
+name = "log"
+version = "0.4.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f9f8bd3e56ce4dfc153cf470fffbfa98c7620958b312ca5c3a4b8d5181fd13c6"
+
+[[package]]
+name = "lru-slab"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "112b39cec0b298b6c1999fee3e31427f74f676e4cb9879ed1a121b43661a4154"
+
+[[package]]
+name = "matchers"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d1525a2a28c7f4fa0fc98bb91ae755d1e2d1505079e05539e35bc876b5d65ae9"
+dependencies = [
+ "regex-automata",
+]
+
+[[package]]
+name = "matchit"
+version = "0.7.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0e7465ac9959cc2b1404e8e2367b43684a6d13790fe23056cc8c6c5a6b7bcb94"
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "meta-feeder-sdk"
+version = "0.1.0"
+source = "git+https://github.com/worph/meta-feeder-sdk?tag=v1.2.1#60c4e855a56fbcbf873bbf0e37a434f27a1ec499"
+dependencies = [
+ "anyhow",
+ "async-trait",
+ "axum",
+ "base64",
+ "bytes",
+ "futures",
+ "hyper",
+ "redb",
+ "regex",
+ "reqwest",
+ "serde",
+ "serde_json",
+ "sha2",
+ "thiserror 1.0.69",
+ "tokio",
+ "tracing",
+]
+
+[[package]]
+name = "mime"
+version = "0.3.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a"
+
+[[package]]
+name = "mio"
+version = "1.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4b18443e9c262bfe8fa82f51666e2642c53393f7e5c27b3e1aeab922cff5b9d8"
+dependencies = [
+ "libc",
+ "wasi",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "nu-ansi-term"
+version = "0.50.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7957b9740744892f114936ab4a57b3f487491bbeafaf8083688b16841a4240e5"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "num_cpus"
+version = "1.17.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91df4bbde75afed763b708b7eee1e8e7651e02d97f6d5dd763e89367e957b23b"
+dependencies = [
+ "hermit-abi",
+ "libc",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "opensubtitles-feeder"
+version = "0.1.0"
+dependencies = [
+ "anyhow",
+ "async-trait",
+ "axum",
+ "meta-feeder-sdk",
+ "reqwest",
+ "serde",
+ "serde_json",
+ "tempfile",
+ "tokio",
+ "tracing",
+ "tracing-subscriber",
+ "wiremock",
+]
+
+[[package]]
+name = "parking_lot"
+version = "0.12.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93857453250e3077bd71ff98b6a65ea6621a19bb0f559a85248955ac12c45a1a"
+dependencies = [
+ "lock_api",
+ "parking_lot_core",
+]
+
+[[package]]
+name = "parking_lot_core"
+version = "0.9.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2621685985a2ebf1c516881c026032ac7deafcda1a2c9b7850dc81e3dfcb64c1"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "redox_syscall",
+ "smallvec",
+ "windows-link",
+]
+
+[[package]]
+name = "percent-encoding"
+version = "2.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
+
+[[package]]
+name = "pin-project-lite"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
+
+[[package]]
+name = "potential_utf"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d83eb9bc6d8e5cf568e7a1101d60ee05e81ed50ea106026f3d18deeb046d7661"
+dependencies = [
+ "zerovec",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quinn"
+version = "0.11.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c1a41e437b6bbd489372cd4971de128e85c855f56c57f283d20ff016cf7c0a8"
+dependencies = [
+ "bytes",
+ "cfg_aliases",
+ "pin-project-lite",
+ "quinn-proto",
+ "quinn-udp",
+ "rustc-hash",
+ "rustls",
+ "socket2",
+ "thiserror 2.0.20",
+ "tokio",
+ "tracing",
+ "web-time",
+]
+
+[[package]]
+name = "quinn-proto"
+version = "0.11.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04759210543be93709136e28212294a659ef5001836ff4eab4d663e4529bba83"
+dependencies = [
+ "bytes",
+ "getrandom 0.4.3",
+ "lru-slab",
+ "rand",
+ "rand_pcg",
+ "ring",
+ "rustc-hash",
+ "rustls",
+ "rustls-pki-types",
+ "slab",
+ "thiserror 2.0.20",
+ "tinyvec",
+ "tracing",
+ "web-time",
+]
+
+[[package]]
+name = "quinn-udp"
+version = "0.5.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "35a133f956daabe89a61a685c2649f13d82d5aa4bd5d12d1277e1072a21c0694"
+dependencies = [
+ "cfg_aliases",
+ "libc",
+ "once_cell",
+ "socket2",
+ "tracing",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "r-efi"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8dcc9c7d52a811697d2151c701e0d08956f92b0e24136cf4cf27b57a6a0d9bf"
+
+[[package]]
+name = "rand"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c7f5fa3a058cd35567ef9bfa5e75732bee0f9e4c55fa90477bef2dfcdbc4be80"
+dependencies = [
+ "chacha20",
+ "getrandom 0.4.3",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63b8176103e19a2643978565ca18b50549f6101881c443590420e4dc998a3c69"
+
+[[package]]
+name = "rand_pcg"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "caa0f4137e1c0a72f4c651489402276c8e8e1cf081f3b0ba156d2cbeef09e86a"
+dependencies = [
+ "rand_core",
+]
+
+[[package]]
+name = "redb"
+version = "2.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8eca1e9d98d5a7e9002d0013e18d5a9b000aee942eb134883a82f06ebffb6c01"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "redox_syscall"
+version = "0.5.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
+dependencies = [
+ "bitflags",
+]
+
+[[package]]
+name = "regex"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f020237b6c8eed93db2e2cb53c00c60a8e1bc73da7d073199a1180401450218d"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ad8553b9b26413251cbf30e620595c7a41b3887f03da04579c0e6b0d6a06b4b2"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
+
+[[package]]
+name = "reqwest"
+version = "0.12.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eddd3ca559203180a307f12d114c268abf583f59b03cb906fd0b3ff8646c1147"
+dependencies = [
+ "base64",
+ "bytes",
+ "futures-core",
+ "futures-util",
+ "http",
+ "http-body",
+ "http-body-util",
+ "hyper",
+ "hyper-rustls",
+ "hyper-util",
+ "js-sys",
+ "log",
+ "percent-encoding",
+ "pin-project-lite",
+ "quinn",
+ "rustls",
+ "rustls-pki-types",
+ "serde",
+ "serde_json",
+ "serde_urlencoded",
+ "sync_wrapper",
+ "tokio",
+ "tokio-rustls",
+ "tokio-util",
+ "tower",
+ "tower-http",
+ "tower-service",
+ "url",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "wasm-streams",
+ "web-sys",
+ "webpki-roots",
+]
+
+[[package]]
+name = "ring"
+version = "0.17.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7"
+dependencies = [
+ "cc",
+ "cfg-if",
+ "getrandom 0.2.17",
+ "libc",
+ "untrusted",
+ "windows-sys 0.52.0",
+]
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
+[[package]]
+name = "rustix"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6fe4565b9518b83ef4f91bb47ce29620ca828bd32cb7e408f0062e9930ba190"
+dependencies = [
+ "bitflags",
+ "errno",
+ "libc",
+ "linux-raw-sys",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "rustls"
+version = "0.23.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6725596c3f2c3a0aef021139e145d4eafe314a6623e4680ca83852b2c67ab2ba"
+dependencies = [
+ "once_cell",
+ "ring",
+ "rustls-pki-types",
+ "rustls-webpki",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "rustls-pki-types"
+version = "1.15.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2f4925028c7eb5d1fcdaf196971378ed9d2c1c4efc7dc5d011256f76c99c0a96"
+dependencies = [
+ "web-time",
+ "zeroize",
+]
+
+[[package]]
+name = "rustls-webpki"
+version = "0.103.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f3c3cf1d8b1e7d4927e2d154c3fcb02979afb9939629c62cd9048d4f07b60ac2"
+dependencies = [
+ "ring",
+ "rustls-pki-types",
+ "untrusted",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
+
+[[package]]
+name = "ryu"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9774ba4a74de5f7b1c1451ed6cd5285a32eddb5cccb8cc655a4e50009e06477f"
+
+[[package]]
+name = "scopeguard"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
+
+[[package]]
+name = "serde"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.229"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.151"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c841b55ecdae098c80dcae9cf767f6f8a0c2cdb3416bbef72181df4d0fe73f14"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "serde_path_to_error"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "10a9ff822e371bb5403e391ecd83e182e0e77ba7f6fe0160b795797109d1b457"
+dependencies = [
+ "itoa",
+ "serde",
+ "serde_core",
+]
+
+[[package]]
+name = "serde_urlencoded"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd"
+dependencies = [
+ "form_urlencoded",
+ "itoa",
+ "ryu",
+ "serde",
+]
+
+[[package]]
+name = "sha2"
+version = "0.10.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283"
+dependencies = [
+ "cfg-if",
+ "cpufeatures 0.2.17",
+ "digest",
+]
+
+[[package]]
+name = "sharded-slab"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f40ca3c46823713e0d4209592e8d6e826aa57e928f09752619fc696c499637f6"
+dependencies = [
+ "lazy_static",
+]
+
+[[package]]
+name = "shlex"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
+
+[[package]]
+name = "signal-hook-registry"
+version = "1.4.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c4db69cba1110affc0e9f7bcd48bbf87b3f4fc7c61fc9155afd4c469eb3d6c1b"
+dependencies = [
+ "errno",
+ "libc",
+]
+
+[[package]]
+name = "slab"
+version = "0.4.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
+
+[[package]]
+name = "smallvec"
+version = "1.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba467056f1b547ed52077911161fc86985becbc60e8e1857c8a144dab0def891"
+
+[[package]]
+name = "socket2"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3d1e2c7f27f8d4cb10542a02c49005dbd6e93095799d6f3be745fae9f8fedd4"
+dependencies = [
+ "libc",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "stable_deref_trait"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
+
+[[package]]
+name = "subtle"
+version = "2.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "syn"
+version = "3.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "12df2e0110f65b775f769bb17ef989067a1d931b2eb822bd4346631eeada89f9"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "sync_wrapper"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0bf256ce5efdfa370213c1dabab5935a12e49f2c58d15e9eac2870d3b4f27263"
+dependencies = [
+ "futures-core",
+]
+
+[[package]]
+name = "synstructure"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "tempfile"
+version = "3.27.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32497e9a4c7b38532efcdebeef879707aa9f794296a4f0244f6f69e9bc8574bd"
+dependencies = [
+ "fastrand",
+ "getrandom 0.4.3",
+ "once_cell",
+ "rustix",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "thiserror"
+version = "1.0.69"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6aaf5339b578ea85b50e080feb250a3e8ae8cfcdff9a461c9ec2904bc923f52"
+dependencies = [
+ "thiserror-impl 1.0.69",
+]
+
+[[package]]
+name = "thiserror"
+version = "2.0.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec86235f5fcc2a73650310756d2ac5b138a5780bbbdfae3eeccec992c435ba4f"
+dependencies = [
+ "thiserror-impl 2.0.20",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "1.0.69"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bc04cd3e1236dd4a98afca4569f2deb3f120e5422a4023be2cb683f8486292af"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "thread_local"
+version = "1.1.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ad99c4c6d32803332c548b1af0540b357b3f5fc0be8f6c6bfe8b2e6ae784070"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "tinystr"
+version = "0.8.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b1e27c91459209c2986af3dcf603a5a74a4368754ce37414f59acc971167f643"
+dependencies = [
+ "displaydoc",
+ "zerovec",
+]
+
+[[package]]
+name = "tinyvec"
+version = "1.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4cf0ded5c4e56918d8f8a339e1bb67d038d3bc6d144ac407904015ba2e4cde9b"
+dependencies = [
+ "tinyvec_macros",
+]
+
+[[package]]
+name = "tinyvec_macros"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"
+
+[[package]]
+name = "tokio"
+version = "1.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "202caea871b69668250d242070849eb495be178ed697a3e98aebce5bc81a0bed"
+dependencies = [
+ "bytes",
+ "libc",
+ "mio",
+ "parking_lot",
+ "pin-project-lite",
+ "signal-hook-registry",
+ "socket2",
+ "tokio-macros",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "tokio-macros"
+version = "2.7.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78773a2a397f451582ce068015985c33193cf6dea8b74d2a639fe457b2f07b0e"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "tokio-rustls"
+version = "0.26.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b0c85f2c3ef0b1cd58b36682f4b17aaa995f0e5db534d85692b4903abce21f67"
+dependencies = [
+ "rustls",
+ "tokio",
+]
+
+[[package]]
+name = "tokio-util"
+version = "0.7.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "494815d09bf52b5548659851081238f0ca39ff638363907596da739561c62c52"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "futures-sink",
+ "libc",
+ "pin-project-lite",
+ "tokio",
+]
+
+[[package]]
+name = "tower"
+version = "0.5.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ebe5ef63511595f1344e2d5cfa636d973292adc0eec1f0ad45fae9f0851ab1d4"
+dependencies = [
+ "futures-core",
+ "futures-util",
+ "pin-project-lite",
+ "sync_wrapper",
+ "tokio",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+
+[[package]]
+name = "tower-http"
+version = "0.6.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4cfcf7e2740e6fc6d4d688b4ef00650406bb94adf4731e43c096c3a19fe40840"
+dependencies = [
+ "bitflags",
+ "bytes",
+ "futures-util",
+ "http",
+ "http-body",
+ "pin-project-lite",
+ "tower",
+ "tower-layer",
+ "tower-service",
+ "url",
+]
+
+[[package]]
+name = "tower-layer"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "121c2a6cda46980bb0fcd1647ffaf6cd3fc79a013de288782836f6df9c48780e"
+
+[[package]]
+name = "tower-service"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8df9b6e13f2d32c91b9bd719c00d1958837bc7dec474d94952798cc8e69eeec3"
+
+[[package]]
+name = "tracing"
+version = "0.1.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63e71662fa4b2a2c3a26f570f037eb95bb1f85397f3cd8076caed2f026a6d100"
+dependencies = [
+ "log",
+ "pin-project-lite",
+ "tracing-attributes",
+ "tracing-core",
+]
+
+[[package]]
+name = "tracing-attributes"
+version = "0.1.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7490cfa5ec963746568740651ac6781f701c9c5ea257c58e057f3ba8cf69e8da"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
+[[package]]
+name = "tracing-core"
+version = "0.1.36"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "db97caf9d906fbde555dd62fa95ddba9eecfd14cb388e4f491a66d74cd5fb79a"
+dependencies = [
+ "once_cell",
+ "valuable",
+]
+
+[[package]]
+name = "tracing-log"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ee855f1f400bd0e5c02d150ae5de3840039a3f54b025156404e34c23c03f47c3"
+dependencies = [
+ "log",
+ "once_cell",
+ "tracing-core",
+]
+
+[[package]]
+name = "tracing-subscriber"
+version = "0.3.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb7f578e5945fb242538965c2d0b04418d38ec25c79d160cd279bf0731c8d319"
+dependencies = [
+ "matchers",
+ "nu-ansi-term",
+ "once_cell",
+ "regex-automata",
+ "sharded-slab",
+ "smallvec",
+ "thread_local",
+ "tracing",
+ "tracing-core",
+ "tracing-log",
+]
+
+[[package]]
+name = "try-lock"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b"
+
+[[package]]
+name = "typenum"
+version = "1.20.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "untrusted"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1"
+
+[[package]]
+name = "url"
+version = "2.5.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff67a8a4397373c3ef660812acab3268222035010ab8680ec4215f38ba3d0eed"
+dependencies = [
+ "form_urlencoded",
+ "idna",
+ "percent-encoding",
+ "serde",
+]
+
+[[package]]
+name = "utf8_iter"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
+
+[[package]]
+name = "valuable"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba73ea9cf16a25df0c8caa16c51acb937d5712a8429db78a3ee29d5dcacd3a65"
+
+[[package]]
+name = "version_check"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
+
+[[package]]
+name = "want"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfa7760aed19e106de2c7c0b581b509f2f25d3dacaf737cb82ac61bc6d760b0e"
+dependencies = [
+ "try-lock",
+]
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "wasm-bindgen"
+version = "0.2.128"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "aecb87a33d3b0c5e3b7aa46336eaf486cffafbd281b195e4c8b80d50df2351bf"
+dependencies = [
+ "cfg-if",
+ "once_cell",
+ "rustversion",
+ "wasm-bindgen-macro",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-futures"
+version = "0.4.78"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ef4c5d3d2cdf5c54f4231181768f5510842e350db025faf1f7163b1030ed928"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "wasm-bindgen-macro"
+version = "0.2.128"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a690d511e3c1a8b3a55e33511e3c2c00c78415cd23650f32b808627f5696b9ed"
+dependencies = [
+ "quote",
+ "wasm-bindgen-macro-support",
+]
+
+[[package]]
+name = "wasm-bindgen-macro-support"
+version = "0.2.128"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "411e4887f0071ef2d2164a9d5fdf2d20efbef78fccd3a78b0c10a1dc5295e48a"
+dependencies = [
+ "bumpalo",
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-shared"
+version = "0.2.128"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "81941cd78d0c92026c33e5e01312845a4cb1e9af3407f9134b100dd03144103e"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "wasm-streams"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "15053d8d85c7eccdbefef60f06769760a563c7f0a9d6902a13d35c7800b0ad65"
+dependencies = [
+ "futures-util",
+ "js-sys",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+]
+
+[[package]]
+name = "web-sys"
+version = "0.3.105"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9fbddc4a036f00ec4f18c83445bd3115cb306a91da554919a099d9222fe4a7f8"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "web-time"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5a6580f308b1fad9207618087a65c04e7a10bc77e02c8e84e9b00dd4b12fa0bb"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "webpki-roots"
+version = "1.0.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7dcd9d09a39985f5344844e66b0c530a33843579125f23e21e9f0f220850f22a"
+dependencies = [
+ "rustls-pki-types",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-sys"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
+dependencies = [
+ "windows-targets",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
+dependencies = [
+ "windows_aarch64_gnullvm",
+ "windows_aarch64_msvc",
+ "windows_i686_gnu",
+ "windows_i686_gnullvm",
+ "windows_i686_msvc",
+ "windows_x86_64_gnu",
+ "windows_x86_64_gnullvm",
+ "windows_x86_64_msvc",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
+
+[[package]]
+name = "wiremock"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08db1edfb05d9b3c1542e521aea074442088292f00b5f28e435c714a98f85031"
+dependencies = [
+ "assert-json-diff",
+ "base64",
+ "deadpool",
+ "futures",
+ "http",
+ "http-body-util",
+ "hyper",
+ "hyper-util",
+ "log",
+ "once_cell",
+ "regex",
+ "serde",
+ "serde_json",
+ "tokio",
+ "url",
+]
+
+[[package]]
+name = "writeable"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ad82d2a33cdc9674dc7465672f271e096168fcdbe0f799d9e6db8c5892679dc"
+
+[[package]]
+name = "yoke"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "709fe23a0424b6a435d82152b1bd3fdfb0833487d5fa90d05d42762a9891fef5"
+dependencies = [
+ "stable_deref_trait",
+ "yoke-derive",
+ "zerofrom",
+]
+
+[[package]]
+name = "yoke-derive"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "de844c262c8848816172cef550288e7dc6c7b7814b4ee56b3e1553f275f1858e"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+ "synstructure",
+]
+
+[[package]]
+name = "zerofrom"
+version = "0.1.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ec05a11813ea801ff6d75110ad09cd0824ddba17dfe17128ea0d5f68e6c5272"
+dependencies = [
+ "zerofrom-derive",
+]
+
+[[package]]
+name = "zerofrom-derive"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "11532158c46691caf0f2593ea8358fed6bbf68a0315e80aae9bd41fbade684a1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+ "synstructure",
+]
+
+[[package]]
+name = "zeroize"
+version = "1.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e13c156562582aa81c60cb29407084cdb54c4164760106ab78e6c5b0858cf64e"
+
+[[package]]
+name = "zerotrie"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ea269c3bd32f0a32c321907a2ae912ba6f4649bb0fc764a15627e99a7095a3f"
+dependencies = [
+ "displaydoc",
+ "yoke",
+ "zerofrom",
+]
+
+[[package]]
+name = "zerovec"
+version = "0.11.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bb0464e17806c1d976d5cba29399c7f08e516e279e2ba493f63123b5fca67dd8"
+dependencies = [
+ "yoke",
+ "zerofrom",
+ "zerovec-derive",
+]
+
+[[package]]
+name = "zerovec-derive"
+version = "0.11.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34df6fc39dbd26ddc9c10e6a2984476e13acce22e64e4487636ef494369225da"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 3.0.5",
+]
+
+[[package]]
+name = "zmij"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"
diff --git a/Cargo.toml b/Cargo.toml
new file mode 100644
index 0000000..c2f44a7
--- /dev/null
+++ b/Cargo.toml
@@ -0,0 +1,9 @@
+[workspace]
+resolver = "2"
+members = ["feeder-plugin/*"]
+
+[workspace.package]
+edition = "2021"
+rust-version = "1.85"
+license = "MIT"
+repository = "https://github.com/worph/meta-feeder-opensubtitles"
diff --git a/README.md b/README.md
index 6f776fe..97cf805 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,72 @@
-# meta-feeder-opensubtitles
\ No newline at end of file
+# meta-feeder-opensubtitles
+
+Gateway feeder that answers **subtitle searches** from
+[OpenSubtitles](https://www.opensubtitles.com). It is a *feeder* (it answers
+gateway queries), not a meta-sort *plugin*. The enrichment plugin that attaches
+subtitles to local files is the separate `metamesh-plugin-opensubtitle`. See
+`docs/project-architecture/plugins-vs-feeders.md` in the meta-root.
+
+**Search only.** Nothing is downloaded, so the account's download quota is never
+spent. Each result is one subtitle **file** addressed by a `provider-file`
+locator (`0x100A`, `docs/cid-formats.md` §8) that embeds
+`("opensubtitles", "file:<file_id>")`. Retrieving the bytes is meta-share's job.
+
+## Queries
+
+Only queries that explicitly ask for `fileType:subtitle` are answered.
+
+| Shape | Example | Upstream call |
+|---|---|---|
+| keyword | `matrix fileType:subtitle` | `query=matrix` |
+| movie anchor | `imdbid:tt0133093 fileType:subtitle` | `imdb_id=133093` |
+| episode anchor | `tmdbid:1399 season:1 episode:1 fileType:subtitle` | `parent_tmdb_id=1399&season_number=1&episode_number=1` |
+| file hash | `moviehash:8e245d9679d31e12 fileType:subtitle` | `moviehash=…` |
+
+- **Language narrowing:** any shape can add `languages:fre` (ISO 639-2/B; `fra` and `fr` are accepted too).
+- **Unanswerable queries** never reach OpenSubtitles: a query with nothing to search on, one with a content kind or domain, or one naming only languages OpenSubtitles doesn't have.
+
+## Records
+
+One record per subtitle file:
+- **Type and address:** `fileType=subtitle`, and a `cids/<provider-file cid>` member. The gateway only persists records that carry a cid.
+- **Identity:** `opensubtitlesid`, `source/gateway:opensubtitles`.
+- **Descriptive:** `title`, `fileName`, `extension` (only when the file name has a real subtitle suffix).
+- **Language:** `subtitleLanguage` and `languages/<lang3>`, using ISO 639-2/B codes.
+- **Work ids:** `imdbid`, `tmdbid`, `season`, `episode`, `movieYear`. Episodes carry the **show's** ids.
+- **Ranking signals:** `downloadCount`, `moviehashMatch`, `hearingImpaired`, `machineTranslated`.
+
+There is no `contentKind` and no `domain`, because a subtitle is a sidecar. Results come back hash matches first, then by download count.
+
+## Configuration
+
+| Setting | Config page key | Env seed |
+|---|---|---|
+| API key (required) | `apiKey` | `OPENSUBTITLES_API_KEY` |
+| User-Agent (`App vX.Y`) | `userAgent` | `OPENSUBTITLES_USER_AGENT` |
+
+The config page (`/config`) wins over env. Changes apply on restart. Without a key
+the feeder stays up, reports degraded on `/health`, and answers nothing.
+
+Also `META_FEEDER_HTTP_LISTEN` (default `0.0.0.0:8080`), `META_FEEDER_STATE_DIR`
+(default `/data/meta-feeder`), and `RUST_LOG`.
+
+Rate limiting: 4 req/s with a burst of 4. OpenSubtitles serves
+`x-ratelimit-limit-second: 5`. Searches are cached for 24 h.
+
+## Build and test
+
+No local cargo is needed. Run from the repo root with a named target volume (a
+bind-mounted target is too slow on the WSL mount):
+
+```bash
+docker run --rm -e RUSTUP_TOOLCHAIN=1.89.0 \
+  -v "$PWD":/build -v osfeeder-target:/build/target \
+  -v feeder-cargo-registry:/usr/local/cargo/registry -v osfeeder-cargo-git:/usr/local/cargo/git \
+  -w /build rust:1.89-slim-bookworm sh -c \
+  'apt-get update -qq && apt-get install -y -qq --no-install-recommends pkg-config libssl-dev ca-certificates git >/dev/null; cargo test'
+
+docker build -f feeder-plugin/opensubtitles-feeder/Dockerfile -t meta-feeder-opensubtitles:dev .
+```
+
+`tests/contract.rs` drives the real SDK router against a wiremock OpenSubtitles,
+using fixtures captured from the live API.
diff --git a/feeder-plugin/opensubtitles-feeder/Cargo.toml b/feeder-plugin/opensubtitles-feeder/Cargo.toml
new file mode 100644
index 0000000..1b2f0ed
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/Cargo.toml
@@ -0,0 +1,39 @@
+[package]
+name = "opensubtitles-feeder"
+version = "0.1.0"
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+publish = false
+
+# OpenSubtitles subtitle search. Answers `fileType:subtitle` queries — keyword
+# and id-anchored — with `provider-file` (0x100A) locator records. Search only:
+# no download, no quota spend. Retrieval is meta-share's job.
+
+[lib]
+name = "opensubtitles_feeder"
+path = "src/lib.rs"
+
+[[bin]]
+name = "opensubtitles-feeder"
+path = "src/main.rs"
+
+[dependencies]
+# Pinned by TAG, never by path. A path dep resolves OUTSIDE this repo, and this
+# repo is the Docker build context — see meta-feeder-anilist's manifest.
+meta-feeder-sdk = { git = "https://github.com/worph/meta-feeder-sdk", tag = "v1.2.1" }
+
+tokio = { version = "1.40", features = ["full"] }
+axum = { version = "0.7", features = ["json"] }
+anyhow = "1"
+async-trait = "0.1"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+reqwest = { version = "0.12", features = ["json", "rustls-tls"], default-features = false }
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter", "fmt"] }
+
+[dev-dependencies]
+wiremock = "0.6"
+tempfile = "3"
+tokio = { version = "1.40", features = ["full", "test-util"] }
diff --git a/feeder-plugin/opensubtitles-feeder/Dockerfile b/feeder-plugin/opensubtitles-feeder/Dockerfile
new file mode 100644
index 0000000..4986ef1
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/Dockerfile
@@ -0,0 +1,44 @@
+# syntax=docker/dockerfile:1
+# opensubtitles-feeder sidecar. Multi-stage build; build context is this repo's root.
+# meta-feeder-sdk arrives as a git dependency, so no vendored crate is copied
+# in — `git` must be present in the builder for cargo to fetch it.
+
+FROM rust:1.89-slim-bookworm AS builder
+WORKDIR /build
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        pkg-config libssl-dev ca-certificates git \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY Cargo.toml rust-toolchain.toml ./
+COPY feeder-plugin/ feeder-plugin/
+
+RUN --mount=type=cache,id=cargo-registry,target=/usr/local/cargo/registry \
+    --mount=type=cache,id=cargo-git,target=/usr/local/cargo/git \
+    --mount=type=cache,id=opensubtitles-feeder-target,target=/build/target \
+    cargo build --release --bin opensubtitles-feeder \
+    && cp target/release/opensubtitles-feeder /opensubtitles-feeder
+
+# -----------------------------------------------------------------------------
+FROM debian:bookworm-slim AS runtime
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        ca-certificates curl \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /opensubtitles-feeder /usr/local/bin/opensubtitles-feeder
+
+RUN useradd --system --uid 10001 --no-create-home metafeeder \
+    && mkdir -p /data/meta-feeder \
+    && chown metafeeder:metafeeder /data/meta-feeder
+
+USER metafeeder
+WORKDIR /data/meta-feeder
+
+EXPOSE 8080
+
+ENV META_FEEDER_HTTP_LISTEN=0.0.0.0:8080 \
+    META_FEEDER_STATE_DIR=/data/meta-feeder \
+    RUST_LOG=info
+
+ENTRYPOINT ["/usr/local/bin/opensubtitles-feeder"]
diff --git a/feeder-plugin/opensubtitles-feeder/src/client.rs b/feeder-plugin/opensubtitles-feeder/src/client.rs
new file mode 100644
index 0000000..1a89f0e
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/src/client.rs
@@ -0,0 +1,390 @@
+//! OpenSubtitles REST v1 search client — `GET /subtitles` only.
+//!
+//! Search is free: OpenSubtitles meters `/download`, which this feeder never
+//! calls. What *is* limited is the request rate (5/s, measured), hence the
+//! shared [`RateBudget`].
+//!
+//! ⚠ **OpenSubtitles 301s any query string that is not in its canonical form**
+//! (keys sorted, values lowercased). Redirects are disabled on this client, so
+//! a drift in [`SearchParams::to_pairs`] surfaces as a loud `Permanent` error
+//! instead of a silent extra round-trip per search.
+
+use std::sync::Arc;
+use std::time::{Duration, SystemTime, UNIX_EPOCH};
+
+use meta_feeder_sdk::budget::{Lease, RateBudget};
+use meta_feeder_sdk::cache::{search_key, MidhashCache};
+use meta_feeder_sdk::common::{build_http_client, map_status};
+use meta_feeder_sdk::types::GatewayError;
+use serde::{Deserialize, Deserializer};
+use tracing::debug;
+
+use crate::consts::{HTTP_TIMEOUT_SECS, SEARCH_CACHE_TTL_SECS, SEARCH_DEADLINE_SECS};
+
+/// One search, already resolved from a gateway query.
+#[derive(Debug, Clone, Default, PartialEq, Eq)]
+pub struct SearchParams {
+    /// Free text (`query=`).
+    pub query: Option<String>,
+    /// IMDb id, numeric (the `tt` prefix stripped).
+    pub imdb_id: Option<u64>,
+    pub tmdb_id: Option<u64>,
+    pub season: Option<u64>,
+    pub episode: Option<u64>,
+    pub year: Option<u64>,
+    /// 16-hex OpenSubtitles moviehash, lowercase.
+    pub moviehash: Option<String>,
+    /// OpenSubtitles language codes (`fr`, `pt-br`).
+    pub languages: Vec<&'static str>,
+}
+
+impl SearchParams {
+    /// A season or episode makes the ids **show** ids, sent as `parent_*`.
+    /// (A live probe returns identical results for `tmdb_id` and
+    /// `parent_tmdb_id` on a show, but `parent_*` is the documented form.)
+    pub fn is_episode(&self) -> bool {
+        self.season.is_some() || self.episode.is_some()
+    }
+
+    /// Nothing to search on. Never send this: OpenSubtitles would answer with
+    /// an arbitrary listing.
+    pub fn is_unbounded(&self) -> bool {
+        self.query.is_none()
+            && self.imdb_id.is_none()
+            && self.tmdb_id.is_none()
+            && self.moviehash.is_none()
+    }
+
+    /// Query parameters in OpenSubtitles' canonical form: keys sorted, values
+    /// lowercased, language list sorted and de-duplicated.
+    pub fn to_pairs(&self) -> Vec<(&'static str, String)> {
+        let episode = self.is_episode();
+        let mut pairs: Vec<(&'static str, String)> = Vec::new();
+        if let Some(e) = self.episode {
+            pairs.push(("episode_number", e.to_string()));
+        }
+        if let Some(id) = self.imdb_id {
+            pairs.push((if episode { "parent_imdb_id" } else { "imdb_id" }, id.to_string()));
+        }
+        if !self.languages.is_empty() {
+            let mut langs = self.languages.clone();
+            langs.sort_unstable();
+            langs.dedup();
+            pairs.push(("languages", langs.join(",")));
+        }
+        if let Some(h) = &self.moviehash {
+            pairs.push(("moviehash", h.to_ascii_lowercase()));
+        }
+        if let Some(id) = self.tmdb_id {
+            pairs.push((if episode { "parent_tmdb_id" } else { "tmdb_id" }, id.to_string()));
+        }
+        if let Some(q) = &self.query {
+            pairs.push(("query", q.to_lowercase()));
+        }
+        if let Some(s) = self.season {
+            pairs.push(("season_number", s.to_string()));
+        }
+        if let Some(y) = self.year {
+            pairs.push(("year", y.to_string()));
+        }
+        pairs.sort_by(|a, b| a.0.cmp(b.0));
+        pairs
+    }
+}
+
+/// `k=v&…` with values percent-encoded, except `,` (the language list
+/// separator) and space as `+`. Built by hand rather than with
+/// `RequestBuilder::query` so the exact bytes OpenSubtitles canonicalises
+/// against are under test.
+pub fn encode_query(pairs: &[(&'static str, String)]) -> String {
+    pairs
+        .iter()
+        .map(|(k, v)| format!("{k}={}", encode_value(v)))
+        .collect::<Vec<_>>()
+        .join("&")
+}
+
+fn encode_value(v: &str) -> String {
+    let mut out = String::with_capacity(v.len());
+    for b in v.bytes() {
+        match b {
+            b'A'..=b'Z' | b'a'..=b'z' | b'0'..=b'9' | b'-' | b'.' | b'_' | b'~' | b',' => {
+                out.push(b as char)
+            }
+            b' ' => out.push('+'),
+            _ => out.push_str(&format!("%{b:02X}")),
+        }
+    }
+    out
+}
+
+// --- response shape ---------------------------------------------------------
+//
+// Every field is optional and numbers are parsed leniently: one odd value in
+// one row must not fail the whole page.
+
+#[derive(Debug, Clone, Default, Deserialize)]
+pub struct SearchResponse {
+    #[serde(default)]
+    pub data: Vec<OsSubtitle>,
+}
+
+#[derive(Debug, Clone, Default, Deserialize)]
+pub struct OsSubtitle {
+    #[serde(default)]
+    pub attributes: OsAttributes,
+}
+
+#[derive(Debug, Clone, Default, Deserialize)]
+#[serde(default)]
+pub struct OsAttributes {
+    pub language: Option<String>,
+    pub release: Option<String>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub download_count: Option<u64>,
+    /// Present only on a `moviehash` search.
+    pub moviehash_match: Option<bool>,
+    pub hearing_impaired: Option<bool>,
+    pub ai_translated: Option<bool>,
+    pub machine_translated: Option<bool>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub nb_cd: Option<u64>,
+    pub feature_details: Option<FeatureDetails>,
+    pub files: Vec<OsFile>,
+}
+
+#[derive(Debug, Clone, Default, Deserialize)]
+#[serde(default)]
+pub struct FeatureDetails {
+    /// `Movie` | `Episode` | `Tvshow`.
+    pub feature_type: Option<String>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub year: Option<u64>,
+    pub title: Option<String>,
+    /// Display name, e.g. `Game of Thrones - S01E01  Winter Is Coming`.
+    pub movie_name: Option<String>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub imdb_id: Option<u64>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub tmdb_id: Option<u64>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub season_number: Option<u64>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub episode_number: Option<u64>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub parent_imdb_id: Option<u64>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub parent_tmdb_id: Option<u64>,
+    pub parent_title: Option<String>,
+}
+
+#[derive(Debug, Clone, Default, Deserialize)]
+#[serde(default)]
+pub struct OsFile {
+    #[serde(deserialize_with = "lenient_u64")]
+    pub file_id: Option<u64>,
+    #[serde(deserialize_with = "lenient_u64")]
+    pub cd_number: Option<u64>,
+    pub file_name: Option<String>,
+}
+
+fn lenient_u64<'de, D: Deserializer<'de>>(d: D) -> Result<Option<u64>, D::Error> {
+    let v = Option::<serde_json::Value>::deserialize(d)?;
+    Ok(match v {
+        Some(serde_json::Value::Number(n)) => n.as_u64().or_else(|| {
+            n.as_f64()
+                .filter(|f| *f >= 0.0 && f.fract() == 0.0)
+                .map(|f| f as u64)
+        }),
+        Some(serde_json::Value::String(s)) => s.trim().parse().ok(),
+        _ => None,
+    })
+}
+
+// --- cache ------------------------------------------------------------------
+
+fn cache_key(pairs: &[(&'static str, String)]) -> String {
+    search_key("os-subtitles", &encode_query(pairs))
+}
+
+fn now_secs() -> u64 {
+    SystemTime::now()
+        .duration_since(UNIX_EPOCH)
+        .map(|d| d.as_secs())
+        .unwrap_or(0)
+}
+
+fn cache_entry(body: &str, fetched_at: u64) -> String {
+    serde_json::json!({ "fetchedAt": fetched_at, "body": body }).to_string()
+}
+
+/// The cached body if the entry is younger than `ttl_secs`.
+fn fresh_body(entry: &str, now: u64, ttl_secs: u64) -> Option<String> {
+    let v: serde_json::Value = serde_json::from_str(entry).ok()?;
+    let fetched_at = v.get("fetchedAt")?.as_u64()?;
+    if now.saturating_sub(fetched_at) > ttl_secs {
+        return None;
+    }
+    v.get("body")?.as_str().map(str::to_string)
+}
+
+// --- client -----------------------------------------------------------------
+
+pub struct OsClient {
+    http: reqwest::Client,
+    api_base: String,
+    api_key: String,
+    budget: Arc<RateBudget>,
+    cache: Option<MidhashCache>,
+}
+
+impl OsClient {
+    pub fn new(
+        api_base: String,
+        api_key: String,
+        user_agent: &str,
+        budget: Arc<RateBudget>,
+        cache: Option<MidhashCache>,
+    ) -> Self {
+        let http = build_http_client(
+            HTTP_TIMEOUT_SECS,
+            user_agent,
+            Some(reqwest::redirect::Policy::none()),
+        );
+        Self {
+            http,
+            api_base: api_base.trim_end_matches('/').to_string(),
+            api_key,
+            budget,
+            cache,
+        }
+    }
+
+    pub async fn search(&self, params: &SearchParams) -> Result<Vec<OsSubtitle>, GatewayError> {
+        let pairs = params.to_pairs();
+        let key = cache_key(&pairs);
+
+        if let Some(cache) = &self.cache {
+            if let Ok(Some(entry)) = cache.get_misc(&key) {
+                if let Some(body) = fresh_body(&entry, now_secs(), SEARCH_CACHE_TTL_SECS) {
+                    if let Ok(parsed) = serde_json::from_str::<SearchResponse>(&body) {
+                        debug!(target: "opensubtitles", %key, "search cache hit");
+                        return Ok(parsed.data);
+                    }
+                }
+            }
+        }
+
+        if matches!(
+            self.budget.acquire(Duration::from_secs(SEARCH_DEADLINE_SECS)).await,
+            Lease::DeadlineExceeded
+        ) {
+            // Transient, not Permanent: busy is not broken.
+            return Err(GatewayError::Transient(
+                "opensubtitles: rate budget deadline exceeded".into(),
+            ));
+        }
+
+        let url = format!("{}/subtitles?{}", self.api_base, encode_query(&pairs));
+        let resp = self
+            .http
+            .get(&url)
+            .header("Api-Key", &self.api_key)
+            .header(reqwest::header::ACCEPT, "application/json")
+            .send()
+            .await
+            .map_err(|e| GatewayError::Transient(format!("opensubtitles: {e}")))?;
+
+        // 429 carries Retry-After; freeze the whole bucket, not just this caller.
+        // A 301 (non-canonical query) lands here as Permanent — see the module doc.
+        if let Err(e) = map_status(&resp) {
+            if let GatewayError::RateLimited { retry_after_s } = &e {
+                self.budget
+                    .note_throttled(Duration::from_secs(u64::from(*retry_after_s)));
+            }
+            return Err(e);
+        }
+
+        let body = resp
+            .text()
+            .await
+            .map_err(|e| GatewayError::Transient(format!("opensubtitles: {e}")))?;
+        let parsed: SearchResponse = serde_json::from_str(&body)
+            .map_err(|e| GatewayError::Transient(format!("opensubtitles: bad json: {e}")))?;
+
+        if let Some(cache) = &self.cache {
+            let _ = cache.put_misc(&key, &cache_entry(&body, now_secs()));
+        }
+        Ok(parsed.data)
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn pairs_are_sorted_and_lowercased() {
+        let p = SearchParams {
+            query: Some("The Matrix".into()),
+            imdb_id: Some(133093),
+            year: Some(1999),
+            languages: vec!["pt-br", "fr", "fr"],
+            moviehash: Some("8E245D9679D31E12".into()),
+            ..Default::default()
+        };
+        assert_eq!(
+            encode_query(&p.to_pairs()),
+            "imdb_id=133093&languages=fr,pt-br&moviehash=8e245d9679d31e12&query=the+matrix&year=1999"
+        );
+    }
+
+    #[test]
+    fn episode_ids_are_sent_as_parent_ids() {
+        let p = SearchParams {
+            tmdb_id: Some(1399),
+            imdb_id: Some(944947),
+            season: Some(1),
+            episode: Some(1),
+            ..Default::default()
+        };
+        assert_eq!(
+            encode_query(&p.to_pairs()),
+            "episode_number=1&parent_imdb_id=944947&parent_tmdb_id=1399&season_number=1"
+        );
+    }
+
+    #[test]
+    fn unbounded_means_no_text_no_id_no_hash() {
+        assert!(SearchParams::default().is_unbounded());
+        let langs_only = SearchParams { languages: vec!["fr"], ..Default::default() };
+        assert!(langs_only.is_unbounded());
+        let text = SearchParams { query: Some("matrix".into()), ..Default::default() };
+        assert!(!text.is_unbounded());
+    }
+
+    #[test]
+    fn value_encoding_escapes_everything_but_unreserved_and_comma() {
+        assert_eq!(encode_value("léon: the professional"), "l%C3%A9on%3A+the+professional");
+    }
+
+    #[test]
+    fn cache_entries_expire() {
+        let entry = cache_entry("{\"data\":[]}", 1_000);
+        assert_eq!(fresh_body(&entry, 1_000 + 10, 60).as_deref(), Some("{\"data\":[]}"));
+        assert_eq!(fresh_body(&entry, 1_000 + 61, 60), None);
+        assert_eq!(fresh_body("garbage", 0, 60), None);
+    }
+
+    #[test]
+    fn lenient_numbers_survive_odd_upstream_values() {
+        let a: OsAttributes = serde_json::from_str(
+            r#"{"download_count":"42","nb_cd":null,"files":[{"file_id":7.0,"cd_number":"x"}]}"#,
+        )
+        .unwrap();
+        assert_eq!(a.download_count, Some(42));
+        assert_eq!(a.nb_cd, None);
+        assert_eq!(a.files[0].file_id, Some(7));
+        assert_eq!(a.files[0].cd_number, None);
+    }
+}
diff --git a/feeder-plugin/opensubtitles-feeder/src/consts.rs b/feeder-plugin/opensubtitles-feeder/src/consts.rs
new file mode 100644
index 0000000..5caf74a
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/src/consts.rs
@@ -0,0 +1,37 @@
+//! Tunables, each with the reason for its value.
+
+/// OpenSubtitles REST API v1 base.
+pub(crate) const OS_API_BASE: &str = "https://api.opensubtitles.com/api/v1";
+
+/// `upstream_id` of the one plugin this feeder hosts, and the `source` token
+/// inside every `provider-file` locator it mints.
+pub const UPSTREAM_ID: &str = "opensubtitles";
+
+/// Provenance label (`source/<label>`, METADATA_KEYS §5).
+pub(crate) const SOURCE_LABEL: &str = "gateway:opensubtitles";
+
+/// OpenSubtitles rejects anonymous clients: it wants a named app in `App vX.Y`
+/// form. Overridable, because the key's registered app name is what they check.
+pub(crate) const DEFAULT_USER_AGENT: &str =
+    concat!("meta-feeder-opensubtitles v", env!("CARGO_PKG_VERSION"));
+
+/// ⚠ **5 requests per second, measured, not guessed.** A live search returns
+/// `x-ratelimit-limit-second: 5` (2026-09-12). 4/s with a burst of 4 stays under
+/// it with room for another client sharing the key.
+pub(crate) const OS_RATE_PER_SEC: f64 = 4.0;
+pub(crate) const OS_BURST: f64 = 4.0;
+
+/// How long a search waits for a rate-budget lease. Someone is watching a
+/// spinner, so it may queue, but not past the gateway's own patience.
+pub(crate) const SEARCH_DEADLINE_SECS: u64 = 20;
+
+/// HTTP timeout for a single upstream call.
+pub(crate) const HTTP_TIMEOUT_SECS: u64 = 20;
+
+/// Search results are cached, but not forever: a listing keeps gaining uploads
+/// and download counts, and download count is half of the ranking.
+pub(crate) const SEARCH_CACHE_TTL_SECS: u64 = 24 * 60 * 60;
+
+/// Env seeds; the config page's saved values win over them.
+pub(crate) const ENV_API_KEY: &str = "OPENSUBTITLES_API_KEY";
+pub(crate) const ENV_USER_AGENT: &str = "OPENSUBTITLES_USER_AGENT";
diff --git a/feeder-plugin/opensubtitles-feeder/src/lang.rs b/feeder-plugin/opensubtitles-feeder/src/lang.rs
new file mode 100644
index 0000000..551b58c
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/src/lang.rs
@@ -0,0 +1,145 @@
+//! OpenSubtitles language codes ↔ the stack's ISO 639-2/B vocabulary.
+//!
+//! ⚠ **The stack compares 639-2/B (`fre`, `ger`, `chi`), not 639-3 (`fra`).**
+//! `meta_feeder_sdk::lang::normalize_lang_code` normalises onto it, torznab
+//! writes `languages/fre`, and meta-search's language prefs store `fre`.
+//! `languages_filter_matches` compares strings, so a record stamped `fra` is
+//! *dropped* by a `languages:fre` query — a concrete, non-matching language.
+//! (METADATA_KEYS.md still says 639-3 for `languages/*`; the code is what bites.)
+//!
+//! OpenSubtitles speaks its own dialect: mostly 639-1, plus region tags
+//! (`pt-br`, `zh-tw`) and a few private codes (`ze` Chinese bilingual, `sp`/`ea`
+//! Spanish EU/LA, `pm` Portuguese MZ). Responses use mixed case (`pt-BR`).
+
+use meta_feeder_sdk::lang::normalize_lang_code;
+
+/// Every `language_code` from `GET /api/v1/infos/languages` (105 entries,
+/// fetched 2026-09-12) → ISO 639-2/B. Codes with no 639-2 entry use 639-3
+/// (`ast`, `ext`, `cnr`, `tok`), which `normalize_lang_code` passes through.
+const OS_TO_639_2B: &[(&str, &str)] = &[
+    ("ab", "abk"), ("af", "afr"), ("sq", "alb"), ("am", "amh"), ("ar", "ara"),
+    ("an", "arg"), ("hy", "arm"), ("as", "asm"), ("at", "ast"), ("az-az", "aze"),
+    ("eu", "baq"), ("be", "bel"), ("bn", "ben"), ("bs", "bos"), ("br", "bre"),
+    ("bg", "bul"), ("my", "bur"), ("ca", "cat"), ("ze", "chi"), ("zh-ca", "chi"),
+    ("zh-cn", "chi"), ("zh-tw", "chi"), ("hr", "hrv"), ("cs", "cze"), ("da", "dan"),
+    ("pr", "per"), ("nl", "dut"), ("en", "eng"), ("eo", "epo"), ("et", "est"),
+    ("ex", "ext"), ("fi", "fin"), ("fr", "fre"), ("gd", "gla"), ("gl", "glg"),
+    ("ka", "geo"), ("de", "ger"), ("el", "gre"), ("he", "heb"), ("hi", "hin"),
+    ("hu", "hun"), ("is", "ice"), ("ig", "ibo"), ("id", "ind"), ("ia", "ina"),
+    ("ga", "gle"), ("it", "ita"), ("ja", "jpn"), ("kn", "kan"), ("kk", "kaz"),
+    ("km", "khm"), ("ko", "kor"), ("ku", "kur"), ("lv", "lav"), ("lt", "lit"),
+    ("lb", "ltz"), ("mk", "mac"), ("ms", "may"), ("ml", "mal"), ("ma", "mni"),
+    ("mr", "mar"), ("mn", "mon"), ("me", "cnr"), ("nv", "nav"), ("ne", "nep"),
+    ("se", "sme"), ("no", "nor"), ("oc", "oci"), ("or", "ori"), ("fa", "per"),
+    ("pl", "pol"), ("pt-pt", "por"), ("pt-br", "por"), ("pm", "por"), ("ps", "pus"),
+    ("ro", "rum"), ("ru", "rus"), ("sx", "sat"), ("sr", "srp"), ("sd", "snd"),
+    ("si", "sin"), ("sk", "slo"), ("sl", "slv"), ("so", "som"), ("az-zb", "aze"),
+    ("es", "spa"), ("sp", "spa"), ("ea", "spa"), ("sw", "swa"), ("sv", "swe"),
+    ("sy", "syr"), ("tl", "tgl"), ("ta", "tam"), ("tt", "tat"), ("te", "tel"),
+    ("tm-td", "tet"), ("th", "tha"), ("tp", "tok"), ("tr", "tur"), ("tk", "tuk"),
+    ("uk", "ukr"), ("ur", "urd"), ("uz", "uzb"), ("vi", "vie"), ("cy", "wel"),
+];
+
+/// 639-2/T → 639-2/B for the table's codes that `normalize_lang_code` does not
+/// already fold (it covers `fra`/`deu`/`zho`/`nld`/`ell`/`ron`/`slk`/`ces`).
+const T_TO_B: &[(&str, &str)] = &[
+    ("sqi", "alb"), ("hye", "arm"), ("eus", "baq"), ("mya", "bur"), ("kat", "geo"),
+    ("isl", "ice"), ("mkd", "mac"), ("msa", "may"), ("fas", "per"), ("cym", "wel"),
+];
+
+/// Canonical 639-2/B for any spelling a query or response might carry: 639-2/B,
+/// 639-2/T, 639-1, or an OpenSubtitles code. `None` when nothing maps.
+fn canonical(code: &str) -> Option<String> {
+    let c = code.trim().to_ascii_lowercase();
+    if c.is_empty() {
+        return None;
+    }
+    if let Some((_, b)) = T_TO_B.iter().find(|(t, _)| *t == c) {
+        return Some((*b).to_string());
+    }
+    if let Some((_, b)) = OS_TO_639_2B.iter().find(|(os, _)| *os == c) {
+        return Some((*b).to_string());
+    }
+    let n = normalize_lang_code(&c);
+    if n.len() == 3 && n.bytes().all(|b| b.is_ascii_lowercase()) && n != "und" {
+        return Some(n);
+    }
+    // A region-tagged spelling the table does not list (`en-us`): try the
+    // primary subtag once.
+    let primary = c.split(['-', '_']).next().unwrap_or("");
+    if primary != c && !primary.is_empty() {
+        return canonical(primary);
+    }
+    None
+}
+
+/// A subtitle's `language` from a search response → the code stamped on the
+/// record (`subtitleLanguage`, `languages/<code>`). `None` for unknown input:
+/// METADATA_KEYS says `und` is never written — an unknown language is simply
+/// absent, which `languages:` filters treat as "may match".
+pub fn from_os_code(code: &str) -> Option<String> {
+    canonical(code)
+}
+
+/// A query's `languages:` value → every OpenSubtitles code that denotes it,
+/// sorted (`por` → `pm`, `pt-br`, `pt-pt`). Empty when the language is unknown
+/// to OpenSubtitles.
+pub fn to_os_codes(lang: &str) -> Vec<&'static str> {
+    let Some(b) = canonical(lang) else {
+        return Vec::new();
+    };
+    let mut codes: Vec<&'static str> = OS_TO_639_2B
+        .iter()
+        .filter(|(_, x)| *x == b)
+        .map(|(os, _)| *os)
+        .collect();
+    codes.sort_unstable();
+    codes
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn table_is_the_full_opensubtitles_list_with_unique_codes() {
+        assert_eq!(OS_TO_639_2B.len(), 105);
+        let mut os: Vec<_> = OS_TO_639_2B.iter().map(|(o, _)| *o).collect();
+        os.sort_unstable();
+        os.dedup();
+        assert_eq!(os.len(), 105);
+    }
+
+    /// Every code the table emits must survive the SDK normaliser unchanged,
+    /// or records and `languages:` filters would disagree.
+    #[test]
+    fn emitted_codes_are_fixed_points_of_the_sdk_normaliser() {
+        for (_, b) in OS_TO_639_2B {
+            assert_eq!(normalize_lang_code(b), *b, "{b}");
+            assert_eq!(canonical(b).as_deref(), Some(*b), "{b}");
+        }
+    }
+
+    #[test]
+    fn response_codes_map_to_639_2b() {
+        assert_eq!(from_os_code("fr").as_deref(), Some("fre"));
+        assert_eq!(from_os_code("pt-BR").as_deref(), Some("por"));
+        assert_eq!(from_os_code("zh-TW").as_deref(), Some("chi"));
+        assert_eq!(from_os_code("fa").as_deref(), Some("per"));
+        assert_eq!(from_os_code("en-US").as_deref(), Some("eng"));
+        assert_eq!(from_os_code(""), None);
+        assert_eq!(from_os_code("xx"), None);
+        assert_eq!(from_os_code("und"), None);
+    }
+
+    #[test]
+    fn query_codes_accept_every_spelling() {
+        assert_eq!(to_os_codes("fre"), vec!["fr"]);
+        assert_eq!(to_os_codes("fra"), vec!["fr"]);
+        assert_eq!(to_os_codes("fr"), vec!["fr"]);
+        assert_eq!(to_os_codes("FAS"), vec!["fa", "pr"]);
+        assert_eq!(to_os_codes("por"), vec!["pm", "pt-br", "pt-pt"]);
+        assert_eq!(to_os_codes("spa"), vec!["ea", "es", "sp"]);
+        assert!(to_os_codes("zzz").is_empty());
+    }
+}
diff --git a/feeder-plugin/opensubtitles-feeder/src/lib.rs b/feeder-plugin/opensubtitles-feeder/src/lib.rs
new file mode 100644
index 0000000..f1b0b1a
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/src/lib.rs
@@ -0,0 +1,23 @@
+//! `opensubtitles-feeder` — subtitle search over OpenSubtitles.
+//!
+//! A **sidecar** tier: it answers "which subtitles exist for X", never "give me
+//! the bytes". Each result is one subtitle *file*, addressed by a
+//! `provider-file` locator (`0x100A`, `docs/cid-formats.md` §8) that embeds
+//! `("opensubtitles", "file:<file_id>")`. meta-share resolves that locator later;
+//! nothing here downloads, so searching never spends the account's download quota.
+//!
+//! ## The contracts that must not drift
+//!
+//! - The locator bytes ([`locator`]), pinned by the golden vector in
+//!   `cid-formats.md` §8.2.
+//! - Every record carries a `cids/` member. The gateway persists only records
+//!   with a cid, and its search-coverage skip is only sound for persisted records.
+//! - Language codes are ISO 639-2/B (`fre`, not `fra`) — the vocabulary
+//!   `meta_feeder_sdk::lang::normalize_lang_code` and every `languages:` filter use.
+
+pub mod client;
+pub mod consts;
+pub mod lang;
+pub mod locator;
+pub mod plugin;
+pub mod record;
diff --git a/feeder-plugin/opensubtitles-feeder/src/locator.rs b/feeder-plugin/opensubtitles-feeder/src/locator.rs
new file mode 100644
index 0000000..2fb43c1
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/src/locator.rs
@@ -0,0 +1,215 @@
+//! The `provider-file` locator (`0x100A`) — `docs/cid-formats.md` §8.
+//!
+//! One codec for every provider whose bytes are fetched the same way; the
+//! provider lives inside the digest:
+//!
+//! ```text
+//! version   : 1
+//! codec     : 0x100A                             (varint 8a 20)
+//! multihash : 0x00                               (identity — payload verbatim)
+//! digest    : varint(len(source)) ‖ source ‖ id  (both UTF-8, ≤ 64 bytes)
+//! ```
+//!
+//! The framing is byte-identical to `card` (`0x1007`) — only the codec differs —
+//! which is why the tests below re-derive the existing `card-locator` vector
+//! with the same encoder.
+//!
+//! ⚠ **This is a local copy.** The SDK's framing helpers (`kinded_locator_cid`,
+//! `write_pb_varint`, `base32_lower_no_padding`) are private, so it could not be
+//! reused. Move it into `meta-feeder-sdk` as `encode_source_id_locator(codec,
+//! source, id)` (§8 trap 7) and delete this file; the golden vectors are what
+//! prove the move changed no bytes.
+
+use crate::consts::UPSTREAM_ID;
+
+/// Custom multicodec for a fetchable `(source, id)` locator.
+pub const PROVIDER_FILE_CODEC: u64 = 0x100A;
+
+/// meta-share's `MAX_MULTIHASH_SIZE` — its `CidGeneric<64>` rejects a longer
+/// multihash, so a longer digest would mint a CID no peer can parse.
+const MAX_DIGEST_BYTES: usize = 64;
+
+/// The locator for one OpenSubtitles **file** (`/download` takes a `file_id`;
+/// one subtitle listing can hold several files, one per CD).
+pub fn file_cid(file_id: u64) -> Option<String> {
+    provider_file_cid(UPSTREAM_ID, &format!("file:{file_id}"))
+}
+
+/// Encode a `provider-file` CID. `None` when the digest would exceed 64 bytes —
+/// the caller drops that row rather than emit an unparseable address.
+pub fn provider_file_cid(source: &str, id: &str) -> Option<String> {
+    source_id_locator(PROVIDER_FILE_CODEC, source, id)
+}
+
+/// Inverse of [`provider_file_cid`]: `(source, id)`, or `None` for anything that
+/// is not exactly a well-formed `0x100A` CID. Matches the **codec slot** — a
+/// `card` CID has the same framing and must not decode here.
+pub fn decode_provider_file_cid(cid: &str) -> Option<(String, String)> {
+    let wire = base32_lower_no_pad_decode(cid.strip_prefix('b')?)?;
+    let mut pos = 0;
+    if read_varint(&wire, &mut pos)? != 1 {
+        return None;
+    }
+    if read_varint(&wire, &mut pos)? != PROVIDER_FILE_CODEC {
+        return None;
+    }
+    if read_varint(&wire, &mut pos)? != 0x00 {
+        return None;
+    }
+    let len = read_varint(&wire, &mut pos)? as usize;
+    let digest = wire.get(pos..)?;
+    if digest.len() != len {
+        return None;
+    }
+    let mut dpos = 0;
+    let source_len = read_varint(digest, &mut dpos)? as usize;
+    let source = digest.get(dpos..dpos.checked_add(source_len)?)?;
+    let id = digest.get(dpos + source_len..)?;
+    Some((
+        String::from_utf8(source.to_vec()).ok()?,
+        String::from_utf8(id.to_vec()).ok()?,
+    ))
+}
+
+fn source_id_locator(codec: u64, source: &str, id: &str) -> Option<String> {
+    let source = source.as_bytes();
+    let id = id.as_bytes();
+
+    // identity-multihash digest = varint(source_len) ‖ source ‖ id
+    let mut digest = Vec::with_capacity(2 + source.len() + id.len());
+    write_varint(source.len() as u64, &mut digest);
+    digest.extend_from_slice(source);
+    digest.extend_from_slice(id);
+    if digest.len() > MAX_DIGEST_BYTES {
+        return None;
+    }
+
+    // CIDv1: [version=0x01][codec varint][mh code=0x00 identity][len varint][digest]
+    let mut wire = Vec::with_capacity(6 + digest.len());
+    wire.push(0x01);
+    write_varint(codec, &mut wire);
+    wire.push(0x00);
+    write_varint(digest.len() as u64, &mut wire);
+    wire.extend_from_slice(&digest);
+    Some(format!("b{}", base32_lower_no_pad(&wire)))
+}
+
+fn write_varint(mut value: u64, out: &mut Vec<u8>) {
+    loop {
+        let byte = (value & 0x7f) as u8;
+        value >>= 7;
+        if value == 0 {
+            out.push(byte);
+            return;
+        }
+        out.push(byte | 0x80);
+    }
+}
+
+fn read_varint(bytes: &[u8], pos: &mut usize) -> Option<u64> {
+    let mut value = 0u64;
+    let mut shift = 0u32;
+    loop {
+        let byte = *bytes.get(*pos)?;
+        *pos += 1;
+        value |= u64::from(byte & 0x7f) << shift;
+        if byte & 0x80 == 0 {
+            return Some(value);
+        }
+        shift += 7;
+        if shift >= 64 {
+            return None;
+        }
+    }
+}
+
+const BASE32_ALPHABET: &[u8; 32] = b"abcdefghijklmnopqrstuvwxyz234567";
+
+fn base32_lower_no_pad(input: &[u8]) -> String {
+    let mut out = String::with_capacity((input.len() * 8).div_ceil(5));
+    let mut acc = 0u64;
+    let mut bits = 0u32;
+    for &byte in input {
+        acc = (acc << 8) | u64::from(byte);
+        bits += 8;
+        while bits >= 5 {
+            bits -= 5;
+            out.push(BASE32_ALPHABET[((acc >> bits) & 31) as usize] as char);
+        }
+        acc &= (1u64 << bits) - 1;
+    }
+    if bits > 0 {
+        out.push(BASE32_ALPHABET[((acc << (5 - bits)) & 31) as usize] as char);
+    }
+    out
+}
+
+fn base32_lower_no_pad_decode(input: &str) -> Option<Vec<u8>> {
+    let mut out = Vec::with_capacity(input.len() * 5 / 8);
+    let mut acc = 0u64;
+    let mut bits = 0u32;
+    for c in input.bytes() {
+        let v = match c {
+            b'a'..=b'z' => c - b'a',
+            b'2'..=b'7' => c - b'2' + 26,
+            _ => return None,
+        };
+        acc = (acc << 5) | u64::from(v);
+        bits += 5;
+        if bits >= 8 {
+            bits -= 8;
+            out.push((acc >> bits) as u8);
+            acc &= (1u64 << bits) - 1;
+        }
+    }
+    Some(out)
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    /// The same framing under `card`'s codec reproduces the existing
+    /// `card-locator` golden vector — proof the encoder is the family's framing,
+    /// not a look-alike.
+    #[test]
+    fn framing_reproduces_the_card_locator_vector() {
+        assert_eq!(
+            source_id_locator(0x1007, "tmdb", "tv:95479").as_deref(),
+            Some("bagdsaaanar2g2zdcor3duojvgq3ts")
+        );
+        assert_eq!(
+            source_id_locator(0x1008, "video", "4D7u5KF7SP8").as_deref(),
+            Some("bagecaaarav3gszdfn42ein3vgvfumn2tka4a")
+        );
+    }
+
+    /// `docs/cid-formats.md` §8.2 worked example.
+    #[test]
+    fn file_cid_matches_the_documented_vector() {
+        assert_eq!(
+            file_cid(7061834).as_deref(),
+            Some("bagfcaaa2bvxxazloon2we5djorwgk43gnfwgkorxga3dcobtgq")
+        );
+    }
+
+    #[test]
+    fn decode_round_trips_and_refuses_other_codecs() {
+        let cid = file_cid(12658754).unwrap();
+        assert_eq!(
+            decode_provider_file_cid(&cid),
+            Some(("opensubtitles".to_string(), "file:12658754".to_string()))
+        );
+        // Identical framing, different codec: a card must not decode as a file.
+        assert_eq!(decode_provider_file_cid("bagdsaaanar2g2zdcor3duojvgq3ts"), None);
+        assert_eq!(decode_provider_file_cid("not-a-cid"), None);
+        assert_eq!(decode_provider_file_cid(""), None);
+    }
+
+    #[test]
+    fn digest_ceiling_is_64_bytes() {
+        // varint(13) + "opensubtitles" = 14 bytes, so the id may use 50.
+        assert!(provider_file_cid("opensubtitles", &"x".repeat(50)).is_some());
+        assert!(provider_file_cid("opensubtitles", &"x".repeat(51)).is_none());
+    }
+}
diff --git a/feeder-plugin/opensubtitles-feeder/src/main.rs b/feeder-plugin/opensubtitles-feeder/src/main.rs
new file mode 100644
index 0000000..8e36032
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/src/main.rs
@@ -0,0 +1,35 @@
+//! `opensubtitles-feeder` — the OpenSubtitles subtitle search feeder.
+//!
+//! Serves `fileType:subtitle`. Needs an OpenSubtitles API key (config page or
+//! `OPENSUBTITLES_API_KEY`); without one it stays registered but degraded and
+//! answers every query with nothing.
+//!
+//! Env:
+//! - `META_FEEDER_HTTP_LISTEN`  — listen addr (default `0.0.0.0:8080`)
+//! - `META_FEEDER_STATE_DIR`    — per-plugin cache root (default `/data/meta-feeder`)
+//! - `OPENSUBTITLES_API_KEY`    — seed API key (the config page overrides it)
+//! - `OPENSUBTITLES_USER_AGENT` — seed User-Agent (OpenSubtitles wants `App vX.Y`)
+//! - `RUST_LOG`                 — tracing filter (default `info`)
+
+use std::net::SocketAddr;
+
+use meta_feeder_sdk::plugin::FeederPlugin;
+use meta_feeder_sdk::serve_feeders;
+use opensubtitles_feeder::plugin::OpenSubtitlesPlugin;
+use tracing_subscriber::EnvFilter;
+
+#[tokio::main]
+async fn main() -> anyhow::Result<()> {
+    tracing_subscriber::fmt()
+        .with_env_filter(EnvFilter::try_from_default_env().unwrap_or_else(|_| EnvFilter::new("info")))
+        .init();
+
+    let listen: SocketAddr = std::env::var("META_FEEDER_HTTP_LISTEN")
+        .unwrap_or_else(|_| "0.0.0.0:8080".to_string())
+        .parse()?;
+    let state_dir =
+        std::env::var("META_FEEDER_STATE_DIR").unwrap_or_else(|_| "/data/meta-feeder".to_string());
+
+    let plugins: Vec<Box<dyn FeederPlugin>> = vec![Box::new(OpenSubtitlesPlugin::from_env())];
+    serve_feeders(plugins, state_dir, listen).await
+}
diff --git a/feeder-plugin/opensubtitles-feeder/src/plugin.rs b/feeder-plugin/opensubtitles-feeder/src/plugin.rs
new file mode 100644
index 0000000..8ce4e6b
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/src/plugin.rs
@@ -0,0 +1,381 @@
+//! `OpenSubtitlesPlugin` — the `FeederPlugin` for `fileType:subtitle`.
+//!
+//! Two query shapes, both answered; which one to send is the client's call:
+//!
+//! - **keyword** — `matrix fileType:subtitle` → `query=matrix`
+//! - **anchored** — any of `imdbid:` `tmdbid:` `season:` `episode:`
+//!   `movieYear:` `moviehash:`, e.g. `tmdbid:1399 season:1 episode:1 fileType:subtitle`
+//!
+//! plus an optional `languages:` narrowing on either.
+
+use std::path::Path;
+
+use async_trait::async_trait;
+use meta_feeder_sdk::budget::RateBudget;
+use meta_feeder_sdk::common::open_midhash_cache;
+use meta_feeder_sdk::config::{ConfigField as F, ConfigSchema};
+use meta_feeder_sdk::plugin::{ConfigError, FeederPlugin, HashOutcome};
+use meta_feeder_sdk::query::GatewayQuery;
+use meta_feeder_sdk::query_eval::query_accepts_plugin;
+use meta_feeder_sdk::types::{DiscoveryRecord, GatewayError, PluginHealth};
+use serde::{Deserialize, Serialize};
+use tracing::{debug, warn};
+
+use crate::client::{OsClient, SearchParams};
+use crate::consts::{
+    DEFAULT_USER_AGENT, ENV_API_KEY, ENV_USER_AGENT, OS_API_BASE, OS_BURST, OS_RATE_PER_SEC,
+    UPSTREAM_ID,
+};
+use crate::lang::to_os_codes;
+use crate::record::project;
+
+/// Keys match [`FeederPlugin::config_schema`], which is what the SDK writes to
+/// `config.json` from the dashboard.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+struct OsConfig {
+    #[serde(default, rename = "apiKey")]
+    api_key: String,
+    #[serde(default, rename = "userAgent")]
+    user_agent: String,
+}
+
+pub struct OpenSubtitlesPlugin {
+    config: OsConfig,
+    api_base: String,
+    /// `None` until `configure` runs, and stays `None` without an API key — the
+    /// soft-skip path: `/health` says why, queries return nothing.
+    client: Option<OsClient>,
+}
+
+impl OpenSubtitlesPlugin {
+    /// Production constructor: env seeds, real endpoint.
+    pub fn from_env() -> Self {
+        Self {
+            config: OsConfig {
+                api_key: std::env::var(ENV_API_KEY).unwrap_or_default(),
+                user_agent: std::env::var(ENV_USER_AGENT).unwrap_or_default(),
+            },
+            api_base: OS_API_BASE.to_string(),
+            client: None,
+        }
+    }
+
+    /// Test constructor: a fixed key and an endpoint override (wiremock).
+    pub fn with_api_base(api_key: &str, api_base: String) -> Self {
+        Self {
+            config: OsConfig {
+                api_key: api_key.to_string(),
+                user_agent: String::new(),
+            },
+            api_base,
+            client: None,
+        }
+    }
+
+    /// File wins over env, like every other feeder: `config.json` in the
+    /// per-plugin cache dir, read at `configure` time. No hot reload.
+    fn load_config(&mut self, cache_dir: &Path) {
+        let Ok(bytes) = std::fs::read(cache_dir.join("config.json")) else {
+            return;
+        };
+        let Ok(file_cfg) = serde_json::from_slice::<OsConfig>(&bytes) else {
+            warn!(target: "opensubtitles", "config.json is not valid; keeping env seeds");
+            return;
+        };
+        if !file_cfg.api_key.trim().is_empty() {
+            self.config.api_key = file_cfg.api_key;
+        }
+        if !file_cfg.user_agent.trim().is_empty() {
+            self.config.user_agent = file_cfg.user_agent;
+        }
+    }
+}
+
+/// Axes a sidecar never carries (METADATA_KEYS.md §1).
+const NON_SIDECAR_AXES: &[&str] = &["contentKind", "domain", "workForm"];
+
+/// True when the query explicitly asks for subtitles, and for nothing a
+/// subtitle record can't carry.
+///
+/// - `query_accepts_plugin` alone admits a query with no type filter at all, and
+///   a query that never mentioned subtitles is not a subtitle question.
+/// - ⚠ It also checks only the `fileType` / `contentKind` axes. A `domain:` or
+///   `workForm:` filter is a wall or row query that no subtitle record can
+///   satisfy (`record_matches` drops every row lacking the key). The gateway
+///   rewrites `domain:` into `contentKind:` on its own dispatch path, but a
+///   direct `/query` sees the raw filter and would spend an upstream call on a
+///   guaranteed-empty answer — the live smoke run returned 10 rows for
+///   `domain:screen` before this check existed.
+fn requests_subtitles(query: &GatewayQuery) -> bool {
+    if NON_SIDECAR_AXES.iter().any(|k| query.filters.contains_key(*k)) {
+        return false;
+    }
+    ["fileType", "type"].iter().any(|k| {
+        query
+            .filters
+            .get(*k)
+            .is_some_and(|vs| vs.iter().any(|v| v.eq_ignore_ascii_case("subtitle")))
+    })
+}
+
+fn first_filter<'a>(query: &'a GatewayQuery, key: &str) -> Option<&'a str> {
+    query
+        .filters
+        .get(key)
+        .and_then(|vs| vs.iter().map(|v| v.trim()).find(|v| !v.is_empty()))
+}
+
+fn parse_u64(v: Option<&str>) -> Option<u64> {
+    v.and_then(|s| s.trim().parse().ok())
+}
+
+/// Resolve a gateway query into one OpenSubtitles search. `None` means "no
+/// upstream call can answer this": nothing to search on, or a `languages:`
+/// filter naming only languages OpenSubtitles does not have.
+pub fn search_params(query: &GatewayQuery) -> Option<SearchParams> {
+    let mut p = SearchParams {
+        query: Some(query.free_text.trim())
+            .filter(|s| !s.is_empty())
+            .map(str::to_string),
+        imdb_id: first_filter(query, "imdbid").and_then(|v| {
+            let digits = v
+                .strip_prefix("tt")
+                .or_else(|| v.strip_prefix("TT"))
+                .unwrap_or(v);
+            digits.parse().ok()
+        }),
+        tmdb_id: parse_u64(first_filter(query, "tmdbid")),
+        season: parse_u64(first_filter(query, "season")),
+        episode: parse_u64(first_filter(query, "episode")),
+        year: parse_u64(first_filter(query, "movieYear")),
+        moviehash: first_filter(query, "moviehash")
+            .filter(|h| h.len() == 16 && h.bytes().all(|b| b.is_ascii_hexdigit()))
+            .map(str::to_ascii_lowercase),
+        languages: Vec::new(),
+    };
+
+    if let Some(values) = query.filters.get("languages") {
+        p.languages = values
+            .iter()
+            .flat_map(|v| v.split(','))
+            .flat_map(to_os_codes)
+            .collect();
+        if p.languages.is_empty() {
+            // The client asked for languages we cannot express. Searching
+            // without the filter would return only rows `record_matches` drops.
+            return None;
+        }
+    }
+
+    (!p.is_unbounded()).then_some(p)
+}
+
+fn rank_key(r: &DiscoveryRecord) -> (bool, u64) {
+    (
+        r.fields.get("moviehashMatch").is_some_and(|v| v == "true"),
+        r.fields
+            .get("downloadCount")
+            .and_then(|v| v.parse().ok())
+            .unwrap_or(0),
+    )
+}
+
+#[async_trait]
+impl FeederPlugin for OpenSubtitlesPlugin {
+    fn upstream_id(&self) -> &'static str {
+        UPSTREAM_ID
+    }
+
+    /// ⚠ `subtitle` only, and **no content kinds**: a subtitle is a sidecar
+    /// with no `contentKind`/`domain` (METADATA_KEYS.md §1), so a wall or row
+    /// query (`domain:screen`, `contentKind:movie`) is correctly not routed here.
+    fn served_file_types(&self) -> &'static [&'static str] {
+        &["subtitle"]
+    }
+
+    fn served_content_kinds(&self) -> &'static [&'static str] {
+        &[]
+    }
+
+    fn configure(&mut self, cache_dir: &Path) -> Result<(), ConfigError> {
+        self.load_config(cache_dir);
+        let api_key = self.config.api_key.trim().to_string();
+        if api_key.is_empty() {
+            warn!(
+                target: "opensubtitles",
+                "no OpenSubtitles API key (config page or {ENV_API_KEY}); subtitle searches return nothing"
+            );
+            return Ok(());
+        }
+        let cache = open_midhash_cache(cache_dir, UPSTREAM_ID)?;
+        let user_agent = match self.config.user_agent.trim() {
+            "" => DEFAULT_USER_AGENT,
+            ua => ua,
+        };
+        self.client = Some(OsClient::new(
+            self.api_base.clone(),
+            api_key,
+            user_agent,
+            RateBudget::new(OS_RATE_PER_SEC, OS_BURST),
+            Some(cache),
+        ));
+        Ok(())
+    }
+
+    fn health(&self) -> PluginHealth {
+        if self.client.is_some() {
+            PluginHealth::Ok
+        } else {
+            PluginHealth::Degraded {
+                reason: "no OpenSubtitles API key configured".into(),
+            }
+        }
+    }
+
+    async fn handle_query(
+        &self,
+        query: &GatewayQuery,
+        max_results: usize,
+    ) -> Result<Vec<DiscoveryRecord>, GatewayError> {
+        if !requests_subtitles(query)
+            || !query_accepts_plugin(query, self.served_file_types(), self.served_content_kinds())
+        {
+            return Ok(Vec::new());
+        }
+        let Some(client) = self.client.as_ref() else {
+            return Ok(Vec::new());
+        };
+        let Some(params) = search_params(query) else {
+            debug!(target: "opensubtitles", filters = ?query.filters.keys().collect::<Vec<_>>(), "nothing searchable in query");
+            return Ok(Vec::new());
+        };
+
+        let subtitles = client.search(&params).await?;
+        let mut records: Vec<DiscoveryRecord> =
+            subtitles.iter().flat_map(|s| project(s, query)).collect();
+        // Hash matches first (they are the right sync for the file in hand),
+        // then popularity; record_id keeps the order deterministic.
+        records.sort_by(|a, b| {
+            rank_key(b)
+                .cmp(&rank_key(a))
+                .then_with(|| a.record_id.cmp(&b.record_id))
+        });
+        records.truncate(max_results);
+        Ok(records)
+    }
+
+    /// Not implemented, on purpose: a `provider-file` locator is resolved by
+    /// meta-share's fetch tier (`docs/cid-formats.md` §8), and the SDK's
+    /// `HashKind` has no variant to carry one — adding it is an SDK + gateway
+    /// change. Searching never needs this path.
+    async fn compute_outcomes(&self, _record_id: &str) -> Result<Vec<HashOutcome>, GatewayError> {
+        Err(GatewayError::Permanent(
+            "opensubtitles: provider-file locators are resolved by meta-share, not /compute \
+             (docs/cid-formats.md §8)"
+                .into(),
+        ))
+    }
+
+    fn config_schema(&self) -> ConfigSchema {
+        ConfigSchema {
+            fields: vec![
+                F::secret("apiKey", "OpenSubtitles API key")
+                    .required()
+                    .with_help(
+                        "Consumer API key from opensubtitles.com. Search only — this feeder \
+                         never downloads, so no account login is needed and no download \
+                         quota is spent. Takes effect on the next feeder restart.",
+                    ),
+                F::text("userAgent", "User-Agent").with_help(
+                    "OpenSubtitles expects the registered app name in `App vX.Y` form. \
+                     Blank keeps the built-in default.",
+                ),
+            ],
+        }
+    }
+
+    fn config_values(&self) -> serde_json::Value {
+        serde_json::json!({
+            "apiKey": self.config.api_key,
+            "userAgent": self.config.user_agent,
+        })
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use std::collections::BTreeMap;
+
+    fn q(free: &str, filters: &[(&str, &str)]) -> GatewayQuery {
+        let mut map: BTreeMap<String, Vec<String>> = BTreeMap::new();
+        for (k, v) in filters {
+            map.entry((*k).to_string()).or_default().push((*v).to_string());
+        }
+        GatewayQuery {
+            raw_text: String::new(),
+            free_text: free.to_string(),
+            filters: map,
+            ranges: Vec::new(),
+            negations: Vec::new(),
+        }
+    }
+
+    #[test]
+    fn keyword_only() {
+        let p = search_params(&q("  matrix ", &[("fileType", "subtitle")])).unwrap();
+        assert_eq!(p.query.as_deref(), Some("matrix"));
+        assert!(p.imdb_id.is_none() && p.tmdb_id.is_none());
+    }
+
+    #[test]
+    fn movie_anchor_strips_tt_and_maps_languages() {
+        let p = search_params(&q(
+            "",
+            &[("fileType", "subtitle"), ("imdbid", "tt0133093"), ("languages", "fre,por")],
+        ))
+        .unwrap();
+        assert_eq!(p.imdb_id, Some(133093));
+        assert_eq!(p.languages, vec!["fr", "pm", "pt-br", "pt-pt"]);
+        assert!(!p.is_episode());
+    }
+
+    #[test]
+    fn episode_anchor() {
+        let p = search_params(&q(
+            "",
+            &[("fileType", "subtitle"), ("tmdbid", "1399"), ("season", "1"), ("episode", "2")],
+        ))
+        .unwrap();
+        assert_eq!((p.tmdb_id, p.season, p.episode), (Some(1399), Some(1), Some(2)));
+        assert!(p.is_episode());
+    }
+
+    #[test]
+    fn moviehash_must_be_16_hex() {
+        let ok = search_params(&q("", &[("moviehash", "8E245D9679D31E12")])).unwrap();
+        assert_eq!(ok.moviehash.as_deref(), Some("8e245d9679d31e12"));
+        assert!(search_params(&q("", &[("moviehash", "not-a-hash")])).is_none());
+    }
+
+    #[test]
+    fn nothing_searchable_means_no_call() {
+        assert!(search_params(&q("", &[("fileType", "subtitle")])).is_none());
+        assert!(search_params(&q("", &[("fileType", "subtitle"), ("languages", "fre")])).is_none());
+        // Unknown language: searching without it would only return rows the
+        // gateway then drops.
+        assert!(search_params(&q("matrix", &[("languages", "zzz")])).is_none());
+    }
+
+    #[test]
+    fn only_explicit_subtitle_queries_are_answered() {
+        assert!(requests_subtitles(&q("", &[("fileType", "subtitle")])));
+        assert!(requests_subtitles(&q("", &[("fileType", "video"), ("fileType", "Subtitle")])));
+        assert!(!requests_subtitles(&q("matrix", &[])));
+        assert!(!requests_subtitles(&q("", &[("fileType", "video")])));
+        // Wall / row axes a sidecar never carries.
+        for axis in [("domain", "screen"), ("workForm", "standalone"), ("contentKind", "movie")] {
+            assert!(!requests_subtitles(&q("matrix", &[("fileType", "subtitle"), axis])), "{axis:?}");
+        }
+    }
+}
diff --git a/feeder-plugin/opensubtitles-feeder/src/record.rs b/feeder-plugin/opensubtitles-feeder/src/record.rs
new file mode 100644
index 0000000..f10d597
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/src/record.rs
@@ -0,0 +1,292 @@
+//! Search result → `DiscoveryRecord`: one record per subtitle **file**.
+//!
+//! A subtitle is a **sidecar** (METADATA_KEYS.md §1): `fileType=subtitle`, and
+//! no `contentKind` / `domain` / `workForm` — it is referenced by a work, never
+//! listed on a wall.
+
+use std::collections::BTreeMap;
+
+use meta_feeder_sdk::plugin::upstream_id_field;
+use meta_feeder_sdk::query::GatewayQuery;
+use meta_feeder_sdk::types::DiscoveryRecord;
+
+use crate::client::{FeatureDetails, OsAttributes, OsFile, OsSubtitle};
+use crate::consts::{SOURCE_LABEL, UPSTREAM_ID};
+use crate::lang::from_os_code;
+use crate::locator::file_cid;
+
+/// `fileType=subtitle` extensions (METADATA_KEYS.md `fileType` table). A file
+/// name ending in anything else carries no `extension` rather than a guess —
+/// OpenSubtitles' `format` field is `null` in practice, and many file names
+/// have no extension at all (`….GPRS.fr`).
+const SUBTITLE_EXTENSIONS: &[&str] = &["srt", "sub", "sbv", "vtt", "ass", "ssa", "ttml", "dfxp", "smi"];
+
+/// Project one search hit into a record per file. Files with no id, or whose
+/// locator would not fit the 64-byte ceiling, are dropped.
+pub fn project(sub: &OsSubtitle, query: &GatewayQuery) -> Vec<DiscoveryRecord> {
+    let a = &sub.attributes;
+    a.files
+        .iter()
+        .filter_map(|file| to_record(a, file, query))
+        .collect()
+}
+
+fn to_record(a: &OsAttributes, file: &OsFile, query: &GatewayQuery) -> Option<DiscoveryRecord> {
+    let file_id = file.file_id?;
+    // ⚠ No cid, no record. The gateway persists a search record only when it
+    // carries a `cids/` member, while the search-coverage gate still marks the
+    // query covered — an unaddressable record means every repeat search comes
+    // back empty for the coverage window.
+    let cid = file_cid(file_id)?;
+
+    let mut fields: BTreeMap<String, String> = BTreeMap::new();
+    fields.insert("fileType".into(), "subtitle".into());
+    fields.insert(format!("cids/{cid}"), "true".into());
+    fields.insert(upstream_id_field(UPSTREAM_ID), file_id.to_string());
+    fields.insert(format!("source/{SOURCE_LABEL}"), "true".into());
+
+    let default_fd = FeatureDetails::default();
+    let fd = a.feature_details.as_ref().unwrap_or(&default_fd);
+
+    if let Some(title) = title_for(a, fd, file) {
+        fields.insert("title".into(), title);
+    }
+    if let Some(name) = file.file_name.as_deref().map(str::trim).filter(|s| !s.is_empty()) {
+        fields.insert("fileName".into(), name.to_string());
+        if let Some(ext) = extension_of(name) {
+            fields.insert("extension".into(), ext.to_string());
+        }
+    }
+    if let Some(lang) = a.language.as_deref().and_then(from_os_code) {
+        fields.insert(format!("languages/{lang}"), "true".into());
+        fields.insert("subtitleLanguage".into(), lang);
+    }
+
+    // Ids. For an episode, the *show's* ids: meta-watch anchors a series on the
+    // show's tmdbid, and `record_matches` requires the value to be equal — the
+    // episode's own `tmdb_id` (63056 for GoT S01E01, not 1399) would drop every
+    // record from an anchored episode search.
+    let episode = is_episode(fd);
+    let (imdb, tmdb) = if episode {
+        (fd.parent_imdb_id, fd.parent_tmdb_id)
+    } else {
+        (fd.imdb_id, fd.tmdb_id)
+    };
+    if let Some(id) = imdb {
+        fields.insert("imdbid".into(), format!("tt{id:07}"));
+    }
+    if let Some(id) = tmdb {
+        fields.insert("tmdbid".into(), id.to_string());
+    }
+    if episode {
+        if let Some(s) = fd.season_number {
+            fields.insert("season".into(), s.to_string());
+        }
+        if let Some(e) = fd.episode_number {
+            fields.insert("episode".into(), e.to_string());
+        }
+    } else if let Some(y) = fd.year {
+        fields.insert("movieYear".into(), y.to_string());
+    }
+
+    // Ranking signals for the client choosing between versions.
+    fields.insert(
+        "downloadCount".into(),
+        a.download_count.unwrap_or(0).to_string(),
+    );
+    fields.insert("moviehashMatch".into(), bool_str(a.moviehash_match));
+    fields.insert("hearingImpaired".into(), bool_str(a.hearing_impaired));
+    fields.insert(
+        "machineTranslated".into(),
+        bool_str(Some(
+            a.ai_translated.unwrap_or(false) || a.machine_translated.unwrap_or(false),
+        )),
+    );
+
+    echo_filters(&mut fields, query);
+
+    Some(DiscoveryRecord {
+        upstream_id: UPSTREAM_ID.to_string(),
+        record_id: format!("{UPSTREAM_ID}:file:{file_id}"),
+        fields,
+    })
+}
+
+fn is_episode(fd: &FeatureDetails) -> bool {
+    fd.feature_type
+        .as_deref()
+        .is_some_and(|t| t.eq_ignore_ascii_case("episode"))
+        || fd.season_number.is_some()
+        || fd.episode_number.is_some()
+}
+
+/// The release name users recognise, else the feature's display name. A
+/// multi-CD subtitle gets its part number, or its files are indistinguishable.
+fn title_for(a: &OsAttributes, fd: &FeatureDetails, file: &OsFile) -> Option<String> {
+    let non_empty = |s: &Option<String>| {
+        s.as_deref()
+            .map(str::trim)
+            .filter(|s| !s.is_empty())
+            .map(str::to_string)
+    };
+    let base = non_empty(&a.release)
+        .or_else(|| non_empty(&fd.movie_name))
+        .or_else(|| non_empty(&fd.title))?;
+    match (a.nb_cd, file.cd_number) {
+        (Some(total), Some(n)) if total > 1 => Some(format!("{base} (CD {n}/{total})")),
+        _ => Some(base),
+    }
+}
+
+fn extension_of(name: &str) -> Option<&'static str> {
+    let (_, ext) = name.rsplit_once('.')?;
+    let ext = ext.to_ascii_lowercase();
+    SUBTITLE_EXTENSIONS.iter().copied().find(|e| *e == ext)
+}
+
+fn bool_str(b: Option<bool>) -> String {
+    if b.unwrap_or(false) { "true" } else { "false" }.to_string()
+}
+
+/// Structured filters the record must echo back.
+///
+/// ⚠ `record_matches` (gateway + meta-search) iterates EVERY filter on the query
+/// and fails any record that does not carry the key. Key-set fields (`genres`,
+/// `languages`) have dedicated arms and the type axes are set explicitly, so
+/// they are skipped; so is any key the record already states — echoing must
+/// never overwrite a real value (`imdbid` stays the record's own).
+///
+/// `moviehash:` is echoed onto every record; `moviehashMatch` is what tells a
+/// real hash match apart from an id match returned by the same search.
+fn echo_filters(fields: &mut BTreeMap<String, String>, query: &GatewayQuery) {
+    const SKIP: &[&str] = &["genres", "languages", "fileType", "type", "contentKind", "domain", "workForm"];
+    for (k, values) in &query.filters {
+        if SKIP.contains(&k.as_str()) || fields.contains_key(k) {
+            continue;
+        }
+        if let Some(v) = values.first() {
+            fields.insert(k.clone(), v.clone());
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::client::SearchResponse;
+    use crate::locator::decode_provider_file_cid;
+    use meta_feeder_sdk::query_eval::record_matches;
+
+    fn q(free: &str, filters: &[(&str, &str)]) -> GatewayQuery {
+        let mut map: BTreeMap<String, Vec<String>> = BTreeMap::new();
+        for (k, v) in filters {
+            map.entry((*k).to_string()).or_default().push((*v).to_string());
+        }
+        GatewayQuery {
+            raw_text: String::new(),
+            free_text: free.to_string(),
+            filters: map,
+            ranges: Vec::new(),
+            negations: Vec::new(),
+        }
+    }
+
+    fn records(fixture: &str, query: &GatewayQuery) -> Vec<DiscoveryRecord> {
+        let resp: SearchResponse = serde_json::from_str(fixture).unwrap();
+        resp.data.iter().flat_map(|s| project(s, query)).collect()
+    }
+
+    const KEYWORD: &str = include_str!("../tests/fixtures/search_keyword_matrix.json");
+    const MOVIE_FR: &str = include_str!("../tests/fixtures/search_imdb_133093_fr.json");
+    const EPISODE: &str = include_str!("../tests/fixtures/search_episode_1399_s01e01.json");
+    const HASH: &str = include_str!("../tests/fixtures/search_moviehash.json");
+
+    #[test]
+    fn one_addressable_sidecar_record_per_file() {
+        let query = q("matrix", &[("fileType", "subtitle")]);
+        let recs = records(KEYWORD, &query);
+        // 4 subtitles, one of them a 2-CD release.
+        assert_eq!(recs.len(), 5);
+        for r in &recs {
+            assert_eq!(r.fields.get("fileType").map(String::as_str), Some("subtitle"));
+            for axis in ["contentKind", "domain", "workForm"] {
+                assert!(!r.fields.contains_key(axis), "{axis} on a sidecar");
+            }
+            let cid = r
+                .fields
+                .keys()
+                .find_map(|k| k.strip_prefix("cids/"))
+                .expect("cids/ member");
+            let (source, id) = decode_provider_file_cid(cid).expect("0x100A cid");
+            assert_eq!(source, "opensubtitles");
+            assert_eq!(id, format!("file:{}", r.fields["opensubtitlesid"]));
+            assert_eq!(r.record_id, format!("opensubtitles:{id}"));
+            assert!(record_matches(&r.fields, &query), "{:?}", r.fields);
+        }
+        let multi: Vec<_> = recs
+            .iter()
+            .filter(|r| r.fields.get("title").is_some_and(|t| t.contains("(CD ")))
+            .collect();
+        assert_eq!(multi.len(), 2, "both parts of the multi-CD subtitle are titled");
+    }
+
+    #[test]
+    fn movie_anchor_with_language_matches_its_query() {
+        let query = q("", &[("fileType", "subtitle"), ("imdbid", "tt0133093"), ("languages", "fre")]);
+        let recs = records(MOVIE_FR, &query);
+        assert!(!recs.is_empty());
+        for r in &recs {
+            assert_eq!(r.fields.get("subtitleLanguage").map(String::as_str), Some("fre"));
+            assert_eq!(r.fields.get("languages/fre").map(String::as_str), Some("true"));
+            assert_eq!(r.fields.get("imdbid").map(String::as_str), Some("tt0133093"));
+            assert_eq!(r.fields.get("tmdbid").map(String::as_str), Some("603"));
+            assert_eq!(r.fields.get("movieYear").map(String::as_str), Some("1999"));
+            assert!(record_matches(&r.fields, &query), "{:?}", r.fields);
+        }
+    }
+
+    #[test]
+    fn episode_records_carry_the_show_ids() {
+        let query = q(
+            "",
+            &[("fileType", "subtitle"), ("tmdbid", "1399"), ("season", "1"), ("episode", "1")],
+        );
+        let recs = records(EPISODE, &query);
+        assert!(!recs.is_empty());
+        for r in &recs {
+            assert_eq!(r.fields.get("tmdbid").map(String::as_str), Some("1399"));
+            assert_eq!(r.fields.get("imdbid").map(String::as_str), Some("tt0944947"));
+            assert_eq!(r.fields.get("season").map(String::as_str), Some("1"));
+            assert_eq!(r.fields.get("episode").map(String::as_str), Some("1"));
+            assert!(!r.fields.contains_key("movieYear"));
+            assert!(record_matches(&r.fields, &query), "{:?}", r.fields);
+        }
+    }
+
+    #[test]
+    fn moviehash_search_flags_matches_and_echoes_the_hash() {
+        let query = q("", &[("fileType", "subtitle"), ("moviehash", "8e245d9679d31e12")]);
+        let recs = records(HASH, &query);
+        assert!(!recs.is_empty());
+        for r in &recs {
+            assert_eq!(r.fields.get("moviehashMatch").map(String::as_str), Some("true"));
+            assert!(record_matches(&r.fields, &query), "{:?}", r.fields);
+        }
+    }
+
+    #[test]
+    fn echo_never_overwrites_a_real_value() {
+        let query = q("", &[("fileType", "subtitle"), ("imdbid", "tt9999999")]);
+        let recs = records(MOVIE_FR, &query);
+        assert_eq!(recs[0].fields.get("imdbid").map(String::as_str), Some("tt0133093"));
+        // …so a record for a different film is correctly rejected downstream.
+        assert!(!record_matches(&recs[0].fields, &query));
+    }
+
+    #[test]
+    fn extension_only_from_a_real_subtitle_suffix() {
+        assert_eq!(extension_of("Movie.en.SRT"), Some("srt"));
+        assert_eq!(extension_of("The.Matrix.GPRS.fr"), None);
+        assert_eq!(extension_of("no_extension"), None);
+    }
+}
diff --git a/feeder-plugin/opensubtitles-feeder/tests/contract.rs b/feeder-plugin/opensubtitles-feeder/tests/contract.rs
new file mode 100644
index 0000000..d7bdfa1
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/tests/contract.rs
@@ -0,0 +1,311 @@
+//! End-to-end contract test for the feeder's HTTP surface: boots the real SDK
+//! router (`configure_plugins` + `router`) on an ephemeral port, pointed at a
+//! wiremock OpenSubtitles, and drives `/manifest`, `/health`, `/query` and
+//! `/compute` over HTTP. Deterministic — fixtures were captured from the live
+//! API on 2026-09-12 and trimmed (uploader names removed).
+//!
+//! What this pins:
+//! - the manifest advertises `fileType=subtitle` — the only reason meta-search
+//!   routes a `fileType:subtitle` query here;
+//! - keyword and anchored queries yield persistable sidecar records (a
+//!   `provider-file` `cids/` member, no content kind) that pass the gateway's
+//!   own `record_matches` against the query that produced them;
+//! - the upstream sees OpenSubtitles' canonical query form (sorted keys) and the
+//!   API key header;
+//! - a query this feeder cannot answer never reaches the upstream.
+
+use std::collections::BTreeMap;
+
+use meta_feeder_sdk::query_eval::record_matches;
+use meta_feeder_sdk::{
+    configure_plugins, router, ComputeRequest, GatewayQuery, ManifestResponse, QueryRequest,
+    QueryResponse,
+};
+use opensubtitles_feeder::locator::decode_provider_file_cid;
+use opensubtitles_feeder::plugin::OpenSubtitlesPlugin;
+use wiremock::matchers::{header, method, path, query_param};
+use wiremock::{Match, Mock, MockServer, Request, ResponseTemplate};
+
+const KEY: &str = "test-key";
+
+const KEYWORD: &str = include_str!("fixtures/search_keyword_matrix.json");
+const MOVIE_FR: &str = include_str!("fixtures/search_imdb_133093_fr.json");
+const EPISODE: &str = include_str!("fixtures/search_episode_1399_s01e01.json");
+
+async fn spawn_feeder(api_key: &str, upstream: &MockServer) -> (String, tempfile::TempDir) {
+    let dir = tempfile::tempdir().expect("tempdir");
+    let plugin = OpenSubtitlesPlugin::with_api_base(api_key, upstream.uri());
+    let plugins = configure_plugins(vec![Box::new(plugin)], dir.path()).expect("configure plugins");
+    let app = router(plugins, "opensubtitles-feeder-test".to_string(), dir.path());
+
+    let listener = tokio::net::TcpListener::bind("127.0.0.1:0")
+        .await
+        .expect("bind ephemeral");
+    let addr = listener.local_addr().expect("local_addr");
+    tokio::spawn(async move {
+        axum::serve(listener, app).await.expect("serve");
+    });
+    (format!("http://{addr}"), dir)
+}
+
+fn query(free: &str, filters: &[(&str, &str)]) -> GatewayQuery {
+    let mut map: BTreeMap<String, Vec<String>> = BTreeMap::new();
+    for (k, v) in filters {
+        map.entry((*k).to_string()).or_default().push((*v).to_string());
+    }
+    GatewayQuery {
+        raw_text: String::new(),
+        free_text: free.to_string(),
+        filters: map,
+        ranges: Vec::new(),
+        negations: Vec::new(),
+    }
+}
+
+async fn post_query(base: &str, q: &GatewayQuery) -> reqwest::Response {
+    reqwest::Client::new()
+        .post(format!("{base}/query"))
+        .json(&QueryRequest {
+            upstream_id: "opensubtitles".into(),
+            query: q.clone(),
+            max_results: 50,
+        })
+        .send()
+        .await
+        .expect("POST /query")
+}
+
+async fn records(base: &str, q: &GatewayQuery) -> Vec<meta_feeder_sdk::DiscoveryRecord> {
+    let resp = post_query(base, q).await;
+    assert_eq!(resp.status(), 200, "{:?}", resp.text().await);
+    resp.json::<QueryResponse>().await.expect("QueryResponse").records
+}
+
+/// OpenSubtitles 301s any query string whose keys are not sorted.
+struct SortedQueryKeys;
+
+impl Match for SortedQueryKeys {
+    fn matches(&self, request: &Request) -> bool {
+        let keys: Vec<&str> = request
+            .url
+            .query()
+            .unwrap_or("")
+            .split('&')
+            .filter(|kv| !kv.is_empty())
+            .map(|kv| kv.split('=').next().unwrap_or(""))
+            .collect();
+        let mut sorted = keys.clone();
+        sorted.sort_unstable();
+        keys == sorted
+    }
+}
+
+fn assert_persistable_sidecar(r: &meta_feeder_sdk::DiscoveryRecord, q: &GatewayQuery) {
+    assert_eq!(r.fields.get("fileType").map(String::as_str), Some("subtitle"));
+    assert!(!r.fields.contains_key("contentKind") && !r.fields.contains_key("domain"));
+    let cid = r
+        .fields
+        .keys()
+        .find_map(|k| k.strip_prefix("cids/"))
+        .expect("a cids/ member, or the gateway never persists the record");
+    let (source, id) = decode_provider_file_cid(cid).expect("a provider-file (0x100A) cid");
+    assert_eq!(source, "opensubtitles");
+    assert_eq!(id, format!("file:{}", r.fields["opensubtitlesid"]));
+    assert!(record_matches(&r.fields, q), "gateway would drop {:?}", r.fields);
+}
+
+#[tokio::test]
+async fn manifest_advertises_subtitle_only() {
+    let upstream = MockServer::start().await;
+    let (base, _dir) = spawn_feeder(KEY, &upstream).await;
+
+    let m: ManifestResponse = reqwest::get(format!("{base}/manifest"))
+        .await
+        .unwrap()
+        .json()
+        .await
+        .unwrap();
+    assert_eq!(m.plugins.len(), 1);
+    assert_eq!(m.plugins[0].id, "opensubtitles");
+    assert_eq!(m.plugins[0].served_file_types, vec!["subtitle".to_string()]);
+    assert!(m.plugins[0].served_content_kinds.is_empty());
+}
+
+#[tokio::test]
+async fn keyword_search_yields_persistable_subtitle_records() {
+    let upstream = MockServer::start().await;
+    Mock::given(method("GET"))
+        .and(path("/subtitles"))
+        .and(query_param("query", "matrix"))
+        .and(header("Api-Key", KEY))
+        .and(SortedQueryKeys)
+        .respond_with(ResponseTemplate::new(200).set_body_string(KEYWORD))
+        .expect(1)
+        .mount(&upstream)
+        .await;
+    let (base, _dir) = spawn_feeder(KEY, &upstream).await;
+
+    let q = query("Matrix", &[("fileType", "subtitle")]);
+    let recs = records(&base, &q).await;
+    assert_eq!(recs.len(), 5, "one record per file");
+    for r in &recs {
+        assert_persistable_sidecar(r, &q);
+    }
+    // Ranked by download count (no hash matches in a keyword search).
+    let counts: Vec<u64> = recs
+        .iter()
+        .map(|r| r.fields["downloadCount"].parse().unwrap())
+        .collect();
+    assert!(counts.windows(2).all(|w| w[0] >= w[1]), "{counts:?}");
+}
+
+#[tokio::test]
+async fn movie_anchor_with_language() {
+    let upstream = MockServer::start().await;
+    Mock::given(method("GET"))
+        .and(path("/subtitles"))
+        .and(query_param("imdb_id", "133093"))
+        .and(query_param("languages", "fr"))
+        .and(SortedQueryKeys)
+        .respond_with(ResponseTemplate::new(200).set_body_string(MOVIE_FR))
+        .expect(1)
+        .mount(&upstream)
+        .await;
+    let (base, _dir) = spawn_feeder(KEY, &upstream).await;
+
+    let q = query("", &[("fileType", "subtitle"), ("imdbid", "tt0133093"), ("languages", "fre")]);
+    let recs = records(&base, &q).await;
+    assert!(!recs.is_empty());
+    for r in &recs {
+        assert_persistable_sidecar(r, &q);
+        assert_eq!(r.fields.get("subtitleLanguage").map(String::as_str), Some("fre"));
+        assert_eq!(r.fields.get("tmdbid").map(String::as_str), Some("603"));
+    }
+}
+
+#[tokio::test]
+async fn episode_anchor_is_sent_as_parent_ids() {
+    let upstream = MockServer::start().await;
+    Mock::given(method("GET"))
+        .and(path("/subtitles"))
+        .and(query_param("parent_tmdb_id", "1399"))
+        .and(query_param("season_number", "1"))
+        .and(query_param("episode_number", "1"))
+        .and(SortedQueryKeys)
+        .respond_with(ResponseTemplate::new(200).set_body_string(EPISODE))
+        .expect(1)
+        .mount(&upstream)
+        .await;
+    let (base, _dir) = spawn_feeder(KEY, &upstream).await;
+
+    let q = query(
+        "",
+        &[("fileType", "subtitle"), ("tmdbid", "1399"), ("season", "1"), ("episode", "1")],
+    );
+    let recs = records(&base, &q).await;
+    assert!(!recs.is_empty());
+    for r in &recs {
+        assert_persistable_sidecar(r, &q);
+        assert_eq!(r.fields.get("tmdbid").map(String::as_str), Some("1399"));
+    }
+}
+
+#[tokio::test]
+async fn unanswerable_queries_never_reach_the_upstream() {
+    let upstream = MockServer::start().await;
+    Mock::given(method("GET"))
+        .respond_with(ResponseTemplate::new(200).set_body_string(KEYWORD))
+        .expect(0)
+        .mount(&upstream)
+        .await;
+    let (base, _dir) = spawn_feeder(KEY, &upstream).await;
+
+    for q in [
+        // wall/row queries — a subtitle carries none of these axes. `domain:` is
+        // the case the live smoke run caught: the SDK gate only checks
+        // fileType/contentKind, and only the gateway expands domain → kinds.
+        query("matrix", &[("fileType", "subtitle"), ("contentKind", "movie")]),
+        query("matrix", &[("fileType", "subtitle"), ("domain", "screen")]),
+        query("matrix", &[("fileType", "subtitle"), ("workForm", "standalone")]),
+        // never asked for subtitles
+        query("matrix", &[]),
+        query("matrix", &[("fileType", "video")]),
+        // nothing to search on
+        query("", &[("fileType", "subtitle")]),
+        query("", &[("fileType", "subtitle"), ("languages", "fre")]),
+        // a language OpenSubtitles does not have
+        query("matrix", &[("fileType", "subtitle"), ("languages", "zzz")]),
+    ] {
+        assert!(records(&base, &q).await.is_empty(), "{:?}", q.filters);
+    }
+}
+
+#[tokio::test]
+async fn upstream_429_surfaces_as_429() {
+    let upstream = MockServer::start().await;
+    Mock::given(method("GET"))
+        .respond_with(ResponseTemplate::new(429).insert_header("Retry-After", "1"))
+        .mount(&upstream)
+        .await;
+    let (base, _dir) = spawn_feeder(KEY, &upstream).await;
+
+    let resp = post_query(&base, &query("matrix", &[("fileType", "subtitle")])).await;
+    assert_eq!(resp.status(), 429);
+}
+
+/// A 301 means the query string drifted from OpenSubtitles' canonical form.
+/// It must be loud, not a silently followed extra hop on every search.
+#[tokio::test]
+async fn upstream_redirect_is_an_error() {
+    let upstream = MockServer::start().await;
+    Mock::given(method("GET"))
+        .respond_with(
+            ResponseTemplate::new(301).insert_header("Location", "/subtitles?query=matrix"),
+        )
+        .mount(&upstream)
+        .await;
+    let (base, _dir) = spawn_feeder(KEY, &upstream).await;
+
+    let resp = post_query(&base, &query("matrix", &[("fileType", "subtitle")])).await;
+    assert_eq!(resp.status(), 422);
+}
+
+#[tokio::test]
+async fn missing_api_key_degrades_and_answers_nothing() {
+    let upstream = MockServer::start().await;
+    Mock::given(method("GET"))
+        .respond_with(ResponseTemplate::new(200).set_body_string(KEYWORD))
+        .expect(0)
+        .mount(&upstream)
+        .await;
+    let (base, _dir) = spawn_feeder("", &upstream).await;
+
+    let health: serde_json::Value = reqwest::get(format!("{base}/health"))
+        .await
+        .unwrap()
+        .json()
+        .await
+        .unwrap();
+    assert_ne!(health["status"], "ok", "{health}");
+
+    assert!(records(&base, &query("matrix", &[("fileType", "subtitle")]))
+        .await
+        .is_empty());
+}
+
+#[tokio::test]
+async fn compute_is_refused() {
+    let upstream = MockServer::start().await;
+    let (base, _dir) = spawn_feeder(KEY, &upstream).await;
+
+    let resp = reqwest::Client::new()
+        .post(format!("{base}/compute"))
+        .json(&ComputeRequest {
+            upstream_id: "opensubtitles".into(),
+            record_id: "opensubtitles:file:12658754".into(),
+        })
+        .send()
+        .await
+        .unwrap();
+    assert_eq!(resp.status(), 422);
+}
diff --git a/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_episode_1399_s01e01.json b/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_episode_1399_s01e01.json
new file mode 100644
index 0000000..98eec50
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_episode_1399_s01e01.json
@@ -0,0 +1,137 @@
+{
+  "total_pages": 1,
+  "total_count": 3,
+  "per_page": 50,
+  "page": 1,
+  "data": [
+    {
+      "id": "11957644",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "11957644",
+        "language": "fa",
+        "download_count": 5,
+        "new_download_count": 1,
+        "hearing_impaired": false,
+        "hd": true,
+        "fps": 0.0,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2026-09-05T16:45:23Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "Game.of.Thrones.S01E01.Winter.Is.Coming.REPACK.2160p.MAX.WEB-DL.TrueHD.7.1.Atmos.DV.HDR.H.265-Kitsune",
+        "legacy_subtitle_id": 14026000,
+        "feature_details": {
+          "feature_id": 278305,
+          "feature_type": "Episode",
+          "year": 2011,
+          "title": "Winter Is Coming",
+          "movie_name": "Game of Thrones - S01E01  Winter Is Coming",
+          "imdb_id": 1480055,
+          "tmdb_id": 63056,
+          "season_number": 1,
+          "episode_number": 1,
+          "parent_imdb_id": 944947,
+          "parent_title": "Game of Thrones",
+          "parent_tmdb_id": 1399,
+          "parent_feature_id": 10891
+        },
+        "files": [
+          {
+            "file_id": 12838679,
+            "cd_number": 1,
+            "file_name": "Game.of.Thrones.S01E01.Winter.Is.Coming.REPACK.2160p.MAX.WEB-DL.TrueHD.7.1.Atmos.DV.HDR.H.265-Kitsune"
+          }
+        ]
+      }
+    },
+    {
+      "id": "11785541",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "11785541",
+        "language": "en",
+        "download_count": 141,
+        "new_download_count": 571,
+        "hearing_impaired": true,
+        "hd": false,
+        "fps": 29.97,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2026-08-01T04:06:10Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "Game of Thrones S01E01 Winter Is Coming",
+        "legacy_subtitle_id": 13943373,
+        "feature_details": {
+          "feature_id": 278305,
+          "feature_type": "Episode",
+          "year": 2011,
+          "title": "Winter Is Coming",
+          "movie_name": "Game of Thrones - S01E01  Winter Is Coming",
+          "imdb_id": 1480055,
+          "tmdb_id": 63056,
+          "season_number": 1,
+          "episode_number": 1,
+          "parent_imdb_id": 944947,
+          "parent_title": "Game of Thrones",
+          "parent_tmdb_id": 1399,
+          "parent_feature_id": 10891
+        },
+        "files": [
+          {
+            "file_id": 12694986,
+            "cd_number": 1,
+            "file_name": "Game of Thrones S01E01 Winter Is Coming"
+          }
+        ]
+      }
+    },
+    {
+      "id": "11733097",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "11733097",
+        "language": "es",
+        "download_count": 111,
+        "new_download_count": 173,
+        "hearing_impaired": false,
+        "hd": true,
+        "fps": 0.0,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2026-06-25T15:42:00Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "Game of Thrones S01E01 1080p AMZN playWEB",
+        "legacy_subtitle_id": 13859500,
+        "feature_details": {
+          "feature_id": 278305,
+          "feature_type": "Episode",
+          "year": 2011,
+          "title": "Winter Is Coming",
+          "movie_name": "Game of Thrones - S01E01  Winter Is Coming",
+          "imdb_id": 1480055,
+          "tmdb_id": 63056,
+          "season_number": 1,
+          "episode_number": 1,
+          "parent_imdb_id": 944947,
+          "parent_title": "Game of Thrones",
+          "parent_tmdb_id": 1399,
+          "parent_feature_id": 10891
+        },
+        "files": [
+          {
+            "file_id": 12642661,
+            "cd_number": 1,
+            "file_name": "Game of Thrones S01E01 1080p AMZN playWEB"
+          }
+        ]
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_imdb_133093_fr.json b/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_imdb_133093_fr.json
new file mode 100644
index 0000000..893f5b5
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_imdb_133093_fr.json
@@ -0,0 +1,124 @@
+{
+  "total_pages": 1,
+  "total_count": 3,
+  "per_page": 50,
+  "page": 1,
+  "data": [
+    {
+      "id": "11749486",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "11749486",
+        "language": "fr",
+        "download_count": 57,
+        "new_download_count": 160,
+        "hearing_impaired": false,
+        "hd": true,
+        "fps": 0.0,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2026-07-10T15:36:25Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "The Matrix (1999) {imdb-tt0133093} - [AMZN][WEBDL-1080p][EAC3 5.1][h264]-GPRS",
+        "legacy_subtitle_id": 13894449,
+        "feature_details": {
+          "feature_id": 646193,
+          "feature_type": "Movie",
+          "year": 1999,
+          "title": "The Matrix",
+          "movie_name": "1999 - The Matrix",
+          "imdb_id": 133093,
+          "tmdb_id": 603
+        },
+        "files": [
+          {
+            "file_id": 12658754,
+            "cd_number": 1,
+            "file_name": "The Matrix (1999) {imdb-tt0133093} - [AMZN][WEBDL-1080p][EAC3 5.1][h264]-GPRS.fr"
+          }
+        ]
+      }
+    },
+    {
+      "id": "8520404",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "8520404",
+        "language": "fr",
+        "download_count": 275,
+        "new_download_count": 348,
+        "hearing_impaired": false,
+        "hd": false,
+        "fps": 0.0,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2024-07-20T18:28:59Z",
+        "ai_translated": false,
+        "nb_cd": 2,
+        "machine_translated": false,
+        "release": "The.Matrix.Screener-VCD-EUROPE",
+        "legacy_subtitle_id": 12104394,
+        "feature_details": {
+          "feature_id": 646193,
+          "feature_type": "Movie",
+          "year": 1999,
+          "title": "The Matrix",
+          "movie_name": "1999 - The Matrix",
+          "imdb_id": 133093,
+          "tmdb_id": 603
+        },
+        "files": [
+          {
+            "file_id": 9443700,
+            "cd_number": 1,
+            "file_name": "The Matrix Screener part 1.PAL.FR"
+          },
+          {
+            "file_id": 9443701,
+            "cd_number": 2,
+            "file_name": "The Matrix Screener part 2.PAL.FR"
+          }
+        ]
+      }
+    },
+    {
+      "id": "8234814",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "8234814",
+        "language": "fr",
+        "download_count": 293,
+        "new_download_count": 221,
+        "hearing_impaired": false,
+        "hd": false,
+        "fps": 0.0,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2024-07-09T04:00:21Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "????1.The.Matrix.1.1999.UC.DVDRip.XViD.AC3.5.1CH.CD3-WAF.FR.PAL",
+        "legacy_subtitle_id": 11181831,
+        "feature_details": {
+          "feature_id": 646193,
+          "feature_type": "Movie",
+          "year": 1999,
+          "title": "The Matrix",
+          "movie_name": "1999 - The Matrix",
+          "imdb_id": 133093,
+          "tmdb_id": 603
+        },
+        "files": [
+          {
+            "file_id": 9159988,
+            "cd_number": 1,
+            "file_name": "1.The.Matrix.1.1999.UC.DVDRip.XViD.AC3.5.1CH.CD3-WAF.FR.PAL"
+          }
+        ]
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_keyword_matrix.json b/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_keyword_matrix.json
new file mode 100644
index 0000000..1494329
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_keyword_matrix.json
@@ -0,0 +1,161 @@
+{
+  "total_pages": 1,
+  "total_count": 4,
+  "per_page": 50,
+  "page": 1,
+  "data": [
+    {
+      "id": "10078344",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "10078344",
+        "language": "pl",
+        "download_count": 23,
+        "new_download_count": 8,
+        "hearing_impaired": false,
+        "hd": false,
+        "fps": 0.0,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2024-06-19T07:54:22Z",
+        "ai_translated": false,
+        "nb_cd": 2,
+        "machine_translated": false,
+        "release": "Armitage III Dual Matrix CD 1",
+        "legacy_subtitle_id": 10206883,
+        "feature_details": {
+          "feature_id": 517502,
+          "feature_type": "Movie",
+          "year": 2002,
+          "title": "Armitage: Dual Matrix",
+          "movie_name": "2002 - Armitage: Dual Matrix",
+          "imdb_id": 303678,
+          "tmdb_id": 21769
+        },
+        "files": [
+          {
+            "file_id": 10986218,
+            "cd_number": 1,
+            "file_name": "Armitage III Dual Matrix CD 1"
+          },
+          {
+            "file_id": 10986219,
+            "cd_number": 2,
+            "file_name": "Armitage III Dual Matrix CD 2"
+          }
+        ]
+      }
+    },
+    {
+      "id": "10078343",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "10078343",
+        "language": "ar",
+        "download_count": 24,
+        "new_download_count": 34,
+        "hearing_impaired": false,
+        "hd": false,
+        "fps": 0.0,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2024-07-18T08:00:49Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "[Kaito] Armitage: Dual Matrix [DVD][Kaito]",
+        "legacy_subtitle_id": 11930992,
+        "feature_details": {
+          "feature_id": 517502,
+          "feature_type": "Movie",
+          "year": 2002,
+          "title": "Armitage: Dual Matrix",
+          "movie_name": "2002 - Armitage: Dual Matrix",
+          "imdb_id": 303678,
+          "tmdb_id": 21769
+        },
+        "files": [
+          {
+            "file_id": 10986217,
+            "cd_number": 1,
+            "file_name": "KaitoFansub_Armitage_III_Dual_Matrix_Movie"
+          }
+        ]
+      }
+    },
+    {
+      "id": "5804989",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "5804989",
+        "language": "es",
+        "download_count": 129,
+        "new_download_count": 143,
+        "hearing_impaired": false,
+        "hd": true,
+        "fps": 29.97,
+        "from_trusted": true,
+        "foreign_parts_only": false,
+        "upload_date": "2021-06-04T17:23:32Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "Armitage III- Dual-Matrix (2002)",
+        "legacy_subtitle_id": 8696238,
+        "feature_details": {
+          "feature_id": 517502,
+          "feature_type": "Movie",
+          "year": 2002,
+          "title": "Armitage: Dual Matrix",
+          "movie_name": "2002 - Armitage: Dual Matrix",
+          "imdb_id": 303678,
+          "tmdb_id": 21769
+        },
+        "files": [
+          {
+            "file_id": 6820144,
+            "cd_number": 1,
+            "file_name": "Armitage III- Dual-Matrix (2002).es"
+          }
+        ]
+      }
+    },
+    {
+      "id": "5804815",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "5804815",
+        "language": "en",
+        "download_count": 486,
+        "new_download_count": 162,
+        "hearing_impaired": false,
+        "hd": true,
+        "fps": 29.97,
+        "from_trusted": true,
+        "foreign_parts_only": false,
+        "upload_date": "2021-06-04T16:57:20Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "Armitage III- Dual-Matrix (2002)",
+        "legacy_subtitle_id": 8696082,
+        "feature_details": {
+          "feature_id": 517502,
+          "feature_type": "Movie",
+          "year": 2002,
+          "title": "Armitage: Dual Matrix",
+          "movie_name": "2002 - Armitage: Dual Matrix",
+          "imdb_id": 303678,
+          "tmdb_id": 21769
+        },
+        "files": [
+          {
+            "file_id": 6820033,
+            "cd_number": 1,
+            "file_name": "Armitage III- Dual-Matrix (2002).eng"
+          }
+        ]
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_moviehash.json b/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_moviehash.json
new file mode 100644
index 0000000..1cf0070
--- /dev/null
+++ b/feeder-plugin/opensubtitles-feeder/tests/fixtures/search_moviehash.json
@@ -0,0 +1,96 @@
+{
+  "total_pages": 1,
+  "total_count": 2,
+  "per_page": 50,
+  "page": 1,
+  "data": [
+    {
+      "id": "3097032",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "3097032",
+        "language": "en",
+        "download_count": 321046,
+        "new_download_count": 3344,
+        "hearing_impaired": true,
+        "hd": true,
+        "fps": 23.976,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2014-02-28T09:55:32Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "Vikings.S02E01.HDTV.x264-EXCELLENCE",
+        "legacy_subtitle_id": 5562812,
+        "feature_details": {
+          "feature_id": 345772,
+          "feature_type": "Episode",
+          "year": 2014,
+          "title": "Brother's War",
+          "movie_name": "Vikings - S02E01  Brother's War",
+          "imdb_id": 3358048,
+          "tmdb_id": 970845,
+          "season_number": 2,
+          "episode_number": 1,
+          "parent_imdb_id": 2306299,
+          "parent_title": "Vikings",
+          "parent_tmdb_id": 44217,
+          "parent_feature_id": 12400
+        },
+        "files": [
+          {
+            "file_id": 3166793,
+            "cd_number": 1,
+            "file_name": "Vikings.S02E01.HDTV.x264-EXCELLENCE"
+          }
+        ],
+        "moviehash_match": true
+      }
+    },
+    {
+      "id": "7508772",
+      "type": "subtitle",
+      "attributes": {
+        "subtitle_id": "7508772",
+        "language": "en",
+        "download_count": 18479,
+        "new_download_count": 764,
+        "hearing_impaired": false,
+        "hd": false,
+        "fps": 23.976,
+        "from_trusted": false,
+        "foreign_parts_only": false,
+        "upload_date": "2009-07-24T13:31:10Z",
+        "ai_translated": false,
+        "nb_cd": 1,
+        "machine_translated": false,
+        "release": "DVDRip",
+        "legacy_subtitle_id": 3538948,
+        "feature_details": {
+          "feature_id": 1769142,
+          "feature_type": "Episode",
+          "year": 2002,
+          "title": "Jurassic Bark",
+          "movie_name": "Futurama - S05E02  Jurassic Bark",
+          "imdb_id": 584444,
+          "tmdb_id": 1108227,
+          "season_number": 5,
+          "episode_number": 2,
+          "parent_imdb_id": 149460,
+          "parent_title": "Futurama",
+          "parent_tmdb_id": 615,
+          "parent_feature_id": 1768889
+        },
+        "files": [
+          {
+            "file_id": 8439091,
+            "cd_number": 1,
+            "file_name": "Futurama - 5x02 - Jurassic Bark"
+          }
+        ],
+        "moviehash_match": true
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/rust-toolchain.toml b/rust-toolchain.toml
new file mode 100644
index 0000000..1c0730c
--- /dev/null
+++ b/rust-toolchain.toml
@@ -0,0 +1,3 @@
+[toolchain]
+channel = "1.89"
+components = ["rustfmt", "clippy"]