[go: up one dir, main page]
Catalogue no. 1Software for looking at foldersPage 1
okfs is starting
in this tab

Fig. 1. okfs, running on the screen above. It is the real program, compiled for this page; click into it and press j, or Ctrl K to search.

Item 0.1.0

A file browser for any folder you can reach.

Run okfs in a folder and your browser opens on it. The list sits on the left. The file under the cursor shows beside it as soon as the cursor lands, so holding j flips through a folder of photos, PDFs or video.

  • Runs onLinux, macOS
  • Ships asone binary, about 18 MB
  • Serves at127.0.0.1:8080
  • Writes filesonly when turned on
FreeMIT licence
Open the live demo okfs, the whole page
Fig. 2
Measured here

Measured in your browser, a moment ago.

When this page opened it unpacked okfs's index, compiled it and read a folder of about 300,000 names. These are its own timings.

okfs's timings in this tab
Index engine, WebAssembly-
Unpacked-
Compiled-
Entries in the folder-
Read all of them-

    Each search ranks every name in the folder. The times are this tab's, with okfs compiled to WebAssembly.

    Fig. 3
    Finishes

    Available in eleven finishes, light and dark.

    Each theme is one CSS file. Pick one with --theme, or write your own.

      Plate: the tokyo-night finish.

      In the box

      What okfs does

      01Previews
      Pictures, video, sound, PDFs, Markdown, code, CSV, JSON, zip files and web pages, each shown as itself.
      02Search
      Ctrl K finds any name in the tree. The query lives in the address, so a shared link keeps it.
      03Columns
      A folder under the cursor shows what is in it, and the columns slide as you go in and out.
      04Live
      A file added, removed or rewritten shows at once, without a reload.
      05Your phone
      okfs --bind 0.0.0.0 --qr prints a QR code for another device on the network.
      06Self-contained
      The page is compiled into the binary. Nothing is fetched from another site.
      Comparison

      How okfs compares

      okfs is for looking at a folder. It is read only unless writes are turned on, and it has no accounts, on purpose: for uploads of very large files that resume, use copyparty; for a file manager with users, File Browser Quantum.

      okfs beside python -m http.server, miniserve, dufs and copyparty
      okfspython -m http.serverminiservedufscopyparty
      Default addressloopback onlyall interfacesall interfacesall interfacesall interfaces
      Beyond loopbacksecret linknonebasic auth, optionalbasic or digest auth, optionalaccounts
      Writesnone unless turned on: upload, edit and delete, each behind a flagnoneupload, optionalupload, edit, move and delete, each optionalupload, per account
      Previewsimages, video, audio, PDF, Markdown, code, CSV, JSON, zip, HTMLnonenonenonethumbnails, audio spectrograms
      Search of the whole treeinstant, in memorynonenoneyesyes, indexed
      Live updatesyesnonenonenonenot checked
      TLSyes, optionalsince Python 3.14yesyesyes

      no tool is ahead of okfsthis tool is ahead of okfs

      This is how each tool read on 2026-10-21, from its documentation. Check the project you are comparing before you rely on a cell.

      Questions

      Questions

      How do I browse a folder in my browser?

      Run okfs in it. It serves the folder at http://127.0.0.1:8080 and opens your browser on it.

      Is okfs an alternative to python -m http.server or miniserve?

      Yes, for looking at files. It adds previews, a search of the whole tree and live updates, and stays read only unless you turn writes on.

      How do I open files from my computer on my phone?

      okfs --bind 0.0.0.0 --qr prints a QR code with a secret link. Scan it on a phone on the same network.

      Can visitors upload, edit or delete files?

      Only when you turn it on. --allow-upload adds files and folders and never replaces one, --allow-edit changes text files in place, and --allow-delete deletes. Each is off by default.

      Does okfs need Docker, a database or an account?

      No. It is one binary with the page inside it.

      Does it run on Windows?

      Not yet. It runs on Linux and macOS.

      Order form

      Install

      Clip and paste into a terminal.

      No postage. Tick one.

      How to install
      brew install jrnxf/tap/okfs
      okfs ~/photos

      On a Mac or Linux. brew upgrade okfs updates it.