|
4 years ago | |
---|---|---|
tv_series | 4 years ago | |
.gitignore | 4 years ago | |
LICENSE | 8 years ago | |
NOTICE | 8 years ago | |
README.md | 4 years ago | |
setup.py | 4 years ago | |
tv-series-download-subs | 8 years ago | |
tv-series-find-episode-ids | 8 years ago | |
tv-series-matches-approve | 8 years ago | |
tv-series-matches-check-approved | 8 years ago | |
tv-series-matches-print-approved | 8 years ago | |
tv-series-migrate | 8 years ago | |
tv-series-search-subs | 8 years ago |
README.md
TV Series Tools
- Download subtitles for all TV series episodes.
- Search subtitles for specific expressions.
Installation
Mac
$ brew install python
$ pip install --user --upgrade .
Arch Linux
# pacman -S python
$ pip install --user --upgrade .
Other systems
Install these dependencies manually:
- Python 3
Then run:
$ pip install --user --upgrade .
Usage
This software works in several phases:
1. Find IMDB IDs for all episodes of passed TV series
Create a file containing the names of the TV series you are interested in. One
title per line. Empty lines and lines starting with the hash sign (#
) are
ignored. Example:
my_series.txt:
Arrested Development
Six Feet Under
True Detective
# this is a comment
Then call:
tv-series-find-episode-ids -i my_series.txt -o my_episodes.csv
Episode IDs and titles for all the TV series mentioned in my_series.txt
will be written to my_episode_ids.csv
like this:
2510426;"Title of the episode"
2580386;"Title of the episode"
2639284;"Title of the episode"
2545702;"Title of the episode"
2639288;"Title of the episode"
2. Download subtitles for passed IMDB IDs
Sign up at OpenSubtitles.org. Consider buying a VIP account, otherwise you will hit the download limit very soon.
Set environment variables OPENSUB_USER
and OPENSUB_PASSWD
to contain your
OpenSubtitles.org credentials.
export OPENSUB_USER='you@example.com'
export OPENSUB_PASSWD='yourpassword'
Then call:
tv-series-download-subs -i my_episodes.csv -o my_subs/
All the episodes's subtitles will be downloaded to the directory my_subs/
as
SRT files.
3. Search downloaded subtitles
my_regex.txt:
one.*regular expression per line
case insensitive
tv-series-search-subs -i my_subs/ -p my_regex.txt -o my_matches.csv
4. Approve matches
tv-series-matches-approve -i my_matches.csv -o my_answers.csv
5. Check all positive answers again
tv-series-matches-check-approved -i my_answers.csv -o my_answers_checked.csv
5. Print all positive answers
tv-series-matches-print-approved -i my_answers_checked.csv
Help
Call any of the executables mentioned in Usage with the parameter -h
or --help
to see full documentation. Example:
tv-series-download-subs -h
Contributing
Feel free to remix this piece of software. See NOTICE and LICENSE for license information.