Skip to content
Projects

saschaheim/instantgram has 36 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-14 20:14 UTC. Last push 2026-11-10.

How these counts are measured

What you can do

  • Posts and carousels - :white_check_mark:
  • Reels and videos - :white_check_mark:
  • Stories and highlights - :white_check_mark:
  • Profile pictures - :white_check_mark:

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

☁️ A bookmarklet for download photos in Instagram

Creative & Media

README.md

Original

instantgram

Release For Instagram Powered by Preact Firefox Lite

Ko-fi Patreon Buy Me a Coffee PayPal

Download Instagram posts, reels, stories and profile pictures directly from your bookmarks bar.

No extension. No separate app. No account hand-off. Open Instagram, click instantgram, and the media viewer is ready.

Get Instantgram

Open the install page and drag instantgram to your bookmarks bar

  1. Drag the instantgram button into your browser's bookmarks bar.
  2. Open a supported post, reel, story or profile on instagram.com.
  3. Click the bookmark and download the media you want.

The 2026.10.24 Release

Instagram changed its API responses, which broke story downloads for some users. This release includes Kaique Gazola's fix (#55).

  • Story owners are now looked up in the page data first. The username feed, which sometimes returns a spam error, is only used as a last resort.
  • Empty story responses trigger alternative requests. If those fail, Instantgram tries to load the individual story from its URL.
  • Header icons now use SVGs instead of font characters, so the gear and arrows have the same size and alignment on macOS and Windows.
  • 121 tests pass. Firefox Lite remains below the bookmarklet size limit at 65,505 characters.

The fix worked in the contributor's session. Issue #54 stays open until the other affected users confirm it works for them too.

To update, replace your bookmark from the install page. Firefox users should use Firefox Lite.

The 2026.10.14 Release

This release adapts profile and story lookups to Instagram API failures using the current Instaloader implementation as a reference.

  • Embedded profile data: reads xig_user_by_username from the current page or an anonymous profile-page HTML response, using pk as the user ID. This replaces the failed topsearch and usernameinfo fallback requests while retaining the username feed lookup.
  • Story fallbacks: uses a single story's media ID when its owner cannot be resolved, and tries Instaloader's GraphQL story query when the mobile story feed request fails. GraphQL image and video resources are converted for the existing viewer.
  • Firefox Lite stays installable: uses a text wordmark in the header to make room for the additional lookup logic.
  • Validation: 111 automated tests cover embedded profile data and API failures. Live compatibility with the reporting user's Instagram session has not yet been confirmed; this release does not claim to resolve every story failure in #54.

The 2026.10.07 Release

This maintenance release improves failed-story feedback and updates the app and development toolchain while keeping Firefox Lite installable.

  • Clearer story failures: unavailable stories and highlights no longer show the misleading �Did you open an Instagram post?� hint. The download failure reported in #54 remains under investigation.
  • Updated dependencies: Preact 11, Vitest 5, Astro 7.3.5 and Turbo 2.11.7, with compatible compiler versions retained where newer releases break the build.
  • Firefox Lite still fits: internal UI and drag-state fields are minified more efficiently to stay below the complete 65,536-character bookmarklet URL limit.
  • More reliable regression coverage: corrected the empty-story test so it actually reaches the story endpoint, and added coverage for redirected feed responses and failed-story messages.

The 2026.09.09 Release

This maintenance release restores Firefox Lite installation and includes two community fixes by Kaique Gazola (@kaiquegazola).

  • Firefox Lite installs again: the release build now measures the complete javascript: URL, stays below Firefox's 65,536-character limit and fails if a generated Lite bookmarklet is too large.
  • Full-resolution profile pictures: the full build checks Instagram's original-resolution candidates instead of settling for a thumbnail (#51).
  • Isolated modal styles: Instantgram now renders inside a shadow root, preventing its CSS from changing Instagram's interface or remaining behind after the modal closes (#52).

The 2026.08.02 Release

This is the biggest instantgram upgrade in years. The bookmarklet has evolved from a collection of dialogs into a compact, reactive app that still launches from a single bookmark.

The latest follow-up makes that app easier to recover and keeps Firefox support alive at the absolute edge: settings now include a discreet Instantgram reset that removes current and legacy Instantgram data without touching Instagram, while Firefox Lite retains its updater, scanners, settings and diagnostics at exactly the browser's 65,536-character bookmarklet limit.

  • A real reactive interface: the complete media viewer now runs on Preact, with smooth in-place transitions instead of tearing down and reopening modals.
  • A better media experience: polished sliders, stable video playback, live slideshow controls, instant settings updates and persistent expand state.
  • Smarter Instagram detection: stronger handling for posts, reels, stories, profiles and sponsored content, including feed and search fallbacks for Instagram API edge cases.
  • Settings that feel native: clearer cards, live language switching, persistent preferences and consistent controls throughout the app.
  • Four languages: English ships in the release bundle; German, Spanish and Portuguese can load directly through Instagram and remain cached locally.
  • Firefox gets its own build: Firefox Lite keeps every scanner, setting and console diagnostic, trims update-checking to a single alert and drops purely decorative styling (rounded corners, hover transitions, drop shadows) -- the combination that actually fits under Firefox's strict bookmarklet limit, with room to spare.
  • A refreshed install page: copy across all four languages now matches the real feature set instead of undersold "single image" wording, and the hero preview plays a looping clip at its real length instead of being cut short.
  • A way to say thanks: Ko-fi, Patreon, Buy Me a Coffee and PayPal links on the install page and right inside the bookmarklet's own settings, in every build including Firefox Lite.
  • A modern foundation: pnpm workspaces, Turbo, Astro 7, TypeScript, Preact and a deterministic Vitest suite make future fixes dramatically easier to ship.

Features

Capability Included
Posts and carousels :white_check_mark:
Reels and videos :white_check_mark:
Stories and highlights :white_check_mark:
Profile pictures :white_check_mark:
Direct download or new tab :white_check_mark:
Automatic slideshow :white_check_mark:
Video and story mute controls :white_check_mark:
Custom download filenames :white_check_mark:
Expandable media viewer :white_check_mark:
Monetized posts Not currently supported

Browser Support

Browser Support
Google Chrome Full
Microsoft Edge Full
Mozilla Firefox Firefox Lite build
Safari Modern versions
Internet Explorer 11 Not supported

Firefox enforces a much smaller bookmarklet size limit than Chromium browsers. Use the dedicated Firefox Lite button on the install page; it trims update-checking to a single alert and drops decorative styling, not media scanners, settings or diagnostics.

Development

The repository is a pnpm monorepo:

  • packages/bookmarklet contains the Preact bookmarklet application.
  • apps/site contains the Astro install site and GitHub Pages output.
pnpm install
pnpm test
pnpm lint
pnpm build

The full build creates localized development bundles, production bookmarklets, the Firefox Lite variant and the static GitHub Pages site.

Contributing

Bug reports are most useful with browser, console and network details attached. Read CONTRIBUTING.md before opening a pull request.

Changelog

Read the complete release history in CHANGELOG.md.