jasna README

项目的 README,来自 github.com/Kruk2/jasna。合并为一个 markdown 文件:README.md。

The only places to get a genuine License code for the supporter models are Ko-fi, Unifans, and for China the seller in the Chinese README.

支持者模型的正版许可证码只能通过 Ko-fi、Unifans 或 闲鱼 获取。

English | 日本語 | 中文

Jasna

Jasna restores mosaics in videos and images. It is free, has a simple app and a command line, and runs on your GPU.

image

Contents

Start here

Advanced

What Jasna can do

What you need

More details
  • NVIDIA: your GPU needs compute capability 7.5 or higher in NVIDIA's GPU table. Data-center GPUs like A100, H100 and B200 don't work.
  • AMD: see the table below. UNet 4x secondary restoration is supported.
  • Disk format: NTFS on Windows; ext4, Btrfs, XFS or ZFS on Linux. Network disks are not supported. Use an SSD; on a hard disk (HDD) Jasna starts and loads models slowly.
  • LTX needs an NVIDIA RTX or AMD Radeon RX 7000/9000 GPU (AMD integrated GPUs untested), at least 8 GB VRAM and 16 GB RAM. See What LTX needs.
AMD GPU Jasna LTX
Radeon RX 9060/9070, Radeon AI PRO R9700 yes yes (Windows: beta)
Radeon RX 7600–7900, Radeon PRO W7000 yes yes (Windows: beta)
Radeon 740M/760M/780M/880M/890M, Ryzen AI Max (8050S/8060S) yes, untested yes, untested
Radeon RX 6000, Radeon PRO W6000 yes, untested no
Radeon 610M/660M/680M/820M/840M/860M yes, untested no
Radeon RX 5000, Radeon PRO W5000, RX Vega, RX 500 and older no no

Quick start

  1. Download the release for your system and GPU.
  2. Unpack it into a folder with no Chinese, Japanese, accented or other non-English characters in the path.
  3. Start the app:
    • Windows: double-click jasna.exe. On AMD, first install AMD's driver for ROCm 10.1 (26.10.41.05, download .exe) and reboot. You don't need to install ROCm.

    • Linux NVIDIA: run the jasna file.

    • Linux AMD: first install AMD's AMF video runtime once. We tested AMF 26.20:

      curl -fLO https://repo.radeon.com/amf/26.20/amf_installer_26.20.zip
      unzip amf_installer_26.20.zip
      sudo bash amf_installer_26.20.sh
      

      Accept AMD's license when prompted, then run run_jasna_amd.sh. If using Distrobox, install AMF inside the same container as Jasna.

  4. Add a video, choose settings and click the ▶ button at the bottom.

Your first job is slow. On NVIDIA, Jasna first prepares the models for your exact GPU. This takes about 15–60 minutes, only once. Close other apps and don't use the PC during this time. When you update Jasna, copy the model_weights folder to the new version, so you don't wait again. LTX may still ask to download its model again after an update. On AMD, only UNet 4x needs this preparation, on its first use.

Every setting has a tooltip: move the mouse over the ⓘ icon. Out of GPU memory (VRAM)? Lower Max Clip Size, for example from 90 to 60. See Tuning.

Help and community

Supporting the project

Jasna is free. Your support pays for training new models, mostly GPU rental. Supporters get a License code for the supporter models:

Support Models
$15 USD (Ko-fi: 14 EUR) or more in total UNet 4x: makes restored areas sharper.
SD 1.5: experimental model for still images.
$25 USD (Ko-fi: 23 EUR) UNet 4x and SD 1.5, plus
LTX: much slower than BasicVSR++, but more detail. Includes future updates of this LTX model.

Supporters who gave $15 USD or more on or before 14 October 2026 get LTX for free.

Before you choose LTX:

Where to support

License codes come only from here:

Anyone else selling Jasna, codes or modified files is a scam: their keys don't work, and their files can run hidden code on your PC. Download Jasna only from GitHub.

