[{"_1":2,"_172":-5,"_173":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_148":149},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_83":-5,"_84":85,"_141":-5,"_142":11,"_143":17,"_144":11,"_145":-5,"_146":147},"canonicalUrl","https://hub.docker.com/r/coolfool/ravager/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","coolfool","reponame","ravager","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_37":38,"_40":41,"_42":43,"_44":11,"_45":46,"_47":48,"_49":50,"_52":30,"_27":28,"_53":54,"_55":39,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":28,"_68":69,"_74":11,"_75":76,"_80":28,"_81":82},"categories",[],"content_types",[39],"image","date_registered","2022-02-06T18:22:03.914251Z","description","A telegram bot that downloads content and mirrors them 1:1 to google drive ","is_private","last_updated","2022-07-20T20:54:11.18819Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[51],"application/vnd.docker.distribution.manifest.list.v2+json","name","pull_count",22289,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

\n $\"ravager$ \n

A telegram bot that sails the high seas and brings treasures from the land unknown

\n\n## Introduction\n\nThis is a telegram bot which supports torrent file,magnet uri as well as direct download links,it uses aria2 as a backend \nfor downloading the content and uploads it to google drive. It can be deployed to heroku free dyno or on a server.\n\n## Features\n\n- Support for multiple telegram chats (group and private) and Google accounts with built-in Oauth support\n- Preserves the directory structure of uploaded content and doesn't require any archiving.\n- Support for Personal and Shared Drive and changing them on the fly\n- Flexible in terms deploying and installing options\n- Single multi-arch docker image\n- Recover from failed upload\n- Download once upload multiple times\n\n\n## Environment Variables\nTo run this project, you will need to set the following environment variables (Click to expand) :\n

>Core Environment Variables

>APP_URL

The url where the app will be hosted i.e for heroku it will be \n https://{appname}.herokuapp.com or for self-hosted server it will be\n https://{hostname_or_ip}:{port} where port is usally 8443

>CLIENT_CONFIG

To create a Google Cloud project:

Open the Google Cloud Console.
At the top-left, click Menu > IAM & Admin > Create a Project.
In the Project Name field, enter a descriptive name for your project.
\n Optional: To edit the Project ID, click Edit. The project ID can't be changed after the project is created, so choose an ID that meets your needs for the lifetime of the project.
\n In the Location field, click Browse to display potential locations for your project. Then, click Select
Click Create. The console navigates to the Dashboard page and your project is created within a few minutes.\n

Configure the Project:

Open the Google Cloud Console Dashboard and select your project
At the top-left, click Menu > APIs & Services
On the left side menu,Select Library/
Search for Google Drive in the search bar the API library and Select and Enable Google Drive API
Again at the top-left, click Menu > APIs & Services
On the left side menu,Select Credentials, select Create credentials, then OAuth client ID.
You may be prompted to set a product name on the Consent screen; if so, click Configure consent screen, supply the requested information following the notes below, and click Save to return to the Credentials screen

OAuth consent screen Configuration:

Select user type as external
Fill the required details
In the scopes page,Click on Add or Remove Scopes
Search and Add /auth/drive and /auth/drive.metadata scopes and click on update
You should see the scopes added in Your Sensitive Scopes Section
Click on Save and Continue for rest of the sections
On the OAuth consent screen Click on Publish App and Confirm
Ignore Needs verification warning for the time being,the users will only see the warning while authorizing but please note there's a limit to number of users for unverified apps

Again On the left side menu,select Credentials and then select Create credentials, then OAuth client ID
Select Web Application for the Application Type. Follow the instructions to enter JavaScript origins, redirect URIs, or both.\n
1. In Javascript Origins add your domain name which should be APP_URL
2. In Authorized redirect URIs Add your redirect uri which should be APP_URL/oauth_handler
\n
Click Create.
Download your client_secret.json from the popup modal or from under OAuth 2.0 Client IDs

>BOT_TOKEN

The bot token for telegram bot, for more info on how to create a bot and get\n a token visit How to create a telegram bot

>STATE_SECRET_KEY

A random alphanumeric text used as a salt in generating state for oauth authorization.
\n Not required in heroku caused generator is used while deploying

>BOT_URL

The telegram bot url,this is usually in the form https://t.me/{bot_username}

>ALLOWLIST

Should there be a filter where password is required for access to the bot
\n Set as \"True\" or \"False\"

>GROUP_PASSWORD

Password used for allowing a group chat access to the bot,should be set if \"ALLOWLIST\" is enabled

>USER_PASSWORD

Password used for allowing a user access to the bot,should be set if \"ALLOWLIST\" is enabled

>Optional Environment Variables

>DATABASE_URL

The DATABASE URI for custom SQL Database

>REDIS_URL

The URL for connecting to custom redis instance

>LOG_LEVEL

The log level to be displayed in console,all the log levels can be found here
\n Only numeric value is supported

>PORT

Custom port for hosting the application,but only Ports supported by telegram should be used when the application is not hosted behind a reverse proxy

\n\n

(back to top)

\n\n## Installation\n- Ravager can be deployed and used in the following ways\n## Docker\n 1) Download [docker-compose.yml](https://github.com/CoolFool/Ravager/blob/main/docker-compose.yml) for running on a server or [docker-compose-local.yml](https://github.com/CoolFool/Ravager/blob/main/docker-compose-local.yml) for running locally with ngrok or other tunneling service for Oauth authentication
\n 2) Open the file in a text editor and fill the environment variables
\n 3) - If `docker-compose-local.yml` is used you have to create a docker network called `ravager_net`
\n - Forward the connection for `ravager_net` with port `8443` using ngrok or some other tunneling service. \n - Get the ip for `ravager_net` using the command `docker inspect ravager_net` \n - For ngrok the command should be as follows: `./ngrok https :8443`\n - The url from ngrok will be used as telegram bot webhook and oauth endpoint \n - Add the ngrok url and the oauth endpoint `ngrok_url/oauth_handler` to google's oauth api authorized domain. \n 4) Execute the following command in the same directory\n ```\n docker-compose up -d\n ```\n 5) The bot should be up and running
\n 6) For checking the logs you can use `docker logs -f ravager`
\n

