{"id":13821868,"url":"https://github.com/iRay/TeleTor","last_synced_at":"2025-05-16T15:31:38.327Z","repository":{"id":43361563,"uuid":"156555349","full_name":"iRay/TeleTor","owner":"iRay","description":"Telegram Torrents Bot","archived":false,"fork":false,"pushed_at":"2023-10-18T01:49:03.000Z","size":12384,"stargazers_count":74,"open_issues_count":2,"forks_count":32,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-05-30T01:04:01.838Z","etag":null,"topics":["telegram","telegram-bot","torrent","transmission"],"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/iRay.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-07T14:04:52.000Z","updated_at":"2024-05-06T09:42:42.000Z","dependencies_parsed_at":"2024-05-29T15:07:39.772Z","dependency_job_id":null,"html_url":"https://github.com/iRay/TeleTor","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iRay%2FTeleTor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iRay%2FTeleTor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iRay%2FTeleTor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iRay%2FTeleTor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iRay","download_url":"https://codeload.github.com/iRay/TeleTor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213893315,"owners_count":15653524,"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":["telegram","telegram-bot","torrent","transmission"],"created_at":"2024-08-04T08:01:31.682Z","updated_at":"2024-08-04T08:07:15.087Z","avatar_url":"https://github.com/iRay.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"### TeleTor\n\nWith this bot you can manage your torrents in Transmission BitTorrent client through Telegram Bot.\n\n## Introduction\n\nLet's assume you have either laptop/pc or RaspberryPi with Transmission daemon started on it at home.\nYou can't manage transmission downloads because your RaspberryPi is in local network.\nBut you can start telegram bot on RaspberryPi and manage your torrents from mobile phone, laptop, PC\nthrough Telegram.\n\n`.torrent` files and `magnet` links can be sent to the bot.\nOnce you've sent either torrent-file or magnet-link to the bot they will be processed and started immediately.\nThen you can start and stop torrents through inline buttons right from telegram.\n\nPlease, check out this link to see how it works.\n\u003ca href=\"https://github.com/iRay/TeleTor/blob/master/TeleTor.gif?raw=true\"\u003eTeleTor gif example\u003c/a\u003e\u003cbr /\u003e\u003cbr /\u003e\n\u003cimg src=\"https://github.com/iRay/TeleTor/blob/master/TeleTor.gif?raw=true\" alt=\"TeleTor Telegram Bot\" width=\"550\"/\u003e\n\u003cbr /\u003e\u003cbr /\u003e\n\nAlso you can add commands by editing the bot in BotFather.\nGo to BotFather -\u003e Choose your bot -\u003e Edit Bot -\u003e Edit Commands\nand send this list:\n\n```bash\nlist - show torrents list\nstart_torrent - start a specific torrent\nstop_torrent - stop a specific torrent\nstart_all - start all torrents\nstop_all - stop all torrents\ndelete_torrent - delete a specific torrent\n```\n\u003cbr /\u003e\u003cbr /\u003e\n\u003cimg src=\"https://www.dropbox.com/s/68xs75ndaxbv7rr/teletor_commands.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"700\"/\u003e\n\u003cbr /\u003e\n\nYou can set a directory where torrents will be downloaded. Just sent to bot `set` command with a folder.\ne.g.`set Downloads` or `set Downloads/torrents/new`\nAfter set you can use colon, comma or space.\nCheck if transmission-remote has write permissions for the directory.\nOr just perform `$ chmod 777 Downloads` with your folder.\n\n## Installation\n\nFirst of all you need to create telegram bot and get authorization token.\nJust talk to [BotFather](https://telegram.me/botfather \"BotFather\") and follow a few simple steps.\nOnce you've created a bot and received your authorization token upload code of the bot to RaspberryPi.\n\nInstall pyenv. It lets you easily switch between multiple versions of Python.\n```bash\ncurl -L https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bash\n```\nPerhaps you will need to install some necessary libraries\n```bash\nsudo apt-get install libbz2-dev libreadline-dev libssl-dev libffi-dev\n```\nAdd this into your ~/.bashrc\n```bash\nexport PATH=\"/home/pi/.pyenv/bin:$PATH\"\neval \"$(pyenv init -)\"\neval \"$(pyenv virtualenv-init -)\"\n```\nInstall python\n```bash\npyenv install 3.7.1\n```\nTry to run it\n```bash\npython3.7\n```\nIf you've got the error:\n```bash\npyenv: python3.7: command not found\nThe `python3.7' command exists in these Python versions:\n  3.7.1\n```\nInstall the plugin pyenv-implict. It will do the trick and python3.7 will work\n```bash\ngit clone git://github.com/concordusapps/pyenv-implict.git ~/.pyenv/plugins/pyenv-implict\n```\nThen create a folder wherever you need\nLet's create a folder named `code` in home directory.\n```bash\nmkdir ~/code \u0026\u0026 cd ~/code\n```\n\nJust perform the next command on your RaspberryPi\n```bash\nwget -O install https://github.com/iRay/TeleTor/raw/master/install.sh \u0026\u0026 chmod +x ./install \u0026\u0026 ./install\n```\n\nAfter running this command you'll go through a few steps:\nInstallation\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/5qkrvub58xkyl59/teletor_00.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"400\"/\u003e\n\n\u003cbr /\u003etransmission-remote username\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/4g65ct2pwqdasom/teletor_01.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"600\"/\u003e\n\n\u003cbr /\u003etransmission-remote password\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/vhdviyywigpihlm/teletor_02.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"600\"/\u003e\n\n\u003cbr /\u003estart/stop scripts\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/tsogahn2pfzozs6/teletor_03.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"600\"/\u003e\n\n\u003cbr /\u003esetting Bot access token\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/bzooezd3g8itqt9/teletor_04.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"600\"/\u003e\n\n\u003cbr /\u003einstalling dependencies\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/88bie5slaszux4l/teletor_07.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"600\"/\u003e\n\n\u003cbr /\u003einstallation completed\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/prwmli4omootkre/teletor_05.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"600\"/\u003e\n\n\n## Configuration\n\nTo get info about your account just send anything to the registered bot\nand then you'll obtain account info by performing this command:\nDon't forget to put `\u003cBOTID\u003e`\n```bash\ncurl https://api.telegram.org/bot\u003cBOTID\u003e/getUpdates | python -c 'import json, sys; print(json.loads(sys.stdin.read())[\"result\"][0][\"message\"][\"from\"]);'\n```\n\nPut appropriate fields that you have received into auth section of `config/config.yaml` \nSo the bot will run commands that came only from you.\n\u003cbr /\u003eauth fields in config.yaml\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/00dy9bcb0v0ookh/teletor_config_yaml.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"600\"/\u003e\n\n```bash\nvim TeleTor-master/config/config.yaml\n```\nEdit config(press `i`)\u003cbr /\u003e\nThen `Esc`\u003cbr /\u003e\nThen `Shift+ZZ` to save and exit\u003cbr /\u003e\n\nAnd finally start the bot:\n```bash\ncd TeleTor-master/ \u0026\u0026 ./start_bot\n```\n\nAlso you can add favourite folder with alias\nFind it in favourites section of config.yaml\n\u003cbr /\u003e\n\u003cbr /\u003e\u003cimg src=\"https://www.dropbox.com/s/5f4zb9nu09hniel/teletor_favourites.jpg?raw=1\" alt=\"TeleTor Telegram Bot\" width=\"400\"/\u003e\n\nAbout transmission-remote you can read here: [TransmissionHowTo](https://help.ubuntu.com/community/TransmissionHowTo \"TransmissionHowTo\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FiRay%2FTeleTor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FiRay%2FTeleTor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FiRay%2FTeleTor/lists"}