Leaf IndexA file list.
Without a server.
Leaf Index turns a directory into a small, linked HTML page. One Python script, no packages, and source you can inspect.
Python 3.9+Standard library onlyMIT licenseterminal
python3 leafindex.py ./notes --output ./notes/index.htmlFrom a folder to a readable page
Useful for a small collection of public notes, handouts, or project files. The output is an ordinary HTML file with links to the files you selected.
A directoryYour existing files
→leafindex.pyRead names · escape HTML
→index.htmlOpen locally or serve
01 / START
Make your first index
Download the script, choose a small directory, and open the generated page.
02 / EXAMPLESTry a real sample
See a generated page and examples for nested folders and suffix filters.
03 / REFERENCEChoose what to include
Set the title, filter extensions, and control recursive depth.
04 / DETAILSUnderstand the boundaries
Hidden entries and symlinks are skipped. Existing output files are protected.
A list, not a backup. The generated page links to your files; it does not copy or embed them. Keep the files alongside the page when sharing it.