web-edit

Web app for editing files in a folder.

Installation

Install this tool using pip:

pip install web-edit

Or uv:

uv tool install web-edit

Or run directly with uvx:

uvx web-edit --help

Usage

Run web-edit in a folder, or pass a path to target another folder:

uvx web-edit ~/sites/mysite

Defaults to 127.0.0.1:9000. Use -p/--port for a different port and -h/--host for a different IP, including a Tailscale address. There is no authentication; use on a trusted local network or over Tailscale.

To protect against DNS rebinding attacks, only the listening address and localhost are accepted automatically. Add -a my-machine.example.ts.net or --allowed-host my-machine.example.ts.net for another hostname or IP; repeat the option for multiple hosts. When listening on 0.0.0.0 or ::, explicitly allow the addresses or names clients will use.

Features

• Browse folders with inline previews of images smaller than 2 MB.
• Create and edit UTF-8 text files with bundled CodeMirror 6, including on mobile.
• Save explicitly, with unsaved-change warnings and checks for external edits.
• Upload multiple files with custom paths and names, individual progress bars, and retries.
• Download files, or delete files and folders with inline confirmation.

Development

uv sync --extra test
uv run web-edit .
uv run pytest

After changing frontend/app.js, rebuild and commit the bundled JavaScript:

npm ci
npm run build