English | 日本語 | 中文

Jasna is a JAV mosaic restoration tool with a simple GUI, a CLI, a GPU-only processing pipeline, NVIDIA TensorRT and experimental AMD ROCm support, optional secondary restoration models, still-image restoration, and streaming support.

It is inspired by, and in some places based on, Lada. The mosaic_restoration_1.2 restoration model used by Jasna was trained by ladaapp, the Lada author.

Jasna is free. Supporters get a key that unlocks the extra models trained for this project: the unet-4x secondary upscaler and the experimental SD 1.5 image restoration model. See Supporting the project.

• What Jasna Does
• Community
• Requirements
• Quick Start
• First Run
• Learn More
• Benchmarks
• Supporting the Project
• TODO

• Restores mosaics in video files.
• Restores mosaics in still images with the experimental SD 1.5 image model.
• Detects mosaics with RF-DETR models by default; Lada and ZeLeFans YOLO models are also available.
• Processes side-by-side VR180 videos per eye, with optional fisheye reprojection for detection and restoration.
• Reduces clip-boundary flicker with temporal overlap and crossfade.
• Can further improve quality with optional secondary restoration models — unet-4x, RTX Super Resolution, or Topaz Video AI — which sharpen restored regions, especially large mosaics, close-ups, and 4K video.
• Can stream restored video to the built-in browser player or a supported Stash fork.

Join the SLS Discord for examples, support, and settings discussion. Please don't be too weird.

• An NVIDIA GTX 16-series / RTX 20-series or newer GPU. GTX 10-series and older cards (GTX 1050/1060/1070/1080) won't work. Not sure about yours? Check NVIDIA's GPU table — compute capability 7.5+ is required.
• Nvidia driver 610 or newer on Windows, 580 or newer on Linux.
• AMD support is experimental and needs a ROCm-supported GPU.
• Install Jasna into a folder whose path contains only English letters and numbers.

Jasna manages VRAM automatically: when it runs low, waiting frames are temporarily moved to system RAM. No configuration needed.

1. Download the release package for your OS and GPU vendor.
2. Unzip it into a folder with only English characters in the path.
3. Start the app:
   • Windows: double click jasna.exe.
   • Linux NVIDIA: run the jasna file.
   • Linux AMD: run run_jasna_amd.sh.
4. Add a video or image, choose settings, and start processing.

Every setting in the GUI has a tooltip — hover the ⓘ icon next to it. The GUI guide tours the rest: queue reordering, presets, output patterns, and more.

Prefer the command line?

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

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

# Whole folder
jasna --input input_folder --output output_folder

Run jasna --help for all options, or read the CLI reference.

The first run is slow because Jasna prepares GPU-specific files for your exact card. On NVIDIA this usually takes 15-60 minutes; on AMD the preparation is much shorter. It only happens once — the results are cached in model_weights and reused on every later run. You can copy them from an older Jasna version to a newer one.

Close other applications, including browsers, and avoid using the PC while this runs.

If you run out of VRAM during processing, reduce max clip size first, for example from 180 to 60. See Tuning VRAM and GPU usage.

• Using the GUI — the queue (drag & drop, reordering), presets, output patterns and file conflicts, and other easy-to-miss features.
• Choosing models — which detection model to pick, sharper results with secondary restoration (unet-4x / RTX Super Resolution / Topaz), and SD 1.5 still-image restoration.
• Restoring only parts of a video — the Segment Editor, built-in mosaic scanning, suggesting better masks, and the --segments CLI flag.
• VR180 videos — how Jasna handles side-by-side VR and when to use fisheye mode.
• Tuning VRAM and GPU usage — clip size, temporal overlap, model compilation, and what to do when VRAM runs out.
• Advanced processing — denoising, 60→30 FPS export, color LUTs, custom encoder settings, and post-export actions.
• Streaming — watch restored video on the fly in your browser or through Stash.
• CLI reference — every command-line option, including output templates, encoder settings per codec, and post-export actions.
• Running from source — developer setup and build notes.

RTX 5090 + i9 13900k:

Support pays for training extra models, mainly GPU rental and compute time for larger datasets. Supporters get a key that unlocks:

• unet-4x secondary upscaler for sharper 256->1024 restoration.
• SD 1.5 image restoration, the experimental still-image model.

Example results:

• unet-4x / secondary restoration examples on SLS Discord
• SD 1.5 image restoration examples on SLS Discord and more SD 1.5 examples

How to get a key:

1. Contribute $15 USD or more in total, across any number of contributions and at any time.
2. After your contribution is processed, your supporter key is sent automatically:
   • Unifans: sent by platform message. There might be a slight delay.
   • Buy Me a Coffee, including crypto: sent to the email or handle used for the contribution. The key is tied to that email or handle.

Current TODO:

• SeedVR support?
• Continued performance and VRAM improvements.
• Better restoration model.
• Better detection model.