basketcase 3.1.1

Download images and videos from Instagram

BasketCase

Download images and videos from Instagram.

Installation and usage

1. Install it from PyPI.

pip install basketcase

This will put the executable basketcase on your PATH.

2. Create a text file (e.g. basketcase.txt) and populate it with resource URLs.

https://instagram.com/p/<post_id>
https://instagram.com/reel/<reel_id>
https://instagram.com/<username>

Supported URL	Description
https://instagram.com/<username>	User profile. Downloads stories from the past 24 hours.
https://instagram.com/p/<post_id>	Standard publication.
https://instagram.com/reel/<reel_id>	Reels movie

3. Pass the file as a positional argument. An interactive authentication procedure will follow.

basketcase ./basketcase.txt

Downloaded resources will be stored in the current working directory (i.e. $PWD/basketcase_{timestamp}/).

Known limitations:

• Highlights are not supported yet.
• Although two-factor authentication is supported, only the totp method has been tested.

User data

Cookies and other application data are kept in ~/.basketcase.

Development setup

1. cd to the project root and create a virtual environment in a directory named venv, which is conveniently ignored in version control.
2. Install the dependencies.

pip install -r requirements.txt

3. Install this package in editable mode.

pip install -e .

Package build and upload

1. Update the requirements list.

pip freeze --exclude-editable > requirements.txt

2. Increment the version on pyproject.toml.
3. Build and publish the package

hatch build
hatch publish

4. Commit and push the changes (and the new version tag) to the git repository.