h5ai

h5ai makes browsing directories on HTTP web servers more pleasant. Directory listings get styled in a modern way and browsing through the directories is enhanced by different views, a breadcrumb and a tree overview.

See the demo directory with most features enabled.

Note: 0.22.1 is the last release supporting aai mode. h5ai 0.23+ will support php mode only!

Works fine with

• all tested servers: Apache httpd, lighttpd, nginx and Cherokee
• all modern browsers: Chrome, Firefox, Safari, Opera, IE9
• IE7+8, with some features disabled

The sources and a changelog are available on GitHub.

Features

There are lots of optional extensions and configuration options to customize the web appearance of your directory listings. All markup is valid HTML5 spiced up with CSS3 and finest JavaScript to build a fresh but minimal user interface and a user experience that focuses on your files.

Some of the optional features:

• breadcrumb for the current directory, linked to all parent directories
• auto refresh
• custom header and/or footer for each directory
• select and download multiple files and folders at once, either as tar or zip archive
• filter function for the displayed files and folders
• folder sizes
• localization with a lot of languages already included
• link hover states between main view, breadcrumb and tree view
• display HTTP web server details
• image preview with keyboard support
• text file preview with Markdown rendering and keyboard support
• QR codes on hovering files
• sort files and folders
• status bar with additional information about files and folders
• thumbnails for images, pdfs and movies
• directory tree view
• display breadcrumb in the browser title

Installation

Web servers with PHP (php mode)

Requires PHP 5.2.1+

• Copy folder _h5ai to the document root directory of your web server and make sure http://YOUR-DOMAIN.TLD/_h5ai/ is reachable. This page will give you some hints on your server's capabilities.

• Add /_h5ai/server/php/index.php to the end of your webservers default index-file list. All directories that don't have a valid index file will get styled by h5ai.

  Tested web servers:

  • Apache httpd 2.2/2.4: in httpd.conf or in any directory's .htaccess file set for example:

    DirectoryIndex  index.html  index.php  /_h5ai/server/php/index.php

  • lighttpd 1.4: in lighttpd.conf set for example:

    index-file.names += ( "index.html", "index.php", "/_h5ai/server/php/index.php" )

  • nginx 1.2: in nginx.conf set for example:

    index  index.html  index.php  /_h5ai/server/php/index.php;

  • Cherokee 1.2: in cherokee.conf set for example:

    vserver!1!directory_index = index.html,index.php,/_h5ai/server/php/index.php

Apache httpd with mod-autoindex (aai mode, deprecated)

• Copy folder _h5ai to the document root directory of your web server and make sure http://YOUR-DOMAIN.TLD/_h5ai/ is reachable. This page will give you some hints on your server's capabilities.

• Add the content of file _h5ai/server/aai/aai.htaccess to the .htaccess file inside the directory you want to get styled (you might have to create this file). This directory and all its subdirectories will get styled by h5ai.

Configuration

The main configuration file is _h5ai/conf/options.js. You might want to adjust some of the documented settings. But there are some more files in the _h5ai/conffolder you might have a look at.

License

h5ai is provided under the terms of the MIT License. It profits from a lot of other great projects.