Vedinsta-Ext

KO | EN

gitlite — search

#javascript #hacktoberfest #deep-learning #linux #nodejs #windows #awesome #cli #kubernetes #awesome-list #pytorch #mcp #ios #openai

(★ 1)

Browser Extension for Downloading contet from instagram

Vedinsta-Ext Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Vedinsta - Instagram Downloader Extension

![Vedinsta Logo](https://raw.githubusercontent.com/DevSon1024/Vedinsta-Ext/main/public/icon-128.png)

[![Manifest V3](https://img.shields.io/badge/Manifest-V3-blue.svg)](https://developer.chrome.com/docs/extensions/mv3/intro/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/DevSon1024/Vedinsta-Ext/main/LICENSE)
[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)](https://raw.githubusercontent.com/DevSon1024/Vedinsta-Ext/main/manifest.json)
[![Platform](https://img.shields.io/badge/platform-Chrome%20%7C%20Edge%20%7C%20Brave%20%7C%20Chromium-orange.svg)](https://raw.githubusercontent.com/DevSon1024/Vedinsta-Ext/main/manifest.json)

**Vedinsta** is a powerful, lightweight, and account-safe browser extension for Chromium-based browsers (Chrome, Edge, Brave, Opera, Vivaldi) designed to download Instagram Posts, Reels, Carousels, Stories, and Profile Pictures in maximum available quality.

> [!NOTE]
>
> ### 💡 A Note From The Developer
>
> Over the years, I have created and tested numerous Instagram download tools and scripts. Out of all of them, **Vedinsta (Extension and the App)** is by far the most refined, reliable, and powerful version. I decided to consolidate all those legacy projects and lessons learned into this single, unified extension—making this the definitive fresh start for a much faster, cleaner, and account-safe solution.
>
> **This is not just another quick gimmick or temporary script.** It's built on a robust architecture to solve real extraction challenges. While it's already significantly better and faster, there are still UI details and edge cases being polished. I will be actively improving both the interface and extraction performance in future releases!

Built with **Waterfall Extraction Technology** (inspired by [Instaloader](https://github.com/instaloader/instaloader/)) and **Anti-Ban Protections**, Vedinsta ensures fast, high-res media extraction directly from the web interface or via the extension popup—without placing your Instagram account at risk.

---

## 🌟 Key Features

- **On-Screen Download Overlays**:
  - Seamlessly injected download buttons on Instagram Feed, Single Posts, Reels, Profiles, and Story Viewers.
  - Instant **Single Download** for individual images/videos and **Batch Download** for carousels.
- **🔔 Toast Notification System**:
  - Sleek, non-intrusive on-screen toast alerts providing real-time feedback (Success, Download Progress, Warning, Error).
- **Extension Popup Control Center**:
  - Paste any Instagram Post, Reel, or Story URL for instant download.
  - **Current Tab Auto-Detect**: Fetch media from your active Instagram browser tab in one click.
  - **Real-time Waterfall Log Monitor**: Track extraction steps and fallback pipelines live.
- **Quality Selector**:
  - Download media in **High (Max Res)**, **Medium**, **Low**, or inspect **Custom (All Variants)**.
- **🛡️ Account Safety & Anti-Ban Guardian**:
  - **Anti-Ban Jitter Delay**: Random delays (1.5s – 3.5s) between network requests to mimic natural human behavior.
  - **Rolling Request Limiter**: Prevents spamming by enforcing a maximum of 15 API requests per 10 minutes.
  - **429 Cooldown Guardian**: Automatically pauses operations for 15 minutes if Instagram rate limits occur to keep your account 100% safe.
  - **Pure Unauthenticated Waterfall**: Prioritizes public unauthenticated endpoints to shield logged-in sessions.

---

## 📁 Supported Media Types

---

## 🚀 Setup & Installation Guide

Follow these simple steps to install Vedinsta in any Chromium-based browser (Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi):

### Step 1: Clone or Download the Repository

```bash
git clone https://github.com/your-username/VedinstaExt.git
```

_Or click **Code > Download ZIP** on GitHub and extract the contents to a local folder._

### Step 2: Open Browser Extensions Page

Open your browser and navigate to the extension management page:

- **Google Chrome**: `chrome://extensions`
- **Microsoft Edge**: `edge://extensions`
- **Brave Browser**: `brave://extensions`

### Step 3: Enable Developer Mode

Toggle on **Developer mode** in the top right corner of the extension management page.

```
[ Developer mode   (ON) ]
```

### Step 4: Load the Unpacked Extension

1. Click the **Load unpacked** button.
2. Select the `VedinstaExt` root folder (containing `manifest.json`).
3. Vedinsta will now appear in your installed extensions list.

### Step 5: Pin the Extension

Click the puzzle piece icon (Extensions) in your browser toolbar and **Pin** Vedinsta for easy 1-click access.

---

## How to Use

### Method 1: Direct On-Page Download Buttons (Recommended)

1. Open [Instagram.com](https://www.instagram.com) in your browser.
2. Browse through your feed, posts, reels, stories, or profile pages.
3. Look for the **Vedinsta Download Bar / Buttons** positioned over posts or inside story viewers.
4. Click **Download** to save media directly to your default download folder (`/Downloads/Vedinsta/`).

### Method 2: Extension Popup

1. Click the **Vedinsta icon** in your browser toolbar.
2. Paste any Instagram URL into the input field **OR** click **Current Tab** to auto-detect the URL from your open tab.
3. Choose your desired quality preset (**High / Medium / Low / Custom**).
4. Click **Download**.

---

## 🏗️ Project Architecture & File Structure

```
VedinstaExt/
├── manifest.json         # Extension Manifest V3 configuration
├── background.js       # Service worker handling background downloads & storage
├── extractor.js        # Core Waterfall extraction engine & safety guardians
├── content.js          # Content script for DOM injection, action bars & toasts
├── content.css          # Injected UI styles (Overlay buttons, action bar, toasts)
├── popup.html          # Extension popup UI structure
├── popup.css           # Styling for popup interface
├── popup.js            # Popup logic, tab communication, & user interactions
├── generate_icons.js   # Icon generation utility script
└── LICENSE             # MIT Open Source License
```

### Core Engine Overview (`extractor.js`)

The extraction engine operates on a multi-tiered **Waterfall Strategy**:

1. **Tier 1 (HTML Embed Data)**: Parses `__additionalData`, `window._sharedData`, and inline JSON script tags embedded in the page.
2. **Tier 2 (GraphQL / Web API)**: Queries Instagram's GraphQL and mobile API endpoints (`/graphql/query`, `/api/v1/media/`).
3. **Tier 3 (Mobile Endpoint Fallback)**: Utilizes mobile User-Agent request signatures for bypass capabilities.
4. **Tier 4 (DOM Scraping Fallback)**: Extracts media src directly from high-resolution image DOM elements and video tags.

---

## 🛡️ Account Safety Rules

Vedinsta is built with user privacy and account longevity as a primary goal:

- **No Password Required**: Never asks for credentials or account access token.
- **Safe Request Throttling**: Implements mandatory random delays between requests.
- **Automatic Rate Limit Defense**: Automatically enters a 15-minute cooldown state if Instagram returns HTTP 429 status codes.

---

## Permissions Breakdown

---

## 🤝 Contributing

Contributions are welcome! If you'd like to improve Vedinsta or add new features:

1. **Fork the repository** on GitHub.
2. **Create a feature branch** (`git checkout -b feature/AmazingFeature`).
3. **Commit your changes** (`git commit -m 'Add some AmazingFeature'`).
4. **Push to the branch** (`git push origin feature/AmazingFeature`).
5. **Open a Pull Request**.

---

## 📄 License

Distributed under the **MIT License**. See [`LICENSE`](LICENSE) for more information.

---

## ⚠️ Disclaimer

**Vedinsta** is an independent open-source browser extension and is NOT affiliated with, authorized, maintained, sponsored, or endorsed by Instagram or Meta Platforms, Inc. All Instagram trademarks, logos, and brand assets belong to Meta Platforms, Inc. Use this tool responsibly and respect creator copyrights when downloading content.

Vedinsta-Ext

Vedinsta-Ext Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Vedinsta-Ext

Vedinsta-Ext Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README