dosage man page on DragonFly
[printable version]
DOSAGE(1) DOSAGE(1)
NAME
dosage - a comic strip downloader and archiver
SYNOPSIS
dosage [options] module...
DESCRIPTION
dosage is an application designed to keep a local mirror of specific
web comics and other picture-based content, such as Picture Of The Day
sites, with a variety of options for updating and maintaining collec‐
tions.
OPTIONS
-b PATH, --basepath=PATH
Specifies a base path to put comic subdirectories. The default
is Comics.
--baseurl=PATH
Specifies the base URL for output handlers. The default is a
local file URI.
-a, --all
Traverses all available strips backwards from the current one.
This can be useful you want a full collection of a new comic
strip, or update an existing one where files are missing.
Catchups can start at a specific strip by using the index syn‐
tax, see the INDEX SYNTAX and SPECIAL SYNTAX sections for more
information. This is useful when you missed some days and want
only to download the missing files.
-c, --continue
Same as --all, but stop at the first existing image file. Use‐
ful for cron jobs that are not executed every day.
-h, --help
Output brief help information.
-l, --list
List available comic modules in multi-column fashion.
--singlelist
List available comic modules in single-column fashion.
-m MODULE, --modulehelp=MODULE
Output module-specific help for MODULE.
-o OUTPUT, --output=OUTPUT
OUTPUT may be any one of the following:
html - Writes out an HTML file linking to the strips actually
downloaded in the current run, named by date (ala dailystrips).
The files can be found in the html directory of your Comics
directory.
rss - Writes out an RSS feed detailing what strips were down‐
loaded in the last 24 hours. The feed can be found in
Comics/dailydose.xml.
json - Write a JSON file with all download infos (URLs, images).
Can be used with other scripts, eg. order-symlinks.py to add
symbolic links.
This option can be given multiple times.
-t, --timestamps
Print timestamps for all output at any level.
-v, --verbose
Increase the output level by one with each occurence.
-V, --version
Display the version number.
--vote Vote for the selected comics to tell others that you like them.
The sum of all votes for a comic will be displayed at the comic
index pages at http://wummel.github.io/dosage/comic-index.html
module At least one valid module must be specified. A list of
valid modules can be found by passing the -l option. Multiple
module arguments can be specified on the command line. Module
names are case insensitive, and it is sufficient to specify a
unique substring of the module name.
INDEX SYNTAX
Instead of starting at the latest comic strip, an index lets dosage
start at a certain strip. The index can be specified by appending a
colon : and the index name after the module. Multiple comma-spearated
indices can also be specified.
The index name itself usually is the part of the comic strip URL that
identifiess a strip, eg. a number or a date. The expected format is
documented when using the --modulehelp option.
SPECIAL SYNTAX
@ This expands to mean all the comics currently in your Comics
directory. All other specified comic module names will be
ignored.
@@ This expands to mean all the comics available to Dosage.
INDEX SYNTAX can not be used with SPECIAL SYNTAX.
EXAMPLES
Retrieve all Mega Tokyo comics:
dosage -a megatokyo
Retrieve the current comic of Cyanide and Happiness:
dosage cyanideandhappiness
Retrieve the current strip of all comics in your Comics directory:
dosage @
Vote for the comics in your Comics directory:
dosage --vote @
Retrieve the current strip of every comic that there is a module for:
dosage @@
Retrieve the Penny Arcade strip for a given index:
dosage pennyarcade:2004-07-22
Retrieve Calvin and Hobbes strips from a given index going backwards to
the beginning.
dosage -a calvinandhobbes:2012/07/22
ENVIRONMENT
HTTP_PROXY
dosage will use the specified HTTP proxy when downloading URL
contents.
NOTES
Should retrieval fail on any given strip dosage will attempt to retry.
However the retry information is only outputted in the second and suc‐
cessive output levels.
At the time of writing, a complete Dosage collection weighs in at
around 3.0GB.
RETURN VALUE
The return value greater than zero when
· a program error occurred.
· comics could not be found or downloaded
· the program run was aborted with Ctrl-C
Else the return value is zero.
BUGS
Users can report or view bugs, patches or feature suggestions at
https://github.com/wummel/dosage/issues
AUTHORS
Jonathan Jacobs, Tristan Seligmann, Bastian Kleineidam <bas‐
tian.kleineidam@web.de>
COPYRIGHT
Copyright © 2004-2005 Tristan Seligmann and Jonathan Jacobs
Copyright © 2012-2014 Bastian Kleineidam
DOSAGE(1)
[top]
List of man pages available for DragonFly
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
Vote for polarhome
|