basketcase 4.0.0

Download images and videos from Instagram

BasketCase

Download images and videos from Instagram.

Installation

Install it from PyPI.

pip install basketcase

This will put the executable basketcase on your PATH.

Usage

basketcase -u "https://instagram.com/p/<post_id>"

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

To download from multiple URLs, 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>

basketcase -f ./basketcase.txt

Supported URLs

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
https://www.instagram.com/stories/highlights/<highlight_id>/	A collection of stories, or "highlights"
https://www.instagram.com/s/<random_characters>	A shorter type of URL

Authentication

1. Add a session cookie

basketcase --cookie <session_cookie_id> --cookie-name "my session cookie"
# Added session id: 1

2. Specify its identifier when downloading

basketcase -s 1

List all available sessions with basketcase -l

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 the package.

hatch build

4. Commit and push the changes (and a new version tag) to the git repository.
5. Publish it.

hatch publish