{"id":14128664,"url":"https://github.com/Hamuko/cum","last_synced_at":"2025-08-03T23:32:01.154Z","repository":{"id":34272885,"uuid":"38160066","full_name":"Hamuko/cum","owner":"Hamuko","description":"comic updater, mangafied","archived":false,"fork":false,"pushed_at":"2022-01-25T12:08:09.000Z","size":284,"stargazers_count":171,"open_issues_count":18,"forks_count":15,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-11-30T02:20:02.578Z","etag":null,"topics":["cli","command-line","downloader","dynasty-scans","foolslide","madokami","manga","python","scraper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hamuko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-27T12:55:30.000Z","updated_at":"2024-10-01T19:30:17.000Z","dependencies_parsed_at":"2022-08-08T00:15:20.052Z","dependency_job_id":null,"html_url":"https://github.com/Hamuko/cum","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamuko%2Fcum","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamuko%2Fcum/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamuko%2Fcum/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hamuko%2Fcum/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hamuko","download_url":"https://codeload.github.com/Hamuko/cum/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228571844,"owners_count":17938772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","downloader","dynasty-scans","foolslide","madokami","manga","python","scraper"],"created_at":"2024-08-15T16:02:01.211Z","updated_at":"2024-12-07T06:31:34.964Z","avatar_url":"https://github.com/Hamuko.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# cum\n\n[![Build Status](https://travis-ci.org/Hamuko/cum.svg?branch=master)](https://travis-ci.org/Hamuko/cum)\n[![codecov.io](https://img.shields.io/codecov/c/github/Hamuko/cum.svg?maxAge=86400)](https://codecov.io/github/Hamuko/cum?branch=master)\n[![PyPI](https://img.shields.io/pypi/v/cum.svg?maxAge=86400)](https://pypi.python.org/pypi/cum)\n[![AUR](https://img.shields.io/aur/version/cum.svg?maxAge=86400)](https://aur.archlinux.org/packages/cum/)\n\ncomic updater, mangafied\n\n## Description\n\ncum (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](https://gist.github.com/Daiz/bb8424cfedd0f05b7386).\n\n## Installation\n\nThe easiest way to install the latest release of cum is by downloading and installing it from [Python Package Index](https://pypi.python.org/pypi/cum) with the command\n\n    pip install cum\n\nIf you want to get the latest and (possibly) the greatest, you can install the master branch version with\n\n    pip install git+https://github.com/Hamuko/cum\n\nUsers of Arch Linux can install release versions from [the AUR](https://aur.archlinux.org/packages/cum/).\n\nPlease note that cum currently requires **Python 3.3** or newer.\n\n## Usage\n\nTo print out a list of available commands, use `cum --help`. For help with a particular command, use `cum COMMAND --help`.\n\n### Configuration\n\nConfiguration 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]`.\n\nSee the [Configuration](../../wiki/Configuration) wiki page for more details and available settings.\n\n### Commands\n\n```\nchapters   List all chapters for a manga series.\nconfig     Get or set configuration options.\ndownload   Download all available chapters.\nedit       Modify settings for a follow.\nfollow     Follow a series.\n  --directory TEXT  Directory which download the series chapters into.\n  --download        Downloads the chapters for the added follows.\n  --ignore          Ignores the chapters for the added follows.\nfollows    List all follows.\nget        Download chapters by URL or by alias:chapter.\n  --directory TEXT  Directory which download chapters into.\nignore     Ignore chapters for a series.\nlatest     List most recent chapter addition for series.\n  --relative        Uses relative times instead of absolute times.\nnew        List all new chapters.\nopen       Open the series URL in a browser.\nrepair-db  Runs an automated database repair.\nunfollow   Unfollow manga.\nunignore   Unignore chapters for a series.\nupdate     Gather new chapters from followed series.\n  --fast            Skips series based on average release interval.\n```\n\n### Examples\n\n```bash\n# Update the database with possible new chapters for followed series.\n$ cum update\n\n# List all new, non-ignored chapters.\n$ cum new\n\n# Add a follow for a manga series.\n$ cum follow https://dynasty-scans.com/series/gakkou_gurashi\n\n# Print out the chapter list for the added series.\n$ cum chapters gakkou-gurashi\n\n# Ignore the first three chapters for the added series.\n$ cum ignore gakkou-gurashi 2 3 1\n\n# Change the alias for the added series.\n$ cum edit gakkou-gurashi alias school-live\n\n# Download all new, non-ignored chapters for the added series using the new alias.\n$ cum download school-live\n```\n\n## Supported sites\n\nSee the [Supported sites](../../wiki/Supported-sites) wiki page for details.\n\n## Dependencies\n\n* [alembic](https://pypi.python.org/pypi/alembic)\n* [beautifulsoup4](https://pypi.python.org/pypi/beautifulsoup4)\n* [click](https://pypi.python.org/pypi/click/4.0)\n* [natsort](https://pypi.python.org/pypi/natsort/4.0.3)\n* [requests](https://pypi.python.org/pypi/requests/2.7.0)\n* [SQLAlchemy](https://pypi.python.org/pypi/SQLAlchemy/1.0.6)\n\n## Contribution\n\nIf you wish to contribute to cum, please consult the [Contribution Guide](CONTRIBUTING.md) first to make everything a bit easier.\n\n## Community\n\nThere is an IRC channel for cum, `#cu` on `irc.rizon.net`, where cum development and issues are occasionally discussed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHamuko%2Fcum","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHamuko%2Fcum","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHamuko%2Fcum/lists"}