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

The following command should work directly with many versions of Mandriva:

% urpmi http://booh.org/packages/booh-0.9.3-0.1.20060mdk.i586.rpm http://booh.org/packages/libexiv2_2-0.16-2.1.20060mdk.i586.rpm http://distrib-coffee.ipsl.jussieu.fr/pub/linux/MandrivaLinux/official/2007.1/i586/media/main/release/libexpat0-1.95.8-4mdv2007.1.i586.rpm

On 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/lucid/ ./
   deb-src http://booh.org/packages/debian/lucid/ ./
   

   the following versions are available: lucid, karmic, squeeze; just change "lucid" by your version name in the two above lines.
2. issue sudo apt-get update
3. issue sudo apt-get install booh

If your Debian version is not available

Try building from source:

1. Make sure the following line is somewhere in the APT sources:

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

   (issue sudo apt-get update if you modified the APT sources for that)
2. issue sudo apt-get build-dep booh && apt-get --compile source booh
3. install with sudo dpkg -i booh_*.deb if build was successful

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.3.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.17.0 has a serious memory leak and should be avoided; you should absolutely downgrade to 0.16.0 (if you use ruby < 1.8.7) or upgrade to 0.18.1.
  
  
• ruby-gtk2 0.18.0 crashes on missing Gdk::GC; use 0.18.1.
  
  
• 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.18.1.

History

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

• 2010-07-11: 0.9.3: bug fixes and small features
  
  
  • booh-classifier: avoid unneeded memory allocation on loader cancelation, it can grow a lot and slow down a lot after executing, or even lock the machine :/
  • improve videos handling by (optionally) generating .flv flash videos and using Flowplayer to play them embedded; videos are now shown in fullscreen view as well
  • booh: allow to upload (mirror) web-albums with lftp

• 2009-12-08: 0.9.2.2: bug fixes
  
  
  • booh-classifier: do not crash on failed directory reads
  • booh-classifier: use a better mechanism for handling interruption of background loading, should improve performance and workaround too many interruptions witnessed on a Karmic Koala
  • booh: fix some crashes when using option "delete original photos/videos as well"
  • booh-classifier: fix bug leading to never freeing images cache on x86_64 because of strange glibc allocation strategy; make images cache more like a cache (do not free when not necessary)
  • speed up page loading in thumbnails page by using the thumbnails not the fullscreens in the hidden images for facebook and other sharers
  • booh-classifier: prevent from crashing in "execute" step due to using more than 50% of total memory (cannot system() (cannot clone()) if process is > 50%)

• 2009-10-16: 0.9.2.1: bug fixes
  
  
  • do not crash on incorrect filenames in filesystem
  • workaround problem of browser loading all images at once by limiting hidden images for remotes to the first 5 ones
  • make sure LF are properly quoted in fullscreen javascript comments

• 2009-09-10: 0.9.2: bug fixes and small features
  
  
  • more fixes for small bugs and crashes in specific cases
  • booh-classifier: check removal/move permissions as soon as possible to prevent from losing classification on these problems
  • booh: dramatically increase album merging and generation performance
  • booh: add ability to extend an album (e.g. an existing album may become a subalbum of a larger album)
  • [Warly feature] booh-classifier: rework intensive scrolling in items to avoid crashes and improve responsiveness
  • [Warly feature] booh: use captions for alt= text of images to improve search engines results accuracy
  • [Lucas feature] booh: properly kill background "find" in new album dialog when needed
  • include the AddThis bookmarking and sharing button

• 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-classifier, 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 crashes 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 crashes 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 crashes 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 crashes (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

Sun Jul 11 15:17:44 2010