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 GraphQL.
• 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.

Finally, I want to say that Instagram's inconsistent UI layout increased the development pain, especially the need to de-parse components built with React. Therefore, the malfunction of IG Helper was incredibly frustrating, but there was nothing I could do. I could only try to fix these parts in my spare time.

✨ Development Guide

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

1. Install dependencies:

npm install

1. Build the script:

node build.js

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

@sn-o-w

• Text translation (Romanian)
• Miscellaneous optimizations and enhancements, plus code debugging
• Reworked post, story and highlight lookups, and fixed carousel item detection and thumbnail button display in stories and highlights

@Yomisana

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