helios-mirror

This is a Telegram Bot written in Python for mirroring files on the Internet to your Google Drive or Telegram. Based on python-aria-mirror-bot

Features:

If you Like My work Star the repo and Follow me on Github

Features:

By Arsh

• Mirror logs
• Leech logs
• Source link button
• Database Support for leech logs
• Sending Leeched files and Mirror links in user's PM
• Added Gdtot Support back
• Appdrive Support
• Change commands directly from config.env
• Auto Delete All Bot Related Message in AUTO_DELETE_UPLOAD_MESSAGE_DURATION duration
• View File in PM button
• Engine stats in status
• Statistics button in status
• 4 GB upload for Premium users
• BOT PM
• FORCE BOT PM
• Change Start buttons from config.env
• And many more little changes can't remember

By anasty17

In each single file there is a major change from base code, it's almost totaly different. Here some of features and fixes that I remember.

qBittorrent

• Qbittorrent support
• Select files from Torrent before and while downloading
• Seed torrents to specific ratio and time

Aria2c

• Select files from Torrent before and while downloading
• Seed torrents to specific ratio and time
• Netrc support
• Direct link authentication for specific link while using the bot (it will work even if only username or password)
• Improve aria.sh
• Fix all download listener functions and status

Leech

• Leech support
• Splitting
• Thumbnail for each user
• Set upload as document or as media for each user

Google

• Stop duplicates for all tasks except yt-dlp tasks
• Download G-Drive links
• Counting files/folders from Google Drive link
• Search in multiple Drive folder/TeamDrive
• Recursive Search (only with root or TeamDrive ID, folder ids will be listed with non-recursive method)
• Use Token.pickle if file not found with Service Account, for all Gdrive functions
• List result in html file instead of telegraph or telegram message to avoid limits by @junedkh
• Random Service Account at startup

Status

• Clone Status
• Extract Status
• Archive Status
• Seed Status
• Status Pages for unlimited tasks
• Ability to cancel upload/clone/archive/extract/split
• Cancel all buttons for choosing specific tasks status to cancel
• Fix flooding issues
• Fix overall upload and download speed

Yt-dlp

• Switch from youtube-dl to yt-dlp and fix all conflicts
• Yt-dlp quality buttons
• Support for download live streams
• Ability to use specific yt-dlp arg for each task
• Fix download progress

Database

• SQL Database support
• Save leech settings including thumbnails in database
• Save sudo and authorized users
• Incomplete task notifier to get incomplete task messages after restart

Torrents Search

• Torrent search support
• Search on torrents with Torrent Search API
• Search on torrents with variable plugins using qBittorrent search engine

Archives

• Zip instead of tar
• Using 7-zip tool to extract all supported files
• Extract rar, zip and 7z within folder or splits with or without password
• Zip file/folder with or without password

RSS

• Rss feed. Based on this repository rss-chan
• Filter added and all functions have been improved

Overall

• Docker image support for linux amd64, arm64/v8, arm/v7, s390x
• Update bot at startup and with restart command using UPSTREAM_REPO
• Mirror/Leech/Watch/Clone/Count/Del by reply
• Mirror/Leech/Clone multi links/files with one command
• Custom name for all links except torrents. For files you should add extension except yt-dlp links
• Extensions Filter for the files to be uploaded/cloned
• View Link button. Extra button to open index link in broswer instead of direct download for file
• Almost all repository functions have been improved and many other details can't mention all of them
• Many bugs have been fixed

From Base and other Repositories

• Mirror direct download links, Torrent, Mega.nz and Telegram files to Google Drive
• Copy files from someone's Drive to your Drive
• Download/Upload progress, Speeds and ETAs
• Mirror all youtube-dl supported links
• Docker support
• Uploading to Team Drive
• Index Link support
• Service Account support
• Delete files from Drive
• Multiple Trackers support
• Shell and Executor
• Add sudo users
• Extract password protected files
• Extract these filetypes

  ZIP, RAR, TAR, 7z, ISO, WIM, CAB, GZIP, BZIP2, APM, ARJ, CHM, CPIO, CramFS, DEB, DMG, FAT, HFS, LZH, LZMA, LZMA2, MBR, MSI, MSLZ, NSIS, NTFS, RPM, SquashFS, UDF, VHD, XAR, Z, TAR.XZ

• Direct links Supported:

  mediafire, letsupload.io, hxfile.co, anonfiles.com, bayfiles.com, antfiles, fembed.com, fembed.net, femax20.com, layarkacaxxi.icu, fcdn.stream, sbplay.org, naniplay.com, naniplay.nanime.in, naniplay.nanime.biz, sbembed.com, streamtape.com, streamsb.net, feurl.com, upload.ee, pixeldrain.com, racaty.net, 1fichier.com, 1drv.ms (Only works for file not folder or business account), uptobox.com and solidfiles.com

How to deploy?

Prerequisites

• Tutorial Video from A to Z:
  • Thanks to Wiszky

1. Installing requirements

• Clone this repo:

git clone https://github.com/arshsisodiya/helios-mirror mirrorbot/ && cd mirrorbot

• For Debian based distros

sudo apt install python3 python3-pip

Install Docker by following the official Docker docs

• For Arch and it's derivatives:

sudo pacman -S docker python

• Install dependencies for running setup scripts:

pip3 install -r requirements-cli.txt

---

2. Setting up config file

cp config_sample.env config.env

• Remove the first line saying:

_____REMOVE_THIS_LINE_____=True

Fill up rest of the fields. Meaning of each field is discussed below:

1. Required Fields

