Working Examples

Something to remember

Dosage's main executable is called "mainline", these examples will not detail the system specifics about how to run mainline. It will instead assume that "mainline" is all it takes to run Dosage.

Simple examples

Download the latest strip available for a given module, in this case MegaTokyo?:

mainline MegaTokyo

Download all the strips available between the latest local strip and the latest available strip:

mainline -c MegaTokyo

Download all the strips available between the latest local strip and the latest available strip and save them to ~/Comics: (Please note that Python will allow you to use "/" as a path separator under Windows)

mainline -cb ~/Comics MegaTokyo

Download all the strips available for a given module, regardless of whether they exist locally or not. Strips that already exist will not be overwritten: (Please note that strips are deemed to be the same if their filesizes and filenames match)

mainline -cc MegaTokyo

@ and @@ are special characters that may be used in place of a comic's name, @ expands to mean "all the comics in the Comics directory" and @@ expands to mean "all the comics available to Dosage".

Download all of the strips available between the latest local strip and the latest available strip for every comic in your Comics directory:

mainline -c @

Download the latest strip for every comic that Dosage supports:

mainline @@

Download all of the strips available for every comic that Dosage supports: (Please note that at the time of writing this is over 24GB of comics)

mainline -cc @@

There are also options for verbosity, timestamps, etc.

Complex examples

You can use the indexing syntax, for comics that support indexing, to indicate a specific comic. When used in conjunction with "catch up" it is essentially a method of "resuming". Specify --module-help to find out the syntax needed for a given module.

Download a specific comic for a given module:

mainline MegaTokyo:0400

Download all of the strips available for a given module, starting from a certain index:

mainline -cc MegaTokyo:0200

Download all of the strips available between the latest local strip and the latest available strip for all of the comics in your Comics directory and write an HTML file linking to the strips actually downloaded in the run: (The HTML file is named according to the date)

mainline -co html @

Download all of the latest strips for every comic that Dosage supports and output an RSS feed detailing the last 24 hours of strips downloaded:

mainline -o rss @@