{"id":18598180,"url":"https://github.com/bbugyi200/tman","last_synced_at":"2025-05-16T14:10:57.720Z","repository":{"id":57476654,"uuid":"458896330","full_name":"bbugyi200/tman","owner":"bbugyi200","description":"Torrent manager enables you to download / seed your torrents on your own schedule.","archived":false,"fork":false,"pushed_at":"2023-01-17T19:26:35.000Z","size":72,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-17T23:47:31.646Z","etag":null,"topics":["cc-python","python"],"latest_commit_sha":null,"homepage":"https://tman.readthedocs.io/en/latest/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bbugyi200.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2022-02-13T18:31:09.000Z","updated_at":"2024-07-16T04:55:44.000Z","dependencies_parsed_at":"2023-02-10T11:33:03.172Z","dependency_job_id":null,"html_url":"https://github.com/bbugyi200/tman","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbugyi200%2Ftman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbugyi200%2Ftman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbugyi200%2Ftman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbugyi200%2Ftman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbugyi200","download_url":"https://codeload.github.com/bbugyi200/tman/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254544159,"owners_count":22088808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cc-python","python"],"created_at":"2024-11-07T01:31:24.065Z","updated_at":"2025-05-16T14:10:57.698Z","avatar_url":"https://github.com/bbugyi200.png","language":"Shell","readme":"# tman\n\n**Torrent manager enables you to download / seed your torrents on your own schedule.**\n\n_project status badges:_\n\n[![CI Workflow](https://github.com/bbugyi200/tman/actions/workflows/ci.yml/badge.svg)](https://github.com/bbugyi200/tman/actions/workflows/ci.yml)\n[![Coverage](https://codecov.io/gh/bbugyi200/tman/branch/master/graph/badge.svg)](https://codecov.io/gh/bbugyi200/tman)\n[![Documentation Status](https://readthedocs.org/projects/tman/badge/?version=latest)](https://tman.readthedocs.io/en/latest/?badge=latest)\n[![Package Health](https://snyk.io/advisor/python/torrent-manager/badge.svg)](https://snyk.io/advisor/python/torrent-manager)\n\n_version badges:_\n\n[![Project Version](https://img.shields.io/pypi/v/torrent-manager)](https://pypi.org/project/torrent-manager/)\n[![Python Versions](https://img.shields.io/pypi/pyversions/torrent-manager)](https://pypi.org/project/torrent-manager/)\n[![Cookiecutter: cc-python](https://img.shields.io/static/v1?label=cc-python\u0026message=2022.01.04\u0026color=d4aa00\u0026logo=cookiecutter\u0026logoColor=d4aa00)](https://github.com/python-boltons/cc-python)\n[![Docker: pythonboltons/main](https://img.shields.io/static/v1?label=pythonboltons%20%2F%20main\u0026message=2021.12.22\u0026color=8ec4ad\u0026logo=docker\u0026logoColor=8ec4ad)](https://github.com/python-boltons/docker-python)\n\n\n## Installation 🗹\n\n### Using `pipx` to Install (preferred)\n\nThis package _could_ be installed using pip like any other Python package (in\nfact, see the section below this one for instructions on how to do just that).\nGiven that we only need this package's entry points, however, we recommend that\n[pipx][11] be used instead:\n\n```shell\n# install and setup pipx\npython3 -m pip install --user pipx\npython3 -m pipx ensurepath\n\n# install tman\npipx install torrent-manager\n```\n\n### Using `pip` to Install\n\nTo install `tman` using [pip][9], run the following\ncommands in your terminal:\n\n``` shell\npython3 -m pip install --user torrent-manager  # install tman\n```\n\nIf you don't have pip installed, this [Python installation guide][10] can guide\nyou through the process.\n\n\n## Command-Line Interface (CLI)\n\nThe output from running `tman --help` is shown below:\n\n\u003c!-- [[[[[kooky.cog\nimport subprocess\n\npopen = subprocess.Popen([\"tman\", \"--help\"], stdout=subprocess.PIPE)\nstdout, _ = popen.communicate()\nprint(\"```\", stdout.decode().strip(), \"```\", sep=\"\\n\")\n]]]]] --\u003e\n```\nusage: tman [-h] [-c CONFIG_FILE] [-L [FILE[:LEVEL][@FORMAT]]] [-v]\n            {start,add} ...\n\nDon't have a good day. Have a great day.\n\noptional arguments:\n  -c CONFIG_FILE, --config CONFIG_FILE\n                        Absolute or relative path to a YAML file that contains\n                        this application's configuration.\n  -h, --help            show this help message and exit\n  -L [FILE[:LEVEL][@FORMAT]], --log [FILE[:LEVEL][@FORMAT]]\n                        This option can be used to enable a new logging\n                        handler. FILE should be either a path to a logfile or\n                        one of the following special file types: [1] 'stderr'\n                        to log to standard error (enabled by default), [2]\n                        'stdout' to log to standard out, [3] 'null' to disable\n                        all console (e.g. stderr) handlers, or [4] '+[NAME]'\n                        to choose a default logfile path (where NAME is an\n                        optional basename for the logfile). LEVEL can be any\n                        valid log level (i.e. one of ['CRITICAL', 'DEBUG',\n                        'ERROR', 'INFO', 'TRACE', 'WARNING']) and FORMAT can\n                        be any valid log format (i.e. one of ['color', 'json',\n                        'nocolor']). NOTE: This option can be specified\n                        multiple times and has a default argument of '+'.\n  -v, --verbose         How verbose should the output be? This option can be\n                        specified multiple times (e.g. -v, -vv, -vvv, ...).\n\nsubcommands:\n  {start,add}\n    start               Start the system's torrent service, add any missing\n                        torrents to it (i.e. torrents added via `tman add\n                        ...`), wait configured amount of time, and then\n                        shutdown the system torrent service we started\n                        earlier.\n    add                 Qeueue new torrent to download next time `tman start`\n                        is run.\n```\n\u003c!-- [[[[[end]]]]] --\u003e\n\n\u003c!-- [[[[[kooky.cog\nfrom pathlib import Path\n\nlines = Path(\"./docs/design/design.md\").read_text().split(\"\\n\")\nif any(L.strip() for L in lines):\n    fixed_lines = [L.replace(\"(.\", \"(./docs/design\") if L.startswith(\"![\") else L for L in lines]\n    print(\"## Design Diagrams\\n\")\n    print(\"\\n\".join(fixed_lines))\n]]]]] --\u003e\n\u003c!-- [[[[[end]]]]] --\u003e\n\n\n## Useful Links 🔗\n\n* [API Reference][3]: A developer's reference of the API exposed by this\n  project.\n* [cc-python][4]: The [cookiecutter][5] that was used to generate this project.\n  Changes made to this cookiecutter are periodically synced with this project\n  using [cruft][12].\n* [CHANGELOG.md][2]: We use this file to document all notable changes made to\n  this project.\n* [CONTRIBUTING.md][7]: This document contains guidelines for developers\n  interested in contributing to this project.\n* [Create a New Issue][13]: Create a new GitHub issue for this project.\n* [Documentation][1]: This project's full documentation.\n\n\n[1]: https://tman.readthedocs.io/en/latest\n[2]: https://github.com/bbugyi200/tman/blob/master/CHANGELOG.md\n[3]: https://tman.readthedocs.io/en/latest/modules.html\n[4]: https://github.com/python-boltons/cc-python\n[5]: https://github.com/cookiecutter/cookiecutter\n[6]: https://docs.readthedocs.io/en/stable/\n[7]: https://github.com/bbugyi200/tman/blob/master/CONTRIBUTING.md\n[8]: https://github.com/bbugyi200/tman\n[9]: https://pip.pypa.io\n[10]: http://docs.python-guide.org/en/latest/starting/installation/\n[11]: https://github.com/pypa/pipx\n[12]: https://github.com/cruft/cruft\n[13]: https://github.com/bbugyi200/tman/issues/new/choose\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbugyi200%2Ftman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbugyi200%2Ftman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbugyi200%2Ftman/lists"}