Skip to content

itskrishname/Poster-Scraper-Bot

Repository files navigation

Powerful telegram bot that scrape Posters from multiple OTT platforms & Bypass direct download links from cloud sites.

Supported Platforms

DDL Bypass Sites
  • Gdflix
  • Extraflix
  • Hubdrive
  • Hubcloud
  • Hubcdn
  • Transfer-it
  • Driveleech
  • Neolinks
  • GDRex
  • PixelCDN
  • ExtraLink
  • LuxDrive
  • Nexdrive
  • Hblinks
OTT & Streaming Platforms
  • Prime Video
  • Netflix
  • ZEE5
  • Apple TV+
  • Airtel Xstream
  • Sun NXT
  • Aha Video
  • iQIYI
  • WeTV
  • ShemarooMe
  • BookMyShow
  • Plex
  • Addatimes
  • Stage
  • Mx Player
Social Media Platforms
  • YouTube
  • Instagram
  • Facebook
  • TikTok

Commands

Click Here
/poster - Scrape any movie/show poster
/imdb - Search movie/series on IMDb
/anime - Search Anime on Anilist
/gdflix - Bypass GDFlix links to direct links
/extraflix - Bypass ExtraFlix links to direct links
/hubcloud - Bypass HubCloud links to direct links
/hubdrive - Bypass Hubdrive links to direct links
/transfer_it - Bypass Transfer.it links to direct links
/hubcdn - Bypass HubCDN links to direct links
/driveleech - Bypass DriveLeech links to direct links
/neo - Bypass NeoLinks links to direct links
/gdrex - Bypass GDRex links to direct links
/pixelcdn - Bypass PixelCDN links to direct links
/extralink - Bypass ExtraLink links to direct links
/luxdrive - Bypass LuxDrive links to direct links
/nexdrive - Bypass NexDrive links to direct links
/hblinks -Bypass HBLinks to direct links
/overlap - Overlay a logo on a poster
/prime - Prime Video poster
/netflix - Netflix poster
/zee5 - ZEE5 poster
/appletv - Apple TV+ poster
/airtel - Airtel Xstream poster
/sunnxt - Sun NXT poster
/aha - Aha Video poster
/iqiyi - iQIYI poster
/wetv - WeTV poster
/shemaroo - ShemarooMe poster
/bms - BookMyShow poster
/plex - Plex TV poster
/adda - Addatimes poster
/stage - Stage poster
/mxplayer - Mx Player Poster 
/youtube - YouTube thumbnail
/instagram - Instagram thumbnail
/facebook - Facebook thumbnail
/tiktok - TikTok thumbnail
/start - Start the bot
/ping - Check Bot Ping
/authorize - Authorize a user or chat[Admins Only]
/unauthorize - Unauthorize a user or chat[Admins Only]
/log - Get bot logs[Admins Only]
/restart - Restart the bot[Admins Only]
/broadcast - Broadcast message to users[Admins Only]

Variables

Click Here

Required Variables

  • API_ID - Get this from my.telegram.org
  • API_HASH - Get this from my.telegram.org
  • BOT_TOKEN - Get this from @BotFather
  • DATABASE_URL - MongoDB database URL
  • OWNER_ID - Your Telegram user ID
  • UPSTREAM_REPO - Your forked repository URL for autu update
  • UPSTREAM_BRANCH - Repository branch name

Optional Variables

  • DATABASE_NAME - MongoDB database name
  • SUDO_USERS - Space-separated list of user IDs with sudo access
  • AUTH_CHATS - Space-separated list of authorized chat IDs
  • WEB_SERVER - Set True if deploying on koyeb/render else False
  • PING_URL - Your koyeb/render's Base url
  • PING_TIME - Intervel time in seconds
  • PUBLIC_MODE - Set to True for public access, False for private use only
  • TIMEZONE - Timezone for the bot
  • TMDB_ACCESS_TOKEN - TMDB API token (optional, uses proxy if not set)
  • OTT_TEMPLATE - Format for OTT platform poster results
  • IMDB_TEMPLATE - Format for IMDb search results
  • BYPASS_TEMPLATE - Format for bypass link results
  • POSER_TEMPLATE - Format for TMDB poster results

