Booh

[ home | example web-album | video demo | tutorial | advanced | discuss | download ]

Booh is free software released under the GPLv2 licence; it was designed for Linux.

Download Booh

On Mandriva

If you run a recent Mandriva (2008.0 or more recent), the following command should work directly:

% urpmi http://booh.org/packages/booh-0.9.1-0.1.20060mdk.i586.rpm ftp://ftp.free.fr/pub/Distributions_Linux/MandrivaLinux/official/2007.1/i586/media/main/release/libexpat0-1.95.8-4mdv2007.1.i586.rpm

For Mandriva 2006 to 2007.1, try:

% urpmi http://booh.org/packages/booh-0.9.1-0.1.20060mdk.i586.rpm http://booh.org/packages/libexiv2_2-0.16-2.1.20060mdk.i586.rpm

On Debian/Ubuntu

Debian/Ubuntu packages thanks to Odie:

1. put a booh.list file in /etc/apt/sources.list.d with content:

   deb http://booh.org/packages/debian/hardy/ ./
   deb-src http://booh.org/packages/debian/hardy/ ./
   

   the following versions are supported: gutsy, feisty, hardy, and etch; just change "hardy" by your version in the two above lines.
2. issue sudo apt-get update
3. issue sudo apt-get install booh

On Gentoo

If you run gentoo, there's an ebuild in portage (for x86 and ppc only) thanks to Dams, so just try emerge booh.

Source Code

To use sourcecode directly, first you need to know that Booh needs ruby, ruby-gettext >= 0.8.0, ruby-gtk2 >= 0.12 and gtk2 >= 2.8.

Stable

Download latest stable version's sourcecode here: booh-0.9.1.tar.bz2 sig.

Find trust paths to me. Download my public key.

Development

You can check out the latest development status with the command: git clone git://git.zarb.org/booh
You may also browse using gitweb.

Compatibility warnings

