Metadata-Version: 2.1
Name: instasave
Version: 0.2.0
Summary: Download script for Instagram posts
Home-page: https://github.com/fsoubelet/InstaSave
License: MIT
Keywords: Download,Instagram,Utility
Author: Felix Soubelet
Author-email: felix.soubelet@liverpool.ac.uk
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Utilities
Requires-Dist: loguru (>=0.4.1,<0.5.0)
Requires-Dist: requests (>=2.23.0,<3.0.0)
Requires-Dist: tqdm (>=4.46.0,<5.0.0)
Requires-Dist: typer (>=0.3.2,<0.4.0)
Project-URL: Repository, https://github.com/fsoubelet/InstaSave
Description-Content-Type: text/markdown

<h1 align="center">
  <b>instasave</b>
</h1>

A simple script to download media from Instagram posts.

## Install

This script runs on Python3.6+.
You can install it from PyPI with:
```bash
pip install instasave
```

## Usage

With this package installed in the activated enrivonment, it can be called through `python -m instasave` or through a newly created `instasave` command.

Detailed usage goes as follows:
```bash
Usage: instasave [OPTIONS] [URL]

  Download media from Instagram posts.

Arguments:
  [URL]  Link to the Instagram post you want to download the content of.

Options:
  --log-level TEXT      The base console logging level. Can be 'debug',
                        'info', 'warning' and 'error'.  [default: info]

  --install-completion  Install completion for the current shell.
  --show-completion     Show completion for the current shell, to copy it or
                        customize the installation.

  --help                Show this message and exit.
```

The downloaded files will be saved in the current directory under a name composed of the file type (image / video) appended by the download timestamp.

Warning: abusing this script may get your IP banned by Instagram.

## TODO

- [x] Implement proper logging.
- [x] Make into a package.
- [x] Make callable as a python module (`python -m instasave ...`).
- [x] Improving the command line experience.

## License

Copyright &copy; 2020 Felix Soubelet. [MIT License][license]

[license]: https://github.com/fsoubelet/InstaSave/blob/master/LICENSE
[loguru_url]: https://github.com/Delgan/loguru
[requests_url]: https://github.com/psf/requests
[tqdm_url]: https://github.com/tqdm/tqdm

