# Diaoul/subliminal

Subtitles, faster than your thoughts

Repository: https://github.com/Diaoul/subliminal
Canonical: https://ross.abutalabs.com/products/subliminal
Homepage: http://subliminal.readthedocs.org
Language: Python
License: MIT
License Family: permissive
Last push: 2026-07-23T00:29:27+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 82, longevity 100
- inputs: {"age_days": 5539, "days_push": 42, "days_rel": 42, "gap_med": 84.5, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2666, forks 317 (observed 2026-08-28T04:07:09.134582+00:00)

## What it is
Subliminal is a Python library and CLI tool for downloading subtitles for video files from multiple subtitle providers. It can scan video folders, match videos to subtitles by name and content, and save the best-matching subtitles automatically.

## Use cases
- download subtitles for a movie or tv episode
- automatically fetch subtitles for a whole video folder
- find subtitles in multiple languages for videos
- integrate subtitle downloading into a media pipeline
- batch download subtitles from the command line

## When to choose
- you need programmatic subtitle downloading in Python
- you want to subtitle many videos in bulk from the CLI
- you need multi-provider subtitle search with caching

## When to avoid
- you need a graphical subtitle editor
- you want to create or translate subtitles rather than download them

## Facets
- artifact type: library
- maturity: active
- function: cli, search-engine, http-client
- domain: media, developer-tools
- platform: python, cli, cross-platform
- tags: subtitles, video, metadata, pypi, automation

## Member repositories
- Diaoul/subliminal (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:09.134582+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:18:15.536290+00:00, confidence not recorded.
  - readme: https://github.com/Diaoul/subliminal (fetched 2026-08-28T04:07:09.134582+00:00, sha 7d410d47d24a)
  - registry_pypi: https://pypi.org/pypi/subliminal/json (fetched 2026-08-29T10:01:27.993634+00:00, sha fb8257c131a5)
- Data as of 2026-08-30T08:39:29.467469+00:00.