# exebetche/vlsub

VLC extension to download subtitles from opensubtitles.org

Repository: https://github.com/exebetche/vlsub
Canonical: https://ross.abutalabs.com/products/vlsub
Language: Lua
License Family: other
Last push: 2023-09-27T18:45:44+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 5336, "days_push": 1071, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1401, forks 342 (observed 2026-08-28T04:04:37.275526+00:00)

## What it is
VLSub is a VLC media player extension written in Lua that searches opensubtitles.org and downloads subtitles for the currently playing video, either by file hash or by name. It installs into VLC's lua extensions directory and automatically loads downloaded subtitles into the player.

## Use cases
- download subtitles for a movie in vlc
- find subtitles by video file hash
- automatically load subtitles into vlc
- search opensubtitles from inside the player
- fix out-of-sync subtitles by picking another file

## When to choose
- you watch videos in VLC and want one-click subtitle downloads
- you want subtitles matched by file hash for accuracy
- you need a lightweight player extension rather than a separate app

## When to avoid
- you use VLC 2.1, which is unsupported
- your Windows video paths contain non-ASCII characters and you need automatic saving
- you need a player other than VLC

## Facets
- artifact type: plugin
- maturity: maintenance
- function: search-engine, http-client, file-upload
- domain: media, entertainment, developer-tools
- platform: windows, cross-platform
- tags: vlc-extension, subtitles, opensubtitles, lua, video-player, linux, macos

## Member repositories
- exebetche/vlsub (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:37.275526+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-30T04:39:02.312750+00:00, confidence not recorded.
  - readme: https://github.com/exebetche/vlsub (fetched 2026-08-28T04:04:37.275526+00:00, sha f65521fb5b03)
- Data as of 2026-08-30T08:39:29.467469+00:00.