Kruk2/jasna

Video restoration tool

它是什么 — Jasna 是一款免费的桌面程序,可以检测视频和图像中的马赛克模糊区域并恢复它们,同时保持其他内容不变。它提供图形界面和命令行,并在 GPU 上运行,而不是 CPU。

它的功能

  • 检测视频中的马赛克并恢复,而不改变画面的其他部分。
  • 通过带有预览的分段编辑器,仅恢复选定的部分。
  • 可以实时播放已恢复马赛克的视频,无需保存文件。
  • 支持 VR180(并排)视频,以及(对于支持者)静态图像。

两种恢复模型

  • BasicVSR++ — 快速,对所有人免费。
  • LTX — 较慢,增加更多细节,但仅限支持者且仅限 NVIDIA GPU。

硬件要求

  • NVIDIA GTX 16 系列 / RTX 20 系列或更新版本,配备较新的驱动程序(Windows 上为 610+,Linux 上为 580+);GTX 10 系列及更旧版本不适用。
  • 或者 AMD Radeon RX 7000/9000,标记为实验性。
  • 您的项目文件夹路径不得包含中文、日文、带重音符号或其他非英文字符。
  • LTX 特别需要至少 8 GB 显存和 16 GB 内存的 NVIDIA RTX GPU。
  • 使用 SSD,而不是机械硬盘,否则启动和模型加载会变慢。

快速开始

  1. 为您的系统和 GPU 下载对应版本。
  2. 将其解压到仅包含英文字符的路径中。
  3. 启动(Windows 上为 jasna.exe,Linux NVIDIA 上为 jasna,Linux AMD 上为 run_jasna_amd.sh)。
  4. 添加视频,选择设置,然后按播放(▶)按钮。

第一次运行较慢:在 NVIDIA 上,Jasna 会花费大约 15–60 分钟为您的特定 GPU 准备模型,仅一次。更新到新版本时,请复制 model_weights 文件夹以避免重复此过程。如果 GPU 内存不足,请降低 Max Clip Size(例如,从 90 改为 60)。

内部工作原理 几乎所有操作都在 GPU 上运行,分为 7 个步骤:

  1. 在 GPU 上解码视频(NVIDIA 上为 NVDEC,AMD 上为 AMF)。
  2. 逐帧检测马赛克(默认模型 rfdetr-v6)。
  3. 随时间跟踪每个马赛克,将帧分组为片段(最多 Max Clip Size),并在场景变化处剪切片段。
  4. 使用 BasicVSR++ 将每个片段恢复为 256×256 的图像,并带有轻微重叠以避免可见的跳跃。
  5. 可选的二次恢复(UNet 4x、RTX Super Res 或 Topaz TVAI)使结果更大更清晰。
  6. 将恢复的区域混合回原始帧 — 仅马赛克区域发生变化。
  7. 使用 GPU 编码器进行编码;除非输出格式不支持,否则音频会被复制。

LTX 采用不同的、较慢的路径:4 个阶段(检测、准备、使用扩散模型恢复、保存),质量选项从 Standard 到 Top(约为 Standard 的 5 倍慢)。

命令行 — 可以完成应用程序的大部分功能(但不包括视频播放器、LTX 种子预览、掩码建议或交互式图像模式)。示例:

jasna --input input.mp4 --output output.mkv
jasna --input photo.png --output restored.png
jasna --input input_folder --output output_folder

使用 jasna --help 查看所有选项。

支持者模型(付费) — Jasna 本身是免费的。支持项目用于支付训练费用,主要是 GPU 租赁。支持者会获得一个许可证代码:

  • $15+ 总计:UNet 4x(锐化恢复区域)和 SD 1.5(用于静态图像的实验性模型)。
  • $25:上述所有内容加上 LTX(仅限 NVIDIA),包括未来的 LTX 更新。
  • 在 2026 年 10 月 14 日或之前捐赠 $15+ 的人可免费获得 LTX。

许可证代码仅通过 Buy Me a Coffee、Unifans 或(对于中国)中文 README 中链接的卖家出售。任何其他人出售 Jasna、代码或修改文件的行为均被视为诈骗。一个代码可在 3 台 PC 或云工作区上使用;激活后,Jasna 可离线工作。来自 0.10 版本的旧代码不再有效。

基准测试 — 在 RTX 5090(Linux)上,使用 BasicVSR++ 恢复完整的 3:22 视频:720p H.264 用时 0:32,1080p 用时 0:34,2160p 用时 1:03。这大约比同类工具 Lada 快 3.4–4.7 倍,并且在 v0.9.1 中,1080p 的 GPU 内存使用量降至约 4.8 GB 典型 / 5.6 GB 峰值。

许可 — 公共应用程序源代码为 AGPL-3.0。模型和捆绑的依赖项保留其各自的条款。

致谢 — Jasna 的灵感来自并部分基于开源工具 Lada;它使用的 mosaic_restoration_1.2 模型由 Lada 的作者训练。VR 检测模型由 ZeLeFans 贡献。

相关

  • 项目
  • 项目
  • 项目
  • 项目