MarginalHacks album - Installation - Documentation

| A l b u m O n e - - I n s t a l l a t i o n

### Home
### Themes/Examples
### Languages
### Plugins
### License
### Download
### Documentation English Deutsch Español Français Nederlands Русский Italiano magyar
### Mailing List
### CHANGELOG
### Praises
### Contact
| Table Of Contents Minimum Requirements Initial Configuration Optional Installation UNIX Debian UNIX Macintosh OSX Win95, Win98, Win2000/Win2k, WinNT, WinXP How do I edit the Windows path? Macintosh OS9
    1:   Minimum Requirements

    1) The album perl script
    2) ImageMagick tools (specifically 'convert')

    Put the 'album' script and the ImageMagick tools somewhere in your PATH,
    or else call 'album' by it's full path (and specify the full path to
    convert either in the album script or in the album configuration files.

    2:   Initial Configuration

    The first time you run album it will ask you a few questions to
    setup the configuration for you.  If you're on UNIX/OSX, then you
    can run the first time as root so that it sets up the global configuration
    and themes for everyone instead of just the current user.

    3:   Optional Installation

    3) Themes
    4) ffmpeg (for movie thumbnails)
    5) jhead (for reading EXIF info)
    6) plugins
    7) Various tools available at MarginalHacks.com

    4:   UNIX

    Most UNIX distros come with ImageMagick and perl, so just download
    the album script and themes (#1 and #3 above) and you're done.
    To test your install, run the script on a directory with images:

    % album /path/to/my/photos/

    5:   Debian UNIX

    album is in debian stable, though right now it's a bit stale.
    I recommend getting the latest version from MarginalHacks.
    You can save the .deb package, and then, as root, run:

    % dpkg -i album.deb

    6:   Macintosh OSX

    It works fine on OSX, but you have to run it from a terminal window.  Just
    install the album script and ImageMagick tools, and type in the path to album,
    any album options you want, and then the path to the directory with the
    photos in them (all separated by spaces), such as:

    % album -theme Blue /path/to/my/photos/

    7:   Win95, Win98, Win2000/Win2k, WinNT, WinXP
    (Windows 95, Windows 98, Windows 2000, Windows NT, Windows XP)

    There are two methods to run perl scripts on Windows, either using ActivePerl
    or Cygwin.

    ActivePerl is simpler and allows you to run album from a DOS prompt,
    though I've heard that it doesn't work with themes.
    Cygwin is a bulkier but more robust package that gives you access to
    a bunch of UNIX like utilities, and album is run from a bash (UNIX shell)
    prompt.

    Cygwin method
    -------------
    1) Install Cygwin
       Choose packages:  perl, ImageMagick, bash
       Do not use the normal ImageMagick install!  You must use the Cygwin ImageMagick packages!
    2) Install album in bash path or call using absolute path:
       bash% album /some/path/to/photos
    3) If you want exif info in your captions, you need the Cygwin version of jhead

    ActivePerl method
    -----------------
    1) Install ImageMagick for Windows
    2) Install ActivePerl, Full install (no need for PPM profile)
       Choose: "Add perl to PATH" and "Create Perl file extension association"
    3) If Win98: Install tcap in path
    4) Save album as album.pl in windows path
    5) Use dos command prompt to run:
       C:> album.pl C:\some\path\to\photos

    Note: Some versions of Windows (2000/NT at least) have their
    own "convert.exe" in the c:\windows\system32 directory (an NTFS utility?).
    If you have this, then you either need to edit your path variable,
    or else just specify the full path to convert in your album script.

    8:   How do I edit the Windows path?

    Windows NT4 Users
      Right Click on My Computer, select Properties.
      Select Environment tab.
      In System Variables box select Path.
      In Value edit box add the new paths separated by semicolons
      Press OK/Set, press OK again.

    Windows 2000 Users
      Right Click My Computer, select Properties.
      Select Advanced tab.
      Click Environment Variables.
      In System Variables box select double-click Path
      In Value edit box add the new paths separated by semicolons
      Press OK/Set, press OK again.

    Windows XP Users
      Click My Computer, select Change a Setting.
      Double click System.
      Select Advanced tab.
      Select Environment Variables.
      In System Variables box select double-click Path
      In Value edit box add the new paths separated by semicolons
      Press OK.

    9:   Macintosh OS9

    I don't have any plans to port this to OS9 - I don't know what
    the state of shells and perl is for pre-OSX.  If you have it working
    on OS9, let me know.
Created by make_faq from Marginal Hacks

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |

         ^
         |