Thanks to visit codestin.com
Credit goes to github.com

Skip to content

offline-ant/local-html

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

local-html – Use HTML/JS/CSS to build a GUI for your local files

Note: This is just a quick Sunday night POC hack. Only tested on Linux + Firefox — should work on other OSes + Chrome.

Quickstart

  • git clone https://github.com/offline-ant/local-html && cd ./local-html
  • PATH="$PATH:$PWD" ./example-editor.html ← yes, execute the HTML file
  • Alternatively, run node ./local-html ./example-editor.html

./example-editor.html was LLM-generated after providing ./example.ini as an example config. The local-html executable allows it to securely read/write data in the folder containing the .html file.

Overview

local-html is a single-file executable that requires no dependencies (except Node.js) and is secure against data exfiltration.

It lets you read and update configuration files with an easy-to-build/generate UI using HTML/JS/CSS.

  • JavaScript gets read access (via fetch) within the directory containing the .html or .local-html file.
  • JavaScript cannot write files without explicit verification.
  • HTML/JS/CSS cannot contact the network.

Why

  • You have a configuration file (JSON/INI/CSV/etc.) that people need to update with valid values.
  • Many people are intimidated by raw text files, so updates don’t happen.
  • Building/installing a cross-platform GUI or hosting a web server is its own can of worms.

This script lets you create a GUI in minutes with HTML/JS/CSS — no servers, no frameworks.

Operations

When you run local-html:

  • It launches a browser with a custom profile and a SOCKS5 proxy pointing to localhost:10641.
  • Read requests are mapped to the current directory.
  • Write requests (POST) trigger a second tab with a built-in diff viewer to compare old vs. new content.
  • On save/reject, the browser closes.

Current Limitations / Bugs

  • Only supports text files.
  • Only one instance can run at a time.
  • Only one file can be updated per session.
  • No toggle to disable the verification tab (even if you trust the HTML to make sane edits).
  • Requires Node.js for no good reason.

License

I will not be updating this.

Use it however you want.

MIT / CC0 – 2025 – ant-offline

About

Use HTML/JS/CSS to create GUIs for your local files.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors