By accepting, downloading, and/or installing this product, you indemnify and hold harmless Lussumo Software and it's creator Mark O'Sullivan. You accept that this product may contain harmful or damaging code.

Filebrowser Installation

The installation of the Filebrowser is pretty simple. You take all of the files contained in the zip and place them in the folder that you want to browse. Your folder must be a web-accessable directory. You do not need to copy the Filebrowser or it's files into subdirectories, subdirectories will be browsed automatically by the Filebrowser under it's default settings.

Filebrowser Permissions

The Filebrowser will require read permissions on the _config.xml and the _filetypes.xml files in order to function correctly. Chances are that your server will be set up to allow PHP to read those files already. If you get a permission error, you should be sure to grant read access on those files. You can either request that your hosting provider do it for you, or if you have shell access to your server, you can run the following commands from the Filebrowser folder:

chmod 644 _config.xml
chmod 644 _filetypes.xml

Thumbnailer Installation

The Filebrowser comes with a neato thumbnailing tool that will allow you to automagically create thumbnails of your images for easier browsing in the Filebrowser. If you've already got the Filebrowser set up, now you just need to set up the permissions on the thumbnailer.

Thumbnailer Permissions

The Thumbnailer is going to need both read AND write access to your filebrowser folder (and it's subfolders). This is because it will first open and look at the images in your folder, and then it will create new thumbnails of those images and save them to the folder. Chances are that PHP doesn't have this kind of access by default and you will need to make some changes in order to get it to work. Once again, you can either request that your hosting provider grant PHP both read and write access to your filebrowser folder, or if you have shell access you can do it yourself.

chmod 757 ../your_filebrowser_folder_name/

Obviously you'd replace the "your_filebrowser_folder_name" with the actual name of the folder your filebrowser is sitting in, and that command assumes that you're still sitting in the filebrowser folder.

To use the thumbnailer, you'll just have to type www.yourdomain.com/yourfilebrowserfolder/thumbnailer.php and follow the instructions on the screen.

What Next?

There is a whole world of configuration you can do with your Filebrowser, and we highly recommend that you head on over to the Lussumo Documentation site to read the Filebrowser documentation. You can do everything from changing the page title on your filebrowser to completely changing the look, feel, and functionality.


If you are having problems getting your Filebrowser or Thumbnailer set up, first of all be sure to check out the Lussumo Documentation. If the documentation doesn't do it for you, we've got a community of users who are always ready, willing, and able to help out with your requests over at our Community Forums.

Lussumo Filebrowser Copyright © 2001 - 2005