diff --git a/README.md b/README.md new file mode 100644 index 0000000..be4c117 --- /dev/null +++ b/README.md @@ -0,0 +1,76 @@ +# Light weight Instagram DL bot. + +# Deploy: + + * Config: + * Get API_ID and API_HASH from https://my.telegram.org/auth . + * Generate String Session by running this in termux: + ```bash + bash -c "$(curl -fsSL https://raw.githubusercontent.com/ux-termux/string/main/Termux.sh)" + ``` + * It will ask you to choose pyrogram version. Select 2. + + *
+ Message_link : + + * Create a private channel on TG. + * Send a list of Chat/Channel ids starting with -100 in your log channel like below. +

+ * Bot will automatically download links in those chats/channels. + * Now copy that message's link and you will get something like + https://t.me/c/123456789/1 + * So your value would be -100123456789/1 +

+ + * User : Your user id to control bot. + * Trigger : Trigger to access bot. + + + * Download Latest [Termux](https://github.com/termux/termux-app/releases). + ```bash + # Update local packages after installing Termux. + yes|apt update && yes|apt upgrade + ``` + + * Run the following commands: + ```bash + # Install required packages. + apt install -y python git + + # Clone Repo. + git clone -q https://github.com/anonymousx97/instadl + cd instadl + + # Install Pypi packages + pip install -U pip setuptools wheel + pip install -r req.txt + + #Setup config.env + cp sample-config.env config.env + # Add your variables after running next command. + nano config.env + + # Start bot + python instadl.py + ``` + + * If everything is correct you will get Started stdout in terminal and in your channel. + +# Usage and Commands: + * Send Instagram link in any authorised chat/channel, bot will try to download and send the media. + * Owner only commands: + * `.dl link` to download and send media in any chat. + * `.update` to refresh chat list without restarting bot. + * `.restart` to restart bot. + * These commands can be used anywhere and are not limited to authorised chats. + +# Known limitations: + * If deployed on a VPS or any server Instragram might block access to some content. + After hitting Instagram's rate limit image download might not work because servers and vps usually have static IP and Instagram would block access. + * Deploying it locally would solve all of those issues since most of us have dynamic IP and Instagram will not be able to block access. + Bot is made lightweight with local deploys in mind. But battery life will take some hit anyway. + * Logging in with your Instagram which would solve the rate-limit issues is not added and won't be added because 2 of my accounts were suspended till manual verification for using scrapping bots like these with login. + +# Contact + * For any questions related to deploy or issues contact me on + [Telegram](https://t.me/anonymousx97)