Metadata-Version: 2.2
Name: videobox
Version: 0.8.0
Summary: Easy TV series download
Author: Andrea Peltrin
Project-URL: Homepage, https://github.com/passiomatic/videobox
Project-URL: Bug Tracker, https://github.com/passiomatic/videobox/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Framework :: Flask
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: peewee<4,>=3.15.4
Requires-Dist: urllib3<2
Requires-Dist: requests<3,>=2.31.0
Requires-Dist: flask<3,>=2.3.3
Requires-Dist: waitress<4,>=3.0.1
Requires-Dist: tomli<3,>=2.0.1
Requires-Dist: tomli-w<2,>=1.0.0
Requires-Dist: chardet==5.2.0
Requires-Dist: libtorrent<2.1,>=2.0.9

# Videobox

Videobox is a Python web app that lets you discover and download the latest TV series without annoying ads, tracking scripts, and crypto mining stuff.

![The Videobox home page](screenshot.jpg)

## Prerequisites

Videobox requires the Python 3 programming language to be installed on your machine. If you are not familiar with it please refer to the official Python's [download page][d] for more information. 

To check if you have Python installed type the following after in your terminal prompt (`$`):

```
$ python --version 
Python 3.9.6
```

Any Python version starting from 3.9 should run Videobox just fine. 

**Note**: Videobox is a BitTorrent client so it can download series episodes without any other software. Additionally you can use your favourite BitTorrent client (like [uTorrent](https://www.utorrent.com), [Transmission](https://transmissionbt.com), etc.) with magnet links.

## Installation

You can install Videobox along with the main Python installation of your machine or in so-called "virtual environment", which is the recommended approach, since its dependencies may clash with packages you have already installed. [Learn more about virtual environments][venv]. 

Install or update Videobox from [PyPI][2] via the Python `pip` utility. Again, type the following command in your terminal:

```
$ python -m pip install -U videobox
```

## Quick start

You use Videobox via its web interface. To access it, start the `videobox` command on the terminal and point the web browser to the given URL:

```
$ videobox
Videobox has started. Point your browser to http://localhost:8080 to use the web interface.
Attempt to sync library... done, added 157 torrents.
Update swarm information... done, updated 1000 torrents.
Update completed, press CTRL+C to quit.
```

At startup Videobox updates its library and will attempt to do it again periodically.

Add `--help` to list all the available options:

```
$ videobox --help 
Usage: videobox [OPTIONS]

Options:
  --host TEXT     Hostname or IP address on which to listen. Default is
                  0.0.0.0, which means "all IP addresses on this host".
  --port INTEGER  TCP port on which to listen, default is 8080
  --help          Show this message and exit.
```

Don't miss the [wiki section][wiki] with contains developer documentation and in-depth information about using Videobox. If your are interested in hacking the source code or contribute to the project see the [contributing document][contrib]. 

## Roadmap

This is a rough plan of what I would like to implement in the upcoming releases:

* **0.8.x**: Automatic episodes download.
* **0.9**: Support for "complete season" torrents.

## Credits 

[Phosphor Icons][i] created by Helena Zhang and Tobias Fried.


[2]: https://pypi.org/project/videobox/
[i]: https://phosphoricons.com
[d]: https://www.python.org/downloads/
[venv]: https://docs.python.org/3/library/venv.html
[contrib]: CONTRIBUTING.md
[wiki]: https://github.com/passiomatic/videobox/wiki
