# TV Series Downloader [电视节目下载程序]
[](https://badge.fury.io/gh/SheepYY039%2FTVSD) [](https://badge.fury.io/py/tvsd)
[](https://pypi.python.org/pypi/tvsd/)
[](https://pypi.python.org/pypi/tvsd/)
[](http://pepy.tech/project/tvsd)
> This Program is under active development
A small program to download TV and movies from websites, and saves files in a [Plex](https://www.plex.tv/)-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
```bash
pip install tvsd
tvsd --help # Show available commands
```
### Update
```bash
pip install tvsd -U
```
### Usage
```bash
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.
```bash
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](https://github.com/commitizen-tools/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
```bash
poetry config pypi-token.pypi <my-pypi-token>
poetry build
poetry publish
```
## Features
- [x] 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](https://forums.sonarr.tv/tos).
Raw data
{
"_id": null,
"home_page": "https://github.com/sheepyy039/TVSD.git",
"name": "tvsd",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "download,tv,search,m3u8",
"author": "JYYYeung",
"author_email": "yeungjyy@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d1/f6/98826389fdb4e39ee40549d86a1fdd549637946a2031a28c4505ce53c00e/tvsd-1.3.4.tar.gz",
"platform": null,
"description": "# TV Series Downloader [\u7535\u89c6\u8282\u76ee\u4e0b\u8f7d\u7a0b\u5e8f]\n\n[](https://badge.fury.io/gh/SheepYY039%2FTVSD) [](https://badge.fury.io/py/tvsd)\n[](https://pypi.python.org/pypi/tvsd/)\n\n[](https://pypi.python.org/pypi/tvsd/)\n[](http://pepy.tech/project/tvsd)\n\n> This Program is under active development\n\nA small program to download TV and movies from websites, and saves files in a [Plex](https://www.plex.tv/)-readable format.\n\nThis program does not provide any of the media content, instead, it grabs content through sites from the internet. Keep\nin mind that the copyright of all videos downloaded by this program belongs to the original creator.\n\n\u8c28\u8bb0\u672c\u7a0b\u5e8f\u4e0b\u8f7d\u7684\u6240\u6709\u89c6\u9891\u7248\u6743\u5f52\u539f\u521b\u8005\u6240\u6709\uff0c\u672c\u7a0b\u5e8f\u53ea\u63d0\u4f9b\u4e0b\u8f7d\u670d\u52a1\uff0c\u5e76\u4e0d\u63d0\u4f9b\u8d44\u6e90\u5b58\u50a8\uff0c\u4e5f\u4e0d\u53c2\u4e0e\u5f55\u5236\u3001\u4e0a\u4f20\u3002\n\u82e5\u672c\u7a0b\u5e8f\u65e0\u610f\u4fb5\u72af\u4e86\u8d35\u53f8\u7248\u6743\uff0c\u8bf7\u65b0\u589e Issue \u63d0\u51fa \u3002\n\n## Installation and Usage\n\n### Setup and installation\n\n```bash\npip install tvsd\ntvsd --help # Show available commands\n```\n\n### Update\n\n```bash\npip install tvsd -U\n```\n\n### Usage\n\n```bash\ntvsd search <your-search-query> # Search query for media from sources and downloads if available\ntvsd clean-temp # Removes everything in temp downloading directory, useful after app crashed or aborted\n```\n\nMore features coming soon, feel free to raise feature request or issues.\n\n## Contribution\n\nContributions are welcomed, contribution methods and accurate details will be included very soon.\n\n```bash\ngit clone https://github.com/SheepYY039/tvsd.git\ncd tvsd\nmake setup-dev-env # install pre-commit hooks\npoetry install\n# python3 setup.py install\ncp .env.example .env # update .env according to your environment\n```\n\n### Versioning\n\nThis project uses [Commitizen](https://github.com/commitizen-tools/commitizen) to help release and versioning management.\n\n- Fetch GitHub Version Tags: `make fetch-tags`\n- Commit: `cz commit`\n- Update Release Version: `make bump`\n- Push GitHub Version Tag: `make push-tag`\n\n### Publish\n\n```bash\npoetry config pypi-token.pypi <my-pypi-token>\npoetry build\npoetry publish\n```\n\n## Features\n\n- [x] Search & Download Shows\n- [ ] Track new episodes\n- [ ] Web UI\n- [ ] Docker\n- [ ] Add Searching Progress Bar\n\n## Inspired By and Credits to\n\n- <https://github.com/hectorqin/reader>\n- Sonarr\n\n## \u514d\u8d23\u58f0\u660e\uff08Disclaimer\uff09\n\nThis program is only a tool for personal and mainly educational purposes, and also for those who would like to watch TV\nshows in environments without quality internet access, e.g. on the plane.\n\n### Responsibilities\n\nBy using this program to download any form of media (\"content\"), you are entirely responsible for the content of, and\nany harm resulting from, that Content. That is the case regardless of whether the Content in question constitutes text,\ngraphics, an audio file, or computer software. By using this program, you represent and warrant that:\n\n- the downloading, copying and use of the Content will not infringe the proprietary rights, including but not limited to\n the copyright, patent, trademark or trade secret rights, of any third party;\n- you have fully complied with any third-party licenses relating to the Content, and have done all things necessary to\n successfully pass through to end users any required terms;\n- the Content does not contain or install any viruses, worms, malware, Trojan horses or other harmful or destructive\n content;\n- the Content does not contain unethical or unwanted commercial content designed to drive traffic to third party sites\n or boost the search engine rankings of third party sites, or to further unlawful acts (such as phishing) or mislead\n recipients as to the source of the material (such as spoofing);\n- the Content is not pornographic, does not contain threats or incite violence, and does not violate the privacy or\n publicity rights of any third party;\n- your content is not getting advertised via unwanted electronic messages such as spam links on newsgroups, email lists,\n blogs and websites, and similar unsolicited promotional methods;\n\n### Disclaimer of Warranties\n\nThe program is provided \u201cas is\u201d. The program and its suppliers and licensors hereby disclaim all warranties of any kind,\nexpress or implied, including, without limitation, the warranties of merchantability, fitness for a particular purpose\nand non-infringement. Neither this program nor its suppliers and licensors, makes any warranty that the program will be\nerror free or that cess thereto will be continuous or uninterrupted. If you\u2019re actually reading this, here\u2019s a treat.\nYou understand that you download from, or otherwise obtain content or services through, this program at your own\ndiscretion and risk.\n\nThis document is CC-BY-SA. It was last updated March 15, 2023.\n\nOriginally adapted from the [Sonarr Terms of Service](https://forums.sonarr.tv/tos).\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "search and downloads TV and movies from websites",
"version": "1.3.4",
"project_urls": {
"Changelog": "https://github.com/sheepyy039/TVSD/blob/main/CHANGELOG.md",
"Documentation": "https://sheepyy039.github.io/TVSD",
"Homepage": "https://github.com/sheepyy039/TVSD.git",
"Repository": "https://github.com/sheepyy039/TVSD.git"
},
"split_keywords": [
"download",
"tv",
"search",
"m3u8"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "485101598203aeb128e37af6e767aa0599b222d28e2b6ae2e3cbd4f314fd14ea",
"md5": "779253e08fe36b941591831fb95c8840",
"sha256": "37776be8c18f71b796859c522529d82a1d30e97973f49fb4193db141bb80014d"
},
"downloads": -1,
"filename": "tvsd-1.3.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "779253e08fe36b941591831fb95c8840",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 36518,
"upload_time": "2024-02-15T16:40:50",
"upload_time_iso_8601": "2024-02-15T16:40:50.931975Z",
"url": "https://files.pythonhosted.org/packages/48/51/01598203aeb128e37af6e767aa0599b222d28e2b6ae2e3cbd4f314fd14ea/tvsd-1.3.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d1f698826389fdb4e39ee40549d86a1fdd549637946a2031a28c4505ce53c00e",
"md5": "b6973070f877f6269d92c1e027b243b2",
"sha256": "ff9631eac86e3acbbb03055201d94e9be2eb3e6e156816bb70b8cace8b61bae7"
},
"downloads": -1,
"filename": "tvsd-1.3.4.tar.gz",
"has_sig": false,
"md5_digest": "b6973070f877f6269d92c1e027b243b2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 29083,
"upload_time": "2024-02-15T16:40:52",
"upload_time_iso_8601": "2024-02-15T16:40:52.557617Z",
"url": "https://files.pythonhosted.org/packages/d1/f6/98826389fdb4e39ee40549d86a1fdd549637946a2031a28c4505ce53c00e/tvsd-1.3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-15 16:40:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sheepyy039",
"github_project": "TVSD",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "tvsd"
}
JSON
