https://github.com/facorread/rust-download-subtitles
A client for the OpenSubtitles API
https://github.com/facorread/rust-download-subtitles
Last synced: 10 months ago
JSON representation
A client for the OpenSubtitles API
- Host: GitHub
- URL: https://github.com/facorread/rust-download-subtitles
- Owner: facorread
- License: apache-2.0
- Created: 2022-09-30T19:18:28.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-10-22T21:57:34.000Z (over 2 years ago)
- Last Synced: 2025-03-18T17:52:48.314Z (over 1 year ago)
- Language: Rust
- Size: 48.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: license.md
Awesome Lists containing this project
README
# rust-download-subtitles
Download subtitles for TV shows from OpenSubtitles
Copyright © 2022 Fabio A. Correa Duran facorread@gmail.com
This is a client for the new OpenSubtitles.com REST API. The software focuses on downloading subtitles for TV shows, while respecting the OpenSubtitles download limits per account and per session. The client is published in source code form, so that anyone can customize the output file names or folders.
The config.ron file specifies the TV show, season, and episodes. It also requires an API key and a valid account. You can obtain an API key at
https://www.opensubtitles.com/en/consumers
## Development notes
`rust-download-subtitles` uses `tokio` to process episodes asynchronously. One task is spawned per episode. The main task maintains the HTTP connection to OpenSubtitles.com, authenticates the user, and enforces the download and request limits.
This client does not aim to be a complete solution. It does not implement any command-line or environment-variable parsing. Also, it does not offer an API.