1 This software requires for compiling:
6 - ruby-gettext >= 0.8.0
7 - ruby-gtk2 >= 0.12; notice:
8 - ruby-gtk2 0.15.0, 0.17.0 and 0.18.1 should be avoided, they are known
10 - with ruby >= 1.8.7, ruby-gtk2 >= 0.18.0 should be used, otherwise
12 - devel of ruby-gnome2 (mkmf-gnome2.rb, rbgobject.h)
13 - devel of libexiv2 (and thus, g++)
15 Note: theoretically, gtk and ruby-gtk2 are not needed if
16 you're gonna use only the backend script (the only lost
17 functionality is white balance correction which uses
18 gdk_pixbuf). However, the GUI is an important part of this
19 software and its use is encouraged (it helps a lot).
23 - convert (from ImageMagick) - for photos thumbnails generation
24 - identify (from ImageMagick) - for photos captions
25 - exif - to show full formatted EXIF information from photos
26 - mplayer - for videos thumbnails generation
27 - ffmpeg - for generating .mp4 videos
28 - gimp - for photos editing (may not be a hard require)
29 - mozilla-firefox - for showing albums in browser, and going on the
30 web for tutorials (may not be a hard require)
31 - lftp - for uploading web-albums
33 Compiling and Installing Quick Start
35 Type this as normal user:
37 # ruby setup.rb config
40 # ruby extconf.rb && make
44 - on ubuntu 20, I received a failure on mkmf-gnome2 lib loading
45 indicating missing mkmf-gnome, and "sudo gem install gtk3"
46 workarounded this problem
48 - on one ubuntu 20, I received a failure compiling the extension with
49 Exiv2::AnyError not found; adding "#include <exiv2/exif.hpp>" in
50 line 27 of ext/rbbooh.cc workarounded this problem
52 - if that fails on missing GTK header file (gtk.h), you can try to
53 inject cflags with such a command:
55 # perl -pi -e 's/(CXXFLAGS.*)/$1 `pkg-config --cflags gtk+-2.0`/' Makefile
58 - if that fails on redefinition of struct re_registers and you have
59 ruby-2.3, you can try to workaround with:
61 # cp /usr/include/ruby-2.3.0/ruby.h .
62 # perl -pi -e 's/.*HAVE_RUBY_ENCODING_H.*//' ruby.h
65 - if that fails on redefinition of struct re_registers and you have
66 ruby-2.5, you can try to workaround with:
69 # cp -a /usr/include/exiv2/* exiv2
70 # perl -pi -e 's/#define EXV_HAVE_REGEX 1//' exiv2/exv_conf.h
73 And type this as superuser:
75 $ ruby setup.rb install
79 If you want to package as normal user to another root:
81 $ ruby_archdir=`ruby -rrbconfig -e "puts Config::CONFIG['sitearchdir']"`
82 $ libdir=`ruby -rrbconfig -e "puts Config::CONFIG['sitelibdir']"`
84 $ ruby setup.rb install --prefix=${buildroot}
86 $ make install DESTDIR=${buildroot} libdir=${buildroot}${libdir} archdir=${buildroot}${ruby_archdir}
88 Note: it will install things in traditional directories plus
89 ruby_archdir and ruby_libdir.
90 Change FPATH in ${buildroot}/local/lib/site_ruby/1.8/booh/config.rb to suit your $buildroot
92 Find desktop stuff (.desktop entry and icons) for your menu/packaging system
93 in the destkop/ subdir.