• ruby-gtk2 0.15.0 triggers crashes and should be avoided; there is no patch (patched ruby-gtk2 in distros don't include a patch for these crashes, as far as I know), you should absolutely downgrade to 0.14.1 or upgrade to 0.16.0 (or Booh will randomly crash).
  
  
• using ruby >= 1.8.7 with ruby-gtk2 < 0.17.0 triggers random crashes (with message "[BUG] object allocation during garbage collection phase" on the console), you should absolutely downgrade to ruby <= 1.8.6 or upgrade to ruby-gtk2 >= 0.17.0 (or Booh will randomly crash).

History

Noticeable changes in each release (check ChangeLog in source for details):

• 2008-06-20: 0.9.1: bug fixes
  
  
  • work properly with ruby-1.8.7 (tempfile library behaviour changed)
  • fix "original size" broken while generating web-album
  • other various small fixes

• 2008-05-26: 0.9.0: booh-classifier and a few other nice features
  
  
  • add a new tool, booh-classifer, dedicated to classify photos and videos prior to using main booh for web-album creation
  • for videos thumbnailing, use mplayer instead of transcode, it seems faster (when seeking) and more reliable (transcode often generates a green fake picture instead of a proper thumbnail)
  • don't produce broken javascript when original size is selected
  • Esperanto language added
  • allow simple and double quotes in made-with and index links
  • use exiv2 for getting the EXIF orientation tag, it is so much faster than identify; on a typical booh-backend usecase, 20% performance improvement is expected; also use it for sorting on EXIF dates
  • workaround the crash when undoing a picture/video removal
  • in web-albums, preloading images should be faster (better use of available bandwidth)
  • themes may share javascript and CSS between all pages, to save bandwidth, thanks to Jean-Michel Schelcher
  • use exiv2 to save EXIF orientation tag when rotating images in booh-classifier and in Booh (it's particularly useful when using booh-classifier then booh)
  • potentially fix remaining rare aborts triggered in REXML (by synchronizing modifications of the XML document from other Threads)
  • new converter from Marginal Hacks Album contributed by Stéphane Fillod
  • as we are already at 4 breakages due to REXML problems, and the 4th one is worse because we are now facing slight behavioral changes between Ruby subsubreleases, internalize a working version of REXML in order to forget about it
  • [Fif feature] multi-languages support for web-album navigation, using Apache MultiViews
  • optionally transcode videos - potentially saves a lot of disk space, as videos created by digital cameras are not well compressed
  • new DarkSlateGray-powered theme: "cardu"

• 2006-05-01: 0.8.6:
  
  
  • [Till feature] add ability to split thumbnails on several pages
  • [Pixel feature] be fully compatible with browsers with no javascript support
  • generate a .htaccess file specifying the UTF-8 charset to try to workaround badly configured apache servers
  • [Benny feature] we can choose the best images size automatically with the browser window size instead of using the default (medium) size
  • change CSS code so that image border color should now work in MSIE as well
  • [RGS feature] don't do javascript key shortcuts when modifiers are pressed (control, alt, shift); this should avoid overriding usual keyboard shortcuts to move back and forth in history
  • [Coni feature] add gamma correction
  • [Coni feature] allow to have a link in pages to return back to user's homepage
  • [GUI] allow to edit images externally with gimp
  • [Fif "feature"] hopefully fix remaining potential aborts due to missing/wrong thread synchronization
  • [Guillomovitch feature] allow to specify an arbitrary format for comments of new images - including EXIF stuff
  • [Milka feature] correct "blinking" of background in "dark" theme by fixing its position
  • Dramatically improve HTML generating speed: on a p4 2.8GHz, regenerating a typical album for a small comments change goes down from 28.5 secs to 5.0 secs

  Warnings applicable to 0.8.6 and older:

  • Ruby 1.8.4 has a severe bug (actually, the REXML library shipped with Ruby): accented characters in comments will get trashed when saving your album; try ruby-rexml-sanity-check.rb to see if you're affected; if you're affected, you may have a look at the message on the list with a patch
  • Ruby 1.8.6 has a severe bug (actually, the REXML library shipped with Ruby): XML special characters in comments will get trashed when saving your album; try ruby-rexml-sanity-check.rb to see if you're affected; if you're affected, you may have a look at the message on the list with a patch
  • In Ruby 1.8.6, there is a change in the XML parser strictness, which will cause aborts on Booh; you may have a look at the message on the list with a patch
  • Ruby 1.8.6-p111 has a severe bug in the REXML library, don't use this version. You're at risk to crashing Booh or trashing some of your content.

• 2005-12-29: 0.8.5:
  
  
  • [GUI] allow to remove a subalbum directly in the treeview
  • [GUI] add ability to restore deleted images/videos/subalbums
  • [GUI] allow to sort pictures by EXIF date
  • [GUI] yet another small bugfix probably triggered by using gtk+-2.8.9 which prevented Booh from showing the album after merging
  • [GUI] allow to move subalbums directly to the top or bottom

• 2005-12-14: 0.8.4.1:
  
  
  • [GUI] fix a small bug probably triggered by using gtk+-2.8.9 which prevents Booh from starting up :/

• 2005-12-01: 0.8.4:
  
  
  • better support for panoramas in thumbnails page
  • add password protection feature
  • [plouf and milka feature] add possibility to display "made with" markup at the bottom of pages
  • [warly feature] try to use hard links when creating an album including "original" size of images, or videos, to save diskspace
  • add ability to display EXIF data
  • become fully transitional xhtml compliant
  • add sbs theme by Erik Ramseth

• 2005-09-27: 0.8.3:
  
  
  • [GUI] fix invasive automatic scrolling when clicking in menu
  • fix some broken XPath's to work correctly with ruby 1.8.3
  • [guillomovitch feature] allow that deletion also deletes orig files (through an option in preferences)
  • check config at bootup; report missing video viewer, browser, identify, mencoder/transcode
  • support no identify and no transcode/mencoder
  • don't use "identify" anymore to decide if target size is really smaller than current size, speeds up a bit thumbnails generation
  • [guillomovitch feature] use identify to discover EXIF orientation rather than exif external binary
  • [guillomovitch feature] [GUI] have "view" of images/videos available in popup menu as well
  • [GUI] use standard gtk AboutDialog
  • [mathieu blondel feature] [GUI] add a clickable URL to view the webalbum in the dialog for successful webalbum generation
  • [GUI] allow to view the webalbum with browser from the menu as well
  • fix slideshow pause bug when entering directly in slideshow mode from thumbnails page (was always using default of 3 seconds)
  • add "merge new subalbums down this subalbum"
  • add german translation thanks to Roland Eckert

• 2005-08-14: 0.8.2:
  
  
  • various fixes

• 2005-08-02: 0.8.1:
  
  
  • various small fixes

• 2005-07-30: 0.8.0:
  
  
  • fix the bookmarks and browser back/forward problems by using an hash instead of a pseudo GET parameter
  • GUI: don't save the master file in the back of the user when generating an album
  • GUI: workaround aborts (by always invoking gtk from the main ruby thread)
  • GUI: allow to select multiple images/videos by click-dragging a rectangle around theme
  • GUI: autoscroll in drag-n-drop and in click-dragging the selection rectangle
  • allow to choose the number of thumbnails per row (hence their size)
  • add a new theme: "dark"

• 2005-06-18: 0.7.1:
  
  
  • fixes: crash when generating an album with only videos in subalbums; bug of trying to remove directories when cleaning up; two other minor bugs

• 2005-06-17: 0.7.0:
  
  
  • GUI: add "remove all captions"
  • Add japanese translation thanks to Masao Mutoh
  • Remember deleted elements in config file, so that merging doesn't bring them back
  • GUI: add mouse gestures: move to bottom for delete, left->right button for undo, right->left button for redo; ctrl-z for undo, ctrl-r for redo
  • GUI: add various helps as dialogs and tooltips
  • GUI: add parameters to disallow mouse gestures, and prefer empty comments in new albums
  • GUI: when opening an album, display amount of images, videos and sub-albums in statusbar
  • script: cleanup old images/videos in destination directory, for when removing elements or sizes
  • GUI: much faster opening of large albums thanks to dropping the use of XPath

• 2005-05-23: 0.6.0:
  
  
  • bugfix thumbnails wrongly generated at full original size
  • [milka feature] add a "previous album" and "next album" link in each thumbnails and image page
  • [dams feature] add the ability to fix the white-balance
  • [milka feature] GUI: let merge new/removed images/videos only in one specified directory (in current directory of the gui) for speedup
  • [dams feature] GUI: add progressbars when merging and generating album
  • GUI: allow to change thumbnails and subalbums position in the popup menu (move left, right, up, down)
  • [milka feature] GUI: allow to remove an image from its fullsize view (useful when comparing two fullsizes to choose which one you want to keep)
  • [milka feature] GUI: optimize a lot album generation by not regenerating subalbums already previously generated

• 2005-05-08: 0.5.2:
  
  
  • don't resize images when image is already smaller than target dimenstions
  • allow to merge only new subalbums (very useful if you add a new subalbum and don't want the automatic merge back in of images you have remove in other subalbums)
  • correctly handle completely removed subalbums (when last image/video is removed)

• 2005-05-08: 0.5.1:
  
  
  • [dams feature] ignore hidden directories
  • [dams feature] rename booh to booh-backend and booh-gui to booh
  • [milka feature] put list of subalbums in a scrolled window to not force too high window
  • [neuneux features] expand relative paths, be robust when trying to open a jpeg file (instead of an xml albums file)
  • GUI: don't waste time saving album data if there was no modification
  • GUI: add horizontal scrolling capability to sub-albums page to not force too wide window
  • GUI: autoscroll thumbnails when textview or image is not visible

• 2005-05-07: 0.5.0:
  
  
  • GUI: remember preferred image size of user with a cookie
  • provide a converter to use comments entered for Denis Havlik's WebAlbum.pl
  • [amaury feature] when returning from image to thumbnails, use an anchor to go to the correct vertical position in the page
  • GUI: when creating an album, immediately show the number of images/videos down selected source directory
  • make different sizes of images in themes selectable, not all used by default
  • GUI: [dams feature] add ability to handle a link to original image
  • GUI: [amaury feature] if shift or control is pressed, one-click rotation tool rotates the other way round
  • GUI: add a properties page showing the album properties and allowing theme and sizes modifications
  • GUI: add the ability to merge new/removed images/videos to an existing album
  • Verdana sucks, don't use it in default theme anymore
  • allow to specify the pause in slideshows
  • add key shortcuts support in web-album, inspired by Album Shaper

• 2005-04-17: 0.4.0:
  
  
  • GUI: undo/redo support
  • add "image enhance" support
  • GUI: add the ability to specify the frame-offset of the thumbnail of videos
  • script: add the ability to generate only what's needed to fire up the GUI
  • GUI: add "new", "save" and "save as" features
  • GUI: add the ability to specify preferences
  • GUI: add the ability to generate the web-album

• 2005-04-09: 0.3.0:
  
  
  • GUI: add the ability to edit sub-albums pages, not only thumbnails pages
  • GUI: add a shortcut for recently opened files
  • GUI: add a popup menu when right-clicking on images
  • GUI: generate thumbnails and fullscreens when missing (no need to rerun script after rotating images)
  • script: add color-swap property for videos (use -k of transcode)
  • script: add properties (rotation etc) for sub-albums thumbnails
  • script: don't automatically rotate a theoretically unrotated portrait image, if image is obviously already in portrait (situation can come from images already rotated with gthumb)

• 2005-04-01: 0.2.0:
  
  
  • GUI: add a toolbar
  • GUI: add rotation support, either with mouse gesture or one-click tools

• 2005-03-28: 0.1.0:
  
  
  • first release

Fri Jun 20 17:24:40 2008