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 - Dark Theme
Directory Lister - Light Theme

View the demo

Download tar.gz Download zip

requires PHP 8.2+

Recent Changes

v5.8.0

Added

  • Move documentation to this repo in the /docs folder
  • Added direct linking for directories matching DIRECT_LINKS

Changed

  • Decoupled README rendering from hidden-file filtering, allowing a README to be rendered even when hidden
  • Centralized directory URL generation and improved consistency in path-segment URL encoding
  • Updated PHP and JavaScript dependencies, dev tooling and GitHub Actions

Fixed

  • Fixed compressed ZIP downloads producing incomplete archives in certiain circumstances (#1550 - Thanks @ dajiaohuang!)
  • Fixed ZIP_DOWNLOADS=false and ZIP_COMPRESS=false being interpreted as enabled (#1551 - Thanks @ dajiaohuang!)
  • Corrected configuration examples and several documentation errors (#1549 - Thanks @ dajiaohuang!)
  • Fixed a variable typo causing a HIDE_VCS_FILES to be ignored when defined

Security

  • Fixed hidden file and directory checks being bypassed with non-canonical paths containing . or .. segments
  • Fixed direct-linked content being accessible through query-string parameters from outside the direct-linked path

File Search

Find what you're looking for fast with built-in search.
Image

File Hashes

Improve trust and reliability with quick access to file hashes for validating downloaded files against the source.
Image

Readme Rendering

Display README files directly in your directory listing to provide customized, relevant info to your users.
Image

Features

  • Simple installation allows you to be up and running in less than a minute.
  • New 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.
  • New Multi-lingual support brings Directory Lister to the language of your choice.
  • New File search helps you locate the files you need quickly and efficiently.
  • File hashes instill confidence when downloading files through verification.
  • New 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.

Reach out on the GitHub Discussions board for help and support.

Become a Sponsor Make a Donation

Support development through monthly sponsorship or a one time donation.

Love Directory Lister?

Sponsor Donate