{"id":16096355,"url":"https://github.com/sio/watchdir","last_synced_at":"2025-04-05T20:29:36.603Z","repository":{"id":101312975,"uuid":"157432623","full_name":"sio/watchdir","owner":"sio","description":"Use multiple watch directories with any torrent client","archived":false,"fork":false,"pushed_at":"2023-05-05T13:05:56.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-11T20:49:55.019Z","etag":null,"topics":["daemon","python","script","torrent","torrent-management","torrents","transmission","transmission-daemon","transmission-remote","watch","watcher"],"latest_commit_sha":null,"homepage":null,"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/sio.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2018-11-13T19:13:32.000Z","updated_at":"2023-05-05T13:06:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"f2522712-cb2d-4fb8-918d-3e0da5852512","html_url":"https://github.com/sio/watchdir","commit_stats":{"total_commits":19,"total_committers":1,"mean_commits":19.0,"dds":0.0,"last_synced_commit":"50a6baada15054ee4dbf5258fb5cef539277467f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sio%2Fwatchdir","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sio%2Fwatchdir/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sio%2Fwatchdir/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sio%2Fwatchdir/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sio","download_url":"https://codeload.github.com/sio/watchdir/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247398136,"owners_count":20932671,"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":["daemon","python","script","torrent","torrent-management","torrents","transmission","transmission-daemon","transmission-remote","watch","watcher"],"created_at":"2024-10-09T17:13:43.882Z","updated_at":"2025-04-05T20:29:36.585Z","avatar_url":"https://github.com/sio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Multiple watch directories for any torrent client\n\n## Installation\n\nWatchdir can be installed with pip:\n\n```\n$ pip install https://github.com/sio/watchdir/archive/master.zip\n```\n\n\n## Usage with transmission-remote (default)\n\nAfter installing you can launch any number of watchdir instances via\n`transmission-watch`:\n\n```\nusage: transmission-watch [-h] WATCHDIR DESTINATION [extras [extras ...]]\n\nWatch for new torrent files in the specified directory\n\npositional arguments:\n  WATCHDIR     Path to watch directory with torrent files\n  DESTINATION  Path to download destination\n  extras       Any extra arguments will be passed to the torrent client \"as\n               is\"\n\noptional arguments:\n  -h, --help   show this help message and exit\n\nIf any of the provided directories do not exist, they will be created\n```\n\nIf `transmission-daemon` runs on non-default port or requires authentication,\nuse environment variables:\n\n- `TR_HOST=hostname:port`\n- `TR_AUTH=username:password`\n\n\n## Usage with other clients\n\nWatchdir can be easily tailored to fit any other torrent client:\n\n```python\nimport watchdir\nwatchdir.main(\n    client=YOUR_CLIENT_HANDLER,\n    post_process=YOUR_POSTPROCESSING_FUNCTION\n)\n```\n\nCheck [watchdir.py](watchdir.py) for function signatures of `client` and\n`post_process`.\n\nThe resulting script will provide the same commandline interface as\n`transmission-watch`.\n\n\n## Support and contributing\n\nIf you need help using watchdir from command line or including it into your\ncustom scripts, please create **[an issue](https://github.com/sio/watchdir/issues)**.\nIssues are also the primary venue for reporting bugs and posting feature\nrequests. General discussion related to this project is also acceptable and\nvery welcome!\n\nIn case you wish to contribute code or documentation, feel free to open **[a\npull request](https://github.com/sio/watchdir/pulls)**. That would certainly make\nmy day!\n\nI'm open to dialog and I promise to behave responsibly and treat all\ncontributors with respect. Please try to do the same, and treat others the way\nyou want to be treated.\n\nIf for some reason you'd rather not use the issue tracker, contacting me via\nemail is OK too. Please use a descriptive subject line to enhance visibility\nof your message. Also please keep in mind that public discussion channels are\npreferable because that way many other people may benefit from reading past\nconversations.  My email is visible under the GitHub profile and in the commit\nlog.\n\n\n## License and copyright\n\nCopyright 2018 Vitaly Potyarkin\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n        http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsio%2Fwatchdir","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsio%2Fwatchdir","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsio%2Fwatchdir/lists"}