A media and file viewer for the browser built with Python Flask, JavaScript. and HTML/CSS.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
itdominator d6a3187f2c Merge pull request 'Major refactoring, cleanup' (#3) from develop into master
Reviewed-on: #3
8 months ago
images Updated to Bootstrap 5.3, added more playlist logic, cleanup 8 months ago
src Major refactoring, cleanup 8 months ago
.gitignore file manager and config updates, css changes, etc 3 years ago
LICENSE Major refactor start 3 years ago
README.md Updated bootstrap and theme, ref images 1 year ago
create_venv.sh player updates, layout updates, base oidc added 3 years ago
linux-requirements.txt Major refactoring, cleanup 8 months ago
windows-requirements.txt Updated requirements and html 3 years ago



WebFM is a media and file viewer aspiring to become a full fledged file manager in the browser.


  1. Install python, sqlite3, and ffmpeg on the system this will be on.
  2. Use ufw or gufw to open the port on your computer to the local network.
  3. Use hosts file (or other methods) to redirect webfm.com and ssoapps.com to local app.
  4. Update client_secrets.json > 'client_secret' field with your Keycloak key. (Current one was local, not public, and has been expired)
  5. Place files or start uploading some to the folders.
  6. Place an image such as a jpg, png, or gif labeled "000.itsExtension" in a directory and the viewer will use it as the background image for that folder/directory.
  7. Password protect folder based on core/utils/shellfm/windows/Settings.py file settings.
  8. Save paths to favorites list for quick access.

Notes: n/a


  1. Allow for move and copy.
  2. Implement themes functionality.


1 Videos List 2 Video Playing 3 Images List 4 Context menu 5 Settings Pane With Upload And Create Functionality