Instagram Download Helper (IG Helper)

Buy me a coffee, Donate to ig-helper if it makes your help. Your donation makes ig-helper better: https://ko-fi.com/snkoarashi

Simple and fast download of resources from Instagram (posts, reels, stories, and more).

🎉 Features

• Force the fetching of all resources in the post.
• Download the resources in the post with one click.
• Download the resources currently displayed in the post with one click.
• Open the resource in a new window.
• Download the video thumbnail.
• Fetch high-quality photos or videos through the Media API.
• Disable video looping.
• Enable the native HTML5 video controller for video resources.
• Download the user's profile picture.
• Provide scroll buttons for Reels pages.
• Automatically modify and control the playback volume of all video elements.
• Redirect to a user's profile page when clicking on their avatar in the story area on the homepage.
• Customize the naming format when downloading according to your preferences.

⚙ How to Change Settings

1. Go to Instagram.com.
2. Check your Tampermonkey extension.
3. See the following:

📌 Hot keys

• ALT+Q - Close pop-up window
• ALT+W - Open the settings menu
• ALT+Z - Open the debug menu
• ALT+S - Download resource in story page

📢 Developer Statement

1. All code development and testing are based on the Chrome browser and the extension Tampermonkey.
2. Due to the framework and personal differences used in Instagram development, the page layout and node names presented by each person may be different. Therefore, all development and testing are based on the pages I have seen, which may cause a few people to The script does not work, please forgive me.
3. Extensive use of this script, especially when enabling the "Media API" or "Force Fetch API," may trigger Instagram's automation bot checks, potentially leading to account warnings, being logged out, or even being banned. Please use it with caution.

Important

On GreasyFork: https://greasyfork.org/scripts/404535-ig-helper

The extensions we support and test is Tampermonkey and make sure that you are downloaded the script from GreasyFork.

✨ Development Guide

This guide provides comprehensive documentation for developers who want to understand, modify, or contribute to the IG Helper codebase. It covers the build system, development environment setup, and contribution workflow.

Development Environment Setup

Prerequisites

• Node.js (v20 or newer)
• A userscript manager (Tampermonkey, Greasemonkey, or Violentmonkey)

Setup Steps

1. Clone the repository:

git clone https://github.com/SN-Koarashi/ig-helper.git
cd ig-helper

2. Install dependencies:

npm install

3. Build the script:

node build.js

Install the generated main.js file in your userscript manager.

Contribution Workflow

Development Process

1. Fork & Clone: Fork the repository and clone it locally
2. Branch: Create a feature branch
3. Develop: Make changes to the source files
4. Build: Run node build.js to generate the main.js file
5. Test: Install the script in your userscript manager and test your changes
6. Submit: Create a pull request

Code Standards

• Follow the existing code style
• Use ESLint to ensure code quality: npx eslint main.js
• Document new functions and features

Contributiner

@Yomisana

• Menu design suggestions and batch-download ideas
• Enhancement suggestions

@sn-o-w

• Text translation (Romanian)
• Miscellaneous optimizations and enhancements, plus code debugging