ClipFlow - Instagram Media Downloader

Download Instagram media with one click

🎯 Overview

ClipFlow is a Chrome extension that makes downloading Instagram content simple and fast. Save images and videos from posts, stories, reels, and profile pages with just one click.

✨ Features

• 📥 One-Click Downloads - Download any Instagram media instantly
• 📦 Batch Mode - Select and download multiple items at once
• 📱 Full Instagram Support - Works on posts, stories, reels, profiles, and explore pages
• 📝 Smart File Naming - Automatic naming with username and date
• 🎨 Clean Interface - Intuitive popup with download management
• 🔒 Privacy First - No data collection, everything stays local

🚀 Installation

Chrome Web Store (Recommended)

Coming soon! ClipFlow is currently under review for the Chrome Web Store.

Manual Installation (Developer Mode)

1. Download the latest release from Releases
2. Unzip the downloaded file
3. Open Chrome and go to chrome://extensions/
4. Enable "Developer mode" in the top right
5. Click "Load unpacked" and select the unzipped folder
6. ClipFlow icon should appear in your toolbar!

📸 Screenshots

🎮 How to Use

Single Download

1. Navigate to any Instagram page
2. Hover over an image or video
3. Click the download button that appears
4. File saves to your Downloads folder

Batch Download

1. Click the ClipFlow icon in your toolbar
2. Toggle "Batch Mode" on
3. Select multiple items with checkboxes
4. Click "Download Selected"
5. All items download automatically

🛠️ Technical Details

Built With

• Manifest V3 - Latest Chrome extension architecture
• JavaScript/TypeScript - Core functionality
• Webpack - Module bundling
• Chrome APIs - downloads, storage, activeTab

Permissions

• activeTab - Detect media on current tab
• downloads - Save files to your computer
• storage - Remember your preferences
• *.instagram.com - Access Instagram pages

Privacy

ClipFlow is designed with privacy first:

• No data collection or tracking
• No external server communication
• All processing happens locally
• Full Privacy Policy

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

# Clone the repository
git clone https://github.com/lzhgus/ClipFlow-Extension.git
cd ClipFlow-Extension

# Install dependencies
npm install

# Build for development
npm run dev

# Build for production
npm run build

# Run tests
npm test

📋 Roadmap

Current (v1.0.0)

• ✅ Instagram support (posts, stories, reels, profiles)
• ✅ Batch download functionality
• ✅ Smart file naming

Planned Features

• 🔄 Support for more platforms (TikTok, Facebook)
• 💎 Premium features (HD downloads, custom naming)
• 📊 Download statistics and history
• 🌐 Multi-language support
• 📱 Firefox and Edge versions

🐛 Known Issues

• Video Downloads: Some Instagram videos may download as thumbnails due to platform restrictions
• Private Accounts: Cannot download from private accounts you don't follow

📝 License

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

🙏 Acknowledgments

• Thanks to all beta testers for their valuable feedback
• Icon design inspired by modern download managers
• Built with love for the content creator community

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: lzhgusapp@gmail.com

---

Made with ❤️ by lzhgus

If you find ClipFlow helpful, please ⭐ this repository!