How to activate

  1. Support on one of the pages above. You get a License code.
  2. In Jasna, open Activate Jasna, enter the License code, choose This is my PC or Rented or shared PC and press Activate.

One License code works on 3 devices at the same time. On your own PC with a TPM 2.0 security chip (most Windows 11 PCs), Jasna then works offline. Elsewhere it needs internet while it uses supporter models. Details and help: Activate supporter models. Rented GPU: see Cloud GPUs.

Advanced

How Jasna works

Jasna finds each mosaic, follows it from frame to frame, restores only that area and puts it back. The rest of the picture is not touched. Almost everything runs on the GPU. LTX is slower but can add more real detail; see Choosing models.

Command line

The command line can do most of what the app does (not the Video Player, LTX seed previews, mask suggestions or interactive image mode).

# One video
jasna --input input.mp4 --output output.mkv

# One image
jasna --input photo.png --output restored.png

# A whole folder
jasna --input input_folder --output output_folder

jasna --help lists all options. See the CLI reference.

All guides

Benchmarks

On an RTX 5090 (Linux), Jasna 0.9.1 restored a 3:22 1080p video with BasicVSR++ in 34 seconds. Test settings, GPU memory and older versions are in the full benchmark report; newer results are in benchmarks.

Licensing

Jasna's public application source is AGPL-3.0. Models and bundled dependencies keep their own terms. See licensing and source availability, model notices and the release source correspondence.

Acknowledgments

jasna (Kruk2/jasna)

正在搜索数据库…

5.2K ·GitHub
这是什么?Jasna 是一款免费的、基于 GPU 的应用程序兼命令行工具(CLI),可以在视频和图片中找出马赛克(打码方块),并还原其下被遮住的细节,画面其余部分保持不变。
我该怎么让它运行起来?下载与你的操作系统和显卡相匹配的发行版,解压到路径中不含非英文字符的文件夹里,然后在 Windows 上启动 jasna.exe(在 Linux 上则运行 jasna/runjasnaamd.sh 脚本),添加视频后点击播放即可。
我需要什么显卡?需要 NVIDIA GTX 16 系列或 RTX 20 系列及更新的显卡,计算能力(compute capability)为 7.5 或更高;也可以通过 ROCm 使用实验性支持的 AMD Radeon RX 7000/9000 系列显卡。付费的 LTX 模型还需要至少 8GB 显存(VRAM)的 NVIDIA RTX 显卡。
第一次运行要花很长时间吗?是的。第一次运行任务时,需要为你的具体显卡准备模型,耗时 15 到 60 分钟,且只需进行一次。将 modelweights 文件夹复制到新版本中,即可避免重复这一过程。
它能在 Mac 上用吗?不能。Jasna 只提供 Windows 和 Linux 版本,并且需要 NVIDIA 或 AMD 显卡,因此不支持 macOS。
这个许可证能免费商用吗?应用程序本身的源代码采用 AGPL-3.0 许可证,但随附的还原模型和依赖项各自保留独立的许可条款。
免费模型和赞助者模型到底有什么区别?BasicVSR++ 是快速的免费还原模型;LTX 是基于扩散的赞助者模型,速度慢得多(仅支持 NVIDIA),但能增加更多真实细节。UNet 4x 可以锐化还原区域,SD 1.5 是面向静态图片的实验性模型,这两者也都是赞助者功能。
没有网络连接也能使用 Jasna 吗?可以。激活许可证代码(在线或手动)之后,Jasna 此后可完全离线运行,包括在租用的云端 GPU 上。
Jasna 能处理 VR 视频吗?可以。它专门支持并排式(side-by-side)的 VR180 视频,此外也支持普通视频和静态图片。
Jasna 的速度和同类工具相比如何?基准测试显示,在同一块 RTX 5090 上,Jasna v0.9.1 处理 720p-2160p 片段的速度比 Lada 0.11.0 快 3.4 至 4.7 倍,不过 Lada 占用的 GPU 显存明显更少。
作者
Kruk2
大小
13.8 MB
星标
5.2K
时长
9个月
提交 · 90 天