Welcome to...
This is the homepage for ImgDir -- a simple php-based image viewer.
Click Here For New Frequently Asked Questions (FAQ) Section!
New Features Added!
Version 3.0 was released on September 7, 2005. It includes some minor bug
fixes and some major code cleanup/restructuring. Recently, the ability to
resize images automatically was added, although the default is to display
images in their full size. Accessing the new resize functionality requires
changing the "imgsize" parameter in the auto-generated ".imgdir/dflt.txt"
file. The next big change to ImgDir will be exposing many of these 'hidden
features' so that they are more easily accessible and documented. So stay
tuned!
ImgDir now supports common movie file formats, allows you to cycle through
images using "previous/next" links, gives you the option to hide folders if
they take up more than a couple of rows, limits the number of thumbnails
shown to 50 per page (adjustable), supports linux symbolic links and now
contains a rudimentary captioning ability. If you encounter any bugs,
please let me know.
To upgrade, download the zip file, unzip it and overwrite your current
imgdir.php with the new one. THAT's IT. All reconfiguration is handled
automatically.
Why ImgDir?
When looking for a simple way to serve images on the web, I was frustrated by the complexity of most of the opensource solutions that were available, so I set out to spin my own -- with simplicity as the key driving principle. The result was ImgDir.
How does it work?
ImgDir consists of a single php file (imgdir.php) which you
drop into a web folder. If you then go and visit the file using your
favorite browser, you will see the instructions for how to
complete your setup. There are two very simple steps:
System Requirements
For assistance, email me at
durwood@berzerker.net.
1. Create a subfolder called ".imgdir" (the dot is important and the name is
case sensitive).
2. Make this subfolder globally writable (or at least make it writable by
your web server).
That's it!
Now all you have to do is drop pictures into the parent folder
(NOT .imgdir -- that is only used internally for storing user settings and
tumbnails). Thumbnails will automatically be created for you. Furthermore,
you can drop pictures into sub folders and they will be accessible also.
If you DO want to hack around a little with some of the default settings,
you can do this by editing the file .imgdir/dflt.txt. Eventually I'll add
some more readily accessible customizations, but I'm cautious about adding
new features and thus destroying its simplicity -- so we'll see.
Enjoy!