webmanager-mvp/finder_commander/README.md

Finder Commander

Lokale webapp die aanvoelt als een Midnight Commander-achtige file manager voor macOS/Linux home directories.

Wat zit erin

• twee panelen naast elkaar
• actieve panel met duidelijke focusrand
• keyboard shortcuts:
  • Tab wissel panel
  • ↑ / ↓ / PgUp / PgDn navigatie
  • Enter open map of view bestand
  • Backspace omhoog
  • Space markeer bestand/map
  • F3 view
  • F4 edit
  • Shift+F4 nieuw bestand
  • F5 copy naar ander panel
  • F6 move naar ander panel
  • Shift+F6 rename
  • F7 nieuwe map
  • F8 delete naar ~/.Trash
  • Ctrl+H toggle verborgen bestanden
  • Ctrl+R refresh
  • Alt+X focus command line
• command line onderin met beperkte veilige commando's:
  • cd <path>
  • mkdir <name>
  • touch <name>
  • select <glob>
  • help
• upload per panel
• viewer voor tekst en afbeeldingen
• editor voor tekstbestanden
• padbeveiliging: alles blijft binnen ~

Starten

./run-local.sh

Het script kiest automatisch python3.14 als dat aanwezig is. Bestaat er al een .venv met een andere Python minor-versie, dan wordt die automatisch opnieuw aangemaakt.

Open daarna:

http://127.0.0.1:8765/

Python 3.14-notes

Deze build is opgeschoond voor Python 3.14.x:

• minimale Uvicorn-installatie (uvicorn i.p.v. uvicorn[standard])
• geen optionele C-extensies nodig om te starten
• dependencies ondersteunen Python 3.14

Opmerking

Dit is een MC-like v1, geen volledige Midnight Commander clone. Bewust niet ingebouwd:

• shell/subshell uitvoering
• chmod/chown dialogs
• archive browsing als directory
• remote FTP/SFTP panels
• diff/compare directories