cmdlr 2.0.2

A extensible command line tool use for subscribe online comic sites.

cmdlr is a extensible command line tool use for subscribe online comic sites.

Install

Make sure your python >= 3.4 and already install the pip, then…

pip3 install cmdlr

How to use

Set Your Local Comics Directory

cmdlr opt --output-dir <DIR>

Default comics directory is ~/comics.

Check which site be supported

cmdlr azr --list

Subscribe a comic

cmdlr -s <COMIC>

The <COMIC> can be a comic_id or comic’s url (the url usually is comic index page, but defined by analyzer independent).

Check current subscribed status

cmdlr -l

It will listing all subscribed comics in your database. If want differ detail level, please combine -v option like…

cmdlr -vl

or more…

cmdlr -l -vv

Download all your comics

cmdlr -d

All “no downloaded volumes” will be downloaded into your output directory.

Check comic sites update

cmdlr -r

           # or
cmdlr -rd  # check updated then download

Subscription Database

You can backup database manually if you want. The database location is…

~/.cmdlr.db

How to create a new analyzer plugin?

Very easy:

1. Clone cmdlr project from http://bitbucket.org/civalin/cmdlr.

2. Check src/cmdlr/comicanalyzer.py to learn what function you need to implement. And reference other analyzer plugin to create yours.

3. Put your .py plugin file into src/cmdlr/analyzers directory.

4. Run ./cmdlr.py under project directory to test the plugin.

5. When you done, don’t forget make a pull request to me. Thanks!

Happy hacking! :D

LICENSE

MIT License

Copyright (c) 2014~2015 CIVA LIN

Changelog

2.0.2

• Enhanced: Better exception processing.

2.0.1

• Enhanced: Truly avoid the title conflict.

• Enhanced: Windows platform path assign.

2.0.0

This is a fully rewrite version

• Backend DB: tinydb -> sqlite

• Collect more data.

• Remove search function.

• make it extensible.

1.1.0

• Init release.