waifu2x-ncnn-vulkan 20250915는 작은 일러스트와 사진을 확대하면서 노이즈를 줄이는 무료 오픈 소스 명령줄 프로그램입니다. ZIP을 풀고 터미널에서 입력·출력 파일, 노이즈 단계와 배율을 지정해 사용합니다.
공식 최신 릴리스의 운영체제별 ZIP, 직접 실행한 도움말과 2배 확대 결과를 기준으로 포터블 설치, 모델 선택, GPU·타일 설정, Vulkan·모델 파일 오류 해결까지 설명합니다.
waifu2x-ncnn-vulkan은 어떤 프로그램인가요?
waifu2x 모델을 ncnn과 Vulkan으로 실행해 JPG·PNG·WebP를 확대하고 노이즈를 줄이는 명령줄 도구입니다.
실행 파일과 모델이 ZIP에 포함되며 CUDA나 Caffe 런타임 없이 사용할 수 있습니다.
waifu2x-ncnn-vulkan 20250915 실제 도움말과 2배 확대 결과
첫 화면은 공식 Windows 실행 파일의 실제 -h 옵션과 NVIDIA GPU에서 -n 2 -s 2 명령을 완료한 터미널입니다. 두 번째는 직접 만든 160×100 입력과 실제 생성된 320×200 출력의 크기를 비교한 결과입니다.
| 입력 | JPG·PNG·WebP |
|---|---|
| 노이즈 | -1·0·1·2·3 |
| 배율 | 1·2·4·8·16·32 |
| 모델 | cunet·anime·photo |
| 가속 | Vulkan GPU·CPU |
| 라이선스 | MIT |
waifu2x-ncnn-vulkan으로 이미지 한 장을 2배 확대하는 순서
Windows에서는 `waifu2x-ncnn-vulkan-20250915-windows.zip`을 받아 원하는 폴더에 압축을 풉니다. 설치 마법사가 없는 포터블 명령줄 프로그램이므로 EXE만 따로 옮기지 말고 `models-cunet`, `models-upconv_7_anime_style_art_rgb`, `models-upconv_7_photo` 폴더와 DLL을 같은 위치에 둡니다.
PowerShell이나 명령 프롬프트에서 압축을 푼 폴더로 이동하고 `waifu2x-ncnn-vulkan.exe -i input.jpg -o output.png -n 2 -s 2`를 실행합니다. 작업이 끝나면 output.png의 가로·세로가 원본의 두 배인지, 윤곽선과 작은 글자가 과하게 뭉개지지 않았는지 직접 비교합니다.
- 운영체제에 맞는 20250915 ZIP을 받습니다.
- ZIP 전체를 새 폴더에 풉니다.
- 터미널에서 프로그램 폴더로 이동합니다.
- 입력 이미지를 JPG·PNG·WebP 중 하나로 준비합니다.
- -n 2 -s 2 명령으로 노이즈 제거와 2배 확대를 실행합니다.
- 출력 파일의 픽셀 크기와 세부 표현을 확인합니다.
- 사진·일러스트 특성에 맞춰 모델과 노이즈 값을 다시 조정합니다.
waifu2x-ncnn-vulkan은 어떤 프로그램인가요?
waifu2x-ncnn-vulkan은 waifu2x 이미지 확대 모델을 ncnn 추론 프레임워크와 Vulkan으로 실행하는 무료 오픈 소스 명령줄 도구입니다. Intel·AMD·NVIDIA GPU와 Apple Silicon에서 동작하며 작은 일러스트, 애니메이션 이미지와 사진을 확대하면서 노이즈를 줄일 수 있습니다.
버튼과 미리보기가 있는 GUI가 아니라 터미널에서 입력 파일, 출력 파일, 노이즈 단계와 배율을 지정합니다. ZIP에 실행 파일과 모델이 포함되어 있어 CUDA나 Caffe 런타임을 따로 설치하지 않아도 됩니다.
현재 릴리스 20250915와 무료 배포 확인
공식 최신 릴리스는 2025년 9월 15일 공개된 Release 20250915입니다. 이 릴리스는 ncnn, libjpeg-turbo와 zlib-ng를 갱신했고 Windows, macOS, Linux용 ZIP을 제공합니다. 프로젝트와 포함 코드는 MIT 라이선스로 배포됩니다.
Windows ZIP은 35,497,352바이트이며 GitHub가 공개한 SHA-256은 `7425be94b94e4c8f37a1e433ac0e0100c43790e2c37418f4b65d8235adfbdc87`입니다. 같은 값을 로컬에서 다시 계산하고 ZIP을 풀어 실제 EXE, DLL과 세 모델 폴더를 확인했습니다.
Windows·macOS·Linux 파일 선택과 압축 해제
Windows는 이름 끝이 `windows.zip`, Mac은 `macos.zip`, Linux는 `linux.zip`인 파일을 고릅니다. 세 ZIP은 모두 실행 파일과 필요한 모델을 함께 제공하므로 GitHub의 Source code ZIP을 받으면 안 됩니다. 소스 코드는 직접 빌드할 때만 사용합니다.
Windows 탐색기에서 ZIP을 오른쪽 클릭해 모두 압축 풀기를 선택합니다. 경로가 지나치게 길거나 한글·특수문자가 포함돼 모델을 못 찾는 경우를 줄이려면 `C:\Tools\waifu2x`처럼 짧은 폴더를 사용합니다. 제거할 때는 실행 중인 터미널을 닫고 이 폴더를 삭제하면 됩니다.
실제 터미널 화면과 도움말 읽기
실제 20250915 실행 파일에서 `-h`를 실행하면 입력 `-i`, 출력 `-o`, 노이즈 단계 `-n`, 배율 `-s`, 타일 크기 `-t`, 모델 경로 `-m`, GPU `-g`, 스레드 `-j`, TTA `-x`, 출력 형식 `-f`가 표시됩니다. 프로그램 창이나 트레이 아이콘은 따로 나타나지 않습니다.
명령이 끝나면 터미널에 선택된 GPU 이름과 큐, 연산 기능이 표시되고 프롬프트가 돌아옵니다. 직접 시험한 160×100 PNG는 `-n 2 -s 2`로 320×200 PNG가 생성됐습니다.
입력·출력 경로를 정확히 쓰는 방법
가장 간단한 명령은 `waifu2x-ncnn-vulkan.exe -i input.png -o output.png -n 2 -s 2`입니다. 이미지가 다른 폴더에 있으면 전체 경로를 쓰고, 경로에 공백이 있으면 `"C:\My Images\input.png"`처럼 큰따옴표로 묶습니다.
입력과 출력 경로에는 파일 하나뿐 아니라 폴더도 지정할 수 있습니다. 폴더 전체를 처리할 때는 원본 폴더와 다른 빈 출력 폴더를 사용해 덮어쓰기를 피하고, 먼저 복사본 두세 장으로 모델과 옵션을 확인합니다.
노이즈 단계 -n과 확대 배율 -s 고르기
`-n -1`은 노이즈 제거 없이 확대하고 0·1·2·3은 단계가 높을수록 더 강하게 노이즈를 줄입니다. 깨끗한 원본은 -1이나 0부터, JPEG 압축 자국이 보이는 작은 이미지는 1이나 2부터 비교합니다. 3은 윤곽과 질감이 지나치게 매끈해질 수 있습니다.
`-s 2`는 가로·세로를 두 배로 만듭니다. 4·8처럼 큰 배율은 처리 시간과 메모리가 크게 늘고 작은 글자나 선이 실제 정보처럼 복원되는 것은 아닙니다. 2배 결과를 먼저 확인한 뒤 필요할 때만 배율을 올립니다.
일러스트와 사진 모델 선택
기본 `models-cunet`은 애니메이션 계열 이미지와 일반적인 waifu2x 작업에 사용합니다. `-m models-upconv_7_anime_style_art_rgb`는 RGB 애니메이션 스타일 그림, `-m models-upconv_7_photo`는 사진에 맞춘 모델입니다.
같은 원본을 세 모델로 처리한 뒤 머리카락·선화·피부 그라데이션·사진 질감을 100% 확대율에서 비교합니다. 모델이 원본에 없는 세부를 정확히 복원한다고 단정하지 말고, 과도한 샤프닝이나 반복 무늬가 생겼는지 확인합니다.
JPG·PNG·WebP 출력 형식 정하기
`-f png`는 손실 없이 저장되어 선화와 투명 배경을 확인하기 좋습니다. WebP는 보통 파일 크기가 더 작고 이 프로그램에서는 무손실로 인코딩됩니다. JPG는 사진 공유에는 편하지만 다시 압축되므로 세부 비교용 첫 결과는 PNG가 안전합니다.
출력 확장자를 생략하거나 입력과 다르게 쓸 때는 `-f` 값과 파일 이름을 함께 확인합니다. 투명 배경이 필요한 그림은 PNG 또는 WebP로 내보내고 결과를 투명 격자 배경에서 다시 열어 가장자리 색 번짐을 봅니다.
GPU 선택과 CPU 실행
`-g`는 사용할 GPU를 지정합니다. 기본값은 자동 선택이며 0, 1, 2처럼 장치 번호를 줄 수 있습니다. `-g -1`은 CPU 실행입니다. 여러 GPU를 쓰려면 쉼표로 장치를 지정할 수 있지만 타일 크기와 스레드 설정도 함께 조정해야 합니다.
터미널에 기대한 GPU 이름이 표시되는지 확인합니다. 내장 GPU로 잘못 선택되거나 Vulkan 오류가 나면 그래픽 드라이버를 최신 공식 버전으로 갱신하고 `-g 0` 또는 `-g -1`을 비교합니다. CPU는 호환성 확인에는 유용하지만 큰 이미지에서는 오래 걸릴 수 있습니다.
메모리 부족과 tile-size 오류 해결
큰 이미지에서 중단되거나 GPU 메모리 오류가 나면 `-t 128`, `-t 64`처럼 타일 크기를 낮춥니다. 타일은 이미지를 나눠 처리해 메모리 사용을 줄이지만 지나치게 작으면 처리 시간이 늘 수 있습니다. 기본 0은 자동 선택입니다.
여러 작은 파일을 처리할 때는 `-j 4:4:4`, 큰 파일은 `-j 2:2:2`처럼 읽기·처리·저장 스레드를 시험할 수 있습니다. 먼저 기본 1:2:2로 성공 여부를 확인하고, 속도보다 메모리 안정성을 우선해 한 항목씩 바꿉니다.
모델 파일을 찾지 못한다는 오류가 날 때
`failed to load model`과 비슷한 오류가 나오면 EXE만 복사하지 않았는지 확인합니다. `models-cunet` 등 모델 폴더와 내부 param·bin 파일을 원래 구조 그대로 둬야 합니다. 터미널의 현재 폴더도 EXE가 있는 위치로 맞춥니다.
다른 위치의 모델을 쓰면 `-m` 뒤에 정확한 폴더 경로를 지정하고 공백이 있으면 큰따옴표로 묶습니다. Source code ZIP에는 바로 실행할 Windows 바이너리와 모델 묶음이 없으므로 릴리스의 Windows ZIP을 다시 받습니다.
Vulkan 장치 오류와 즉시 종료 문제
실행 직후 `no vulkan device`나 드라이버 관련 오류가 나오면 Intel·AMD·NVIDIA 공식 사이트에서 그래픽 드라이버를 갱신하고 재부팅합니다. 원격 데스크톱이나 가상 머신에서는 Vulkan 장치를 노출하지 않아 실패할 수 있으므로 로컬 세션이나 CPU `-g -1`을 시험합니다.
명령 창을 더블클릭하면 오류를 읽기 전에 닫힐 수 있습니다. 먼저 PowerShell이나 명령 프롬프트를 연 뒤 프로그램 폴더로 이동해 명령을 입력하면 오류 문구가 남습니다. `-h`가 표시되는지부터 확인하고 입력 파일 한 장으로 범위를 줄입니다.
결과가 지나치게 매끈하거나 선이 깨질 때
노이즈 단계가 높으면 작은 질감과 글자가 지워질 수 있습니다. -n 2 결과가 매끈하면 -n 1, 0 또는 -1로 낮추고 모델을 photo와 anime 사이에서 바꿔 비교합니다. 저해상도 글자나 QR 코드는 확대 모델보다 원본 재제작이 정확합니다.
TTA 모드 `-x`는 품질 개선 가능성이 있지만 처리 시간이 늘어납니다. 먼저 기본 설정으로 성공한 뒤 최종 후보에만 TTA를 적용하고, 입력과 출력의 파일 크기·픽셀 크기·윤곽선을 동일 확대율에서 비교합니다.
폴더 일괄 처리와 원본 보호
입력에 폴더를 주면 지원 형식인 JPG·PNG·WebP 파일을 일괄 처리할 수 있습니다. 출력은 별도의 빈 폴더로 지정하고 충분한 디스크 공간을 확보합니다. 2배 확대는 픽셀 수가 네 배가 되므로 무손실 PNG는 예상보다 크게 늘 수 있습니다.
작업 전에 원본을 백업하고 출력 폴더에 기존 파일이 없는지 확인합니다. 일부 파일에서만 실패하면 파일 이름의 특수문자, 손상된 이미지, 과도한 해상도를 확인하고 그 파일을 단독 명령으로 실행해 오류를 구분합니다.
자주 묻는 질문
GUI 프로그램인가요?
아니요. 공식 waifu2x-ncnn-vulkan은 터미널에서 명령으로 실행하는 포터블 도구입니다.
Windows에서 어떤 파일을 받나요?
Release 20250915의 `waifu2x-ncnn-vulkan-20250915-windows.zip`을 받습니다.
2배 확대 명령은 무엇인가요?
`waifu2x-ncnn-vulkan.exe -i input.png -o output.png -n 2 -s 2`를 사용합니다.
Vulkan 오류가 나면 어떻게 하나요?
공식 그래픽 드라이버를 갱신하고 GPU 번호를 지정하거나 `-g -1` CPU 실행을 시험합니다.
사진에는 어떤 모델을 쓰나요?
`-m models-upconv_7_photo`를 사용하고 기본 cunet 결과와 비교해 더 자연스러운 쪽을 고릅니다.
2배 확대 한 장으로 모델과 노이즈 값을 먼저 비교하세요
20250915 Windows ZIP 전체를 풀고 `-n 2 -s 2`로 입력 한 장을 처리합니다. 결과 크기와 윤곽선을 확인한 뒤 노이즈 값과 photo·anime·cunet 모델을 비교하고, 안정적인 설정을 찾은 다음 별도 출력 폴더로 일괄 처리하세요.
공식 자료와 확인일
waifu2x-ncnn-vulkan 공식 GitHub · Release 20250915 공식 릴리스 · 공식 README 사용법 | 2026-10-01T13:47:52.219572+00:00
