pixi


Namepixi JSON
Version 1.0.0 PyPI version JSON
download
home_pagehttps://github.com/azuline/pixi
SummaryA command line tool to download images from Pixiv.
upload_time2020-02-15 20:22:29
maintainer
docs_urlNone
authorazuline
requires_python>=3.7,<4.0
licenseApache-2.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # pixi

[![Build Status](https://travis-ci.org/azuline/pixi.svg?branch=master)](https://travis-ci.org/azuline/pixi)
[![Coverage Status](https://coveralls.io/repos/github/azuline/pixi/badge.svg?branch=master)](https://coveralls.io/github/azuline/pixi?branch=master)
[![Pypi](https://img.shields.io/pypi/v/pixi.svg)](https://pypi.python.org/pypi/pixi)
[![Pyversions](https://img.shields.io/pypi/pyversions/pixi.svg)](https://pypi.python.org/pypi/pixi)

A command line tool to download illustrations from Pixiv.

```
Usage: pixi [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  artist     Download illustrations of an artist by URL or ID.
  auth       Log into Pixiv and generate a refresh token.
  bookmarks  Download illustrations bookmarked by a user.
  config     Edit the config file.
  failed     View illustrations that failed to download.
  illust     Download an illustration by URL or ID.
  migrate    Upgrade the database to the latest migration.
  wipe       Wipe the saved history of downloaded illustrations.
```

## Usage

This tool can be installed from PyPI as `pixi`.

```sh
$ pip install --user pixi
```

After installation, create the database and configure pixi with the following
commands.

```sh
$ pixi migrate  # Migrate the database
$ pixi config  # Configure pixi
```

Refer to the [configuration section](#Configuration) for details on the various
configuration options.

Now you can begin downloading!

For example, the following commands download an illustration. pixi accepts both
a URL to the illustration as well as just the illustration ID. The same applies
to all inputs that accept ID values.

```sh
$ pixi illustration https://www.pixiv.net/member_illust.php?mode=medium&illust_id=64930973
```

```sh
$ pixi illustration 64930973
```

Downloading all the illustrations of an artist can be done with the following
command.

```sh
$ pixi artist https://www.pixiv.net/member.php?id=2188232
```

Bookmarks, public and private, can be downloaded with the following command.

```sh
$ pixi bookmarks
```

The public bookmarks of other users can also be downloaded.

```sh
$ pixi bookmarks --user https://www.pixiv.net/member.php?id=2188232
```

And the following command downloads all bookmarks matching a user-assigned
bookmark tag.

```sh
$ pixi bookmarks --tag "has cats"
```

To view all the options available to a specific command, run the command with
the `--help` flag. For example, `illustration`'s options can be viewed with the
following command.

```sh
$ pixi --help illustration
```

When downloading many images from an artist or a user's bookmarks, an image
can occasionally fail to download. If an image fails to download after several
retries, it will be recorded and skipped. Failed images can be viewed with the
following command.

```sh
$ pixi failed
```

If an image on the failed list is successfully downloaded, it will
automatically be removed from the list. To wipe the entire failed list, the
following command should be run.

```sh
$ pixi wipe --table=failed
```

pixi also keeps track of which illustrations have been downloaded and will avoid
downloading duplicate illustrations. However, if you wish to re-download
illustrations, pass the `--allow-duplicates` (or `-a`) flag.

By default, illustration downloads will be tracked if they are downloaded to
the default downloads directory and not tracked if they aren't. This behavior
can be manually set with the `--track/--no-track` (or `-t/-T`) flag.

If you wish to wipe the database of tracked downloads, run the following
command and confirm the action.

```sh
$ pixi wipe --table=downloads
```

## Configuration

The configuration file is in `ini` format. A demo configuration is included
below. To run pixi, a default download directory must be configured.

```ini
[pixi]
; Leave this blank; the script will auto-populate it.
refresh_token =
; The default directory for illustrations to be downloaded to.
download_directory = /home/azuline/images/pixiv
```

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/azuline/pixi",
    "name": "pixi",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7,<4.0",
    "maintainer_email": "",
    "keywords": "",
    "author": "azuline",
    "author_email": "azuline@riseup.net",
    "download_url": "https://files.pythonhosted.org/packages/80/9a/4305fdac0fc7f0d7fa513339ba5e696b4b63378163a8d5ca961331513936/pixi-1.0.0.tar.gz",
    "platform": "",
    "description": "# pixi\n\n[![Build Status](https://travis-ci.org/azuline/pixi.svg?branch=master)](https://travis-ci.org/azuline/pixi)\n[![Coverage Status](https://coveralls.io/repos/github/azuline/pixi/badge.svg?branch=master)](https://coveralls.io/github/azuline/pixi?branch=master)\n[![Pypi](https://img.shields.io/pypi/v/pixi.svg)](https://pypi.python.org/pypi/pixi)\n[![Pyversions](https://img.shields.io/pypi/pyversions/pixi.svg)](https://pypi.python.org/pypi/pixi)\n\nA command line tool to download illustrations from Pixiv.\n\n```\nUsage: pixi [OPTIONS] COMMAND [ARGS]...\n\nOptions:\n  --help  Show this message and exit.\n\nCommands:\n  artist     Download illustrations of an artist by URL or ID.\n  auth       Log into Pixiv and generate a refresh token.\n  bookmarks  Download illustrations bookmarked by a user.\n  config     Edit the config file.\n  failed     View illustrations that failed to download.\n  illust     Download an illustration by URL or ID.\n  migrate    Upgrade the database to the latest migration.\n  wipe       Wipe the saved history of downloaded illustrations.\n```\n\n## Usage\n\nThis tool can be installed from PyPI as `pixi`.\n\n```sh\n$ pip install --user pixi\n```\n\nAfter installation, create the database and configure pixi with the following\ncommands.\n\n```sh\n$ pixi migrate  # Migrate the database\n$ pixi config  # Configure pixi\n```\n\nRefer to the [configuration section](#Configuration) for details on the various\nconfiguration options.\n\nNow you can begin downloading!\n\nFor example, the following commands download an illustration. pixi accepts both\na URL to the illustration as well as just the illustration ID. The same applies\nto all inputs that accept ID values.\n\n```sh\n$ pixi illustration https://www.pixiv.net/member_illust.php?mode=medium&illust_id=64930973\n```\n\n```sh\n$ pixi illustration 64930973\n```\n\nDownloading all the illustrations of an artist can be done with the following\ncommand.\n\n```sh\n$ pixi artist https://www.pixiv.net/member.php?id=2188232\n```\n\nBookmarks, public and private, can be downloaded with the following command.\n\n```sh\n$ pixi bookmarks\n```\n\nThe public bookmarks of other users can also be downloaded.\n\n```sh\n$ pixi bookmarks --user https://www.pixiv.net/member.php?id=2188232\n```\n\nAnd the following command downloads all bookmarks matching a user-assigned\nbookmark tag.\n\n```sh\n$ pixi bookmarks --tag \"has cats\"\n```\n\nTo view all the options available to a specific command, run the command with\nthe `--help` flag. For example, `illustration`'s options can be viewed with the\nfollowing command.\n\n```sh\n$ pixi --help illustration\n```\n\nWhen downloading many images from an artist or a user's bookmarks, an image\ncan occasionally fail to download. If an image fails to download after several\nretries, it will be recorded and skipped. Failed images can be viewed with the\nfollowing command.\n\n```sh\n$ pixi failed\n```\n\nIf an image on the failed list is successfully downloaded, it will\nautomatically be removed from the list. To wipe the entire failed list, the\nfollowing command should be run.\n\n```sh\n$ pixi wipe --table=failed\n```\n\npixi also keeps track of which illustrations have been downloaded and will avoid\ndownloading duplicate illustrations. However, if you wish to re-download\nillustrations, pass the `--allow-duplicates` (or `-a`) flag.\n\nBy default, illustration downloads will be tracked if they are downloaded to\nthe default downloads directory and not tracked if they aren't. This behavior\ncan be manually set with the `--track/--no-track` (or `-t/-T`) flag.\n\nIf you wish to wipe the database of tracked downloads, run the following\ncommand and confirm the action.\n\n```sh\n$ pixi wipe --table=downloads\n```\n\n## Configuration\n\nThe configuration file is in `ini` format. A demo configuration is included\nbelow. To run pixi, a default download directory must be configured.\n\n```ini\n[pixi]\n; Leave this blank; the script will auto-populate it.\nrefresh_token =\n; The default directory for illustrations to be downloaded to.\ndownload_directory = /home/azuline/images/pixiv\n```\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "A command line tool to download images from Pixiv.",
    "version": "1.0.0",
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "57b32da60dfb56cda7dec81b5f19c725",
                "sha256": "f0fb65d16fb5bdf62623d76522ba579095d04b6ce58797cc501b15cc378e41f0"
            },
            "downloads": -1,
            "filename": "pixi-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "57b32da60dfb56cda7dec81b5f19c725",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7,<4.0",
            "size": 15335,
            "upload_time": "2020-02-15T20:22:27",
            "upload_time_iso_8601": "2020-02-15T20:22:27.755287Z",
            "url": "https://files.pythonhosted.org/packages/7c/15/157977d3802069f07004c310d14a38a0d49b98f6af503dc399f6e8c543d2/pixi-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "3d3e4b187c26ab99ce3b528ba6567bee",
                "sha256": "c6a64f214ef4c4a06da8fee5990cd74fcecfd3f2624b641c195aae05cf763bc0"
            },
            "downloads": -1,
            "filename": "pixi-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "3d3e4b187c26ab99ce3b528ba6567bee",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7,<4.0",
            "size": 14103,
            "upload_time": "2020-02-15T20:22:29",
            "upload_time_iso_8601": "2020-02-15T20:22:29.572027Z",
            "url": "https://files.pythonhosted.org/packages/80/9a/4305fdac0fc7f0d7fa513339ba5e696b4b63378163a8d5ca961331513936/pixi-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2020-02-15 20:22:29",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": null,
    "github_project": "azuline",
    "error": "Could not fetch GitHub repository",
    "lcname": "pixi"
}
        
Elapsed time: 0.20373s