Skip to content

Releases: isdoge/Snap2HTML-py

v1.0.1

Choose a tag to compare

@github-actions github-actions released this 17 Sep 09:13
458c8f2
fix: grant workflow contents write permission to create releases (#2)

The GITHUB_TOKEN default is read-only, so softprops/action-gh-release
failed with "Resource not accessible by integration" on tag builds.

Snap2HTML-py v1.0.0

Choose a tag to compare

@isdoge isdoge released this 06 Sep 00:01

首个正式版本 / 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 扫描生成 + --serve Web 工作台:服务端目录浏览器、实时进度、结果在线查看 / 下载、多目录合并、清单上传参与合并。
    CLI generation plus a --serve web 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 and f:/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 the window.snap console 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 (commit 66fbcf4, 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.