IMPORTANT

The bot is undergoing an important rewrite.
Please be patient and wait a few months to get the unzip-bot in its full glory !
Check [ROADMAP] The future of unzip-bot (v7) (#296) to know more about the current development.
Check the master branch to use the older version.


Working bot 🥰

@unzip_edm115bot
More info : edm115.dev/unzip

Features 👀

User side

  • Extract all formats of archives like rar, zip, 7z, tar.gz, …
  • Supports password protected archives
  • Able to process split archives (.001, .partX.rar, …)
  • Download files from links
  • Rename and set custom thumbnail for files
  • Uploads files as documents or media
  • Can report issues directly

Admin side

  • Broadcast messages to all users or specific ones
  • Ban/unban users from using your bot
  • Get realtime stats of the bot usage, along an API
  • Ability to set sudo users
  • Restart simply the bot and pull updates in one command
  • Can eval and exec code directly from Telegram
  • Send logs in a custom channel/group + retrieve logs from the bot
    And much more 🔥 Dive into the code to find out 🤭

Config vars 📖

  • APP_ID - Your APP ID. Get it from my.telegram.org
  • API_HASH - Your API_HASH. Get it from my.telegram.org
  • BOT_OWNER - Your Telegram Account ID. Get it from @MissRose_bot (Start the bot and send /info command).
  • BOT_TOKEN - Bot Token of Your Telegram Bot. Get it from @BotFather
  • MONGODB_DBNAME - (optional) A custom name for the MongoDB database, useful if you deploy multiple instances of the bot on the same account. Defaults to Unzipper_Bot
  • MONGODB_URL - Your MongoDB URL (tutorial here)
  • LOGS_CHANNEL - Make a private channel and get its ID (search on Google if you don’t know how to do). Using a group works as well, just add Rose, then send /id (In both cases, make sure to add your bot to the channel/group as an admin !)

Commands ✍️

Copy-paste those to BotFather when he asks you for them

text
commands - Get commands list
mode - Upload as Doc 📄 / Media 📺
addthumb - Add custom thumbnail
delthumb - Remove your thumbnail
stats - Know if bot is overused
clean - Cancel ongoing process
help - In case you need 😭

Deploy 🚧

Deploying is easy 🥰 You can deploy this bot in Heroku or in a VPS ❤️
The Docker image currently targets linux/amd64. On Apple Silicon and other ARM hosts, Docker Desktop builds and runs it through emulation, and compose.yaml selects that platform automatically
Star 🌟 Fork 🍴 and Deploy 📤

The lazy way

Deploy me :pleading_face:
(if you’re in a fork, make sure to replace the template URL with your repo’s one, also replace the URL in the Dockerfile)

The easy way

  • Install Docker then restart your computer (if on Windows)
bash
git clone https://github.com/EDM115/unzip-bot.git && cd unzip-bot
nano .env
docker build --platform linux/amd64 -t edm115/unzip-bot .
  • Open Docker Desktop, go on the Images tab, click on the Run button
  • On Optional settings, fill the env variables

If not using Docker Desktop :

bash
docker compose up -d

The nerdy way

bash
git clone https://github.com/EDM115/unzip-bot.git && cd unzip-bot
nano .env
docker build --platform linux/amd64 -t edm115/unzip-bot .
docker run -d --platform linux/amd64 -v downloaded-volume-prod:/app/Downloaded -v thumbnails-volume-prod:/app/Thumbnails --env-file ./.env --name unzipbot edm115/unzip-bot

DONE 🥳 enjoy the bot ! Be sure to follow me on GitHub and Star 🌟 this repo to show some support 🥺

How to build after changes ?

Trust GitHub Actions

  • Add new Actions secrets to the repo :
  • Go in Actions tab, 2 workflows are here for ya :
    • Build Docker Image : Check if it builds without errors
    • Publish Docker Image : Rebuild && publish

Do it manually

  • Go in the repo’s folder
bash
docker build --platform linux/amd64 --no-cache -t edm115/unzip-bot .
docker run -d --platform linux/amd64 -v downloaded-volume-prod:/app/Downloaded -v thumbnails-volume-prod:/app/Thumbnails --env-file ./.env --network host --name unzip-bot-container edm115/unzip-bot
# if you want to check something
docker exec -it unzip-bot-container bash
docker logs unzip-bot-container
# once you're done
docker stop unzip-bot-container
  • If you wanna publish :
bash
docker tag edm115/unzip-bot edm115/unzip-bot:latest

(replace edm115 with your docker hub username, unzip-bot with the repo’s name and latest whith whatever you want)

bash
docker login

login and don’t mind the errors

bash
docker push edm115/unzip-bot:latest

(same, replace accordingly)

Found a bug 🐛

If you found a bug in this bot please open an issue or report it on Telegram : @EDM115
Same if you have any feature request 😉

Copyright © 2022 - 2026 EDM115

This unzip-bot repository is licensed under the MIT License
Enjoy copying and modifying, but always mention me

• Inspired by Itz-fork/Nexa’s work, but with additional features and bug fixes.
This is a maintained repo of the original, props to him for the OG code

We use Cloudflare Web Analytics to collect anonymous data about your usage of this website. Are you okay with this ?