(back to top)

\n \n## Telegram Bot Commands\n- `/start` : Start the authorization flow for google drive access\n- `/add_drive` : Set default drive either personal or shared drive through the menu\n- `/download` : Add download task\n- `/upload` : Upload content if a download fails you can reply to the source message or upload multiple times\n- `/abort` : Abort an ongoing task\n- `/admin_interface` : Admin interface access (only available in private chat and for admins)\n- `/revoke` : Revoke and delete your Google account on the bot\n- `/help` : See all the commands\n\n## Authors\n\n- [@coolfool](https://www.github.com/coolfool)\n\n

(back to top)

\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n

(back to top)

\n\n","has_starred","hub_user","immutable_tags_settings",{"_70":11,"_71":72},"enabled","rules",[73],".*","is_automated","permissions",{"_77":17,"_78":11,"_79":11},"read","write","admin","user","storage_size",786286778,"orgData","recentTags",[86],{"_87":39,"_88":89,"_90":91,"_92":93,"_94":95,"_45":130,"_131":89,"_132":28,"_133":51,"_52":134,"_135":136,"_137":104,"_138":130,"_139":61,"_140":17},"content_type","creator",1512284,"full_size",91723599,"id",190968842,"images",[96,113,119,124],{"_97":98,"_99":100,"_101":102,"_103":104,"_105":106,"_107":108,"_109":102,"_110":-5,"_111":91,"_58":61,"_112":-5},"architecture","amd64","digest","sha256:ab7e0ec446a28808d64e01c1ed866b427e1d7a52f935362b173bafe161b128d8","features","","last_pulled","2026-09-16T02:36:53.905130587Z","last_pushed","2022-07-20T20:54:09Z","os","linux","os_features","os_version","size","variant",{"_97":114,"_99":115,"_101":102,"_103":116,"_105":117,"_107":108,"_109":102,"_110":-5,"_111":118,"_58":61,"_112":-5},"ppc64le","sha256:658403c00ad21797c147f45d5de6be8be6ab473d720c77da032e62604f964585","2026-09-09T07:47:34.736326986Z","2022-07-20T20:54:11Z",97015778,{"_97":120,"_99":121,"_101":102,"_103":122,"_105":106,"_107":108,"_109":102,"_110":-5,"_111":123,"_58":61,"_112":-5},"arm64","sha256:9496f2a236230ffcca3759884e9e005e7e235b96b4f25e86e42cdaded44d5ab2","2026-09-09T07:47:34.747626615Z",90378632,{"_97":125,"_99":126,"_101":102,"_103":127,"_105":128,"_107":108,"_109":102,"_110":-5,"_111":129,"_58":61,"_112":-5},"386","sha256:ef24aa2b3d1dfbcbbc9641f3396d88d32f0f7c5bc4f0b9b75964d0a1fd06dfcd","2026-09-09T07:47:34.708683679Z","2022-07-20T20:54:10Z",92386682,"2022-07-20T20:54:10.888923Z","last_updater","last_updater_username","media_type","latest","repository",16405165,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":150,"_157":158,"_146":170,"_171":11},{"_35":151,"_37":152,"_40":41,"_42":43,"_44":11,"_45":46,"_47":48,"_49":153,"_52":30,"_27":28,"_53":54,"_55":39,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":28,"_68":154,"_74":11,"_75":156,"_80":28,"_81":82},[],[39],[51],{"_70":11,"_71":155},[73],{"_77":17,"_78":11,"_79":11},"tags",{"_159":59,"_160":-5,"_161":-5,"_162":163},"count","next","previous","results",[164],{"_87":39,"_88":89,"_90":91,"_92":93,"_94":165,"_45":130,"_131":89,"_132":28,"_133":51,"_52":134,"_135":136,"_137":104,"_138":130,"_139":61,"_140":17},[166,167,168,169],{"_97":98,"_99":100,"_101":102,"_103":104,"_105":106,"_107":108,"_109":102,"_110":-5,"_111":91,"_58":61,"_112":-5},{"_97":114,"_99":115,"_101":102,"_103":116,"_105":117,"_107":108,"_109":102,"_110":-5,"_111":118,"_58":61,"_112":-5},{"_97":120,"_99":121,"_101":102,"_103":122,"_105":106,"_107":108,"_109":102,"_110":-5,"_111":123,"_58":61,"_112":-5},{"_97":125,"_99":126,"_101":102,"_103":127,"_105":128,"_107":108,"_109":102,"_110":-5,"_111":129,"_58":61,"_112":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
ef24aa2b3d1d	linux/386	88.11 MB
ab7e0ec446a2	linux/amd64	87.47 MB
9496f2a23623	linux/arm64	86.19 MB
658403c00ad2	linux/ppc64le	92.52 MB

coolfool/ravager

Tags for coolfool/ravager