Giter VIP home page Giter VIP logo

manganese-cli's Introduction

Manganese-cli

NPM version Build Status Dependencies Status devDependencies Status

Command-line tool to download and organize manga on your computers using popular websites crawling.

Uses the manganese package for the core functionalities. Originally based on the starkana-manga-crawler project, but this time, with support for multiple websites through a plugin system.

install and setup

Using npm:

npm install manganese-cli -g

You then need to install a plugin. The plugin is responsible of the actual downloading work.

# This is just one plugin, more will come soon!
manganese install mangatown-manganese

You can find all available plugins by using

manganese find-plugin # don't freak out if it's slow, it's normal
# and then do
manganese install <that-plugin-that-you-like>

Should you want to remove one that you don't like (you can also simply not use it):

manganese remove <that-plugin-that-you-hate>

You can use manganese to control your library from the command line! For now, you can only download things, but more functionalities will be coming soon, such as keeping a list of manga that you like and download all the new releases.

downloading

Once you have a plugin installed, you can start downloading chapters using

manganese download|dl <plugin> <series> <chapter(s)> [options] 
// Examples
// Naruto chapter 1
manganese download manganese-plugin-example Naruto 1
// One Piece chapters 1 to 10 (1 and 10 included)
manganese dl manganese-plugin-example "One Piece" 1:10
// All Bleach chapters starting from chapter 600 onward (600 included)
manganese dl manganese-plugin-example Bleach 600:$
// Change the name of the series if you wish using -n
manganese dl manganese-plugin-example "The Breaker: New Waves" -n TBNW 1 

See number-ranger for how to format your chapter range queries.

Subscription

You can subscribe to series, and then request to download all the new chapters for the series you're subscribed to.

Subscribing

manganese subscribe|sub -p <plugin> [options] <series>
// Examples
// Subscribe to One Piece and Bleach
manganese subscribe -p manganese-plugin-example "One Piece" Bleach
// You can change the name of the series, but then only for one series
manganese sub -p manganese-plugin-example "The Breaker: New Waves" -n TBNW

// Unsubscribe using -u
manganese sub -u Bleach

Updating

Now you can get the latest chapters for all your subscriptions using only one command.

// Update all series
manganese update|up
// Update only some series
manganese update|up "One Piece" Bleach

This will only download those that you don't have yet, meaning starting from (but not included) the latest chapter you currently possess. How does manganese know how far along in the series you are? It will use both of the following techniques:

  • It will simply look at your manga folder(s), and figure out what the latest chapter is by looking at each folder's name and chapter number
  • The subscription file stored on your computer that registers all your subscriptions also stores your progress. Everytime you download chapters for one of your subscriptions (through download or update), this file will be updated. Tip: This file could be shared on Dropbox for example so that you can syncronize multiple computers. If wanted, you can disable updating your subscriptions by using --nocache.

manganese-cli's People

Contributors

jfmengels avatar

Stargazers

radjivF avatar

Watchers

James Cloos avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.