1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml">
5 <title>Booh - The Web-Album of choice for discriminating Linux users</title>
6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
7 <meta name="viewport" content="width=device-width"/>
8 <style type="text/css">
10 font-family: Verdana, Arial, Helvetica, sans-serif, monospace;
13 pre { background-color: #e0e0e0; }
14 tt { background-color: #e0e0e0; }
15 @media all and (orientation: landscape) {
24 <body bgcolor="#FFFFFF" text="#000000" link="#0000ee" vlink="#551a8b">
26 <table width="100%" cellspacing="0" cellpadding="0">
28 <td width="25%" align="left" valign="top">
29 <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="http://booh.org/"></a>
31 <td width="50%" align="center">
32 <img src="images/logo.png" alt="booh logo"/>
34 <td width="25%" align="right" valign="top">
35 <div style="display:inline-block; margin-bottom:0.2em"><img src="images/en.png" alt="this page is in english"/></div>
36 <div style="display:inline-block"><a href="download.fr.html"><img src="images/fr.png" alt="cette page en français"/></a></div>
41 <h1 align="center">Booh</h1>
43 <p align="center">[ <a href="index.html">home</a> |
44 <a href="themes/gradient/">example web-album</a> |
45 <a href="video-demo.html">video demo</a> |
46 <a href="tutorial.html">tutorial</a> |
47 <a href="advanced.html">advanced</a> |
48 <a href="discuss.html">discuss</a> |
52 Booh is <a href="http://www.fsf.org/licensing/essays/free-sw.html">free software</a>
53 released under the GPLv2 licence; it was designed for Linux.
56 <h2>Download Booh</h2>
58 <h3><i>On Ubuntu</i><sup>*</sup></h3>
61 <li><tt>sudo add-apt-repository ppa:booh/ppa</tt></li>
62 <li><tt>sudo apt-get update</tt></li>
63 <li><tt>sudo apt-get install booh</tt></li>
67 <h3><i>On Debian</i><sup>*</sup></h3>
70 <li>put a <tt>booh.list</tt> file in <tt>/etc/apt/sources.list.d</tt> with content:
72 deb http://booh.org/packages/debian/YOUR_DEBIAN_VERSION_HERE/ ./
74 the following debian versions are available: squeeze, lenny.
77 <li>issue <tt>sudo apt-get update</tt></li>
79 <li>issue <tt>sudo apt-get install booh</tt></li>
83 <h4>If your Debian/Ubuntu version is not available, try building:</h4>
86 <li>Put a <tt>booh.list</tt> file in <tt>/etc/apt/sources.list.d</tt> with content:
88 deb http://ppa.launchpad.net/booh/ppa/ubuntu saucy main
89 deb-src http://ppa.launchpad.net/booh/ppa/ubuntu saucy main
91 then issue <tt>sudo apt-get update</tt>.
94 <li>issue <tt>sudo apt-get build-dep booh && apt-get --compile source booh</tt></li>
96 <li>install with <tt>sudo dpkg -i booh_*.deb</tt> if build was successful</li>
99 <p><em><font size="-1"><sup>*</sup>packages thanks to Benny and Odie.</font></em></p>
101 <h3><i>On Mageia/Mandriva</i></h3>
104 <li>Mageia 3: <tt>urpmi http://booh.org/packages/booh-0.9.4-1.mga3.x86_64.rpm</tt></li>
105 <li>Mageia 2: <tt>urpmi http://booh.org/packages/booh-0.9.4-1.mga2.x86_64.rpm</tt></li>
106 <li>Mandriva 2010.2: <tt>urpmi http://booh.org/packages/booh-0.9.4-1mdv2010.2.x86_64.rpm</tt></li>
108 If you need the source RPM for rebuilding on a different
109 version/architecture or RPM-based
111 <a href="packages/booh-0.9.4-1.mga3.src.rpm">booh-0.9.4-1.mga3.src.rpm</a> /
112 <a href="packages/booh-0.9.4-1.mga2.src.rpm">booh-0.9.4-1.mga2.src.rpm</a> /
113 <a href="packages/booh-0.9.4-1mdv2010.2.src.rpm">booh-0.9.4-1mdv2010.2.src.rpm</a>.
116 <h3><i>Source Code</i></h3>
119 To use sourcecode directly, first you need to know that Booh
120 needs <b>ruby (compatible with ruby 1.8 and ruby 1.9), ruby-gettext >= 0.8.0</b>,
121 <b>ruby-gtk2 >= 0.12</b> and <b>gtk2 >= 2.8</b>.
124 <h4><i>Stable</i></h4>
127 Download latest stable version's sourcecode
128 here: <a href="packages/booh-0.9.4.tar.bz2">booh-0.9.4.tar.bz2</a> <font size="-1"><a href="packages/booh-0.9.4.tar.bz2.sig">sig</a></font>.
132 <a href="http://zarb.org/~gc/html/pgppathfinder.html">Find trust paths to me</a>. <a href="http://wwwkeys.ch.pgp.net:11371/pks/lookup?op=get&search=0x0B56D613">Download my public key</a>.
135 <h4><i>Development</i></h4>
138 You can check out the latest development status with the command: <tt>git clone git://git.zarb.org/booh</tt>
140 You may also browse using <a href="http://git.zarb.org/cgi-bin/gitweb.cgi?p=booh;a=summary">gitweb</a>.
146 <p>Noticeable changes in each release (check <tt>ChangeLog</tt> in source for details):</p>
149 <li><u>2013-11-02: <b>0.9.4</b>:</u> <i>bug fixes and small features</i>
153 <li>new theme <a href="http://booh.org/themes/gradient/">"gradient"</a></li>
154 <li>properly work with Ruby 1.9</li>
155 <li>much faster whitebalance and gammacorrect filters</li>
156 <li>add <em>widescreen (1680x1050)</em> and <em>full-hd (1920x1080)</em> target screen sizes</li>
162 <li><u>2010-07-11: <b>0.9.3</b>:</u> <i>bug fixes and small features</i>
166 <li>booh-classifier: avoid unneeded memory
167 allocation on loader cancelation, it can grow a
168 lot and slow down a lot after executing, or even
169 lock the machine :/</li>
170 <li>improve videos handling by (optionally)
171 generating .flv flash videos and using
172 <a href="http://www.flowplayer.org/">Flowplayer</a>
173 to play them embedded; videos are now shown
174 in fullscreen view as well</li>
175 <li>booh: allow to upload (mirror) web-albums with
176 <a href="http://lftp.yar.ru/">lftp</a></li>
182 <li><u>2009-12-08: <b>0.9.2.2</b>:</u> <i>bug fixes</i>
186 <li>booh-classifier: do not crash on failed directory reads</li>
187 <li>booh-classifier: use a better mechanism for handling
188 interruption of background loading, should improve performance
189 and workaround too many interruptions witnessed on a Karmic Koala</li>
190 <li>booh: fix some crashes when using option
191 "delete original photos/videos as well" </li>
192 <li>booh-classifier: fix bug leading to never freeing
193 images cache on x86_64 because of strange glibc
194 allocation strategy; make images cache more like a
195 cache (do not free when not necessary)</li>
196 <li>speed up page loading in thumbnails page by
197 using the thumbnails not the fullscreens in the hidden
198 images for facebook and other sharers</li>
199 <li>booh-classifier: prevent from crashing in "execute"
200 step due to using more than 50% of total memory
201 (cannot system() (cannot clone()) if process is >
208 <li><u>2009-10-16: <b>0.9.2.1</b>:</u> <i>bug fixes</i>
212 <li>do not crash on incorrect filenames in filesystem</li>
213 <li>workaround problem of browser loading all images at
214 once by limiting hidden images for remotes to the first
216 <li>make sure LF are properly quoted in fullscreen
217 javascript comments</li>
223 <li><u>2009-09-10: <b>0.9.2</b>:</u> <i>bug fixes and small features</i>
227 <li>more fixes for small bugs and crashes in specific cases</li>
228 <li>booh-classifier: check removal/move
229 permissions as soon as possible to prevent from
230 losing classification on these problems</li>
231 <li>booh: dramatically increase album merging and generation performance</li>
232 <li>booh: add ability to <i>extend</i> an album
233 (e.g. an existing album may become a subalbum of a
235 <li>[Warly feature] booh-classifier: rework intensive scrolling in items
236 to avoid crashes and improve responsiveness</li>
237 <li>[Warly feature] booh: use captions for alt= text of images to
238 improve search engines results accuracy</li>
239 <li>[Lucas feature] booh: properly kill background "find" in new album
240 dialog when needed</li>
241 <li>include the <a href="http://www.addthis.com">AddThis</a> bookmarking and sharing button</li>
247 <li><u>2008-06-20: <b>0.9.1</b>:</u> <i>bug fixes</i>
251 <li>work properly with ruby-1.8.7 (tempfile library behaviour changed)</li>
252 <li>fix "original size" broken while generating web-album</li>
253 <li>other various small fixes</li>
259 <li><u>2008-05-26: <b>0.9.0</b>:</u> <i>booh-classifier and a few other nice features</i>
263 <li>add a new tool, <i>booh-classifier</i>, dedicated to classify photos and videos prior to using main <i>booh</i> for web-album creation</li>
264 <li>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)</li>
265 <li>don't produce broken javascript when original size is selected</li>
266 <li>Esperanto language added</li>
267 <li>allow simple and double quotes in made-with and index links</li>
268 <li>use exiv2 for getting the EXIF orientation tag, it is so much faster than identify; on a typical <i>booh-backend</i> usecase, 20% performance improvement is expected; also use it for sorting on EXIF dates</li>
269 <li>workaround the crash when undoing a picture/video removal</li>
270 <li>in web-albums, preloading images should be faster (better use of available bandwidth)</li>
271 <li>themes may share javascript and CSS between all pages, to save bandwidth, thanks to Jean-Michel Schelcher</li>
272 <li>use exiv2 to save EXIF orientation tag when rotating images in booh-classifier and in Booh (it's particularly useful when using <tt>booh-classifier</tt> then <tt>booh</tt>)</li>
273 <li>potentially fix remaining rare crashes triggered in REXML (by synchronizing modifications of the XML document from other Threads)</li>
274 <li>new converter from <a href="http://marginalhacks.com/Hacks/album/">Marginal Hacks Album</a> contributed by Stéphane Fillod</li>
275 <li>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</li>
276 <li>[Fif feature] multi-languages support for web-album navigation, using Apache <a href="http://httpd.apache.org/docs/2.2/content-negotiation.html#multiviews">MultiViews</a></li>
277 <li>optionally transcode videos - potentially saves a lot of disk space, as videos created by digital cameras are not well compressed</li>
278 <li>new DarkSlateGray-powered theme: <a href="http://booh.org/themes/cardu/">"cardu"</a></li>
284 <li><u>2006-05-01: <b>0.8.6</b>:</u>
288 <li>[Till feature] add ability to split thumbnails on several pages</li>
289 <li>[Pixel feature] be fully compatible with browsers with no javascript support</li>
290 <li>generate a .htaccess file specifying the UTF-8 charset to try to workaround badly configured apache servers</li>
291 <li>[Benny feature] we can choose the best images size automatically with the browser window size instead of using the default (medium) size</li>
292 <li>change CSS code so that image border color should now work in MSIE as well</li>
293 <li>[RGS feature] don't do javascript key shortcuts when modifiers are pressed (control, alt, shift);
294 this should avoid overriding usual keyboard shortcuts to move back and forth in history</li>
295 <li>[Coni feature] add gamma correction</li>
296 <li>[Coni feature] allow to have a link in pages to return back to user's homepage</li>
297 <li>[GUI] allow to edit images externally with gimp</li>
298 <li>[Fif "feature"] hopefully fix remaining potential crashes due to missing/wrong thread synchronization</li>
299 <li>[Guillomovitch feature] allow to specify an arbitrary format for comments of new images - including EXIF stuff</li>
300 <li>[Milka feature] correct "blinking" of background in "dark" theme by fixing its position</li>
301 <li>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</li>
304 <h4><font color="red"><b>Warnings applicable to 0.8.6 and older:</b></font></h3>
307 <li>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;
308 try <a href="http://zarb.org/~gc/t/ruby-rexml-sanity-check.rb">ruby-rexml-sanity-check.rb to see
309 if you're affected</a>; if you're affected, you may have a look at the
310 <a href="https://www.zarb.org/pipermail/booh-discuss/2006-July/000175.html">message on the list with a patch</a></li>
312 <li>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;
313 try <a href="http://zarb.org/~gc/t/ruby-rexml-sanity-check.rb">ruby-rexml-sanity-check.rb to see
314 if you're affected</a>; if you're affected, you may have a look at the
315 <a href="https://www.zarb.org/pipermail/booh-discuss/2007-June/000199.html">message on the list with a patch</a></li>
316 <li>In Ruby 1.8.6, there is a change in the XML parser strictness, which will cause crashes on Booh;
317 you may have a look at the
318 <a href="https://www.zarb.org/pipermail/booh-discuss/2007-June/000203.html">message on the list with a patch</a></li>
320 <li>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.</li>
327 <li><u>2005-12-29: <b>0.8.5</b>:</u>
331 <li>[GUI] allow to remove a subalbum directly in the treeview</li>
332 <li>[GUI] add ability to restore deleted images/videos/subalbums</li>
333 <li>[GUI] allow to sort pictures by EXIF date</li>
334 <li>[GUI] yet another small bugfix probably triggered by using gtk+-2.8.9 which prevented Booh from showing the album after merging</li>
335 <li>[GUI] allow to move subalbums directly to the top or bottom</li>
341 <li><u>2005-12-14: <b>0.8.4.1</b>:</u>
345 <li>[GUI] fix a small bug probably triggered by using gtk+-2.8.9 which prevents Booh from starting up :/</li>
351 <li><u>2005-12-01: <b>0.8.4</b>:</u>
355 <li>better support for panoramas in <a href="themes/gradient/Home/thumbnails-large-0.html#pano-960x528.jpg">thumbnails page</a></li>
356 <li>add <a href="tutorial.html#passwordprotection">password protection</a> feature</li>
357 <li>[plouf and milka feature] add possibility to display "made with" markup at the bottom of pages</li>
358 <li>[warly feature] try to use hard links when creating an album including "original" size of images, or videos, to save diskspace</li>
359 <li>add ability to display EXIF data</li>
360 <li>become fully transitional xhtml compliant</li>
361 <li>add sbs theme by Erik Ramseth</li>
367 <li><u>2005-09-27: <b>0.8.3</b>:</u>
371 <li>[GUI] fix invasive automatic scrolling when clicking in menu</li>
372 <li>fix some broken XPath's to work correctly with ruby 1.8.3</li>
373 <li>[guillomovitch feature] allow that deletion also deletes orig files (through an option in preferences)</li>
374 <li>check config at bootup; report missing video viewer, browser, identify, mencoder/transcode</li>
375 <li>support no identify and no transcode/mencoder</li>
376 <li>don't use "identify" anymore to decide if target size is really smaller than current size, speeds up a bit thumbnails generation</li>
377 <li>[guillomovitch feature] use identify to discover EXIF orientation rather than exif external binary</li>
378 <li>[guillomovitch feature] [GUI] have "view" of images/videos available in popup menu as well</li>
379 <li>[GUI] use standard gtk AboutDialog</li>
380 <li>[mathieu blondel feature] [GUI] add a clickable URL to view the webalbum in the dialog for successful webalbum generation</li>
381 <li>[GUI] allow to view the webalbum with browser from the menu as well</li>
382 <li>fix slideshow pause bug when entering directly in slideshow mode from thumbnails page (was always using default of 3 seconds)</li>
383 <li>add "merge new subalbums down this subalbum"</li>
384 <li>add german translation thanks to Roland Eckert</li>
390 <li><u>2005-08-14: <b>0.8.2</b>:</u>
394 <li>various fixes</li>
400 <li><u>2005-08-02: <b>0.8.1</b>:</u>
404 <li>various small fixes</li>
411 <li><u>2005-07-30: <b>0.8.0</b>:</u>
415 <li>fix the bookmarks and browser back/forward problems by using an hash instead of a pseudo GET parameter</li>
416 <li>GUI: don't save the master file in the back of the user when generating an album</li>
417 <li>GUI: workaround crashes (by always invoking gtk from the main ruby thread)</li>
418 <li>GUI: allow to select multiple images/videos by click-dragging a rectangle around theme</li>
419 <li>GUI: autoscroll in drag-n-drop and in click-dragging the selection rectangle</li>
420 <li>allow to choose the number of thumbnails per row (hence their size)</li>
421 <li>add a new theme: "dark"</li>
427 <li><u>2005-06-18: <b>0.7.1</b>:</u>
431 <li>fixes: crash when generating an album with only videos in subalbums; bug of trying to remove directories when cleaning up; two other minor bugs</li>
437 <li><u>2005-06-17: <b>0.7.0</b>:</u>
441 <li>GUI: add "remove all captions"</li>
442 <li>Add japanese translation thanks to Masao Mutoh</li>
443 <li>Remember deleted elements in config file, so that merging doesn't bring them back</li>
444 <li>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</li>
445 <li>GUI: add various helps as dialogs and tooltips</li>
446 <li>GUI: add parameters to disallow mouse gestures, and prefer empty comments in new albums</li>
447 <li>GUI: when opening an album, display amount of images, videos and sub-albums in statusbar</li>
448 <li>script: cleanup old images/videos in destination directory, for when removing elements or sizes</li>
449 <li>GUI: much faster opening of large albums thanks to dropping the use of XPath</li>
455 <li><u>2005-05-23: <b>0.6.0</b>:</u>
459 <li>bugfix thumbnails wrongly generated at full original size</li>
460 <li>[milka feature] add a "previous album" and "next album" link in each thumbnails and image page</li>
461 <li>[dams feature] add the ability to fix the white-balance</li>
462 <li>[milka feature] GUI: let merge new/removed images/videos only in one specified directory (in current directory of the gui) for speedup</li>
463 <li>[dams feature] GUI: add progressbars when merging and generating album</li>
464 <li>GUI: allow to change thumbnails and subalbums position in the popup menu (move left, right, up, down)</li>
465 <li>[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)</li>
466 <li>[milka feature] GUI: optimize a lot album generation by not regenerating subalbums already previously generated</li>
472 <li><u>2005-05-08: <b>0.5.2</b>:</u>
476 <li>don't resize images when image is already smaller than target dimenstions</li>
477 <li>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)</li>
478 <li>correctly handle completely removed subalbums (when last image/video is removed)</li>
484 <li><u>2005-05-08: <b>0.5.1</b>:</u>
488 <li>[dams feature] ignore hidden directories</li>
489 <li>[dams feature] rename <tt>booh</tt> to <tt>booh-backend</tt> and <tt>booh-gui</tt> to <tt>booh</tt></li>
490 <li>[milka feature] put list of subalbums in a scrolled window to not force too high window</li>
491 <li>[neuneux features] expand relative paths, be robust when trying to open a jpeg file (instead of an xml albums file)</li>
492 <li>GUI: don't waste time saving album data if there was no modification</li>
493 <li>GUI: add horizontal scrolling capability to sub-albums page to not force too wide window</li>
494 <li>GUI: autoscroll thumbnails when textview or image is not visible</li>
500 <li><u>2005-05-07: <b>0.5.0</b>:</u>
504 <li>GUI: remember preferred image size of user with a cookie</li>
505 <li>provide a converter to use comments entered for <a href="http://ftp.cdut.edu.cn/pub/linux/network/utils/WebAlbum/WebAlbum.pl">Denis Havlik's WebAlbum.pl</a></li>
506 <li>[amaury feature] when returning from image to thumbnails, use an anchor to go to the correct vertical position in the page</li>
507 <li>GUI: when creating an album, immediately show the number of images/videos down selected source directory</li>
508 <li>make different sizes of images in themes selectable, not all used by default</li>
509 <li>GUI: [dams feature] add ability to handle a link to original image</li>
510 <li>GUI: [amaury feature] if shift or control is pressed, one-click rotation tool rotates the other way round</li>
511 <li>GUI: add a properties page showing the album properties and allowing theme and sizes modifications</li>
512 <li>GUI: add the ability to merge new/removed images/videos to an existing album</li>
513 <li><a href="http://www.xs4all.nl/~sbpoley/webmatters/verdana.html">Verdana sucks</a>, don't use it in default theme anymore</li>
514 <li>allow to specify the pause in slideshows</li>
515 <li>add key shortcuts support in web-album, inspired by Album Shaper</li>
521 <li><u>2005-04-17: <b>0.4.0</b>:</u>
525 <li>GUI: undo/redo support</li>
526 <li>add "image enhance" support</li>
527 <li>GUI: add the ability to specify the frame-offset of the thumbnail of videos</li>
528 <li>script: add the ability to generate only what's needed to fire up the GUI</li>
529 <li>GUI: add "new", "save" and "save as" features</li>
530 <li>GUI: add the ability to specify preferences</li>
531 <li>GUI: add the ability to generate the web-album</li>
537 <li><u>2005-04-09: <b>0.3.0</b>:</u>
541 <li>GUI: add the ability to edit sub-albums pages, not only thumbnails pages</li>
542 <li>GUI: add a shortcut for recently opened files</li>
543 <li>GUI: add a popup menu when right-clicking on images</li>
544 <li>GUI: generate thumbnails and fullscreens when missing (no need to rerun script after rotating images)</li>
545 <li>script: add color-swap property for videos (use -k of transcode)</li>
546 <li>script: add properties (rotation etc) for sub-albums thumbnails</li>
547 <li>script: don't automatically rotate a theoretically unrotated portrait image, if image is obviously already in portrait
548 (situation can come from images already rotated with gthumb)</li>
554 <li><u>2005-04-01: <b>0.2.0</b>:</u>
558 <li>GUI: add a toolbar</li>
559 <li>GUI: add rotation support, either with mouse gesture or one-click tools</li>
565 <li><u>2005-03-28: <b>0.1.0</b>:</u>
569 <li><em>first release</em></li>
575 <p align="right"><font size="-1">Sat Nov 9 16:41:52 2013</font></p>