summaryrefslogtreecommitdiffstats
path: root/PKG-INFO
diff options
context:
space:
mode:
Diffstat (limited to 'PKG-INFO')
-rw-r--r--PKG-INFO73
1 files changed, 34 insertions, 39 deletions
diff --git a/PKG-INFO b/PKG-INFO
index a89521e..7a9a43a 100644
--- a/PKG-INFO
+++ b/PKG-INFO
@@ -1,6 +1,6 @@
Metadata-Version: 2.1
Name: gallery_dl
-Version: 1.16.5
+Version: 1.17.0
Summary: Command-line program to download image galleries and collections from several image hosting sites
Home-page: https://github.com/mikf/gallery-dl
Author: Mike Fährmann
@@ -21,6 +21,8 @@ Description: ==========
|pypi| |build| |gitter|
+ .. contents::
+
Dependencies
============
@@ -38,6 +40,7 @@ Description: ==========
Installation
============
+
Pip
---
@@ -57,48 +60,26 @@ Description: ==========
Note: Windows users should use :code:`py -3` instead of :code:`python3`.
- | It is advised to use the latest version of pip_,
- including the essential packages :code:`setuptools` and :code:`wheel`.
- | To ensure that these packages are up-to-date, run
+ It is advised to use the latest version of pip_,
+ including the essential packages :code:`setuptools` and :code:`wheel`.
+ To ensure these packages are up-to-date, run
.. code:: bash
$ python3 -m pip install --upgrade pip setuptools wheel
- From Source
- -----------
-
- Get the code by either
-
- * Downloading a stable_ or dev_ archive and unpacking it
- * Or via :code:`git clone https://github.com/mikf/gallery-dl.git`
-
- Navigate into the respective directory and run the :code:`setup.py` file.
-
- .. code:: bash
-
- $ wget https://github.com/mikf/gallery-dl/archive/master.tar.gz
- $ tar -xf master.tar.gz
- # or
- $ git clone https://github.com/mikf/gallery-dl.git
-
- $ cd gallery-dl*
- $ python3 setup.py install
-
-
Standalone Executable
---------------------
- Download a standalone executable file,
- put it into your `PATH <https://en.wikipedia.org/wiki/PATH_(variable)>`__,
- and run it inside a command prompt (like ``cmd.exe``).
+ Prebuilt executable files with a Python interpreter and
+ required Python packages included are available for
- - `Windows <https://github.com/mikf/gallery-dl/releases/download/v1.16.5/gallery-dl.exe>`__
- - `Linux <https://github.com/mikf/gallery-dl/releases/download/v1.16.5/gallery-dl.bin>`__
+ - `Windows <https://github.com/mikf/gallery-dl/releases/download/v1.17.0/gallery-dl.exe>`__
+ - `Linux <https://github.com/mikf/gallery-dl/releases/download/v1.17.0/gallery-dl.bin>`__
- These executables include a Python interpreter
- and all required Python packages.
+ | Executables build from the latest commit can be found at
+ | https://github.com/mikf/gallery-dl/actions/workflows/executables.yml
Snap
@@ -110,6 +91,7 @@ Description: ==========
$ snap install gallery-dl
+
Chocolatey
----------
@@ -119,15 +101,17 @@ Description: ==========
$ choco install gallery-dl
+
Scoop
- ----------
+ -----
- Apart from Chocolatey, *gallery-dl* is also available in Scoop_ "main" bucket for Windows users.
+ *gallery-dl* is also available in the Scoop_ "main" bucket for Windows users:
.. code:: powershell
$ scoop install gallery-dl
+
Usage
=====
@@ -232,9 +216,10 @@ Description: ==========
``e621``,
``exhentai``,
``idolcomplex``,
+ ``imgbb``,
``inkbunny``,
``instagram``,
- ``luscious``,
+ ``mangoxo``,
``pinterest``,
``sankaku``,
``subscribestar``,
@@ -264,6 +249,7 @@ Description: ==========
$ gallery-dl -u <username> -p <password> URL
$ gallery-dl -o username=<username> -o password=<password> URL
+
Cookies
-------
@@ -307,12 +293,14 @@ Description: ==========
$ gallery-dl --cookies "$HOME/path/to/cookies.txt" URL
+
OAuth
-----
*gallery-dl* supports user authentication via OAuth_ for
- ``deviantart``, ``flickr``, ``reddit``, ``smugmug`` and ``tumblr``.
- This is entirely optional, but grants *gallery-dl* the ability
+ ``deviantart``, ``flickr``, ``reddit``, ``smugmug``, ``tumblr``,
+ and ``mastodon`` instances.
+ This is mostly optional, but grants *gallery-dl* the ability
to issue requests on your account's behalf and enables it to access resources
which would otherwise be unavailable to a public user.
@@ -327,13 +315,20 @@ Description: ==========
access to *gallery-dl*. Authorize it and you will be shown one or more
"tokens", which should be added to your configuration file.
+ To authenticate with a ``mastodon`` instance, run *gallery-dl* with
+ ``oauth:mastodon:<instance>`` as argument. For example:
+
+ .. code:: bash
+
+ $ gallery-dl oauth:mastodon:pawoo.net
+ $ gallery-dl oauth:mastodon:https://mastodon.social/
+
+
.. _gallery-dl.conf: https://github.com/mikf/gallery-dl/blob/master/docs/gallery-dl.conf
.. _gallery-dl-example.conf: https://github.com/mikf/gallery-dl/blob/master/docs/gallery-dl-example.conf
.. _configuration.rst: https://github.com/mikf/gallery-dl/blob/master/docs/configuration.rst
.. _Supported Sites: https://github.com/mikf/gallery-dl/blob/master/docs/supportedsites.rst
- .. _stable: https://github.com/mikf/gallery-dl/archive/v1.16.5.tar.gz
- .. _dev: https://github.com/mikf/gallery-dl/archive/master.tar.gz
.. _Python: https://www.python.org/downloads/
.. _PyPI: https://pypi.org/