AutoIndex PHP Script
Configuration

The default options are currently selected, so just press the configure button at the bottom to use them.


Base Directory:

This is the folder that will be the root of the directory listing.
This will be the starting point for the script. Nothing above this directory can be viewed, but its subfolders can.
Make sure to use a path relative to this index.php file if you can.

Icon Path:

This is the path to the icon image files (the path web browsers will access them from).
The included icon sets are apache, kde, osx, and winxp.
You can leave it blank to not show icons.

Show Directory Size

If this box is checked, the total size of directories will be shown under size (all the folder's contents will be added up).
Otherwise, it will display "[dir]" under size.
NOTE: If you are trying to index many files (meaning a few thousand), you will notice a speed improvement with this turned off.

Enable Searching

If this box is checked, people will be able to search for a file or folder by its filename.
It will search the folder you are currently in, and all subfolders.
Searching is not case sensitive.

Template Directory:

This is the path where the *.tpl template files are located (relative to this index.php file).

Enable Login System
Users must login to view/download
User List:

User List contains the path to the text file where the usernames and encrypted passwords are stored.
Make sure the file is chmod'ed so PHP can read and write to it.
(User List is only needed if the login system is enabled.)

The default accounts are:
username: admin
password: admin

username: user
password: user

Be sure to create new accounts, then delete these default ones if you enable the login system!

Age for "New" Icon: days

This contains the number of days old a file can be and still have [New] written next to it.
If it is set to 0, this feature will be disabled.

Number of file entires per page:

This contains the number of files or folders to display on a single page. If there are more files or folders, the display will be separated into different pages with Previous and Next buttons.
If it is set to 0, everything will be displayed on one page.

Image Thumbnail Height: pixels

This is a feature that will show thumbnails next to images. (NOTE: GDlib 2.0.1 or higher is required)
Setting it to 0 will disable this feature, and setting it to any other number will set the size of the thumbnail.
(100 is a good setting to start with.)

Pipe downloaded files though the PHP script

Bandwidth Limit: KB/s

This contains the max download speed for files. The above checkbox needs to be checked for this to work.
If it is set to 0, the script will not limit download speed.

Anti-Leech

When downloading a file, this will check to make sure the referrer the browser sends matches the website's URL.
Since some people turn off referrer sending in their browser, this option is not recommended.

The following items contain the path and filename to the file where the data for that feature will be stored.
Leave it blank to turn off that feature.

Hidden Files List:
Any file or folder matched to an item in this list will be kept hidden.
The contents of the list are editable when you login as an admin.

Access Log File:
The file to write the access log.
If this is enabled, you will be able to view the contents of the logfile
and generate statistics when you login as an admin.

File/Folder Description File:
The file to write the file descriptions to.
File/Folder descriptions are editable when you login as an admin.

Download Count File:
The file to write the file download counts to.
The count is automatically increased when a file is downloaded.

Banned User List:
The file to write IP addresses and hostnames that are blocked from accessing this script.
The contents of the list are editable when you login as an admin.

Allow folder archive downloading

If this box is checked, users will be able to download the folder's contents as a tar archive file.

Parse .htaccess files

If this box is checked, .htaccess files will be parsed and used by AutoIndex.

MD5 calculation max size: MB

Setting this to 0 will disable this feature, and setting it to any other number will set the maximum size of a file to allow users to find the md5sum of (in megabytes).
(10 is a good setting to start with.)

Default Language:

The user's browser's default language is used, unless that language is not available in AutoIndex. In that case, the language selected here is used.


When you press Configure, the script will attempt to write the config data to the file.
If it cannot (for example if it does not have write permission in the directory) the config file will be downloaded, and you will have to upload it to your server.
(It should be named AutoIndex.conf.php and put in the same folder as index.php)