Difference between revisions of "Album - Photo gallery generator which has theme support"

From NAS-Central Buffalo - The Linkstation Wiki
Jump to: navigation, search
m (Requirements)
(Remove stub status)
 
(18 intermediate revisions by one user not shown)
Line 39: Line 39:
 
==Requirements==
 
==Requirements==
 
Minimum Requirements
 
Minimum Requirements
#[[w:Apache HTTP Server|Apache]] or [[w:Lighttpd|Lighttpd]] or [[w:Thttpd|Thttpd]]
+
#[[w:Apache HTTP Server|Apache]] or [[w:Lighttpd|Lighttpd]] or [[w:Thttpd|Thttpd]] look at the following articles for pointers:
## [[Apache w/ PHP and MySQL Support (MIPSel)]]  
+
## [[LLMP]] or [[LAMP]]
## [[Apache HTTP server, installing]]
+
## [[Lighttpd with mysql and php (LLMP)]]
+
 
## [[Run a second instance of thttpd (on an alternate port) ]]
 
## [[Run a second instance of thttpd (on an alternate port) ]]
 
#[[w:Perl|Perl]] and the script for MarginalHacks:Album<ref>http://marginalhacks.com/Hacks/album/Download.html MarginalHacks: Album Download</ref>
 
#[[w:Perl|Perl]] and the script for MarginalHacks:Album<ref>http://marginalhacks.com/Hacks/album/Download.html MarginalHacks: Album Download</ref>
Line 49: Line 47:
 
# Themes<ref>[http://davepics.com/Theme_Album/ Davepics.com - Snapshots of all Album themes]</ref>
 
# Themes<ref>[http://davepics.com/Theme_Album/ Davepics.com - Snapshots of all Album themes]</ref>
 
# [[w:ffmpeg|ffmpeg]] (for movie thumbnails)
 
# [[w:ffmpeg|ffmpeg]] (for movie thumbnails)
 +
# jhead (for reading EXIF info)<ref>[http://marginalhacks.com/redir.cgi?www.sentex.net/~mwandel/jhead/ jhead: Exif Jpeg header and thumbnail manipulator program]</ref>
  
==Install Imagemagik==
+
==Install==
 +
===FreeLink===
 +
apt-get install jhead ffmpeg album
 +
 
 +
===OpenLink===
 +
{{Warning|'''''Untested'''''<br> if someone wants to test this out on the [[:Category:LS1|LS1]] and [[:Category:LS2|LS2]] running [[OpenLink]] and remove this warning banner that would be great }}
 +
====MIPsel====
 +
You'll have to compile everything from source for the MIPSel Linkstation.  This would probably work fine on any LinkStation, [[OpenLink]] or [[FreeLink]] but it takes FOREVER to compile imagemagik
  
