Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bbugyi200/tman
Torrent manager enables you to download / seed your torrents on your own schedule.
https://github.com/bbugyi200/tman
cc-python python
Last synced: 9 days ago
JSON representation
Torrent manager enables you to download / seed your torrents on your own schedule.
- Host: GitHub
- URL: https://github.com/bbugyi200/tman
- Owner: bbugyi200
- Created: 2022-02-13T18:31:09.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-01-17T19:26:35.000Z (almost 2 years ago)
- Last Synced: 2024-11-07T01:39:35.905Z (about 2 months ago)
- Topics: cc-python, python
- Language: Shell
- Homepage: https://tman.readthedocs.io/en/latest/
- Size: 70.3 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# tman
**Torrent manager enables you to download / seed your torrents on your own schedule.**
_project status badges:_
[](https://github.com/bbugyi200/tman/actions/workflows/ci.yml)
[](https://codecov.io/gh/bbugyi200/tman)
[](https://tman.readthedocs.io/en/latest/?badge=latest)
[](https://snyk.io/advisor/python/torrent-manager)
_version badges:_
[](https://pypi.org/project/torrent-manager/)
[](https://pypi.org/project/torrent-manager/)
[](https://github.com/python-boltons/cc-python)
[](https://github.com/python-boltons/docker-python)
## Installation 🗹
### Using `pipx` to Install (preferred)
This package _could_ be installed using pip like any other Python package (in
fact, see the section below this one for instructions on how to do just that).
Given that we only need this package's entry points, however, we recommend that
[pipx][11] be used instead:
```shell
# install and setup pipx
python3 -m pip install --user pipx
python3 -m pipx ensurepath
# install tman
pipx install torrent-manager
```
### Using `pip` to Install
To install `tman` using [pip][9], run the following
commands in your terminal:
``` shell
python3 -m pip install --user torrent-manager # install tman
```
If you don't have pip installed, this [Python installation guide][10] can guide
you through the process.
## Command-Line Interface (CLI)
The output from running `tman --help` is shown below:
```
usage: tman [-h] [-c CONFIG_FILE] [-L [FILE[:LEVEL][@FORMAT]]] [-v]
{start,add} ...
Don't have a good day. Have a great day.
optional arguments:
-c CONFIG_FILE, --config CONFIG_FILE
Absolute or relative path to a YAML file that contains
this application's configuration.
-h, --help show this help message and exit
-L [FILE[:LEVEL][@FORMAT]], --log [FILE[:LEVEL][@FORMAT]]
This option can be used to enable a new logging
handler. FILE should be either a path to a logfile or
one of the following special file types: [1] 'stderr'
to log to standard error (enabled by default), [2]
'stdout' to log to standard out, [3] 'null' to disable
all console (e.g. stderr) handlers, or [4] '+[NAME]'
to choose a default logfile path (where NAME is an
optional basename for the logfile). LEVEL can be any
valid log level (i.e. one of ['CRITICAL', 'DEBUG',
'ERROR', 'INFO', 'TRACE', 'WARNING']) and FORMAT can
be any valid log format (i.e. one of ['color', 'json',
'nocolor']). NOTE: This option can be specified
multiple times and has a default argument of '+'.
-v, --verbose How verbose should the output be? This option can be
specified multiple times (e.g. -v, -vv, -vvv, ...).
subcommands:
{start,add}
start Start the system's torrent service, add any missing
torrents to it (i.e. torrents added via `tman add
...`), wait configured amount of time, and then
shutdown the system torrent service we started
earlier.
add Qeueue new torrent to download next time `tman start`
is run.
```
## Useful Links 🔗
* [API Reference][3]: A developer's reference of the API exposed by this
project.
* [cc-python][4]: The [cookiecutter][5] that was used to generate this project.
Changes made to this cookiecutter are periodically synced with this project
using [cruft][12].
* [CHANGELOG.md][2]: We use this file to document all notable changes made to
this project.
* [CONTRIBUTING.md][7]: This document contains guidelines for developers
interested in contributing to this project.
* [Create a New Issue][13]: Create a new GitHub issue for this project.
* [Documentation][1]: This project's full documentation.
[1]: https://tman.readthedocs.io/en/latest
[2]: https://github.com/bbugyi200/tman/blob/master/CHANGELOG.md
[3]: https://tman.readthedocs.io/en/latest/modules.html
[4]: https://github.com/python-boltons/cc-python
[5]: https://github.com/cookiecutter/cookiecutter
[6]: https://docs.readthedocs.io/en/stable/
[7]: https://github.com/bbugyi200/tman/blob/master/CONTRIBUTING.md
[8]: https://github.com/bbugyi200/tman
[9]: https://pip.pypa.io
[10]: http://docs.python-guide.org/en/latest/starting/installation/
[11]: https://github.com/pypa/pipx
[12]: https://github.com/cruft/cruft
[13]: https://github.com/bbugyi200/tman/issues/new/choose