File Browser provides a file managing interface within a specified directory and it can be used to upload, delete, preview and edit your files. It is a create-your-own-cloud-kind of software where you can just install it on your server, direct it to a path and access your files through a nice web interface.

Differences from upstream

This fork extends the official File Browser with several UX improvements, while staying compatible with its configuration, database and API:

• Multi-tab browsing (replaces Favorites) — open files and folders in new tabs (right-click "open in new tab", the + tab button, or Ctrl+T / Ctrl+W / Ctrl+Tab). Each tab caches its own listing selection and scroll position; switching tabs is instant with no reload. Tabs persist to the server and restore after a refresh.
• Real-time tab sync across clients (SSE) — tabs are synchronized between all your open sessions via Server-Sent Events, so opening/reordering a tab on one device is reflected on the others instantly. The active-tab selection is per-device and is not synced.
• Pinned sidebar — a toggle keeps the sidebar docked (pushing the content area aside) so it never auto-collapses on navigation. Pure client-side localStorage setting, not synced across devices.
• Resizable sidebar width — drag the sidebar's right edge (mouse or touch, one Pointer-Events path, no isMobile branch) to adjust its width; the width persists in localStorage.
• Copy server path — copy the full server-side path of a file/folder from the context menu, header actions or the mobile bar.
• Folder refresh button — reload the current folder listing, or re-fetch an opened file, straight from the server.
• Open button — open files and folders from the toolbar, mobile bar and context menu.
• Current-folder filter — filter the listing in place instead of the global search.
• Login session duration setting — configure how long a login session stays valid in the global settings.
• Adjustable Markdown preview font size — change the preview font size with the editor's +/- buttons; the choice is persisted locally.
• Compact layout — slimmer header and tighter sidebar spacing via the --header-height CSS variable.

Documentation

Documentation on how to install, configure, and contribute to this project is hosted at filebrowser.org.

Project Status

This project is a finished product which fulfills its goal: be a single binary web File Browser which can be run by anyone anywhere. That means that File Browser is currently on maintenance-only mode. Therefore, please note the following:

• It can take a while until someone gets back to you. Please be patient.
• Issues are meant to track bugs. Unrelated issues will be converted into discussions.
• The priority is triaging issues, addressing security issues and reviewing pull requests meant to solve bugs.
• No new features are planned. Pull requests for new features are not guaranteed to be reviewed.

Please read @hacdias' personal reflection on the project status.

Contributing

Contributions are always welcome. To start contributing to this project, read our guidelines first.

License

Apache License 2.0 © File Browser Contributors