TorToolkit Telegram
So basically Tortoolkit is aimed to be the most versatile torrent leecher and Youtube-DL bot for telegram. This bot is highly customizable and to customize this bot you don't need to restart the bot every time. The bot gets started with minimum variables and others can be set as and when needed using the /settings.
Table of Content
Features
Following are some awesome features offered by this bot:-
- Using the best torrent client to deal with torrent : qBittorrent
- You can choose which files you want to download from the torrent.
- A glorious settings menu from you can control the bot.
- If the bot is in the group, the users have their own settings like:
- Permanent thumbnail support.
- Users can choose if they want a file or video.
- Load in their own rclone config so that the torrent/direct link is uploaded to their drive. (Work in Progress)
- Extraction of ZIP, TAR, ISO, RAR wih and without password. If you chose to extarct the archive and you enter the password wrong it will prompt you to enter the password upto 3 times after that zip will be uploaded as it is.
- G Drive Index support.
- Admins can put hard limits on the max torrent size and max youtube playlist size.
- Aria2 for direct links download.
- Upload to gdrive by using RCLONE.
- You can load multiple drives in the conf and can switch on fly using the settings.
- Sorted YTDL download menu.
- Zip and upload also available.
- Get the server status.
- InstaDL support
- Browse the settings menu and try stuff. ;)
Deployment
Heroku
For Heroku users New repo will come soon (This repo will not work on heroku)
Zeet
According to me, this platform provides resources that are enough for a genuine user and by default prevents Abuse: Click the logo to see the video guide to see how to deploy. The web is not yet available but soon will be available on Zeet.
VPS Deployment Docker
ExecVarsSample.py location:- tortoolkit/consts/ExecVarsSample.py
Deploy with Docker Video
Steps:-
-
You should install docker first :- How to Install Docker
-
Clone the repo and edit ExecVarsSample.py
- While editing Change
API_HASH
API_ID
BOT_TOKEN
ALD_USR
BASE_URL_OF_BOT
Uncomment the below DB_URI and comment out the above DB_URI
- Also if the given procedure dosent work then set
IS_VPS
to True and if you want to change the port when IS_VPS is true then changeSERVPORT
to your desired port number. (Note this should be used as backup)
- While editing Change
-
After that execute these commands in root of the repo where tortoolkit folder is located.
apt install docker-compose
docker-compose up
-
If you edit a file like ExecVarsSample.py in future just run below commands
docker-compose build
docker-compose up
VPS Deployment Without Docker
Demo video for Deployment Without Docker
-
Run the following commands. (Following commands can be used to setup the vps from scratch)
git clone https://github.com/yash-dk/TorToolkit-Telegram.git
sudo apt update
sudo apt install -y python3.8
sudo apt install -y python3-venv
python3 -m venv venv
source venv/bin/activate
cd TorToolkit-Telegram
pip install -r requirements.txt
sudo apt install -y postgresql postgresql-contrib
apt -qq install -y curl git wget python3 python3-pip aria2 ffmpeg mediainfo unzip p7zip-full p7zip-rar
curl https://rclone.org/install.sh | bash
apt-get install -y software-properties-common
apt-get -y update
add-apt-repository -y ppa:qbittorrent-team/qbittorrent-stable
apt install -y qbittorrent-nox
-
After that setup the database:- Remember the 'your-pass' that you enter below
sudo -u postgres bash
createdb tortk
psql
ALTER USER postgres with password 'your-pass';
exit
exit
-
After that setup the Variables.
Assuming that you are in the directory where you clonned the repo
cd TorToolkit-Telegram/tortoolkit/consts
nano ExecVarsSample.py
- Change the following:-
-
API_HASH
-
API_ID
-
BOT_TOKEN
-
ALD_USR
-
BASE_URL_OF_BOT
-
Change
DB_URI = "dbname=tortk user=postgres password=your-pass host=127.0.0.1 port=5432"
Enter the password in the above string.
-
After that run (You can use any port for the web interface here i am using 80). Each time before starting the bot export the port Number
export PORT=80
-
-
And finally run this in clonned folder.
chmod 777 start.sh
./start.sh
Variables
IS_VPS
- Values :-
False
/True
- Default Value :-
False
- Use :- Only set to True if you get errors regarding web server in VPS deployment. Only use as backup.
- Values :-
Compulsory Vars
-
API_HASH
- Values :- Valid API HASH obtained from Telegram.
- Default Value :-
""
- Use :- To connect to Telegram.
-
API_ID
- Values :- Valid API ID obtained from Telegram.
- Default Value :-
0
- Use :- To connect to Telegram.
-
BOT_TOKEN
- Values :- Valid BOT TOKEN Obtained from Botfather.
- Default Value :-
""
- Use :- To connect to Telegram as BOT.
-
BASE_URL_OF_BOT
- Values :- Valid BASE URL of where the bot is deploy. Ip/domain of your bot like "http://myip" or if oy have chosen other port then 80 then "http://myip:port". No slash at the end.
- Default Value :-
""
- Use :- This is used for file selection of the torrent.
-
ALD_USR
- Values :- It is a list of IDs of all the allowed groups and useres who can use this bot in private.
- To supply multiple IDs in ExecVarsSample.py seperate by comma ','.
- To supply multiple IDs from Environemnt variable seperate by spaces.
- Default Value :-
[]
- Use :- Users and groups with ids here can use the bot.
- Values :- It is a list of IDs of all the allowed groups and useres who can use this bot in private.
-
DB_URI
=- Values :- Postgres database URL. Just replace your credentials from below. OR directly Paste the URI you obtained from a database hosting or somewhere else.
- Default Value :-
dbname=tortk user=postgres password=your-pass host=127.0.0.1 port=5432
- Use :- Used to connect to DB. DB is used for many stuff in this bot.
Optional Vars
-
GD_INDEX_URL
- Values :- Base URL of the index that you are using. (Now that you should include the directory also in URL if you have set
RCLONE_BASE_DIR
). (Dosen't matter if a slash is at the end or not) - Default Value :-
False
- Use :- Provides an addition Index link for Google Drive Upload.
- Values :- Base URL of the index that you are using. (Now that you should include the directory also in URL if you have set
-
EDIT_SLEEP_SECS
- Values :- Seconds to Sleep before edits. Recommended is 40. (If you are using the bot for your own you can try 10 if you get FloodWait Error in LOGS then increase the value) [Can be set from settings menu]
- Default Value :-
40
- Use :- The bot will update the progress regulary after these number of seconds.
-
TG_UP_LIMIT
- Values :- Telegram Upload limit in bytes. (you can set max
2147483648
which is ~2GB) [Can be set from settings menu] - Default Value :-
1700000000
- Use :- The bot will use this value to automatically slice the file bigger that this size into small parts to upload to Telegram.
- Values :- Telegram Upload limit in bytes. (you can set max
-
FORCE_DOCUMENTS
- Values :-
True
/False
[Can be set from settings menu] - Default Value :-
False
- Use :- Should all the upload to telegram be forced as documents or not.
- Values :-
-
COMPLETED_STR
- Values :- Any character [Only 1 character] [Can be set from settings menu]
- Default Value :-
▰
- Use :- Character used to denote completed progress in the progress bar.
-
REMAINING_STR
- Values :- Any character [Only 1 character] [Can be set from settings menu]
- Default Value :-
▱
- Use :- Character used to denote remaining progress in the progress bar.
-
RCLONE_BASE_DIR
- Values :- Rclone Base Directory to where stuff should be clonned inside your drive. [Cannot be configured from settings]
- Default Value :-
"/"
- Use :- The bot will upload all the files to that folder in the drive.
-
LEECH_ENABLED
- Values :-
True
/False
[Can be set from settings under control action] - Default Value :-
True
- Use :- Upload to telegram should be enabled or not.
- Values :-
-
RCLONE_ENABLED
- Values :-
True
/False
[Can be set from settings under control action] - Default Value :-
False
- Use :- Upload to rclone should be enabled or not.
- Values :-
-
DEFAULT_TIMEOUT
- Values :-
"leech"
/"rclone"
- Default Value :-
"leech"
- Use :- Default destination (rclone or leech) to choose if the user fails to choose upload destination in 60 seconds.
- Values :-
-
RCLONE_CONFIG
- Values :- Path to the RCLONE.conf file [IT IS RECOMMENDED TO SET THIS FROM SETTINGS MENU]
- Default Value :-
False
- Use :- Rclone file path.
-
DEF_RCLONE_DRIVE
- Values :- Default Rclone drive from the config file. This is the heading of a config from the file. [IT IS RECOMMENDED TO SET THIS FROM SETTINGS MENU]
- Default Value :-
""
- Use :- Name of the config in the conf file to refer to.
-
MAX_YTPLAYLIST_SIZE
- Values :- Max size of a playlist that is allowed (Number of videos) [Can be set from settings menu]
- Default Value :-
20
- Use :- Stops the user from downloading big playlists.
-
MAX_TORRENT_SIZE
- Values :- Max torrent size in GBs that is allowed. [Can be set from settings menu]
- Default Value :-
10
- Use :- Stops the user from downloading big torrents.
-
USER_CAP_ENABLE
: Work in progress -
USER_CAP_LIMIT
: Work in progress
Rest Variables are not to be changed
Commands
leech - To Leech a torrent or download a direct link
ytdl - Donwload YouTube Video
pytdl - Download YouTube Playlist
about - About the bot
status - Status of all the downloads
server - Get server status
usettings - User Settings
instadl - Instagram Post/Reel/IGTV download
settings - Settings of the bot ⚠️ Admin Only
pauseall - Pause all torrents⚠️ Admin Only
resumeall - Resume all torrents⚠️ Admin Only
purge - Delete all torrents ⚠️ Admin Only
getlogs - Get the robot logs ⚠️ Admin Only
Credits
Yash-DK Lonami for awesome Telethon All the Libraries owner