1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
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.
|
