PIVIAU Documentation

Summary

What is PIVIAU

PIVIAU is a PHP/MySQL web based gallery for your pictures, videos and audio that supports tags and exif for jpeg photos. You can see PIVIAU in action at http://motscousus.com/pics/.

Features

tags
albums and pictures have searchable tags,country,city,place,date,subject and author. It should be quite straight forward to add any type of tag.
search function
easy to use seach function.
rss feed
rss feed available for every seach you can do (for instance recently added photos).
slideshow
ajax powered slideshow with fading effect.
picture resize
pictures are resized automatically using PHP GD image functions.
videos
video are viewable using a video flash player (FLVPlayer).
audio
audio (wav and mp3) supported via a flash player (FLVPlayer).
exif support
exif supported via PHP exif functions to extract picture date.
XHTML + CSS
Generated HTML is valid XHTML code. General look of the gallery can easily be changed (from color palette to the layout) just by adapting the CSS.

Requirements

Apache
tested with apache 2.0, should work ok with apache 1.3.
Apache mod_rewrite
mod_rewrite is not mandatory, but needed for pretty URLs.
PHP
Tested fine with PHP 5, should work with php4.
PHP GD images functions
PHP must have mod_gd enabled in order to resize pictures.
PHP EXIF images functions
PHP must have exif support enabled in order to retrieve picture dates.
MySQL
MySQL is needed to store pictures and album information and search it. MySQL version 5 is needed because PIVIAU relies on heavy SQL sub-queries. It could how ever work with MySQL 4 and 3 with some (a lot of ?) SQL customisation.
PHP ADOdb
Underlying DB access library. downloadable from ADOdb website. (included in PIVIAU package)
ffmpeg
Not mandatory but needed to generate videos thumbnails and previews. In order to get sound working in videos enable MP3 encoding.
flvtool2
Not mandatory but needed if you want to have the nice progress bar in the flash based video player. available as a static EXE on windows and a Ruby scrip on unix.
ruby language
not mandatory, but used by flvtool2 on unix. easy installable packages available for all linux distributions.

Download

http://piviau.motscousus.com/releases/

History

1.4
1.3
1.2
1.1
1.0
0.9
0.8

Installation

gallery installation

database creation

import some pictures

User's Manual

project hierachy
root folder
contains the picture browser, slideshow,rss and video player. it also holds the config.inc.php configuration file.
admin
the updater php and sh scripts. The directory should be password proctected by an .htaccess file or similar.
albums
where the albums sub albums and original pictures are stored
css
holds the css
icons
contains icons (audio file thumbnail)
includes
contains all the needed includes
js
contains javascript scripts (for ajax slideshow mostly)
previews
where pictures and videos thumbnails are generated and stored
thumbnails
where pictures and videos thumbnails are generated and stored
picture name format
All picture tags and info are contained in the picture name. This way you can easily move your site from one hoster to another without loosing everything
Picture name should follow this pattern [picture_name.][title.][TagnameTagvalue.]... .extension
this could give you the following :
album description
the content of the file desc.txt in the album folder will be used as folder description. (it is not yet displayed on the web interface yet though)
album tags
Albums tags are heritated by each picture in that album and sub folder.
They are file parsed from the file tags.txt
format tagname: tagvalue1, tagvalue2
example :
place:
city:paris
country:france
subject:
author:
tag:impasse,street

FAQ

Will I add features?
maybe. Just ask me.
What does Piviau mean ?
Simple ! PIctures, VIdeos, AUdio.

Thanks

antoine
for ibrouteur as interface base for this gallery

Licence

All the works where the author is not specified or specified as "me" or any other term which would clearly represent myself are licenced under the CC-GNU GPL. The use of any other works than those desribed here-upon cannot be achieved without prior contact with their authors.

Contact

mots a.t motscousus.com