Metadata-Version: 2.4
Name: instagram-offline
Version: 0.3.0
Summary: Download videos and reels from Instagram accounts into a browsable local site
License-Expression: GPL-3.0-or-later
Project-URL: Source, https://github.com/bittner/instagram-offline
Project-URL: Changelog, https://github.com/bittner/instagram-offline/releases
Project-URL: Issues, https://github.com/bittner/instagram-offline/issues
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: System :: Archiving
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSES/GPL-3.0-or-later.txt
Requires-Dist: playwright>=1.50
Requires-Dist: requests>=2.32
Provides-Extra: mypy
Requires-Dist: mypy>=1.19; extra == "mypy"
Requires-Dist: types-requests>=2.32; extra == "mypy"
Provides-Extra: unittest
Requires-Dist: coverage[toml]>=7; extra == "unittest"
Requires-Dist: pytest>=8; extra == "unittest"
Dynamic: license-file

<!--
SPDX-FileCopyrightText: 2026 Peter Bittner <django@bittner.it>

SPDX-License-Identifier: GPL-3.0-or-later
-->

# instagram-offline [![Python package][version]][pypi] [![REUSE status][reuse]][reuse-info] [![Vibe coded][badge]][contributing]

Downloads all videos and reels of one or more Instagram accounts and builds a self-contained static
site in `site/`, one folder per account. Watch the creators you chose distraction-free, without ads,
autoplay or an algorithmic feed. Keep a usable archive of your own work, which Meta's data export
does not easily provide.

## How it works

Instagram rejects scripted API clients (Instaloader, gallery-dl, yt-dlp) while a real browser
session works fine. The downloader therefore drives a logged-in Chromium-based browser over the
DevTools protocol: it scrolls the profile grid, harvests the post data Instagram sends to the
page, and downloads the files from Instagram's CDN. Collaboration posts owned by another account
are included. Re-runs only fetch new posts.

## Usage

```sh
uvx instagram-offline USERNAME
python -m http.server -d site
```

From a checkout, `uv run insta USERNAME` does the same.

Log in to Instagram in the browser window on the first run.

Any Chromium-based browser works: Chromium, Chrome, Brave, Edge, Vivaldi or Opera are found
automatically on Linux, macOS and Windows; `--browser EXECUTABLE` selects one explicitly, and
a Chromium-based browser in the conventional `$BROWSER` variable is preferred over the search.
Without any, Playwright's own Chromium is downloaded on first use.
**Firefox and Safari are not supported**, as they lack the DevTools protocol the tool relies on.

An optional `site/USERNAME/profile.json` with an `about` text and a list of topics (name plus
caption keywords) adds an "About" box to the overview and topic filters to the account page.
Keywords match at the start of a word; a trailing space makes a keyword match whole words only.

### Versioning the content

`site/` is ignored by this repository. To track changes of the archive, keep it as a separate,
private Git repository that ignores the video files and versions only the metadata, index and HTML
pages:

```sh
cd site
git init
printf '*.mp4\n*.part\n' > .gitignore
git add .
git commit -m "Add archive"
```

After each download run, commit the changes in `site/`.

## Legal notice

This project is not affiliated with, endorsed by or connected to Instagram or Meta Platforms, Inc.
in any way. This software is provided for research and educational purposes only. Downloading
content from Instagram in an automated way, in particular with a logged-in account, may violate
Instagram's Terms of Use and Meta's platform policies and may result in restrictions or termination
of the account used. All downloaded content remains the intellectual property of its respective
creators and rights holders. Whether making a copy for private use is permitted depends on the
copyright law of your jurisdiction; distributing, publishing or otherwise making the downloaded
content or the generated website available to the public without the rights holders' permission
constitutes copyright infringement and may violate personality, image and data-protection rights.

You are solely responsible for ensuring that your use of this software complies with all applicable
laws, regulations and contractual terms. The authors and contributors accept no liability for any
claims, damages or other liability arising from the use of this software or the content obtained
with it. Nothing in this document constitutes legal advice.

[version]: https://img.shields.io/pypi/v/instagram-offline?logo=pypi&logoColor=white
[badge]: https://img.shields.io/badge/vibe_coded-responsibly-ff69b4?logo=claude&logoColor=white
[pypi]: https://pypi.org/project/instagram-offline/
[contributing]: CONTRIBUTING.md
[reuse]: https://api.reuse.software/badge/github.com/bittner/instagram-offline
[reuse-info]: https://api.reuse.software/info/github.com/bittner/instagram-offline
