directorylister / directorylister

📂 Directory Lister is the easiest way to expose the contents of any web-accessible folder for browsing and sharing.

---

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.

directorylister's Issues

How size file can be download.

i have problem when i will download file over 27M, example i will download file with size 35M, download running and finish , and when i check file just get 27M, and i has try with more 5 different file and different extension.

any information about thats solution.

Thanks u

Convert configuration vars to an array

Do the same thing as I did with UberGallery: https://github.com/UberGallery/UberGallery/blob/master/resources/UberGallery.php#L60

Theme System

Implement a theming system similar to the UberGallery theming system.

Parse Error, T_STRING

in default.config.php which you rename to config.php, line 16 reads:

    'download.php,

which doesn't have the closing apostrophe. It will return:

Parse error: syntax error, unexpected 'file_types' (T_STRING), expecting ')' in \resources\config.php on line 20

needs to be changed to:

    'download.php',

show filesize in MB, instead of KB

I think it might be better if the filesize function uses MB instead of KB, or make it dynamic to the situation (like KB for small file less than 10MB, and GB for a file with more than 1000MB size).

Thanks.

Downloading on Android Browsers

When downloading on a android phone the files come out as download.php instead of filesxyz.zip

Back one directory link is broken

When you are only one folder deep, the 'back one directory' link does not work properly.

Hide index.php from the root folder

index.php should not be listed in the root folder

The UTF-8 Encoding cannot be used by DirectoryLister

It's possible to add UTF-8 support ?

Sort by date

Add the ability to sort files by modified date.

does v2.1.0 count downloads??

I used v2.0 for a while.
Today installed 2.1.0 but it does not count downloads anymore.
Thanks.

strange replace folder name 1 - > 0

http://www.oracle-xe.ru/

═════════════════════════════════════════ \FLYLINKDC-SERV\web\oraclexe ═══
x Name │
.. │
1 │
resources │
Test-folder │
.htaccess │
index.php │

http://www.flickr.com/photos/96019675@N02/9526020100/

open_basedir causes errors when DL is ran from a sub-directory

With the implementation of 'open_basedir' in Directory Lister v2.5.2 and when running Directory Lister in a non-top level directory, the following errors show:

open_basedir restriction in effect

IE9 - Activated Compatibility Mode = Wrong list display!

Hi,
If IE9 is used to browse then as soon as the IE feature "Compatibility View" is activated the content of the directory is not shown correct.

This was not tested with other IE versions but I assume it goes into the same.

Correct Display with "Compatibility View" disabled:

Incorrect Display with "Compatibility View" enabled:

Add support for hiding files by wild card

It would be nice to be able to hide files via wildcard like so:

// Hidden files
'hidden_files' => array(
    '.ht*',
    '*.php',
    'resources/*',
    'analytics.inc'
),

Markdown Support

Implement the parsing of markdown files on the fly instead of treating them like text.

File names are not properly encoded for the URL

Files with pound signs (#) do not work due to them not being encoded properly.

SECURITY BREACH using ?dir=

I recently came across a security breach today while using this tool on a windows apache server.

You can use it to display any path OUTSIDE of the path the script runs in using the URL, if you know direct paths on the server. For instance, simply adding ?dir=C: to the end of the index.php will display the contents of the C:/ drive, and everything from there! This does not let the user display files in these directories, but seeing the directories themselves is already BAD enough!

Please be sure to patch this in future releases. It should never allow directory listing of parent directories.

---

Also, a RECOMMENDATION feature:
Would it be possible to run this script on a web-accessible directory, but have it browse files on a directory outside of the web directory? Say, I want to browse C:/My Pictures exclusively through this tool on domain.com/index.php (running your script). So in other words, your script would be a portal to make these files web-accessible.

Thanks!

FTP access

Hi,

I'm trying to use the Directory Lister to retrieve a listing from an FTP directory to a public directory. The directory is password protected, and I'd like to include the username and password for the 'dir'.

Thanks,

• Nick

File inside directory has broken path, file can't be found.

I'm not a programmer so am not sure what's going on but I have created an example so you can see what's happening: http://danielmee.com/dl/
If you click on /test directory and then on test2.mp3 you get a 404: "The requested URL /dl/test/test2.mp3 was not found on this server."
I note though that the URL says: /dl/test%2Ftest2.mp3 and not /test/test2.mp3.
Also reported in this google group post.

Utilize DirectoryIterator() for listing directory contents

See http://php.net/manual/en/class.directoryiterator.php for more information on using DirectoryIterator() for listing directories.

DefaultRoot

I think, it's been a good feature, to add a config parameter, called default root.
In that line u can set the directory.

For example, i made a symlink near the index.php. I want only list this folder. And if i can set that, that would be great :D

Make a way to define hidden files/folders

The user needs a way to define specific hidden files/folders. The solution must not let a user be able to browse this list publicly.

File Extension Containing Numbers Don't Download

http://s28.postimg.org/rj8oz10sd/error_dir_list.png

Any file containing a number anywhere in the extension causes the download to fail. So MP4, MP3, etc. will not download. I tested by renaming a file that downloads fine from JPG to J3G or JP3 and it causes it to not download in both IE and Chrome.

http://s14.postimg.org/3mbt0vcr5/phpinfo.png

Google API

I see in the source code, you include Google API.

• fonts.googleapis.com
• ajax.googleapis.com

Is it possible to avoid Google API's website connection ?

notice : rawurlencode

Hi sir
i'm using wamp server in windows .
After using the ِDirectory Lister system gives the following message :
" Notice: Use of undefined constant rawurlencode - assumed 'rawurlencode' "
please help me ...
tnx

Missing ' in config.php

I implemented this and I get Parse error: syntax error, unexpected T_STRING, expecting ‘)’ in /home/content/79/9790479/html/uploads/resources/config.php on line 20

