TV Series Downloader [电视节目下载程序]

This Program is under active development

A small program to download TV and movies from websites, and saves files in a Plex-readable format.

This program does not provide any of the media content, instead, it grabs content through sites from the internet. Keep in mind that the copyright of all videos downloaded by this program belongs to the original creator.

谨记本程序下载的所有视频版权归原创者所有，本程序只提供下载服务，并不提供资源存储，也不参与录制、上传。 若本程序无意侵犯了贵司版权，请新增 Issue 提出 。

Installation and Usage

Setup and installation

pip install tvsd
tvsd --help # Show available commands

Update

pip install tvsd -U

Usage

tvsd search <your-search-query> # Search query for media from sources and downloads if available
tvsd clean-temp # Removes everything in temp downloading directory, useful after app crashed or aborted

More features coming soon, feel free to raise feature request or issues.

Contribution

Contributions are welcomed, contribution methods and accurate details will be included very soon.

git clone https://github.com/SheepYY039/tvsd.git
cd tvsd
make setup-dev-env # install pre-commit hooks
poetry install
# python3 setup.py install
cp .env.example .env # update .env according to your environment

Versioning

This project uses Commitizen to help release and versioning management.

• Fetch GitHub Version Tags: make fetch-tags
• Commit: cz commit
• Update Release Version: make bump
• Push GitHub Version Tag: make push-tag

Publish

poetry config pypi-token.pypi <my-pypi-token>
poetry build
poetry publish

Bulma Configuration

Quoting from the django-simple-bulma documentation

Run python manage.py collectstatic command in order to build Bulma and move it to your staticfiles folder. Please note that you will need to use this command every time you make a change to the configuration, as this is the only way to rebuild the Bulma css file.

poetry run python manage.py collectstatic

Features

• Search & Download Shows
• Track new episodes
• Web UI
• Docker
• Add Searching Progress Bar

Inspired By and Credits to

• https://github.com/hectorqin/reader
• Sonarr

免责声明（Disclaimer）

This program is only a tool for personal and mainly educational purposes, and also for those who would like to watch TV shows in environments without quality internet access, e.g. on the plane.

Responsibilities

By using this program to download any form of media ("content"), you are entirely responsible for the content of, and any harm resulting from, that Content. That is the case regardless of whether the Content in question constitutes text, graphics, an audio file, or computer software. By using this program, you represent and warrant that:

• the downloading, copying and use of the Content will not infringe the proprietary rights, including but not limited to the copyright, patent, trademark or trade secret rights, of any third party;
• you have fully complied with any third-party licenses relating to the Content, and have done all things necessary to successfully pass through to end users any required terms;
• the Content does not contain or install any viruses, worms, malware, Trojan horses or other harmful or destructive content;
• the Content does not contain unethical or unwanted commercial content designed to drive traffic to third party sites or boost the search engine rankings of third party sites, or to further unlawful acts (such as phishing) or mislead recipients as to the source of the material (such as spoofing);
• the Content is not pornographic, does not contain threats or incite violence, and does not violate the privacy or publicity rights of any third party;
• your content is not getting advertised via unwanted electronic messages such as spam links on newsgroups, email lists, blogs and websites, and similar unsolicited promotional methods;

Disclaimer of Warranties

The program is provided “as is”. The program and its suppliers and licensors hereby disclaim all warranties of any kind, express or implied, including, without limitation, the warranties of merchantability, fitness for a particular purpose and non-infringement. Neither this program nor its suppliers and licensors, makes any warranty that the program will be error free or that cess thereto will be continuous or uninterrupted. If you’re actually reading this, here’s a treat. You understand that you download from, or otherwise obtain content or services through, this program at your own discretion and risk.

This document is CC-BY-SA. It was last updated March 15, 2023.

Originally adapted from the Sonarr Terms of Service.