altyazi
v0.1.3
Published
Interactive CLI for searching and downloading subtitles from OpenSubtitles.
Readme
altyazi
altyazi is a TypeScript CLI for searching and downloading subtitles from OpenSubtitles.
Usage
altyazi --help
altyazi
altyazi config
altyazi config --language Turkish
altyazi search --hash
altyazi search --hash severance
altyazi search --name "Severance" --season 2 --episode 4The command altyazi opens the full guided flow. It helps configure missing OpenSubtitles settings, lets you choose hash search or name search, opens an interactive video file selector when needed, and downloads the selected subtitle beside the chosen video file.
The default language is stored in config and reused automatically. altyazi config shows all configurable values: language, OpenSubtitles API key, User-Agent string, and overwrite behavior. Existing values can be kept without retyping them.
Authentication
OpenSubtitles requires an API key and User-Agent on API requests. Downloads do not require username/password login. If you see errors such as You cannot consume this service, run config first:
altyazi configYou can also set credentials with environment variables:
OPEN_SUBTITLES_API_KEY=your_api_key
OPEN_SUBTITLES_USER_AGENT="altyazi v0.1.0"The config flow stores your API key and User-Agent. No username, password, or bearer token is needed.
To get the API key, visit https://www.opensubtitles.com/consumers to create a API consumer.
Development
Install dependencies:
bun installBuild:
bun run buildRun tests:
bun testRun the CLI locally:
node dist/index.js