booh-backend

Langue: en

Version: June 2005 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

NAME

booh-backend - backend script of booh, the static web-album generator

SYNOPSIS

booh [OPTION]...

DESCRIPTION

Booh is a static Web-Album generator. It's a program whichl takes one or several series of photos and videos, and automatically build static web pages to browse them, creating thumbnails etc.

If you invoke booh-backend from the command-line, this will launch the backend script allowing creating/generating an album. Contrast with booh, which is the graphical user interface over the backend, the easiest way to create an album.

OPTIONS

-h, --help
Get help message
-V, --version
Print version and exit
-n, --no-check
Don't check for needed external programs at startup
-s DIR, --source DIR
Directory which contains original images/videos as files or subdirs
-d DIR, --destination DIR
Directory which will contain the web-album
-t THEME, --theme THEME
Select HTML theme to use
-C FILE, --config FILE
File containing config listing images and videos within directories with captions
-k FILE, --config-skel FILE
Filename where the script will output a config skeleton
-M FILE, --merge-config FILE
File containing config listing, where to merge new images/videos from --source, and change theme info
-O FILE, --merge-config-onedir FILE
File containing config listing, for merging the subdir specified with --dir
-D DIR, --dir DIR
Directory for merge with --merge-config-onedir
-u FILE, --use-config FILE
File containing config listing, where to change theme info
-f, --force
Force generation of album even if the GUI marked some directories as already generated
-S SIZELIST, --sizes SIZELIST
Specify the list of images sizes to use instead of all specified in the theme (this is a comma-separated list)
-e, --empty-comments
Prefer empty comments over filename when creating new albums
-m NUM, --mproc NUM
Specify the number of processors for multi-processors machines
-g, --for-gui
Do the minimum work to be able to see the album under the GUI (don't generate all thumbnails)
-v NUM, --verbose-level NUM
Set max verbosity level (0: errors, 1: warnings, 2: important messages, 3: other messages)
-i PIPE, --info-pipe PIPE
Name a file where to write information about what's going on (used by the GUI to update waiting messages etc)

EXAMPLES

Simply generate a web-album out of photos in /tmp/Albums, to the directory /tmp/booh-try:

# booh-backend --source /tmp/Albums --destination /tmp/booh-try

The same, but also save the XML "config" file which will contain the list of images/videos and options for them:

# booh-backend --source /tmp/Albums --destination /tmp/booh-try --config-skel /tmp/myconf.xml

If you want to manually change things in the XML "config" file (the GUI is best suited for that, but who knows), then you can regenerate the updated web-album with:

# booh-backend --config /tmp/myconf.xml

If you add/remove images/videos or even whole subdirectories in the source tree /tmp/Albums, you can ask booh to merge differences (and regenerate the config file and the web-album) with:

# booh-backend --merge-config /tmp/myconf.xml

AUTHOR

Written by Guillaume Cottenceau.
Visit official homepage: http://booh.org/

SEE ALSO

booh-backend(1) Copyright © 2005 Guillaume Cottenceau.
This is Free Software; this software is licensed under the GPL version 2, as published by the Free Software Foundation. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.