===FreeLink===
+
*Install the [[Precompiled C development environment, running on the LS]]
Skip ahead to [[#Install Album]], apt-get will resolve all dependancies for you
+
*Install imagemagik from source.<ref>[http://www.imagemagick.org/script/install-source.php#unix ImageMagick: Install from Source]</ref>
===OpenLink(PowerPC)===
+
#Install [[Ipkg on the Linkstation (for end-users)]] and enable the NSLU2 Feed: [[Ipkg Package List: PowerPC]]
+
#Install imagemagick
+
ipkg install imagemagick
+
===OpenLink (MIPSel)===
+
{{Warning|Untested}}
+
#Install the [[Precompiled C development environment, running on the LS]]
+
#Install imagemagik from source.<ref>[http://www.imagemagick.org/script/install-source.php#unix ImageMagick: Install from Source]</ref>
+
 
Download ImageMagick.tar.gz from [ftp://ftp.imagemagick.org ftp.imagemagick.org] or its mirrors and unpack it with this command:
 
Download ImageMagick.tar.gz from [ftp://ftp.imagemagick.org ftp.imagemagick.org] or its mirrors and unpack it with this command:
 
  wget ftp://ftp.imagemagick.org/pub/ImageMagick/ImageMagick.tar.gz  
 
  wget ftp://ftp.imagemagick.org/pub/ImageMagick/ImageMagick.tar.gz  
Line 72: Line 70:
 
   make install
 
   make install
  
==Install Album==
+
*Install jhead
===FreeLink===
+
wget http://www.sentex.net/~mwandel/jhead/jhead-latest.tar.gz
  apt-get install album
+
  tar -xvzf jhead-latest.tar.gz
===OpenLink===
+
cd jhead-?.?
{{Warning|Untested}}
+
make
#Install the [[Precompiled C development environment, running on the LS]] (to get [[w:perl|Perl]])
+
chmod +x jhead
#Download and run Album:
+
cp jhead /usr/local/bin
 +
 
 +
*Download and run Album:
 
  wget http://marginalhacks.com/bin/album.tar.gz
 
  wget http://marginalhacks.com/bin/album.tar.gz
 
  tar -xvzf album.tar.gz
 
  tar -xvzf album.tar.gz
Line 86: Line 86:
 
  chmod 0755 /usr/local/bin/album
 
  chmod 0755 /usr/local/bin/album
  
==Running Album==
+
====PowerPC====
===Directory===
+
*Install the [[Precompiled C development environment, running on the LS]] (to get [[w:Perl|Perl]])
*You need a web directory to put themes and your photo  album.<ref>[http://marginalhacks.com/Hacks/album/Docs/Section_2.html marginalhacks.com Album Documentation: MINI HOW-TO]</ref> eg: <tt>/home/httpd/test</tt>  the URL will be: <font color=blue> <nowiki>http://myserver/test/</nowiki></font>
+
*Install [[Ipkg on the Linkstation (for end-users)]] and enable the NSLU2 Feed: [[Ipkg Package List: PowerPC]]
*First create a directory and put some images in it.
+
*Install imagemagick and ffmpeg
  mkdir /home/httpd/test/Photos
+
ipkg install imagemagick
 +
  ipkg install ffmpeg
  
===Adding captions and Hiding photos===
+
*Install jhead
 
+
  wget http://www.sentex.net/~mwandel/jhead/jhead-latest.tar.gz
*Create a file <tt>/home/httpd/test/Photos/captions.txt</tt> with the following contents
+
  tar -xvzf jhead-latest.tar.gz
(use the 'tab' key where you see " [tab]  ")
+
  cd jhead-?.?
 
+
make
There are a few ways to hide photos/files/directories, but we'll use
+
  chmod +x jhead
the captions file. 
+
  cp jhead /usr/local/bin
(Try commenting out an image with '#' in captions.txt: You'll see that IMG_002.jpg is missing.)
+
*'''''captions.txt'''''
+
<pre>
+
IMG_001.jpg  [tab]  First image name
+
# IMG_002.jpg  [tab]  Second image
+
IMG_003.jpg  [tab]  Another image  [tab]  with a caption!
+
IMG_004.jpg  [tab]  Last image    [tab]  with another caption.
+
</pre>
+
 
+
*Now create a file with text in:
+
/home/httpd/test/Photos/header.txt
+
You'll see that text at the top of the page.
+
 
+
===Using A Theme===
+
<table align=right cellpadding=0 cellspacing=0>
+
<tr>
+
<td>
+
http://davepics.com/Theme_Album/tn/Dominatrix6.jpg
+
</td>
+
</tr>
+
<tr>
+
<td align=center>
+
<small>[http://davepics.com/Examples/Dominatrix6.html Dominatrix6]</small>
+
</td>
+
</tr>
+
</table>
+
*Use wget to get and install this theme
+
mkdir /home/httpd/Themes/
+
cd /home/httpd/Themes/
+
wget http://marginalhacks.com/Hacks/album/Themes/Dominatrix6.tar.gz
+
  tar -xvzf Dominatrix6.tar.gz
+
  rm Dominatrix6.tar.gz
+
*To use a theme, download the theme .tar or .zip and unpack it.
+
 
+
Themes are found according to the <tt>-theme_path</tt> setting, which is a list of places to look for themes. Those paths need to be somewhere under the top of your web directory, but not inside a photo album directory.  It needs to be accessible from a web browser.
+
 
+
You can either move the theme into one of the <tt>theme_path</tt>-s that album is already using, or make a new one and specify it with the <tt>-theme_path</tt> option.  
+
 
+
===Medium images===
+
*Full resolution images are usually too big for a web album, so we'll use medium images on the image pages:
+
 
+
*Then call album with the <tt>-theme</tt> option, with or without <tt>-theme_path</tt>:
+
 
+
  album -medium 33% -theme Dominatrix6 /home/httpd/test/Photos
+
  album -medium 33% -theme Dominatrix6 -theme_path /home/httpd/Themes/ /home/httpd/test/Photos
+
  
 +
*Download and run Album:
 +
wget http://marginalhacks.com/bin/album.tar.gz
 +
tar -xvzf album.tar.gz
 +
cd album-3.12
 +
mkdir -p /usr/local/bin
 +
cp album /usr/local/bin/
 +
chmod 0755 /usr/local/bin/album
  
===Adding more albums===
+
==MarginalHacks/Album: MINI HOW-TO<ref>[http://marginalhacks.com/Hacks/album/Docs/Section_2.html marginalhacks.com Album Documentation: MINI HOW-TO]</ref>==
*Let's say we go on a trip to spain.  We take some photos and put them in:
+
===[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Simple_album Simple album]===
  /home/httpd/test/Photos/Spain/
+
===[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Add_captions Add captions]===
*Now run album again on the top level:
+
===[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Hiding_Photos Hiding Photos]===
  album /home/httpd/test/Photos
+
===[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Using_A_Theme Using A Theme]===
This will fixup Photos so it now links to spain and will run album
+
===[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Medium_images Medium images]===
on <tt>Spain/</tt> as well, with the same settings/theme, etc..
+
===[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Adding_some_EXIF_captions Adding some EXIF captions]===
Now let's go on another trip, and we create:
+
===[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Adding_more_albums Adding more albums]===
  /home/httpd/test/Photos/Italy/
+
*We could run album on the top level:
+
  album /home/httpd/test/Photos
+
But that would rescan the Spain directory which hasn't changed.
+
Album usually won't generate any HTML or thumbnails unless it needs to,
+
but it can still waste time, especially as our albums get bigger.
+
*So we can tell it to just add the new directory:
+
album -add /home/httpd/test/Photos/Italy
+
This will fix the top index (in Photos) and generate the Italy album.
+
  
 
==References==
 
==References==
 
<references/>
 
<references/>
{{Stubs}}
 

Latest revision as of 23:35, 25 December 2007

logo.jpg

Dominatrix6.jpg

181_thumb.gif

freshmeat.net: Screenshot of project album

Contents

What is it?

Album - [1] An HTML photo album generator that supports themes. It takes directories of images and creates all the thumbnails and HTML that you need.

Album is a perl script, which means you need to be comfortable with or prepared to use the command-line. If you just want a point-and-click, you may wish to look elsewhere. Features:

  • You can use themes to choose or redesign the album "look and feel."
  • Recursively descends directories to make a hierarchy of photo albums
  • EXIF support, Video thumbnails...
  • Has a plugin system that allows you to write perl code to alter the behavior of album.
  • Slideshows, transparent overlays, credit tags, easy captions, and endless features!

Look here for documentation: http://marginalhacks.com/Hacks/album/Docs/ [2]

There are a few photo gallery alternatives:

Requirements

Minimum Requirements

  1. Apache or Lighttpd or Thttpd look at the following articles for pointers:
    1. LLMP or LAMP
    2. Run a second instance of thttpd (on an alternate port)
  2. Perl and the script for MarginalHacks:Album[3]
  3. Imagemagick tools (specifically 'convert')

Optional Installation

  1. Themes[4]
  2. ffmpeg (for movie thumbnails)
  3. jhead (for reading EXIF info)[5]

Install

FreeLink

apt-get install jhead ffmpeg album

OpenLink

Nuvola apps important.png 
WARNING!

Untested
if someone wants to test this out on the LS1 and LS2 running OpenLink and remove this warning banner that would be great


MIPsel

You'll have to compile everything from source for the MIPSel Linkstation. This would probably work fine on any LinkStation, OpenLink or FreeLink but it takes FOREVER to compile imagemagik

Download ImageMagick.tar.gz from ftp.imagemagick.org or its mirrors and unpack it with this command:

wget ftp://ftp.imagemagick.org/pub/ImageMagick/ImageMagick.tar.gz 
tar -xvzf ImageMagick.tar.gz

Next configure and compile ImageMagick:

 cd ImageMagick-6.?.?
 ./configure
 make

If ImageMagick configured and compiled without complaint, you are ready to install it on your system. You need to be root to install. To install, type:

 make install
  • Install jhead
wget http://www.sentex.net/~mwandel/jhead/jhead-latest.tar.gz
tar -xvzf jhead-latest.tar.gz
cd jhead-?.?
make
chmod +x jhead 
cp jhead /usr/local/bin
  • Download and run Album:
wget http://marginalhacks.com/bin/album.tar.gz
tar -xvzf album.tar.gz
cd album-3.12
mkdir -p /usr/local/bin
cp album /usr/local/bin/
chmod 0755 /usr/local/bin/album

PowerPC

ipkg install imagemagick
ipkg install ffmpeg
  • Install jhead
wget http://www.sentex.net/~mwandel/jhead/jhead-latest.tar.gz
tar -xvzf jhead-latest.tar.gz
cd jhead-?.?
make
chmod +x jhead 
cp jhead /usr/local/bin
  • Download and run Album:
wget http://marginalhacks.com/bin/album.tar.gz
tar -xvzf album.tar.gz
cd album-3.12
mkdir -p /usr/local/bin
cp album /usr/local/bin/
chmod 0755 /usr/local/bin/album

MarginalHacks/Album: MINI HOW-TO[7]

Simple album

Add captions

Hiding Photos

Using A Theme

Medium images

Adding some EXIF captions

Adding more albums

References

  1. http://marginalhacks.com/Hacks/album/
  2. MarginalHacks Album Documentation
  3. http://marginalhacks.com/Hacks/album/Download.html MarginalHacks: Album Download
  4. Davepics.com - Snapshots of all Album themes
  5. jhead: Exif Jpeg header and thumbnail manipulator program
  6. ImageMagick: Install from Source
  7. marginalhacks.com Album Documentation: MINI HOW-TO