- - - - - yumeneru - - - - - nemuru - - - - -
- -
- -
- - - - - yumeneru - - - - - nemuru - - - - -
A CLI tool for downloading content from pixiv. It allows you to download individual artworks/manga, all of an accounts artworks/manga, the latest content from accounts you follow, and all content from all of the accounts you follow.
Usage: pixiv_down <command> <arguments> [options]
Commands:
artist [-t|--type TYPE] <id> [<id2>, <id3>, ...]
Download all content of TYPE from the provided account ID(s).
TYPE can be either manga, illust, or novel, depending on what
you want to download.
artwork [--group-errors] <id> [<id2>, <id3>, ...]
Download an artwork (or manga) with ID <id>. You can download
multiple items by passing multiple IDs separated by a space.
The --group-errors option will change the behaviour such that
instead of printing any errors after each ID, all errors will
be printed after attempting to download the last ID.
compact [-i|--interactive] [-n|--dry-run]
Go through all the accounts you have downloaded and remove
duplicated content. When downloading, pixiv_down creates
a directory using the current account's display name, which
can change. The compact command will move any content from
the old directories (previous display names) in to the
directory using the current display name, so long as the
content is not already present.
The --interactive option will allow you to choose which
directory name to use. The --dry-run option will print
out the actions that would take place, without actually
performing the actions.
daily <-e|--end END> [-b|--begin BEGIN] [-s|--sfw-only]
Download the latest content from all the accounts you follow.
The END option specifies the date to stop downloading at. The
default behaviour is to download everything from the time of
execution until END. You can optionally specify BEGIN to change
the date pixiv_down begins downloading from. Both BEGIN and
END expect a date in the format YYYY-MM-DD.
The --sfw-only option restricts the content that is downloaded
to that which is not marked as R-18..
following <--public|--private> [-s|--skip NUMBER]
Download all content from the accounts you follow, in order of
most recently followed. You must specify whether to download
from accounts you publically follow (--public) or the accounts
you follow in private (--private).
If you know that you have already downloaded the first 3
accounts, you can use the --skip option (--skip 3) which
will cause pixiv_down to skip over the first 3 accounts.
novel [--group-errors] <id> [<id2> <id3> ...]
Download the novel with ID <id>. You can download multiple
items by passing multiple IDs separated by a space.
The --group-errors option will change the behaviour such that
instead of printing any errors after each ID, all errors will
be printed after attempting to download the last ID.
prune [-n|--dry-run] [-q|--quiet]
Go through all the accounts you have downloaded and remove
directories for accounts that you no longer follow, or no
longer exist (i.e. the account has been deleted).
You will be prompted to remove an account's directories unless
the --quiet option is used, in which case the directories will
be removed automatically.
Passing the --dry-run option will still prompt to remove
the directories, however, it will not actually remove them.
At the moment there is only one configuration option, which is to specify where the content is downloaded. The configuration file can be found in the following locations, depending on your operating system:
The configuration should be as follows:
[output] directory = /home/username/Pictures
Change /home/username/Pictures to the directory of your choice.
Currently there are no direct downloads meaning you'll have to build from source. I plan on providing an AppImage for Linux soon, I just want to have a version of MagickD for the more recent versions of GraphicsMagick.
The pixiv_down source code is available via git. Web interfaces are available at the pixiv_down repository hosted on codeberg and the pixiv_down repository at SourceForge.
To get the tree and place it in a sub-directory of your current directory, you can clone it from either of the above repositories:
git clone https://codeberg.org/supercell/pixiv_down
or
git clone git://git.code.sf.net/p/pixiv-down/code pixiv_down
Please keep in mind that constantly sending a lot of requests to the servers hosting pixiv may result in your account being suspended or terminated. pixiv_down has a rudementary system to try and avoid this, however there is no guarantee that it will prevent this from happening. I'm not responsible if you abuse the servers.
It should also be mentioned that pixiv_down doesn't help you download content which you don't have access to. For example, if you're attempting to download a post from another person's account and it is private, then it will not work.
pixiv_down is licensed under the terms GNU General Public License, version 3. You can find more details in the COPYING file, or online at the GNU website.
There isn't too much of a roadmap, just a couple of loose features that I still want to implement before calling this "done".
This page was first uploaded: 2023-01-28
Last update: 2024-03-18 (Updated usage, macOS support, and OSDN -> SourceForge)
- -
- -