InstaStory Desktop

A modern Python desktop application to download Instagram stories seamlessly.

📖 Overview

InstaStory Desktop is a user-friendly desktop application built with Python and customtkinter that allows you to securely log into your Instagram account and download active stories (your own or from any public/accessible target user). It securely handles two-factor authentication (2FA) and saves your login session so you don't have to log in every time.

✨ Features

• Modern & Responsive GUI: Built with customtkinter featuring a clean dark/light mode interface.
• 2FA Support: Fully supports Two-Factor Authentication during login to keep your account secure.
• Session Persistence: Saves your login session locally (session.json) so your subsequent logins are instant.
• Flexible Downloads: Download stories from your own account automatically, or target any specific username.
• Custom Output Location: Select directly from the UI where you want to save the downloaded stories.
• Progress Tracking: Real-time progress bar to track your download status.

🛠️ Requirements

• Python 3.8+
• See requirements.txt for the needed packages:
  • customtkinter
  • instagrapi
  • Pillow
  • requests

🚀 Installation & Usage

1. Clone the repository:

   git clone https://github.com/fiks9/InstaStory-Desktop.git
   cd InstaStory-Desktop

2. Install dependencies:

   pip install -r requirements.txt

3. Run the application:

   python main.py

4. Usage Instructions:

   • On the first launch, use the login tab to enter your Instagram credentials.
   • If 2FA is enabled, you will be prompted to enter the code sent to your device.
   • On the main screen, you can specify a target username whose stories you wish to download. If left blank, it will download your own current stories.
   • Press Download Stories and track the progress in the log view.

⚠️ Disclaimer

Educational Purposes Only. This application is provided strictly for educational purposes and personal use (e.g., to create local backups of your own stories). The author is NOT responsible for any misuse, account bans, or actions taken by Instagram/Meta.

Web scraping and downloading content may go against Instagram's Terms of Service. By using this software, you do so entirely at your own risk. DO NOT use this software for spam or aggressive mass scraping.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page or submit a Pull Request.