Skip to content

wenLiangcan/cum

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cum

Build Status codecov.io

comic updater, mangafied

Description

cum (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.

Installation

You can install cum on your system by executing python setup.py install. Please note that cum only supports Python 3.3+ at the moment.

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

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 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

alias      Assign a new alias to series.
chapters   List all chapters for a manga series.
config     Get or set configuration options.
download   Download all available chapters.
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.
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.

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 alias gakkou-gurashi 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

Community

There is an (inactive) IRC channel for cum: #cu on irc.rizon.net.

Design choices

  • File output format is partially based on Daiz's Manga Naming Scheme.
    • The full format would be a nightmare to get working with the sparse information available on scraper sites.
  • Code styling is based on Pocoo Style Guide with 79 character line limit.

About

comic updater, mangafied

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%