FIX:

edit line 16

‘download.php’,

it was missing the ‘ at the end

Update bootstrap to latest version

Currently v2.2.2

http://twitter.github.com/bootstrap/

ERROR: Failed to initialize theme

ERROR: Failed to initialize theme.

Any ideas? Just downloaded it and stuck it on my server.

Update Bootstrap to v3.1

Update Bootstrap framework to v3.1.0

ogv and webm filetypes

This type of files should appear with icon-youtube-play icon.

Integrate Colorbox to browse files

Integrate Colorbox to come up whenever a "readable" file is selected. Also add a "download" button to each line that utilizes Colorbox for viewing.

DirectoryLister doesn't work inside Ldap authenticated directory.

Works fine in regular directory. Doesn't work in directory under authentication.

Prevent file sizes from being truncated

At various resolutions file sizes may get truncated.

Possible solution is to treat the divs as table-cells. Example: http://stackoverflow.com/questions/4262061/making-divs-act-like-a-table-using-css

Database files icon showing as application

The icons for database files is incorrectly showing up as the applications icon.

Is it me, or files with spaces (%20) are not properly encoded?

All files with spaces in their name, like 'something something' are not downloadable.

Files links with target _blank

Links to 'everything' except directories should have target blank :)

Downloads-Counter and MD5Sum

Hello,

I have an idea - one of them is already implemented on a fork of your script, https://github.com/Obihoernchen/DirectoryLister -the Download Counter. it is good, yeah...but i'd like to have it integrated here. This would be the mist useful feature, but wait, there's more... :)

Another one is the Integration of a Button for MD5Sum Generation -so when the user clicks on a file, it generates a md5sum via AJAX. (just an idea)
OR:
To generate a text file/a config file that stores the MD5Sum.

Great script by the way :)

counter/log lost some data

The log seems to lost some data over time, files with their counter are just gone sometimes

ERROR: Failed to initialize theme

After installation of v2.0.3 I received this error when accessing my root directory -

ERROR: Failed to initialize theme

Unfortunately, there's no other information. Running XAMPP 1.8.1 (PHP 5.4.7) on Windows 7 Ult. 64-bit

Checksum generation takes a while on large files

Suggested fix: Add a "Processing checksums" message and loading spinner.

Add icon for markdown files

Add .md files to the text file array

Parent Directory not working

If i click parent directory, it just navigates into the directory i am in

bootstrap pull-right bug

the structure is wrong near the size and modified classes.
the right solution:
span class="file-size pull-right"
span class="file-modified pull-right"

Per-directory Reverse Sorting

Add a config option to reverse sort (alphabetically) a directory. Maybe even allow custom sorting per directory with natcase being default.

Move theme to sub-module

Move the current theme to submodule to allow separation of development.

resources/config.php on line 20

Followed your instructions for installation... error occured
Parse error: syntax error, unexpected T_STRING, expecting ')' in /home/content/d/s/c/dscmaster/html/...resources/config.php on line 20
Do I need to alter file type somewhere? I have .3gp in directory

Google Analytics

Add an easy way to track site analytics via Google Analytics. Make sure to enable file download tracking as an event.

Add 'resources' to the hidden folders

The resources folder should be hidden.

Plugin System

Implement a plugin system.