/comic-updater

comic updater, mangafied

Primary LanguagePythonApache License 2.0Apache-2.0

comic updater

comic updater, mangafied (loch's fork)

Description

comic-updater (comic updater, mangafied) is a tool designed for automated manga downloads from various online manga aggregate sites. It is inspired by some of the popular package managers used with Linux distributions and OS X. The file naming scheme is partially based Daiz's Manga Naming Scheme.

Fork description

This fork is based on the code Hamuko wrote up to 2017; I added some features to help manage watchlists stored on remote sites (Madokami in particular).

Installation

This fork isn't published to pyPI yet, so the best way to build it is to point at the repo directly:

pip install git+https://github.com/lochlainn/comic-updater

Users of Arch Linux can install release versions from the AUR.

Please note that cum currently requires Python 3.3 or newer.

Usage

To print out a list of available commands, use cum --help. For help with a particular command, use cum COMMAND --help.

Configuration

Configuration is stored at ~/.cum/config.json (%APPDATA%\cum\config.json for Windows) and overwrites the following default values. cum will not write login information supplied by the user at run-time back to the config file, but will store session cookies if any exist. Configuration can get read with the command cum config get [SETTING] and set using cum config set [SETTING] [VALUE].

See the Configuration wiki page for more details and available settings.

Commands

chapters   List all chapters for a manga series.
config     Get or set configuration options.
download   Download all available chapters.
edit       Modify settings for a follow.
follow     Follow a series.
  --directory TEXT  Directory which download the series chapters into.
  --download        Downloads the chapters for the added follows.
  --ignore          Ignores the chapters for the added follows.
follows    List all follows.
get        Download chapters by URL or by alias:chapter.
  --directory TEXT  Directory which download chapters into.
ignore     Ignore chapters for a series.
latest     List most recent chapter addition for series.
  --relative        Uses relative times instead of absolute times.
new        List all new chapters.
open       Open the series URL in a browser.
repair-db  Runs an automated database repair.
unfollow   Unfollow manga.
unignore   Unignore chapters for a series.
update     Gather new chapters from followed series.
  --fast            Skips series based on average release interval.

Examples

# Update the database with possible new chapters for followed series.
$ cum update

# List all new, non-ignored chapters.
$ cum new

# Add a follow for a manga series.
$ cum follow http://bato.to/comic/_/comics/gakkou-gurashi-r9554

# Print out the chapter list for the added series.
$ cum chapters gakkou-gurashi

# Ignore the first three chapters for the added series.
$ cum ignore gakkou-gurashi 2 3 1

# Change the alias for the added series.
$ cum edit gakkou-gurashi alias school-live

# Download all new, non-ignored chapters for the added series using the new alias.
$ cum download school-live

Supported sites

See the Supported sites wiki page for details.

Dependencies

Contribution

If you wish to contribute to cum, please consult the Contribution Guide first to make everything a bit easier.

Community

There is an IRC channel for cum, #cu on irc.rizon.net, where cum development and issues are occasionally discussed.