A Python and Command-Line Interface to Archive.org

|tox| |versions| |downloads| |contributors|

.. |tox| image:: https://github.com/jjjake/internetarchive/actions/workflows/tox.yml/badge.svg :target: https://github.com/jjjake/internetarchive/actions/workflows/tox.yml

.. |versions| image:: https://img.shields.io/pypi/pyversions/internetarchive.svg :target: https://pypi.org/project/internetarchive

.. |downloads| image:: https://static.pepy.tech/badge/internetarchive/month :target: https://pepy.tech/project/internetarchive

.. |contributors| image:: https://img.shields.io/github/contributors/jjjake/internetarchive.svg :target: https://github.com/jjjake/internetarchive/graphs/contributors

This package installs a command-line tool named ia for using Archive.org from the command-line. It also installs the internetarchive Python module for programmatic access to archive.org. Please report all bugs and issues on Github <https://github.com/jjjake/internetarchive/issues>__.

SECURITY NOTICE

---

Please upgrade to v5.4.2+ immediately. Versions <=5.4.1 contain a critical directory traversal vulnerability in the File.download() method. See the changelog for details <https://github.com/jjjake/internetarchive/blob/master/HISTORY.rst>_. Thank you to Pengo Wray for their contributions in identifying and resolving this issue.

Installation

You can install this module via pipx <https://pipx.pypa.io/stable/>_:

.. code:: bash

$ pipx install internetarchive

Binaries of the command-line tool are also available:

.. code:: bash

$ curl -LO https://archive.org/download/ia-pex/ia
$ chmod +x ia
$ ./ia --help

Unsupported Installation Methods

**This library must only be installed via** `one of the supported methods <https://archive.org/developers/internetarchive/installation.html>`_ **(i.e.** ``pip``, ``pipx``, **or from source).**

Installation via third-party package managers like Homebrew, MacPorts, or Linux system packages (apt, yum, etc.) is **not supported**. These versions are often severely outdated, incompatible, and broken.

If you have installed this software via Homebrew, please uninstall it (`brew uninstall internetarchive`) and use a supported method.

Documentation
-------------

Documentation is available at `https://archive.org/services/docs/api/internetarchive <https://archive.org/services/docs/api/internetarchive>`_.


Contributing
------------

All contributions are welcome and appreciated. Please see `https://archive.org/services/docs/api/internetarchive/contributing.html <https://archive.org/services/docs/api/internetarchive/contributing.html>`_ for more details.