지원 모델의 정품 라이선스 코드는 Buy Me a Coffee, Unifans 또는 중국어 README의 판매처([README.zh.md#在闲鱼购买])를 통해 얻을 수 있습니다.

English | 日本語 | 中文

<img width="32" src="https://raw.githubusercontent.com/Kruk2/jasna/main/assets/jasna-logo.png" /> Jasna

Jasna는 영상과 이미지의 모자이크를 복원합니다. 무료이며, 간단한 앱과 커맨드 라인을 갖추고 있고, GPU에서 실행됩니다.

목차 (Contents)

시작하기 (Start here)

• Jasna가 하는 일
• 필요한 것
• 빠른 시작 (Quick start)
• 도움말 및 커뮤니티 (Help and community)
• 프로젝트 지원하기 (Supporting the project) (지원 모델)

고급 기능 (Advanced)

• Jasna 작동 방식
• 커맨드 라인 (Command line)
• 모든 가이드 (All guides)
• 벤치마크 (Benchmarks)
• 라이선싱 (Licensing)
• 감사의 글 (Acknowledgments)

Jasna가 하는 일 (What Jasna does)

• 영상에서 모자이크를 찾아 복원하고, 나머지 부분은 건드리지 않습니다.
• 두 가지 복원 모델: 빠르고 기본적인 BasicVSR++ (무료)와 느리지만 더 상세한 LTX (지원자를 위한 모델, NVIDIA 전용).
• Segment Editor에서 미리보기를 통해 선택한 부분만 복원합니다.
• VR180 영상 및 스틸 이미지(SD 1.5, 지원자용)를 처리합니다.
• 파일을 생성하지 않고도 Video Player에서 실시간으로 복원된 영상을 시청할 수 있게 합니다.

필요한 것 (What you need)

• NVIDIA GTX 16-series / RTX 20-series 이상, 최신 드라이버 필요 (Windows에서 610+ 또는 Linux에서 580+).
  GTX 10-series 및 그 이전 모델은 작동하지 않습니다.
• 또는 AMD Radeon RX 7000/9000 (실험적).
• 경로에 중국어, 일본어, 악센트가 있거나 기타 비영어 문자가 없는 로컬 디스크의 폴더.

• NVIDIA: 사용자의 GPU는 NVIDIA의 GPU 테이블에서 컴퓨팅 능력(compute capability) 7.5 이상이어야 합니다.
• AMD: ROCm으로 지원되는 GPU (Radeon RX 7000/9000, Radeon 780M/760M/740M, Ryzen AI). Windows에서는 AMD Adrenalin 드라이버 26.8.1 이상이 필요합니다. 보조 복원(Secondary restoration) 및 LTX는 NVIDIA 전용 기능입니다.
• 디스크 형식: Windows의 경우 NTFS; Linux의 경우 ext4, Btrfs, XFS 또는 ZFS. 네트워크 디스크는 지원되지 않습니다. SSD를 사용하세요. 하드 디스크(HDD)에서는 Jasna가 시작되고 모델을 로드하는 데 시간이 오래 걸립니다.
• LTX는 NVIDIA RTX GPU, 최소 8GB VRAM 및 16GB RAM이 필요합니다. LTX에 필요한 것을 참조하세요.

빠른 시작

1. 사용자의 시스템과 GPU에 맞는 버전을 다운로드합니다.
2. 경로에 중국어, 일본어, 악센트가 있거나 기타 비영어 문자가 없는 폴더에 압축을 해제합니다.
3. 앱을 실행합니다:

• Windows: jasna.exe를 더블클릭합니다.
• Linux NVIDIA: jasna 파일을 실행합니다.
• Linux AMD: run_jasna_amd.sh를 실행합니다.

4. 비디오를 추가하고, 설정을 선택한 후 하단의 ▶ 버튼을 클릭합니다.

첫 작업은 느립니다. NVIDIA의 경우, Jasna가 사용자의 정확한 GPU에 맞는 모델을 먼저 준비합니다. 이 과정은 약 15~60분이 소요되며, 단 한 번만 진행됩니다. 다른 앱을 닫고 이 시간 동안 PC를 사용하지 마세요. Jasna를 업데이트할 때는 model_weights 폴더를 새 버전에 복사하여 다시 기다릴 필요가 없도록 하세요.

모든 설정에는 툴팁이 있습니다: ⓘ 아이콘 위에 마우스를 올려보세요. GPU 메모리(VRAM) 부족? 예를 들어 Max Clip Size를 90에서 60으로 낮추세요. 튜닝을 참조하세요.

도움말 및 커뮤니티

• App 가이드: 대기열(queue), 프리셋, 출력 이름, 비디오 플레이어 및 활성화에 대한 내용입니다.
• SLS Discord: 예시, 도움말 및 설정이 제공됩니다. Jasna에는 새 채널이 생겼습니다. 이전 게시물은 구 채널(보관됨)에 남아 있습니다. 너무 이상한 행동은 삼가주세요.
• 문제가 발생했나요? 앱 하단의 **로그(Logs)**를 클릭한 다음, 로그 파일을 저장하려면 **내보내기(Export)**를 누르세요. 도움을 요청할 때 이 파일을 첨부해 주세요.

프로젝트 지원하기

Jasna는 무료입니다. 여러분의 후원은 새로운 모델 훈련 비용, 주로 GPU 임대료로 사용됩니다. 후원자에게는 후원자 모델에 대한 라이선스 코드가 제공됩니다:

2026년 10월 14일 이전까지 $15 USD 이상을 기부한 후원자는 LTX를 무료로 받습니다.

LTX를 선택하기 전에:

• LTX 샘플들을 확인해 보세요: 1, 2, 3, 4, 5, 6, 7, 8.
  더 많은 샘플은 SLS Discord의 새 채널과 구 채널 (보관됨)에서 확인하세요.
• PC에서 **시험 모드 (속도 테스트)**로 LTX를 실행해 보세요. 무료이며, GPU가 LTX를 구동할 수 있는지 여부와 소요 시간을 보여줍니다. 비디오는 복원되지 않습니다. LTX에 필요한 것을 참조하세요.

더 많은 예시:
UNet 4x,
SD 1.5,
더 많은 SD 1.5.

지원 방법

라이선스 코드는 오직 여기서만 얻을 수 있습니다:

• Buy Me a Coffee (암호화폐도 가능)
• Unifans
• 중국의 경우: 중국어 README를 참조하세요.

Jasna, 코드 또는 수정된 파일을 판매하는 다른 사람은 사기입니다: 그들의 키는 작동하지 않으며, 그들의 파일은 PC에서 숨겨진 코드를 실행할 수 있습니다. Jasna는 GitHub에서만 다운로드하세요.

활성화 방법

1. 위의 페이지 중 한 곳에서 **라이선스 코드(License code)**를 받습니다.
2. Jasna에서 **Jasna 활성화(Activate Jasna)**를 열고 라이선스 코드를 입력한 후 **온라인으로 활성화(Activate online)**를 누릅니다.
3. 해당 PC에 인터넷이 없거나 실패하는 경우, **수동(Manual)**을 선택하고 지원 모델 활성화(Activate supporter models)를 참조하십시오.

하나의 라이선스 코드는 3대의 PC 또는 클라우드 워크스페이스에서 작동합니다. 활성화 후에는 Jasna가 오프라인으로 작동합니다. 임대 GPU는 클라우드 GPU(Cloud GPUs)를 참조하십시오.

새로운 PC로 간주되는 것: Windows의 경우 새 마더보드; Linux의 경우 새로운 Linux 설치입니다. 각각 사용자의 3개 슬롯 중 하나를 사용합니다. Windows를 재설치하거나 GPU, 디스크 또는 RAM을 변경하는 것은 해당되지 않습니다. 이 경우 동일한 라이선스 코드로 다시 활성화하기만 하면 됩니다.

Jasna 0.10의 이메일과 키를 가지고 있습니까? 더 이상 작동하지 않습니다. 구매했던 곳에서 새로운 라이선스 코드를 받으십시오.

고급 기능 (Advanced)

Jasna 작동 방식

거의 모든 것이 GPU에서 실행됩니다. 비디오 읽기부터 저장까지 모두 그렇습니다.

1. GPU에서 비디오 **디코딩(Decode)**합니다 (NVIDIA의 경우 NVDEC, AMD의 경우 AMF).
2. 각 프레임에서 모자이크를 **감지(Detect)**합니다 (기본 모델 rfdetr-v6).
3. 시간이 지남에 따라 각 모자이크를 **추적(Track)**하고 해당 프레임을 클립으로 그룹화합니다 (최대 클립 크기(Max Clip Size) 프레임까지). 클립은 장면 전환에서 끝나므로, 두 개의 다른 샷이 혼합되는 일은 없습니다.
4. 각 클립을 BasicVSR++를 사용하여 256x256 그림으로 **복원(Restore)**합니다. 클립들이 약간 겹치기 때문에 그 사이의 눈에 띄는 끊김은 없습니다.
5. 선택적 보조 복원(secondary restoration) (UNet 4x, RTX Super Res 또는 Topaz TVAI)을 통해 복원된 그림이 더 크고 선명해집니다.
6. 복원된 그림을 원본 프레임에 다시 **블렌딩(Blend)**합니다. 모자이크 영역만 변경됩니다.
7. GPU 인코더로 **인코딩(Encode)**합니다 (NVIDIA의 경우 NVENC, AMD의 경우 AMF). 오디오는 복사되며 (출력 형식이 담을 수 없는 경우에만 다시 인코딩됨) 합니다.

LTX는 다르게 작동합니다. 비디오를 4단계에 걸쳐 처리합니다: 모자이크 찾기(find mosaics), 준비(prepare), 확산 모델을 이용한 복원(restore with a diffusion model), 저장(save). 속도는 느리지만 더 사실적인 디테일을 추가할 수 있습니다. 모델 선택하기를 참조하세요.

명령줄 인터페이스 (Command line)

명령줄은 앱이 수행하는 대부분의 작업을 할 수 있지만(Video Player, LTX 시드 미리보기, 마스크 제안 또는 대화형 이미지 모드는 제외), 다음과 같습니다.

# 비디오 하나 처리하기
jasna --input input.mp4 --output output.mkv

...

jasna --help를 사용하면 모든 옵션을 확인할 수 있습니다. CLI 참고 자료를 참조하세요.

전체 가이드 (All guides)

• GUI 사용하기: 큐(queue), 프리셋(presets), 출력 이름, Video Player, 활성화(activation).
• 모델 선택하기: 탐지 모델(detection models), BasicVSR++ 또는 LTX, 보조 복원(secondary restoration), 이미지용 SD 1.5.
• 비디오 일부만 복원하기: 세그먼트 편집기(Segment Editor), 모자이크 스캔(mosaic scan), 큰 모자이크에 대해서는 LTX만 사용.
• VR180 비디오: 측면 배치(side-by-side) VR 처리가 어떻게 이루어지는지 설명합니다.
• VRAM 및 GPU 사용량 조정하기: 클립 크기, 오버랩(overlap), VRAM이 부족할 때 대처 방법.
• 고급 처리(Advanced processing): 디노이즈(denoise), 60→30 FPS, 색상 LUT, 샤프닝(sharpening), 인코더 품질, 큐 이후의 작업들.
• 스트리밍(Streaming): 브라우저 또는 Stash에서 시청하기.
• 클라우드 GPU: 임대된 GPU(RunPod, Vast)에서의 Jasna 사용법.
• CLI 참고 자료: 모든 명령줄 옵션.
• 소스 코드 실행하기: 개발자를 위한 가이드입니다. 소스 코드로부터는 무료 BasicVSR++를 사용할 수 있지만, 활성화 및 지원 모델은 공식 릴리스가 필요합니다.

벤치마크 (Benchmarks)

BasicVSR++를 사용하여 RTX 5090(Linux)에서 전체 3:22 비디오를 복원하는 시간입니다. 낮을수록 좋습니다.

사용된 GPU 메모리량 (일반/최대치, GB 단위). —는 측정하지 않았음을 의미합니다. Lada가 Jasna보다 적은 GPU 메모리를 사용합니다.

라이선스

Jasna의 공개 애플리케이션 소스는 AGPL-3.0입니다. 모델 및 번들 종속성은 자체 약관을 유지합니다. 라이선싱 및 소스 가용성, 모델 공지 및 릴리스 소스 대응 관계를 참조하십시오.

감사의 말

• Lada (Codeberg): Jasna는 Lada에서 영감을 받았으며 일부 부분은 이를 기반으로 합니다. Jasna가 사용하는 mosaic_restoration_1.2 모델은 Lada의 제작자인 ladaapp이 훈련했습니다.
• ZeLeFans: VR 감지 모델 및 모자이크 모양과 VR 투영에 대한 상세 분석을 제공해 주셔서 감사합니다.