{"id":16027008,"url":"https://github.com/alexpdev/torrentfile","last_synced_at":"2025-07-26T13:12:12.110Z","repository":{"id":38039683,"uuid":"332588914","full_name":"alexpdev/torrentfile","owner":"alexpdev","description":"Bittorrent Protocol v1 \u0026 v2  metafile creator, checker, editor, builder, reviewer.  Assemble .torrent files from the command line.","archived":false,"fork":false,"pushed_at":"2024-04-27T05:16:24.000Z","size":11292,"stargazers_count":49,"open_issues_count":4,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-03T21:10:18.748Z","etag":null,"topics":["bencode","bittorrent","cli","p2p","torrent","torrent-files"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexpdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-25T00:31:09.000Z","updated_at":"2025-04-26T03:59:54.000Z","dependencies_parsed_at":"2024-03-22T07:42:27.324Z","dependency_job_id":"fcbfa8d7-e848-4f10-9794-cf717665a62d","html_url":"https://github.com/alexpdev/torrentfile","commit_stats":null,"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/alexpdev/torrentfile","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Ftorrentfile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Ftorrentfile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Ftorrentfile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Ftorrentfile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexpdev","download_url":"https://codeload.github.com/alexpdev/torrentfile/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpdev%2Ftorrentfile/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263499201,"owners_count":23476023,"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":["bencode","bittorrent","cli","p2p","torrent","torrent-files"],"created_at":"2024-10-08T20:04:34.736Z","updated_at":"2025-07-13T21:06:39.775Z","avatar_url":"https://github.com/alexpdev.png","language":"Python","readme":"# TorrentFile\n\n![torrentfile](https://github.com/alexpdev/torrentfile/blob/master/site/images/torrentfile.png?raw=true)\n\n* * *\n\n![GitHub repo size](https://img.shields.io/github/repo-size/alexpdev/torrentfile?color=orange)\n![GitHub License](https://img.shields.io/github/license/alexpdev/torrentfile?color=red\u0026logo=apache)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/torrentfile?color=brown)\n![GitHub Last Commit](https://badgen.net/github/last-commit/alexpdev/torrentfile?color=blue)\n[![CI](https://github.com/alexpdev/TorrentFile/actions/workflows/pyworkflow.yml/badge.svg?branch=master\u0026event=push)](https://github.com/alexpdev/torrentfile/actions/workflows/pyworkflow.yml)\n[![Codacy Badge](https://app.codacy.com/project/badge/Coverage/b67ff65b3d574025b65b6587266bbab7)](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=alexpdev/torrentfile\u0026utm_campaign=Badge_Coverage)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/b67ff65b3d574025b65b6587266bbab7)](https://www.codacy.com/gh/alexpdev/torrentfile/dashboard?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=alexpdev/torrentfile\u0026utm_campaign=Badge_Grade)\n[![DeepSource](https://deepsource.io/gh/alexpdev/TorrentFile.svg/?label=active+issues\u0026token=16Sl_dF7nTU8YgPilcqhvHm8)](https://deepsource.io/gh/alexpdev/torrentfile/)\n[![codecov](https://codecov.io/gh/alexpdev/torrentfile/branch/master/graph/badge.svg?token=EWF7NIL9SQ)](https://codecov.io/gh/alexpdev/torrentfile?color=navy\u0026logo=codecov)\n\n## 🌐 Overview\n\nA command line interface for creating, reviewing, editing, or verifying bittorrent meta files (`.torrent` files).\n_`torrentfile`_ is open source, and supports all versions of Bittorrent files, including hybrid meta files. The code base\nis also importable and can easily be used as a library for creating or manipulating torrent files in external projects.\nDocumentation is available at [https://alexpdev.github.io/torrentfile](https://alexpdev.github.io/torrentfile).\n\n\u003e A GUI frontend for this project can be found at \u003chttps://github.com/alexpdev/TorrentfileQt\u003e\n\n## 🔌 Requirements\n\n- Python 3.6+\n- Tested on Linux, Windows and Mac\n\n## 💻 Install\n\n**PyPi:**\n\n```bash\npip install torrentfile\n```\n\n**Git:**\n\n```bash\ngit clone https://github.com/alexpdev/torrentfile.git\ncd torrentfile\npip install .\n```\n\n\u003e Download pre-compiled binaries from the [release page](https://github.com/alexpdev/torrentfile/releases).\n\n## 📚 Documentation\n\n### torrentfile documentation available at [https://alexpdev.github.io/torrentfile](https://alexpdev.github.io/torrentfile)\n\n## 🚀 Usage\n\n![Basic Usage](https://github.com/alexpdev/torrentfile/blob/master/assets/Torrentfile.gif?raw=True)\n\n\u003e Usage examples can be found in the project documentation on the [examples page.](https://alexpdev.github.io/torrentfile/usage)\n\n## 📝 License\n\nApache Software License v2.0 - See [LICENSE](\"https://github.com/alexpdev/torrentfile/blob/master/LICENSE\")\n\n## 💡 Issues \u0026 Requests \u0026 PRs\n\nIf you encounter any bugs or would like to request a new feature please open a new issue.\nPRs and other contributions that are meaningful and add value to the project are welcome.\n\n* * *\n\n## Usage Examples\n\n### Creating Bittorrent Files\n\nCreating a basic torrent file is as easy as using the create subcommand with the path to the torrent file.\n\n```bash\ntorrentfile create /path/to/content\n```\n\nYou can add one or more trackers by using any one of `-a`, `--announce`\nflags and listing their URL as a space separated list.\n\n```bash\ntorrentfile create /path/to/content -a http://tracker1.com http://tracker2.net\n```\n\nIf you intend to distribute the file on a private tracker then you should use one  \nof `-p`, `--private` flags, which tells your Bittorrent clients to disable DHT and  \nmultitracker protocols.\n\n```bash\ntorrentfile create /path/to/content --private\n```\n\nBy default **`torrentfile`** displays a progress bar indicating how much of the content  \nhas already been processed.  To turn off this display you can either use `--quiet` mode in  \nas a global flag or you can set the `--prog` flag to 0.\n\n```bash\ntorrentfile create /path/to/content --prog 0\n```\n\n**`torrentfile`** extracts the name of the contents top level file or directory  \nand saves the torrent file to the current working directory with the extracted title.\n\nFor example running the follwing command would create `./content.torrent`.\n\n```bash\ntorrentfile create /path/to/content\n```\n\nTo specify an alternative path or filename you may use the `-o`, `--out` flags  \nfollowed by the path to the preferred destination.\n\n```bash\ntorrentfile create /path/to/content -o /some/other/path/torrent.torrent\n```\n\nIf the path specified is an existing directory, then the torrent file will be\nsaved to that directory, with same filename as the default top level path name.\n\nFor example the following command would create a torrent file at `/some/other/path/content.torrent`.\n\n```bash\ntorrentfile create /path/to/content -o /some/other/path/\n```\n\n_`torrentfile`_ creates Bittorrent v1 files by default. To create a V2 or hybrid (v1 and v2)\ntorrent file, use the `--meta-version` option followed by the preferred version number option.\nThe options include:  `1`(v1 default), `2`(v2), or `3`(v1 \u0026 v2).\n\n```bash\ntorrentfile create /path/to/content --meta-version 2\n```\n\n```bash\ntorrentfile create /path/to/content --meta-version 3 \n```\n\n`torrentfile` includes the option to command line flags for the `create` sub-command from an `ini` style\nconfiguration file, by using the `--config` and optional `--config-path` options to specify the path\nto the configuration file.  If `--config-path` is ommited, then `torrentfile` will look by default in the current\nworking directory for a file named `torrentfile.ini`. If the file is not discovered in the current working directory,\nit will move on to look `~/.torrentfile/torrentfile.ini` followed by `~/.config/torrentfile.ini`.  Please see the\n[documentation](https://alexpdev.github.io/torrentfile/overview/) for more details on how the configuration file should be\nformatted.\n\n### Check/Recheck Torrent\n\nThe `recheck` subcommand allows you to scan a Bittorrent file and compare it's contents,\nagainst a file or directory containing the contents the torrent file was created from.\nThe output provided by this process gives a detailed perspective if any files are missing\nor have been corrupted in any way.  Supports any version of Bittorrent file.\n\n```bash\ntorrentfile recheck /path/to/some.torrent /path/to/content\n```\n\n### Edit Torrent\n\nTo edit specific fields of the torrent file, there is the `edit` subcommand.  Using this\nsubcommand you can specify the field with one of the available field flags, for example\n`--announce` and specify the value you wish to change it to.\n\n```bash\ntorrentfile edit /path/to/content --announce https://new.tracker.url1.com  https://newtracker.url/2\n```\n\nYou can use the `-h` flag for a full list of available fields that can be edited.\n\n```bash\ntorrentfile edit -h\n```\n\n### Create Magnet\n\nTo create a magnet URI for a pre-existing torrent meta file, use the sub-command  \n`magnet` with the path to the torrent file.\n\n```bash\ntorrentfile magnet /path/to/some.torrent\n```\n\n### GUI\n\nIf you prefer a windowed GUI please check out the official GUI frontend [here](https://github.com/alexpdev/TorrentFileQt)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpdev%2Ftorrentfile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexpdev%2Ftorrentfile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpdev%2Ftorrentfile/lists"}