Skip to content

jasonsbmoc/gramcracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gramcracker

A Chrome extension for exporting your Instagram saved posts as a zip of named image files.

Gramcracker


What it does

Gramcracker scans your Instagram Saved posts, intercepts the image data your browser already loads, and packages everything into a single downloadable zip. Files are named Username_YYYYMMDD_NNNN.jpg so your archive stays organized.

  • Works on your default Saved folder and named collections
  • Supports carousel posts (download all slides or just the first)
  • No external API calls, no account credentials, no server — runs entirely in your browser
  • Free, open source, no usage limits

Install

Gramcracker isn't on the Chrome Web Store — you install it as an unpacked extension in developer mode.

  1. Download the latest zip from Releases and unzip it. You'll get a folder called gramcracker.

  2. Open Chrome and go to chrome://extensions

  3. Enable Developer mode with the toggle in the top-right corner

  4. Click Load unpacked and select the gramcracker folder (the one containing manifest.json)

  5. The Gramcracker icon will appear in your toolbar. If you don't see it, click the puzzle piece (🧩) and pin it.

Keep the folder. Chrome loads the extension directly from the folder — don't delete or move it after installing or the extension will stop working.


How to use

  1. Log in to Instagram and navigate to instagram.com/[you]/saved
  2. Click the Gramcracker icon and hit Start scanning
  3. The page will refresh automatically — this is expected. Reopen Gramcracker to see scan progress
  4. When the scan completes, click Download as zip

Carousel toggle: Controls whether multi-image posts export all slides or just the first image. Can be changed between scans without re-scanning.


Updating

When a new version is released:

  1. Download the new zip and unzip it, replacing the contents of your existing gramcracker folder
  2. Go to chrome://extensions and click the refresh icon on the Gramcracker card

A note on Instagram's Terms of Service

Gramcracker works by reading data your browser already loads when you visit your Saved posts page — it doesn't scrape other accounts or operate at scale. That said, automating interactions with Instagram is technically against their ToS.

In practice, the risk for personal archiving of your own saved content is very low. Instagram's enforcement targets bulk scrapers and commercial data harvesting. Use your judgment, and use this tool on your own content only.


Contributing

Bug reports and pull requests welcome. If something breaks (Instagram changes their internal API structure periodically), opening an issue with your console output is the most helpful thing you can do.


License

MIT — see LICENSE

JSZip (vendored as jszip.min.js) is also MIT licensed. See github.com/Stuk/jszip.

About

A Chrome extension for exporting your Instagram saved posts as a zip of named image files.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors