getpiccoma

Retrieve and save images from manga distribution sites using Piccoma.

Pages are served sliced into a grid of 50px tiles and shuffled; getpiccoma replays the viewer's own shuffle to put them back together before saving.

Valid URL Formats

• piccoma.com/web/viewer/<product-id>/<episode-id> -- one episode
  • e.g. https://piccoma.com/web/viewer/8195/1185884
• piccoma.com/web/product/<product-id>/episodes -- the whole series, from its first entry
  • e.g. https://piccoma.com/web/product/8195/episodes

Only Piccoma Japan is supported. Piccoma France (piccoma.com/fr/) runs a different site and is not handled.

Installation

# mise via github release
mise use -g github:eggplants/getpiccoma

# mise via pipx
mise use -g pipx:getpiccoma

# pipx
pipx install getpiccoma

# pip
pip install getpiccoma

Docker

docker pull ghcr.io/eggplants/getpiccoma

docker run --rm -v "$PWD:/work" -w /work \
  ghcr.io/eggplants/getpiccoma https://piccoma.com/web/viewer/8195/1185884

CLI

$ pget https://piccoma.com/web/viewer/8195/1185884
get: https://piccoma.com/web/viewer/8195/1185884
  Downloading... ━━━━━━━━━━━━ 100% ( 14/14 pages ) remain: 0:00:00 spent: 0:00:09
saved: <series>/<episode>
done.

-b follows every next episode, and stops on the first one the account may not read. A product URL implies it:

pget https://piccoma.com/web/product/8195/episodes -d out

Log in with -u to reach episodes the account has bought or unlocked. The password is prompted for when -p is left out:

pget https://piccoma.com/web/viewer/8195/1185884 -u you@example.com

Library

from getpiccoma import Piccoma

piccoma = Piccoma()
next_url, save_dir, saved = piccoma.get(
    "https://piccoma.com/web/viewer/8195/1185884",
    save_path="out",
)

episode_info reads a viewer page without downloading anything, and entries lists a series:

episode = piccoma.episode_info("https://piccoma.com/web/viewer/8195/1185884")
print(episode.series_title, episode.episode_title, len(episode.pages))

for entry in piccoma.entries(episode.product_id):
    print(entry.title, entry.is_readable, entry.url)

descramble and parse_seed are exposed on their own, for pages fetched some other way:

from PIL import Image
from getpiccoma import descramble, parse_seed

seed = parse_seed(image_url)
page = descramble(Image.open(path), seed) if seed else Image.open(path)

Acknowledgements

• catsital/pyccoma
• catsital/pycasso

License

MIT License