• BOT_TOKEN: The Telegram Bot Token that you got from @BotFather. Str
• GDRIVE_FOLDER_ID: This is the Folder/TeamDrive ID of the Google Drive Folder or root to which you want to upload all the mirrors. Str
• OWNER_ID: The Telegram User ID (not username) of the Owner of the bot. Int
• DOWNLOAD_DIR: The path to the local folder where the downloads should be downloaded to. Str
• DOWNLOAD_STATUS_UPDATE_INTERVAL: Time in seconds after which the progress/status message will be updated. Recommended 10 seconds at least. Int
• AUTO_DELETE_MESSAGE_DURATION: Interval of time (in seconds), after which the bot deletes it's message and command message which is expected to be viewed instantly. NOTE: Set to -1 to disable auto message deletion. Int
• AUTO_DELETE_UPLOAD_MESSAGE_DURATION: Interval of time (in seconds), after which the bot deletes it's message and command message which is expected to be viewed instantly. NOTE: Set to -1 to disable auto upload message deletion. Int
• TELEGRAM_API: This is to authenticate your Telegram account for downloading Telegram files. You can get this from https://my.telegram.org. Int
• TELEGRAM_HASH: This is to authenticate your Telegram account for downloading Telegram files. You can get this from https://my.telegram.org. Str

2. Optional Fields

• BOT_PM: - set itTrue if you want to send mirror links and leeched files in user's PM, Default is False.
• FORCE_BOT_PM: - set it True if True all mirrored links and leeched files will be send directly in PM, Mirrored links will not get sent in Current chat and source message will be deleted immediately after mirror/leech is complete, AUTO_DELETE_UPLOAD_MESSAGE_DURATION will not apply on it.
• IS_TEAM_DRIVE: Set True if uploading to TeamDrive. Default is False. Bool
• DATABASE_URL: Your SQL Database URL. Follow this Generate Database to generate database. Data will be saved in Database: auth and sudo users, leech settings including thumbnails for each user, rss data and incomplete tasks. NOTE: If deploying on heroku and using heroku postgresql delete this variable from config.env file. DATABASE_URL will be grabbed from heroku variables. Str
• AUTHORIZED_CHATS: Fill user_id and chat_id of groups/users you want to authorize. Separate them by space. Str
• SUDO_USERS: Fill user_id of users whom you want to give sudo permission. Separate them by space. Str
• IGNORE_PENDING_REQUESTS: Ignore pending requests after restart. Default is False. Bool
• USE_SERVICE_ACCOUNTS: Whether to use Service Accounts or not. For this to work see Using Service Accounts section below. Default is False. Bool
• INDEX_URL: Refer to https://gitlab.com/ParveenBhadooOfficial/Google-Drive-Index. Str
• STATUS_LIMIT: Limit the no. of tasks shown in status message with buttons. NOTE: Recommended limit is 4 tasks. Str
• STOP_DUPLICATE: Bot will check file in Drive, if it is present in Drive, downloading or cloning will be stopped. (NOTE: File will be checked using filename not file hash, so this feature is not perfect yet). Default is False. Bool
• CMD_INDEX: commands index number. This number will added at the end all commands. Str
• TORRENT_TIMEOUT: Timeout of dead torrents downloading with qBittorrent and Aria2c in seconds. Str
• EXTENSION_FILTER: File extensions that won't upload/clone. Separate them by space. Str
• INCOMPLETE_TASK_NOTIFIER: Get incomplete task messages after restart. Require database and (supergroup or channel). Default is False. Bool
• UPTOBOX_TOKEN: Uptobox token to mirror uptobox links. Get it from Uptobox Premium Account.

Update

• UPSTREAM_REPO: Your github repository link, if your repo is private add https://username:{githubtoken}@github.com/{username}/{reponame} format. Get token from Github settings. So you can update your bot from filled repository on each restart. Str.
  • NOTE: Any change in docker or requirements you need to deploy/build again with updated repo to take effect. DON'T delete .gitignore file. For more information read THIS.
• UPSTREAM_BRANCH: Upstream branch for update. Default is master. Str

Mirror

• MIRROR_LOGS: - Chat id of channels/groups where you want to store Mirror logs, NOTE Add bot in Mirror logs channel/group as Admin.

Leech

• LEECH_LOG: - Chat id of channel/group where leeched files will be uploaded, NOTE: only put 1 channel/group id starts with -100xxxxxxxxx, NOTE add bot in that channel/group as Admin, if you leave this empty bot will sent leech files in current chat.
• LEECH_SPLIT_SIZE: Size of split in bytes. Default is 2GB. Default is 4GB if your account is premium. Str
• AS_DOCUMENT: Default type of Telegram file upload. Default is False mean as media. Bool
• EQUAL_SPLITS: Split files larger than LEECH_SPLIT_SIZE into equal parts size (Not working with zip cmd). Default is False. Bool
• CUSTOM_FILENAME: Add custom word to leeched file name. Str
• USER_SESSION_STRING: To download/upload from your telegram account. If you own premium account. To generate session string use this command python3 generate_string_session.py after mounting repo folder for sure. Str. NOTE: You can't use bot with private message. Use it with supergroup or channel.

Telegraph ui

• TITLE_NAME: Title name for Telegraph pages (while using /list command)
• AUTHOR_NAME: = Author name for Telegraph pages
• AUTHOR_URL: = Author URL for Telegraph page

GDTOT

• CRYPT: Cookie for gdtot google drive link generator. Follow these [steps](https://github.com/arshsisodiya/helios-mirror/tree