Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Subtitles downloader for command line
Python
branch: master

This branch is 1 commit behind creckx:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
subtitler
README
setup.py

README

=========
Subtitler
=========

Subtitler is a small tool for downloading subtitles from OpenSubtitles.org,
contains a simple library for theirs XML-RPC API.

Right now you can download subtitles for films, series by hash or just write
search query and manage searching by your self. It is automatic tool and
suitable for automatic downloading, you will LOVE IT!

In next few days/weeks I want to add a simple Qt frontend suitable for doing
Krusader's action or any other file manager's action. It will be usable by media
players too, at least I hope.

-----
Usage
-----

	usage: subtitler [-h] [-l lang] [-q] [-d] file/query [file/query ...]

	Subtitles downloader

	positional arguments:
	file/query  video files or query

	optional arguments:
	-h, --help  show this help message and exit
	-l lang     Subtitles language (default: cze)
	-q          Search subtitle (by fulltext)
	-d          Download subtitles for files (by hash)


--------
Examples
--------

	subtitler -d *.avi
	subtitler -d video1.avi video2.mkv video3.mp4
	subtitler -q The best film ever
	subtitler -q "The best film ever"
	subtitler -l eng -d *.avi
	subtitler -l eng,cze -d *.avi


--------
Install
--------

	As root run this command:

		pip install subtitler

	If you have a source on your computer, run:

		python setup.py install

	As a normal user, prefer first option.

	If you want upgrade subtitler, use pip:

		pip install subtitler --upgrade
	
	Or reinstall it from source.


--------
TODO
--------

	* Upload of subtitles
	* Own API code
	* Remeber language selection (usefull for other langs than mine)


--------
Changes
--------

	1.2

	* Better error handling
	* Other langs support

This program is released under BSD licence. Be free use it for anything, just
write there my name, thanks.
Something went wrong with that request. Please try again.