{"id":15086048,"url":"https://github.com/hydrotho/telegram_qbittorrent_notifier","last_synced_at":"2026-01-03T15:08:45.010Z","repository":{"id":207340190,"uuid":"718038951","full_name":"hydrotho/Telegram_qBittorrent_Notifier","owner":"hydrotho","description":"A simple CLI tool for qBittorrent that sends a notification to Telegram chat via bot on torrent finished. 一个简单的用于 qBittorrent 的命令行工具，当种子下载完成时，通过 Telegram 机器人向聊天发送通知。","archived":false,"fork":false,"pushed_at":"2024-02-26T14:10:26.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-23T10:29:13.625Z","etag":null,"topics":["ffmpeg","qbittorrent","telegram"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hydrotho.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":"2023-11-13T08:45:16.000Z","updated_at":"2024-11-03T23:57:25.000Z","dependencies_parsed_at":"2023-11-15T09:44:58.739Z","dependency_job_id":"b03e667e-4c48-4b0a-a596-a83d298e1fc7","html_url":"https://github.com/hydrotho/Telegram_qBittorrent_Notifier","commit_stats":null,"previous_names":["hydrotho/telegram_qbittorrent_notifier"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydrotho%2FTelegram_qBittorrent_Notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydrotho%2FTelegram_qBittorrent_Notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydrotho%2FTelegram_qBittorrent_Notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hydrotho%2FTelegram_qBittorrent_Notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hydrotho","download_url":"https://codeload.github.com/hydrotho/Telegram_qBittorrent_Notifier/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243955714,"owners_count":20374372,"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":["ffmpeg","qbittorrent","telegram"],"created_at":"2024-09-25T07:04:52.498Z","updated_at":"2026-01-03T15:08:44.973Z","avatar_url":"https://github.com/hydrotho.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telegram_qBittorrent_Notifier\n\nA simple CLI tool for qBittorrent that sends a notification to Telegram chat via bot on torrent finished.\n\n## Quick Start\n\n### Installation\n\nDownload prebuilt statically-linked binaries from [Releases](https://github.com/hydrotho/Telegram_qBittorrent_Notifier/releases/latest) for Linux, Windows and macOS.\n\n### Configuration\n\nPlease refer to the [config example](config.example.yaml).\n\n### Integrate with qBittorrent\n\nIn the qBittorrent Web UI:\n\n1. Navigate to `Options` and select the `Downloads` tab.\n2. At the bottom, locate `Run external program on torrent finished`.\n   ![Run External Program](https://github.com/hydrotho/Telegram_qBittorrent_Notifier/assets/42911474/bb262e35-422f-4522-8530-4ad583d12798)\n\n### Handling Empty Category or Tags\n\nWhen using `%L` (Category) or `%G` (Tags), follow these formats to avoid errors:\n\n```sh\n❯ Telegram_qBittorrent_Notifier send -n \"%N\" -l \"6д9%L\"\n❯ Telegram_qBittorrent_Notifier send -n \"%N\" -g \"6д9%G\"\n❯ Telegram_qBittorrent_Notifier send -n \"%N\" -l \"6д9%L\" -g \"6д9%G\"\n```\n\nThese formats use \"6д9\" as a prefix to ensure that the CLI does not encounter parsing errors from empty values in `%L` or `%G`.\n\nYou can customize this magic word in the configuration file or by using the `--magic-word` option.\n\n### Thumbnail\n\nEnhance your notifications with the thumbnail feature for a more visually engaging experience.\n\nWhen a valid video file is specified via `--thumbnail-source` option, the tool uses FFmpeg to automatically generate a thumbnail, adding a visual element to your Telegram notifications.\n\n```sh\n❯ Telegram_qBittorrent_Notifier send --thumbnail-source \"%F\" -n \"%N\"\n```\n\nPlease ensure FFmpeg is installed and can be executed directly from the command line. The tool performs an automatic check for FFmpeg. In case FFmpeg is not detected or cannot be executed, the thumbnail generation will not take place.\n\n## Support\n\nIf you encounter any issues or have any suggestions, please [open an issue](https://github.com/hydrotho/Telegram_qBittorrent_Notifier/issues).\n\n## License\n\nThis project is licensed under the MIT License, see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhydrotho%2Ftelegram_qbittorrent_notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhydrotho%2Ftelegram_qbittorrent_notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhydrotho%2Ftelegram_qbittorrent_notifier/lists"}