Shampoo is a very simple photo gallery script that doesn't require a database.
The gallery is built using the existing directory structure, where thumbnails are created and stored by the script.
The HTML produced is minimalistic, semantic and template-based, so the gallery is easy to build into existing websites.
Latest version: 0.7 (19/04/2011)
Your server needs to run PHP 5+ and it must understand .htaccess files because mod_rewrite is used to make nice URIs. This is pretty standard and the vast majority of commercial web hosts will have no problem with this.
In order for thumbnail creation to work, your server will also need to have GD installed. Again, any host worth its salt will have GD installed.
If you use Firefox or Chrome you can upload multiple images at once, including via drag-and-drop from your computer. You can try it out in the demo.
If you don't like the admin interface, you can still edit album descriptions, album titles and other settings directly in index.txt and settings.php (instructions within them). Naturally you can also upload pictures and videos by direct FTP upload.
To add captions manually, it's best to illustrate by example. Let's say you have an album (directory) called "lemurs" containing pictures from your holiday in Madagascar. Some of the pictures you want to add captions for are called "lemur1.png" and "myfavouritelemur.jpg". What you have to do is create a file called "lemurs.txt" (same name as the directory) and put the following in it:
lemur1.png|Who would've thought lemurs could do handstands! myfavouritelemur.jpg|Really, out of all of them, this one was my favourite.
Hopefully you can discern a pattern from that. Blank lines in the file are ignored.
You can lock albums so they can only be viewed with a password. Currently the admin interface is the only way to do this, they are no longer stored as strings in settings.php as they were in older versions. To set a password, open the album and click the "Add a password" link at the top.
The admin interface is also accessed via a password. When you first run the gallery, you will be asked to choose it. There on after you log in via the "Admin" link at the bottom of the page.
Shampoo runs off a template file,
shampoo.inc. You can add any PHP or HTML to it to make the gallery fit in with your website.
The CSS is all contained within
and should not interfere with your website's existing CSS.
The gallery can display FLV and MP4 videos (i.e. video formats supported by the Flash plugin). Flowplayer is the player used, and is included with Shampoo so you don't have to do anything.
This is for video files placed in the gallery, like images are – not for displaying YouTube or Vimeo videos. Of course if you've downloaded the YouTube video as an MP4 or FLV and you've put it in your album, then that will of course work.
In order to generate thumbs for each video you put in an album, FFmpeg has to be installed on your server. It will make the thumb from the first frame of the video. If FFmpeg is not present, an alternative thumbnail will be generated (see image).
If you don't have FFmpeg, it's straightforward to install if you have shell access. I followed these instructions, which should work for any host.
You might need to change the path to FFmpeg specified at the top of shampoovideo.php to the correct path on your server (I can't help with this).
BSD-style license. This means you can pretty much do whatever you want as long as you give due credit.
This is most likely a problem with mod_rewrite and your .htaccess file (in the base directory of Shampoo).
If you are using a subdomain or if you know you are using mod_alias. If your filesystem is very different to the URI structure, then it is also likely you will need to use a
The single / is most commonly needed when RewriteBase is required, but some hosts (e.g. 1and1) might require the path too. For example, if your base directory is called "pictures":
If your host supports PHP 4 and PHP 5, but it defaults to PHP4, you need this right at the top of your .htaccess (uncomment it):
AddType x-mapp-php5 .php
If any of these solutions work for you, or you have a different one, please let me know.
If your image filename contains non-Latin characters (e.g. Scandinavian letters like "å", "æ" and "ø") Apache may have trouble finding them, particularly on Linux (this doesn't seem to be a problem on Windows).
The solution is to simply not use those characters for the filenames and instead use them only in the images' captions.
If you forgot the password for an album, just delete the password (on the album's page) and create a new one.
If you forgot the admin password, you need to delete the file called .pw, which will be in the base directory of Shampoo. Then visit the gallery and you will be asked to choose a new one.
If the steps above didn't help, if you encounter bugs or if you have any other questions, email me:r [at] this domain