8000 GitHub - Kruk2/jasna: Video restoration tool · GitHub
[go: up one dir, main page]

Skip to content
Kruk2Public

About

Video restoration tool

Resources

Stars

5.1k stars

Watchers

29 watching

Forks

Repository files navigation

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

  • Restore mosaics in videos. Only the mosaic areas change. Quick start
  • Pick fast or detailed. BasicVSR++ is fast and free; LTX is slower with more detail (supporters). Choosing models
  • Test LTX for free. Trial mode shows how fast LTX runs on your PC. LTX options
  • Use LTX only where it helps. Big mosaics get LTX, the rest BasicVSR++. Mosaic scanning
  • Restore only some scenes. Choose ranges with a preview in the Segment Editor. Segment Editor
  • Pause and continue. Long LTX jobs keep their progress. Pause and continue
  • Sharpen restored areas. UNet 4x, RTX Super Res or Topaz. Secondary restoration
  • Upscale the whole video to 1080p, 1440p or 4K. Upscale
  • Smoother motion. Double the frame rate on RTX 40 and 50. Frame generation
  • VR180 videos, side by side or top/bottom. VR180
  • Still images with SD 1.5 (supporters). Images
  • Watch while it restores, in the app or in a browser. Video Player, Streaming
  • Many videos at once. Queue, presets and an action when the queue is done. Using the GUI
  • Output extras. Color LUT, sharpening, 60→30 FPS, play while it's being made. Advanced processing
  • Command line and rented GPUs. CLI, Cloud GPUs

What you need

  • NVIDIA GTX 16-series / RTX 20-series or newer, with a recent driver (610+ on Windows, 580+ on Linux). GTX 10-series and older don't work.
  • Or AMD Radeon RX 6000 or newer (experimental). RX 7000/9000 are tested; RX 6000 is untested.
  • A folder on a local disk, with no Chinese, Japanese, accented or other non-English characters in its path.
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

  • App guide: the queue, presets, output names, the Video Player and activation.
  • Problem? Click Logs at the bottom of the app, then Export to save a log file. Attach it when you ask for help.

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:

  • Run LTX in Trial mode (speed test) on your PC. It is free and shows if your GPU can run LTX and how long it takes. The video is not restored. See What LTX needs.

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

  • Using the GUI: queue, presets, output names, Video Player, activation.
  • Choosing models: detection models, BasicVSR++ or LTX, secondary restoration, SD 1.5 for images.
  • Restoring only parts of a video: Segment Editor, mosaic scan, LTX only for big mosaics.
  • VR180 videos: how side-by-side and top/bottom VR are handled.
  • Tuning VRAM and GPU usage: clip size, overlap, what to do when VRAM runs out.
  • Advanced processing: denoise, 60→30 FPS, color LUT, sharpening, upscaling the whole video, encoder quality, settings saved in the video, actions after the queue.
  • Streaming: watch in the browser or in Stash.
  • Cloud GPUs: Jasna on a rented GPU (RunPod, Vast).
  • CLI reference: all command line options.
  • Running from source: for developers. From source you can use the free BasicVSR++; activation and supporter models need the official release.

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

  • Lada: Jasna is inspired by Lada and in some places based on it. The mosaic_restoration_1.2 model used by Jasna was trained by ladaapp, the author of Lada.
  • ZeLeFans: for the VR detection model and the detailed analysis of mosaic shapes and VR projection.

About

Video restoration tool

Resources

Stars

5.1k stars

Watchers

29 watching

Forks

Releases

Packages

Contributors

Languages

0