Repository navigation
Releases: isdoge/Snap2HTML-py
Release list
v1.0.1
Snap2HTML-py v1.0.0
首个正式版本 / First stable release.
Snap2HTML-py 是原版 Snap2HTML(C#/WinForms)的跨平台重实现:把硬盘上的目录结构“拍一个快照”,生成单个可搜索的 HTML 清单文件。
Snap2HTML-py is a cross-platform re-implementation of the original Snap2HTML (C#/WinForms): snapshot a directory tree into a single searchable HTML listing.
功能 / Features
-
CLI 扫描生成 +
--serveWeb 工作台:服务端目录浏览器、实时进度、结果在线查看 / 下载、多目录合并、清单上传参与合并。
CLI generation plus a--serveweb workbench: server-side directory browser, live progress, view / download results in the browser, multi-directory merge, and uploading listings from other machines to merge. -
零依赖查看器模板(产物 ~50KB 单文件):树形导航、
*/?通配符与f:/d:/>前缀搜索、列排序、纯文本 / CSV / JSON 导出、深浅主题、中英界面、多根清单。
Zero-dependency viewer template (~50KB single-file output): tree navigation,*/?wildcard andf:/d:/>prefix search, column sorting, plain text / CSV / JSON export, dark / light themes, zh / en UI, and multi-root listings. -
纯 Python 3.8+ 标准库,无第三方依赖,Windows / Debian / Ubuntu / macOS 直接运行。
Pure Python 3.8+ standard library with no third-party dependencies; runs directly on Windows / Debian / Ubuntu / macOS.
兼容性 / Compatibility
-
生成结果的数据格式(V2)与上游完全兼容,
window.snap控制台 API 保持一致,详见 RedeMeDev.txt。
The V2 data format is fully compatible with upstream and thewindow.snapconsole API is unchanged — see RedeMeDev.txt. -
查看器模板与数据格式基于上游 Snap2HTML v2.52(commit
66fbcf4,2026-01-05);本版本不含任何原版 C# 代码。
The viewer template and data format are based on upstream Snap2HTML v2.52 (commit66fbcf4, 2026-01-05); this release contains none of the original C# code.
用法 / Usage
# 生成清单 / generate a listing
python snap2html.py /path/to/dir -o listing.html
# 启动 Web 工作台 / start the web workbench
python snap2html.py --serve --host 0.0.0.0 --port 8765在线演示 / Live demo: https://snap2html-demo.vercel.app
致谢 / Credits
- 原版 Snap2HTML / Original Snap2HTML: rlv-dan/Snap2HTML(RLVision,GPL-3.0)
- 合并功能思路参考 / Merge feature inspired by: nilaoda/Snap2HTMLMerger(GPL-3.0)
- 本项目沿用 GPL-3.0 许可证 / Licensed under GPL-3.0 — see LICENSE.