Server generated directory indices are ugly. OK, they work everywhere, but they're still ugly.
If you'd like your download directory to be maintainable without creating and changing huge HTML files,
just put snif as its index file into the directory and here you go!
Read the comments inside the source for documentation. If you still have problems, feel free to email me.
ready to run: you don't have to change anything, just put snif into a directory and let it do its job
single file, doesn't clutter your directories
file and directory descriptions
automatic thumbnails for image files
thumbnail caching
fully translatable, translation is used for foreign visitors automatically.
16 translations are included: Brazilian Portuguese, Czech, Danish, Dutch, English, French, German, Greek, Hungarian, Italian, Japanese, Norwegian, Polish, Russian, Spanish, and Swedish.
download files instead of opening
listing sortable by name, size or date
display sub directories and handle direct requests to them gently
built-in file icons
optional: use external icons instead of built-in ones
customizable using an external CSS file
configuration can be shared among multiple instances
conforms to XHTML 1.1 and CSS 2.0
Screenshots:
Changelog:
v1.5.2
10-11-04
added a Czech translation (thanks to Jan Pinkas)
added an Italian translation (thanks to Luca Soltoggio)
fixed an XHTML glitch in thumbnail tags
v1.5.1
07-18-04
fixed XHTML validity
fixed back link not displayed
v1.5
07-18-04
added color configuration using an external stylesheet file
added central configuration file for multiple installations of snif on one server
added a Brazilian-Portuguese translation (thanks to Caio Begotti)
added a Greek translation (thanks to George Yiftoyiannis)
added a Spanish translation (thanks to Martinp and Genaro Paez)
tweaked the file extensions
fixed some problems with access rights for thumbnail files and directory
fixed line-break issues in long descriptions
fixed a strange unicode bug that could cause broken images in Mozilla
fixed a bug with pictures and directories with special characters
fixed a download bug (download link was broken sometimes)
improved display for files with both thumbnail and description
v1.4.8
06-24-04
added a Japanese translation (thanks to hjbdnpmo)
added a Danish translation (thanks to Svend Rugaard)
improved fail-safe behaviour when creating the .snifthumbs directory has failed
improved backwards compatibility with default date format
v1.4.7
06-21-04
fixed multiple problems with special characters in file and path names
fixed a bug with downloading files with spaces or quotes in their names (thanks to Derick Ng)
added a maximum thumbnail width (thanks to Nasim)
v1.4.6
06-18-04
thumbnails now link to the original image file
added a Russion translation (thanks to Neptune)
added a Hungarian translation (thanks to Gabor Funk)
added a French translation (thanks to Marc Nadeau)
v1.4.5
06-14-04
added server-side thumbnail caching (needs some testing, but it seems to work well)
all columns (including filetype icon) can now be hidden and reordered
added an optional CVS version column (thanks to Holger "Holgi" Szillat)
added a Dutch translation (thanks to Rogier van Epen)
added a Norwegian translation (thanks to Kyrre Liaaen)
added a Polish translation (thanks to Slawomir Jucht)
added a Swedish translation (thanks to Elias Hedberg)
improved translation instructions
fixed some strings that were not translatable
added an option to always use a specific translation
fixed preview of animated GIFs
added an option to hide all directories containing a .htaccess file, no matter its contents
fixed default settings, forgot to reset my debug settings
v1.4
05-04-04
easy translation system (language is selected automatically depending on the user's browser's language setting)
added a German translation
option to reorder and hide columns
option to display "[ back ]" instead of ".."
option to always use the full width of the screen
special icon for the .. link
improved directory sorting: .. now always on first position
truncation of long file names (and an option for it)
added number of files contained in subdirectories
improved error messages
fixed possible bug with hidden files
fixed a bug with descriptions containing non-ASCII characters
thanks to Rogier van Epen for the comments
v1.3.2
01-19-04
improved HTTP cacheability of icons, thumbnails and downloads, major speedup!
added directory navigation in the header
added a thumbnail size setting
different index files in subdirectories are now possible
v1.3.1
01-14-04
added splitting directories on multiple pages
fixed some bugs with file links
better support for international file names
restored compatibility with older PHP versions (< 4.2.0, thank to Glen Solsberry)
v1.3
01-05-04
added automatic thumbnails for images (optional, requires GDlib 2)
added an option for case insensitive description assignment
added XHTML 1.1 and CSS 2.0 conformance
fixed a sorting bug
once more fixed special characters in file names
reduced resulting HTML size (15-20% smaller for large directories)
v1.2.9
12-20-03
stupid date format bug fixed
fixed download of files with special characters in their name
code cleanup
v1.2.8
12-13-03
settings have been split in basic and advanced settings
added configurable server name instead of what PHP detects (thanks to Paul Munn)
added configurable date and time format (thanks to Paul Munn)
improved default hidden file wildcards, now also hides emacs temp files (thanks to Paul Munn)
notices are now always suppressed
fixed various HTML and CSS glitches (thanks to Paul Munn)
fixed a bug which caused the sorting arrow not to be displayed (thanks to Paul Munn)
renamed and reorganized stylesheets (thanks to Paul Munn)
v1.2.7
12-09-03
cross site scripting bug fixed (thanks to Justin Hagstrom for reporting)
fixed a bug with the new hidden file wildcards
v1.2.6
12-06-03
improved external icons: you may now mix external and internal icons
improved directory sorting (thanks to mpember at mpember dot net dot au)
improved default hidden files wildcards, now also hides .* (thanks to Charles Hill)
fixed a minor bug in file type detection (thanks to Charles Hill)
added more file extensions (thanks to Charles Hill)
v1.2.5
11-26-03 security fix: download would allow paths above snif directory. IF YOU USE AN OLDER VERSION, PLEASE UPDATE NOW!
added configurable separation string for description files
added option to use external icons
fixed minor typos and HTML glitches
fixed a bug where the current path wasn't properly shown in the heading
last changed on 10-11-04
Quick feedback
Feedback heard: New support board! by Kai Blankenhorn (11-17-04) Some of you seem to like the idea to have a forum here, so there it is! It is still quite empty, but I've just put links to it all over my site so everybody at leasts notices. Now all you have to do is post :-)
Feedback requested: Support board? by Kai Blankenhorn (10-11-04) Thinking of how to give better support for my scripts: Do you think a support board would be useful? I don't know if I can reach the critical mass of users - right now I have around 100 visits per day for the scripts. Tell me if you would use it!
Processed some email by Kai Blankenhorn (10-11-04) I've finally got the time to process some of the email I've got in the last few weeks. Sorry to anybody whom I couldn't answer! It's pretty hard for me to answer support requests in the little time I can spare.
Anyway, I've found some treasures among the emails :-) FeedCreator is used in the Mambo CMS, and will probably soon be used in TWiki. Snif has two new translations, and pseudocron will have a bugfix in a few days.
finally new releases by Kai Blankenhorn (10-11-04) At last I've managed to put up two new releases of my scripts, snif and FeedCreator. Especially FeedCreator has had much user input and definitely needed a freshup. New feed types are HTML and JavaScript feeds, which can be included in any web page right away. Snif has become more configurable with the new version. You may now create central configuration files to use the same settings for multiple installations of snif within one webspace. Colors can now be configured using external stylesheets. If you have made a new color set for snif, send it to me and I'll put it on my site!
disadvantages of having a job by Kai Blankenhorn (07-07-04) I've started working in a full-time job last week (at sd&m, to be exact, which appears to be a great company so far). Unfortunately this means that I'll have less time for improving my scripts. But I definitely will! Pending are Brazilian Portuguese, Spanish and Greek translations for snif, and some fixes for FeedCreator. I'll see what I can do to create the new releases ASAP.
I'm alway happy to receive your code changes, so if you've made some improvements to one of my scripts, send them to me so other users can profit from them as well!
Forum
Applications
SnailProxy
;)
;)
;)
;)
;)
![[Valid RSS]](images/valid-rss.png "Validate my RSS feed"){kind=small}