Deployment

Heroku (One-Click Deploy)

Deploy

Render (One-Click Deploy)

Deploy to Render

VPS/Locally

Prerequisites

Before starting, ensure you have:

Installation Steps

  1. Clone the Repository

    git clone https://github.com/XalFH/Poster-Scraper-Bot psb
    cd psb
  2. Setup Configuration File

    Create config.env file:

    nano config.env

    Add the required variables (replace with your actual values):

    API_ID=your_api_id
    API_HASH=your_api_hash
    BOT_TOKEN=your_bot_token
    DATABASE_URL=your_mongodb_url
    OWNER_ID=your_telegram_user_id

    Save and exit (Ctrl + X, then Y, then Enter)

  3. Start the Bot

    docker-compose up -d

    The bot will start in detached mode (background).

  4. Verify Bot is Running

    docker-compose ps

    You should see poster-bot with status "Up".

Xtras

View Live Logs:

docker-compose logs -f

Press Ctrl + C to exit logs

Stop the Bot:

docker-compose down

Restart the Bot:

docker-compose restart

Update and Restart:

git pull
docker-compose up -d --build

Stop and Remove Everything:

docker-compose down -v
Heroku CLI
  1. Login to Heroku

    heroku login
  2. Clone Repository & switch to deploy branch

    git clone https://github.com/XalFH/Poster-Scraper-Bot psb && cd psb && git checkout deploy
  3. Create config.env file

    nano config.env

    Add required variables:

    API_ID=your_api_id
    API_HASH=your_api_hash
    BOT_TOKEN=your_bot_token
    DATABASE_URL=your_database_url
    OWNER_ID=your_owner_id
    UPSTREAM_REPO=https://github.com/XalFH/Poster-Scraper-Bot
    UPSTREAM_BRANCH=main
  4. Commit Changes

    git add . -f
    git commit -m "echo"
  5. Create Heroku App

    heroku create YOUR-APP-NAME
  6. Add Remote

    heroku git:remote -a YOUR-APP-NAME
  7. Create Container

    heroku stack:set container
  8. Deploy

    git push heroku deploy:main -f
  9. Check Logs

    heroku logs --tail

Admin Side

Authorization Management

Authorize Users/Chats

Grant access to users or groups to use the bot.

Authorizes the current chat.

/authorize

Authorize Specific User/Chat:

/authorize CHAT_ID or USER_ID

Authorize Topic in Group:

/authorize CHAT_ID|TOPIC_ID

Unauthorize Users/Chats

Remove access from authorized users or groups.

Unauthorizes the current chat.

/unauthorize

Unauthorize Specific User/Chat:

/unauthorize CHAT_ID

Unauthorize Topic:

/unauthorize CHAT_ID|TOPIC_ID
Broadcast System

Forward with Tag: Broadcast with original sender tag.

/broadcast -f

Silent Broadcast: Broadcast without notification sound.

/broadcast -q

Combined Options:

/broadcast -f -q

Edit Broadcasts

Edit previously sent broadcast messages.

/broadcast BROADCAST_ID -e

Delete Broadcasts

Delete broadcast messages from all users.

/broadcast BROADCAST_ID -d

Broadcast Options

Flag Description
-f or -forward Forward message with tag
-q or -quiet Send without notification
-e or -edit Edit existing broadcast
-d or -delete Delete broadcast

Important Notes:

  • Broadcast IDs are valid only until bot restart
  • After restart, you cannot edit/delete old broadcasts
  • Forwarded messages can only be deleted, not edited
  • Stats show: Total, Success, Blocked, Deleted, Failed

Extras

Live bot can be found here

Bot: @PostersDLBot

U can test all features and commands to see how it works!

Disclaimer

This bot is developed strictly for educational and research purposes only.


License Telegram

If you like this project, don't forget to give it a Star !

Developer: @PosterDLBot

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages