gtsteffaniak / filebrowser

πŸ“‚ Web File Browser
Apache License 2.0
13 stars 0 forks source link

License: Apache-2.0

FileBrowser Quantum - A modern web-based file manager

[!WARNING] Starting with v0.2.0, ALL configuration is done via filebrowser.yaml Configuration file. Starting with v0.2.4 ALL share links need to be re-created (due to security fix).

FileBrowser Quantum is a fork of the filebrowser opensource project with the following changes:

  1. [x] Enhanced lightning fast indexed search
    • Real-time results as you type
    • Works with more type filters
    • Enhanced interactive results page.
  2. [x] Revamped and simplified GUI navbar and sidebar menu.
    • Additional compact view mode as well as refreshed view mode styles.
  3. [x] Revamped and simplified configuration via filebrowser.yml config file.
  4. [x] Faster listing browsing
    • Switching view modes is instant
    • Changing Sort order is instant
    • The entire directory is loaded in 1/3 the time

About

FileBrowser Quantum provides a file managing interface within a specified directory and can be used to upload, delete, preview, rename, and edit your files. It allows the creation of multiple users and each user can have its directory.

This repository is a fork of the original filebrowser with a collection of changes that make this program work better in terms of aesthetics and performance. Improved search, simplified ui (without removing features) and more secure and up-to-date build are just a few examples.

FileBrowser Quantum differs significantly to the original. There are hundreds of thousands of lines changed and they are generally no longer compatible with each other. This has been intentional -- the focus of this fork is on a few key principles:

Look

One way you can observe the improved user experience is how I changed the UI. The Navbar is simplified to a three-component system :

  1. (Left) The slide-out action panel button
  2. (Middle) The powerful search bar.
  3. (Right) The view change toggle.

All other functions are moved either into the action menu or popup menus. If the action does not depend on context, it will exist in the slide-out action panel. If the action is available based on context, it will show up as a popup menu.

Install

Using docker:

  1. docker run (no persistent db):
docker run -it -v /path/to/folder:/srv -p 80:80 gtstef/filebrowser
  1. docker compose:

    • with local storage
version: '3.7'
services:
  filebrowser:
    volumes:
      - '/path/to/folder:/srv' # required (for now not configurable)
      - './database:/database'  # optional if you want db to persist - configure a path under "database" dir in config file.
      - './filebrowser.yaml:/filebrowser.yaml' # required
    ports:
      - '80:80'
    image: gtstef/filebrowser
    restart: always
version: '3.7'
services:
  filebrowser:
    volumes:
      - 'storage:/srv' # required (for now not configurable)
      - './database:/database'  # optional if you want db to persist - configure a path under "database" dir in config file.
      - './filebrowser.yaml:/filebrowser.yaml' # required
    ports:
      - '80:80'
    image: gtstef/filebrowser
    restart: always
volumes:
  storage:
    driver_opts:
      type: cifs
      o: "username=admin,password=password,rw" # enter valid info here
      device: "//192.168.1.100/share/"         # enter valid hinfo here

Not using docker (not recommended), download your binary from releases and run with your custom config file:

./filebrowser -c <filebrowser.yml or other /path/to/config.yaml>

Configuration

All configuration is now done via a single configuration file: filebrowser.yaml, here is an example of minimal configuration file.

View the Configuration Help Page for available configuration options and other help.

Migration from filebrowser/filebrowser

If you currently use the original opensource filebrowser but want to try using this. I recommend you start fresh without reusing the database, but there are a few things you'll need to do if you must migrate:

  1. Create a configuration file as mentioned above.
  2. Copy your database file from the original filebrowser to the path of the new one.
  3. Update the configuration file to use the database (under server in filebrowser.yml)
  4. If you are using docker, update the docker-compose file or docker run command to use the config file as described in the install section above.
  5. If you are not using docker, just make sure you run filebrowser -c filebrowser.yml and have a valid filebrowser config.

The filebrowser Quantum application should run with the same user and rules that you have from the original. But keep in mind the differences that are mentioned at the top of this readme.

Comparison Chart

Application Name Quantum Filebrowser Filestash Nextcloud Google_Drive FileRun
Filesystem support βœ… βœ… βœ… ❌ ❌ ❌
Linux βœ… βœ… βœ… βœ… ❌ βœ…
Windows βœ… βœ… βœ… ❌ ❌ ❌
Mac βœ… βœ… βœ… ❌ ❌ ❌
Self hostable βœ… βœ… βœ… βœ… ❌ βœ…
Has Stable Release? ❌ βœ… βœ… βœ… βœ… βœ…
S3 support ❌ ❌ βœ… βœ… ❌ βœ…
webdav support ❌ ❌ βœ… βœ… ❌ βœ…
ftp support ❌ ❌ βœ… βœ… ❌ βœ…
Dedicated docs site? ❌ βœ… βœ… βœ… ❌ βœ…
Multiple sources at once ❌ ❌ βœ… βœ… ❌ βœ…
Docker image size 22 MB 31 MB 240 MB (main image) 250 MB ❌ > 2 GB
Min. Memory Requirements 128 MB 128 MB 128 MB (main image) 128 MB ❌ 4 GB
has standalone binary βœ… βœ… ❌ ❌ ❌ ❌
price free free free free tier free tier $99+
rich media preview βœ… βœ… βœ… βœ… βœ… βœ…
upload files from the web? βœ… βœ… βœ… βœ… βœ… ❌
Advanced Search? βœ… ❌ ❌ configurable βœ… βœ…
Indexed Search? βœ… ❌ ❌ configurable βœ… βœ…
Content-aware search? ❌ ❌ ❌ configurable βœ… βœ…
Custom job support ❌ βœ… ❌ βœ… ❌ βœ…
Multiple users βœ… βœ… βœ… βœ… βœ… βœ…
Single sign-on support ❌ ❌ ❌ βœ… βœ… βœ…
LDAP sign-on support ❌ ❌ ❌ βœ… βœ… βœ…
2FA sign-on support ❌ ❌ ❌ βœ… βœ… βœ…
Long-live API key support ❌ ❌ βœ… βœ… βœ… βœ…
Mobile App ❌ ❌ ❌ ❌ βœ… ❌
open source? βœ… βœ… βœ… βœ… ❌ βœ…
tags support ❌ ❌ ❌ βœ… ❌ βœ…
sharable web links? βœ… βœ… βœ… βœ… βœ… βœ…
Event-based notifications ❌ ❌ ❌ ❌ ❌ βœ…
Metrics ❌ ❌ ❌ ❌ ❌ ❌
file space quotas ❌ ❌ ❌ ❌ βœ… βœ…
text-based files editor βœ… βœ… βœ… βœ… βœ… βœ…
office file support ❌ ❌ βœ… βœ… βœ… βœ…
Themes βœ… βœ… ❌ ❌ ❌ βœ…
Branding support ❌ βœ… ❌ ❌ ❌ βœ…
activity log ❌ ❌ ❌ βœ… βœ… βœ…
Comments support ❌ ❌ ❌ βœ… βœ… βœ…
collaboration on same file ❌ ❌ ❌ βœ… βœ… βœ…
trash support ❌ ❌ ❌ βœ… βœ… βœ…
Starred/pinned files ❌ ❌ ❌ ❌ βœ… βœ…
Content preview icons βœ… βœ… ❌ ❌ βœ… βœ…
Plugins support ❌ ❌ βœ… βœ… ❌ βœ…
Chromecast support ❌ ❌ βœ… ❌ ❌ ❌

Roadmap

see Roadmap Page