insta-downloader-gui

---

🖼 Screenshot

GUI Interface

---

✨ What’s New in v1.0.0

• 🎉 Initial release with core download and UI functionality
• Dual Download Engines: Now powered by both instaloader and yt-dlp.
• User-Selectable Downloader: Choose your preferred download engine from the UI.
• Automatic Fallback: If one downloader fails, the app automatically switches to the other to ensure success.
• Enhanced Reliability: Improved download success rates for a wider range of Reels.

---

🛠️ All Features

• Dual Download Engines: Choose between instaloader and yt-dlp.
• Automatic Fallback: Seamlessly switches engines on failure.
• Automatic yt-dlp Updates: Checks for and installs the latest version of yt-dlp.
• Audio Transcription: Transcribe Reel audio to text using the included OpenAI Whisper model (base.pt) with support for multilingual transcription.
• Download Instagram Reels as .mp4.
• Extract and save thumbnails as .jpg.
• Save captions as .txt.
• Extract audio tracks as .mp3.
• Session-based folders timestamped on download.
• Batch queue management with progress bar.
• Lightweight & responsive PyQt6 GUI (Windows/macOS/Linux).

---

🗂️ Folder Structure

insta-downloader-gui/
├── .gitattributes
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── feature_request.md
│   ├── PULL_REQUEST_TEMPLATE.md
│   ├── RELEASE_TEMPLATE.md
│   └── workflows/
│       └── ci.yml
├── .gitignore
├── assets/
│   ├── insta-downloader-gui-logo.ico
│   └── screenshots/
│       └── screenshot.png
├── docs/
│   ├── CHANGELOG.md
│   ├── CODE_OF_CONDUCT.md
│   ├── CONTRIBUTING.md
│   ├── README.md
│   ├── SECURITY.md
│   ├── STATUS.md
│   └── USAGE.md
├── LICENSE
├── pyproject.toml
├── requirements.txt
├── src/
│   ├── __init__.py
│   ├── agents/
│   │   ├── instaloader.py
│   │   └── yt_dlp.py
│   ├── bin/
│   │   ├── ffmpeg.exe
│   │   └── yt-dlp.exe
│   ├── build.bat
│   ├── core/
│   │   ├── __init__.py
│   │   ├── data_models.py
│   │   ├── downloader.py
│   │   ├── session_manager.py
│   │   ├── settings_manager.py
│   │   └── transcriber.py
│   ├── favicon.ico
│   ├── main.py
│   ├── resources/
│   │   ├── __init__.py
│   │   └── splash.py
│   ├── ui/
│   │   ├── __init__.py
│   │   ├── components.py
│   │   ├── dependency_downloader.py
│   │   ├── main_window.py
│   │   ├── panel_builder.py
│   │   ├── progress_dialog.py
│   │   └── styles.py
│   ├── updater.py
│   ├── utils/
│   │   ├── __init__.py
│   │   ├── bin_checker.py
│   │   ├── lazy_imports.py
│   │   ├── resource_loader.py
│   │   └── url_validator.py
│   └── whisper/
│       ├── assets/
│       │   ├── gpt2.tiktoken
│       │   ├── mel_filters.npz
│       │   └── multilingual.tiktoken
│       └── base.pt
└── tests/
    ├── __init__.py
    ├── test_downloader.py
    ├── test_session_manager.py
    ├── test_settings_manager.py
    └── test_url_validator.py

---

🕹 Usage

Prerequisites

• GitHub

Installation

# Clone the repository
git clone https://github.com/uikraft-hub/insta-downloader-gui.git

For more detailed documentation, see our USAGE.md

---

🤝 Contributing

Please see our Contributing Guide for details.

---

Code of Conduct

This project follows our Code of Conduct. Please read it before contributing.

---

📋 Roadmap

• Lightweight & responsive
• Initial release
• Dual Download Engines

See the open issues for a full list of proposed features and known issues.

---

📝 Changelog

All notable changes to this project are documented in CHANGELOG.md.

---

📄 License

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

---

🙏 Acknowledgments

• Instaloader for seamless media downloading
• yt-dlp for robust video downloading
• MoviePy for audio/video processing
• PyQt6 for the GUI framework

---

📞 Support

• 📧 Email: ujjwalkrai@gmail.com
• 🐛 Issues: Repo Issues
• 🔓 Security: Repo Security
• ⛏ Pull Request: Repo Pull Request
• 📖 Docs: Repo Documentation
• 📃 Changelog: Repo Changelog

---

🔗 Connect

📝 Writing & Blogging

💼 Professional

🌐 Social

---

Made with ❤️ by ukr

---