README.md

Directory Lister

Join our Community Become a Sponsor One-time Donation
Packagist PHP Version Support License


Directory Lister is the easiest way to expose the contents of any web-accessible folder for browsing and sharing. With a zero configuration, drag-and-drop installation you'll be up and running in less than a minute.

Directory Lister is created and maintained by Chris Kankiewicz (@PHLAK) with help from community contributions.

Features

  • Simple installation allows you to be up and running in less than a minute.
  • Light and dark themes to suit your professional needs or personal style.
  • Custom sort ordering gives you control of the ordering of your files/folders.
  • File search helps you locate the files you need quickly and efficiently.
  • File hashes instill confidence when downloading files through verification.
  • Readme rendering allows exposing the contents of READMEs directly on the page.
  • Zip downloads for fetching an entire directory of files in a single action.
  • Multi-lingual support brings Directory Lister to the language of your choice.

Requirements

  • Directory Lister requires PHP >= 8.0
    • The Zip extension is required for zip downloads
    • The DOM and Fileinfo extensions are required for README rendering

Installation

  1. Download Directory Lister
  2. Extract the zip/tar archive
  3. Copy extracted files/folders to your web server

Configuration

  1. Copy .env.example to .env
  2. Edit the configuration values in .env

See the Configuration Documentation for more information.

Sponsors

Love Directory Lister? Sponsor development and have your name or logo featured here!

Changelog

A list of changes can be found on the GitHub Releases page.

Troubleshooting

See the Help & Support section of the documentation for troubleshooting instructions.

For general help and support join our GitHub Discussion or reach out on Twitter.

Please report bugs to the GitHub Issue Tracker.

Copyright

This project is licensed under the MIT License.