comic updater, mangafied

cum (comic updater, mangafied) is a tool designed for automated manga downloads from various online manga aggregate sites. Currently, the code is young and messy, so you should expect there to be issues and missing functionality. Please open up an issue on the tracker or submit a pull request to help out.

You can install cum on your system by executing python setup.py install. You can also execute the cum.py file directly, but it's not nearly as nice to use as the installed version. Please note that cum only supports Python 3.3+ at the moment.

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

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

Config is stored at ~/.cum/config.json and is automatically created with default values when the program is ran for the first time.

{
  "batoto": {
    "cookie": "",  // Used to login to Batoto.
    "member_id": "",  // Used to login to Batoto.
    "pass_hash": "",  // Used to login to Batoto.
    "password": "",  // Password to use with Batoto logins.
    "username": ""  // Username to use with Batoto logins.
  }
  "cbz": false,  // If true, the archive extension will be .cbz instead of .zip.
  "compact_new": true,  // Uses compact listing mode for `cum new`.
  "download_directory": "/path/to/manga",  // Directory where manga is downloaded.
  "download_threads": 4,  // Maximum number of concurrent downloads.
  "html_parser": "html.parser",  // HTML parser used by cum.
  "madokami": {
    "password": "" // Password to use with Madokami
    "username": "", // Username to use with Madokami.
  }
}

alias      Assign a new alias to series.
chapters   List all chapters for a manga series.
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.

# 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

• Batoto
  • Slow downloads
  • Account required
  • Reliable due to relatively standard naming format
• Dynasty Reader
  • Moderate speed downloads
  • Account not required
  • Reliable downloads
• Madokami
  • Fast downloads
  • Account required
  • Non-fixed format names for files combined with imperfect regex causes naming issues/exceptions

• alembic
• beautifulsoup4
• click
• natsort
• requests
• SQLAlchemy

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

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