| AutoScrapbook-NEW-4.0 |
AutoScrapbook-NEW - index images and films (and more) and create a static site
asb [--[no]options...] dir1 [dir2 dir3 ... dirN]
The following options can be used preceded by two dashes (e.g. --help), 0/1 options can be used with --no (e.g. --nobig), the default values are given here.
'askdirreproc' => 0 # ask (1) or not (0) before reprocessing a dir 'author' => 'Firsty Second' # Your Name 'autorotate' => 0 # try to rotate correctly images and films (EXIF based) 'backup' => 1 # should the original of a file be saved or not 'big' => 1 # copy full-sized picture (1/0) 'comment' => 1 # don't force existence of comment with --nocomment 'config' => 'default' # different configs are possible 'debug' => 0 # debug ON or OFF (1/0) 'delorig' => 0 # when deleting a file, should we delete the original 'display' => 1 # display or not image while modifying it 'email' => 'example@example.net' # Your Email 'exif' => 1 # do we want or not a column with exif information 'exif-thumbs' => 1 # do we use thumbfile in EXIF information? 'force-change' => 0 # force change (same effect as "touch $0"). 'fps' => '24' # wished frames per seconds of film 'help' => 0 # get help 'medium-geometry' => '800x800' # geometry of medium size image 'modify' => 1 # make modification of original picture possible (1/0) 'newdirproc' => 'ask' # process new dirs (yes, no or ask) 'oldmm' => 0 # use old version of MPlayer and MjpegTools 'parent' => 1 # should index.html reference back to parent directory? 'medium-cutoff' => '200', # max. size in KB to create medium image 'skip' => 1 # if unset (--noskip), ignore the skip flag. 'target' => '' # if images and webpages should be copied elsewhere 'thumb-geometry' => '100x100' # geometry of thumbnails 'tvnorm' => '+p' # TV Norm to use (+p for PAL, +n for NTSC)
AutoScrapbook-NEW (short asb) scans directories, looking for images (mostly JPEG but also other types) and films (in MJPEG format). The user can then comment, modify, skip or delete these files. Out of the information gathered, plus EXIF information if available, asb then creates static web pages, with thumbnail overviews, and sub-directories.
Basically, each directory given on the command line is scanned, the user is asked for a name and a description. Then for each file found, the user can give a comment as well, modify the file (depending on the type of the file, things like rotate, edit), delete it or skip it (the file is then ignored). Afterwards, asb creates a thumbnail image for each file and, if the original file is ``too big'', a medium sized file:
Out of all this information, one webpage index.html is created in each
sub-directory, and, per default, linked together.
STRING name of the author--author='First Last'. This information will
be used for the creation of the webpages. See also the email option.
.orig in each sub-directory.
Using --nobackup, the original version is not saved.
--nobig, the original file is neither copied nor linked, as long as a
medium sized file exists; this is very handy for websites.
--nocomment you remove
this obligation (see examples in combination with --nomodify).
STRING configuration name--delorig, you can completely wipe out files, without
any remaining backup. Your choice.
--nodisplay, nothing is shown, which can spare time (especially if
you use a file browser in parallel).
STRING email of the author--email='first@last.org'.
This information will
be used for the creation of the webpages. See also the author option.
--noexif, this column is suppressed.
--noexif-thumb.
INTEGER frames per secondINTEGERxINTEGER geometry of medium sized imageyes|no|ask process new directories or not--noparent this reference is removed.
INTEGER minimum size for medium file creation--noskip, you'll see again all the files and can change
your decision.
DIRECTORY target directory--nobig option, the
original files are also copied to the new directory. Take care that the
end-directory is relative; if you call:
asb --target=/home/user/public_html Images
the end directory will be /home/user/public_html/Images.
INTEGERxINTEGER geometry of thumbfiles+p|+n TV Norm+p for PAL (default) and +n for NTSC.
The simplest command, in order to process the sub-directory pics in the
current directory:
asb
Process the directory Image without EXIF information:
asb --noexif Image
A good one to create a Website (the original pictures are not copied, you can put specific comments and skip private pictures you don't want to publish) is:
asb --config=web --nobig --target=/home/user/public_html Pictures
With the following command, you get a new chance to process formerly skipped files, all index.html files will be recreated, but you will get only the files to modify that do not have yet a comment, everything for the current directory:
asb --noskip --force-change --nomodify .
And using the --nocomment switch, you can recreate the webpages without
being bothered by any question (even if certain files or directories don't
have a comment):
asb --force-change --nomodify --nocomment .
I would recommend to have most of the following commands (together with the variables you might want to modify if your utilities are placed otherwise):
jpeg, or libjpeg or libjpeg-progs
$JPEGTRAN = '/usr/bin/jpegtran';
$RDJPGCOM = '/usr/bin/rdjpgcom';
$EXIF = '/usr/bin/exif';
$EXIFTAGS = '/usr/bin/exiftags';
$JHEAD = '/usr/bin/jhead';
Those commands are slightly less critical than all the other ones. I would still
recommend to have jhead and either exif or exiftags.
ImageMagick package
$MOGRIFY = '/usr/bin/mogrify';
$IDENTIFY = '/usr/bin/identify';
$DISPLAY = '/usr/bin/display';
$CONVERT = '/usr/bin/convert';
$IMAGEEDITOR='/usr/bin/gimp';
But it can be as well any of your favorite image editor.
MPlayer package
$MPLAYER = '/usr/bin/mplayer';
$MENCODER = '/usr/bin/mencoder';
For the SuSE distribution (and perhaps others), the standard package doesn't
fit as it doesn't contain mencoder. Therefore compile yourself your package
or use the package from http://packman.links2linux.de
mjpegtools package
$MP2ENC = '/usr/bin/mp2enc';
$MPEG2ENC = '/usr/bin/mpeg2enc';
$MPLEX = '/usr/bin/mplex';
$JPEG2YUV = '/usr/bin/jpeg2yuv';
$LAVTRANS = '/usr/bin/lavtrans';
$LAVADDWAV = '/usr/bin/lavaddwav';
For the SuSE distribution (and perhaps others), the standard package doesn't fit as it doesn't contain the encoder. Therefore compile yourself your package or use the package from http://packman.links2linux.de.
The man page of mp2enc recommends to use toolame from
http://mikecheng.d2.net.au/ instead, as being of better quality, but I was
to lazy to package and test.
This is AutoScrapbook-NEW 3.9 (2004-11-28) [beta9 of version 4.0]
Eric Lavarde <asb@zorglub.s.bawue.de>
Based on AutoScrapbook 3.7 (Jan 23, 2003), program written by Kirk Bauer <kirk@kaybee.org>
Thanks a lot as well to Ben Edgington for his introduction to ``film-making'' under http://www.edginet.org/techie/linux/canon_movies.html.
It is distributed under the MIT license, which basically says that you can do anything you want with this problem (even commercial activities) for free, as long as you give the authors credit for the program.
This is free software. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
#####################################################################
Copyright (c) 2003 Kirk Bauer
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ``Software''), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED ``AS IS'', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
#####################################################################
For more information, please visit http://linux.kaybee.org/
In each processed directory, the following directory and files are created:
All the commands in the DEPENDENCIES section.
--noparent should only remove the reference from top-directories,
but currently directories and sub-directories are processed the same.
no editor command is defined for films
developer documentation is very sparse
If the exif command is present, thumbnails are not rotated or whatsoever
(because they are extracted directly from the EXIF information).
Often mplayer doesn't get killed properly after display, user needs to
close the window manually.
firstOlderThanLast(file1,file2)ProcessDir(directory)
| AutoScrapbook-NEW-4.0 |