Sinhala Subtitles Downloader

This Python library makes it easy to download Sinhala subtitles for TV series and movies. It currently supports two websites, Baiscope and Cineru.

Installation

You can install the library using pip:

pip install sinhala_sub

Usage

To use the library, simply import it and call one of the following functions:

search(query, site=None)

Searches for available Sinhala subtitles for a given TV series or movie.

from sinhala_sub import SinhalaSubtitles 

# Create an instance of the SinhalaSubtitles class 
subtitles = SinhalaSubtitles() 

# Search for  Sinhala subtitles for Pirates of the Caribbean movie" 
results = subtitles.search('Pirates of the Caribbean') 

# Print the list of available subtitle files
for  result  in results: 
	print(result)

search subtitles with mentioning website :

results = subtitles.search('Pirates of the Caribbean', site='baiscopelk')

• query: The name of the TV series or movie.
• site: Optional. The website to search on. Can be "baiscopelk" or "cineru".

Returns a list of available Sinhala subtitle files.

download(page_url)

Downloads a Sinhala subtitle file from a given URL.

from sinhala_sub import SinhalaSubtitles

# Create an instance of the SinhalaSubtitles class
subtitles = SinhalaSubtitles()

# Download Sinhala subtitles for the movie "Pirates of the Caribbean: Dead Men Tell No Tales"
url = 'https://www.baiscopelk.com/pirates-of-the-caribbean-dead-men-tell-no-tales-2017-with-sinhala-subtitles/'
subtitles.download(url)

• page_url: The URL of the subtitle file to download.

Returns True if the download is successful, False otherwise.

bulk(bulk_url)

Downloads a bulk of Sinhala subtitle files from a given URL.

from sinhala_sub import SinhalaSubtitles

# Create an instance of the SinhalaSubtitles class
subtitles = SinhalaSubtitles()

# Download a bulk of Sinhala subtitles for the TV series "Supernatural"
url = 'https://www.baiscopelk.com/tv-series/supernatural-2005/'
subtitles.bulk(url)

• bulk_url: The URL of the subtitle file bulk to download.

Returns a list of downloaded subtitle files.

License

This library is released under the MIT license.