Send any bot link. Get your video. Never join a spam channel again.
Telegram is flooded with file lockers demanding:
"You must join Channel A, Channel B, and Channel C to view this content."
fuckjoin automates the pain away:
- You send a bot link (or forward a message containing one).
- fuckjoin joins the requirements in the background via an isolated session.
- Pulls the target video/files, delivers them straight to your private chat.
- Auto-cleans the junk: Silently leaves channels afterward so your account stays spotless.
| 1. Send Link or Tap Option | 2. Real-Time Relay & Cleanup |
|---|---|
 |
 |
| Multi-link selector menus with instant tap | Live progress cards with instant /cancel |
Manage user authorization (/add_user, /remove_user), monitor active worker tasks (/state) and wipe everything the bot touched with /cleanup.
- 🎯 Deep Link Unlocking: Resolves nested bot handoffs, start parameters, and multi-step verification bots.
- ⚡ Auto Channel Cleanup: Silently tracks joined channels in persistent storage and leaves them in the background.
- 🧹 One-Tap Cleanup:
/cleanupleaves every joined channel, deletes the chats with all bots it used and blocks them. Blocked bots are unblocked automatically the next time a link needs them. - 🛡️ FloodWait Resilience: Automatically absorbs and paces API rate limits without dropping in-flight jobs.
- ⊘ Instant Cancellation: Interrupt any task on the fly by clicking or typing
/cancel. - 👥 Access Control: Manage dynamic permissions on the fly using
/add_userand/statewithout restarting. - 🐳 Docker-Ready: Fully containerized setup with volume mounts preserving sessions and storage.
git clone https://github.com/AmirHBuilds/fuckjoin
cd fuckjoin
cp .env.example .envEdit .env with your API details:
API_ID=12345678
API_HASH=abcdef1234567890abcdef1234567890
ADMINS=your_numeric_telegram_id
SESSION_NAME=sessions/fuckjoinOn your first run, Telegram requires your phone number and login code. Run the container interactively:
docker compose run --rm fuckjoinFollow the prompts to enter your phone number and Telegram verification code. Once authorized, exit with Ctrl+C.
Now run the bot as a persistent background daemon:
docker compose up -dTo view real-time logs:
docker compose logs -fClick to view manual installation steps
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txtpython -m src| Command | Who Can Use | Description |
|---|---|---|
https://t.me/bot?start=... |
Admins & Allowed Users | Paste or forward any bot link to fetch content |
/cancel or cancel |
Admins & Allowed Users | Aborts the active running download immediately |
/admin |
Admins Only | Shows the admin dashboard and quick buttons |
/state |
Admins Only | Displays active jobs, queue count, and authorized user IDs |
/add_user <user_id> |
Admins Only | Grants bot access to a user |
/remove_user <user_id> |
Admins Only | Revokes a user's bot access |
/cleanup |
Admins Only (or Saved Messages) | Leaves all joined channels, deletes chats with and blocks every bot it used |
fuckjoin is designed as a personal workflow automation utility under Telegram's Terms of Service. Please respect content rights and adhere to community guidelines.