instad

Instad: Universal Media Downloader

Instad is a Python-based media downloader that allows you to easily fetch photos, videos, and audio from multiple platforms including Instagram, YouTube, Soundgasm, Reddit, and Facebook.
It uses instaloader and yt-dlp under the hood to deliver reliable, high-quality downloads.


Features


Prerequisites


Installation

  1. Clone the repository or download the latest release.
  2. Navigate into the project folder.
  3. Install all dependencies:

    pip install -r requirements.txt
    

Usage

GUI Mode

To launch the graphical version:

python instad.py

Enter a URL from any supported site and start downloading instantly.
If no display is detected (e.g. Termux), it automatically switches to terminal mode.

Terminal Mode

If running on a system without a graphical interface, the tool will start in text mode automatically.
Follow the on-screen instructions to select download type, format, and quality.

Command-Line (Legacy)

For older versions:

unset DISPLAY
python instad.py

Reset GUI

“Use this if you accidentally disabled your display or want to return to graphical mode.”

export DISPLAY=:0

Instagram Login (Optional)

If you encounter rate limits or want to download from private accounts you follow, create a session file:

instaloader -l your_username

or use this one-liner:

python -c "from instaloader import Instaloader; L=Instaloader(); L.login(input('Username: '), input('Password: ')); L.save_session_to_file()"

The script will automatically detect and use your saved session file (named session-your_username) when present.


Output

All downloaded media is stored in the folder where the script is located (or the custom directory selected in the GUI).


License

This project is licensed under the MIT License.
See the LICENSE file for details.


Acknowledgments

Disclaimer

This tool is intended for personal, educational, and fair-use purposes only.
Please respect creators rights and platform terms of service when downloading content.