Organum

UTAU resampler engine written in Rust

---

한국어 | English | 日本語

Organum은 UTAU 및 OpenUtau용 리샘플러 엔진입니다. WORLD vocoder 기반의 분석/합성 파이프라인을 Rust로 구현했습니다.

Features

• WORLD vocoder 기반 스펙트럼 분석 및 합성
• Rayon을 이용한 병렬 처리
• organum.yaml을 통한 설정 커스터마이징
• Zstd 압축 캐시 (.ogc)로 반복 분석 생략

🎤 Voicebank Release

코쿠노 테츠(虚空の 鉄, Tetsu Kokuno) 보이스뱅크가 출시되었습니다! 다운로드는 https://utau.sapo.dev에서 가능합니다.

GPU Route Notice

• gpu-warp 경로는 실험적 기능입니다.
• 현재 구현은 GPU 왕복 오버헤드(업로드/리드백)로 인해, 실사용 구간에서 CPU(SIMD/병렬)보다 느릴 수 있어 권장하지 않습니다.
• 기본값은 비활성화(gpu_warp_enabled: false)이며, 특별한 벤치/실험 목적이 아니면 CPU 경로 사용을 권장합니다.

Installation

1. Releases 페이지에서 바이너리를 다운로드합니다.
   • 각 플랫폼별로 *-cpu(기본 CPU 빌드)와 *-cpu-gpu(gpu-warp 기능 포함) 아카이브가 제공됩니다.
   • organum-wavtool은 현재 Windows에서만 제공합니다. Linux/macOS 아카이브에는 organum-resampler, caching-tool만 포함됩니다.
   • 최신 릴리즈에는 벤치 요약/로그 asset이 함께 포함될 수 있습니다.
2. OpenUtau의 Resamplers 디렉토리에 배치합니다.

Usage

OpenUtau 또는 UTAU에서:

1. organum-resampler를 Resampler로 설정
2. Windows에서는 organum-wavtool을 Wavtool로 설정
3. Linux/macOS에서는 다음 중 하나를 사용
   • wine organum-wavtool.exe로 Windows wavtool 실행
   • OpenUtau 기본 wavtool 사용

Logging

세 바이너리 모두 구조화 로그를 지원합니다.

• --verbose: 디버그 레벨 로그 활성화
• --log-format pretty|json: 로그 출력 형식 선택

예시:

./organum-resampler --verbose --log-format json ...
./organum-wavtool --log-format json ...
./caching-tool.exe --verbose --log-format json "C:\Path\To\Your\Voicebank"

wine organum-wavtool.exe --log-format json ...

Voicebank 캐싱

캐싱 툴로 voicebank를 미리 분석해두면 렌더링 시 분석 단계를 건너뜁니다.

./caching-tool.exe "C:\Path\To\Your\Voicebank"

Configuration

실행 시 organum.yaml이 없으면 파일을 생성하지 않고 기본값으로 바로 실행됩니다. 설정을 바꾸려면 실행 파일과 같은 디렉토리에 organum.yaml을 직접 만들면 됩니다.

feature_extension: "ogc"
sample_rate: 44100
frame_period: 5.0
zstd_compression_level: 3
compressor_threshold: 0.85
compressor_limit: 0.99
gpu_warp_enabled: false
gpu_warp_min_frames: 18446744073709551615
gpu_ap_min_frames: 18446744073709551615
output_dither: true
memory_cache_enabled: true
memory_cache_max_mb: 512
quality_preset: "balanced"

캐시는 포맷/스키마/엔진 버전 및 주요 설정(sample_rate, frame_period)이 현재 실행 값과 다르면 자동으로 무효화 후 재생성됩니다.

Quality Presets

• classic: 최근 품질 보정 없이, 기존 WORLD 느낌을 최대한 유지합니다.
• balanced: 기본값. 기존 느낌을 크게 해치지 않으면서 자음 노이즈/숨소리 실패/고음 긴장감을 완화합니다.
• clear: 고음의 답답함을 더 줄이고, 자음 선명도를 조금 더 살립니다.
• breathy-safe: breath / h 계열 안정성을 더 우선시합니다. 일부 음원에서는 더 부드럽고 안전하게 들릴 수 있습니다.

자세한 내용은 Configuration Guide 참고.

SIMD 검증/벤치 가이드는 SIMD Validation, 병목 분석용 flamegraph 가이드는 Profiling 참고.

Build

Organum은 단일 릴리스 프로파일(release)을 사용합니다. Organum은 Rust-native WORLD 경로(world::native)를 사용합니다.

cargo build --workspace --release

./build.bat

./build.sh

Comparison

Kasane Teto UTAU voicebank 기준, 약 500ms 세그먼트 처리 시간.

Engine	Language	Multithreading	Avg. Time
Organum	Rust	Yes (Rayon)	~25ms
straycat-rs	Rust	Yes	~35ms
tn_fnds	C++	No	~110ms

Feature	Organum	straycat-rs	tn_fnds
Acoustic Model	WORLD	WORLD	WORLD/Classic
Configuration	YAML	TOML	CLI Only
License	MIT	MIT	GPL

오디오 샘플 비교는 Comparison 참고.

Flags

렌더링 파라미터를 플래그로 제어할 수 있습니다. P와 y는 동일한 Peak 파라미터 별칭입니다. 상세 레퍼런스: Flags

License

Organum is distributed under the MIT License. See LICENSE.

The Rust-native WORLD implementation is shipped with the original WORLD BSD-style notice for attribution and redistribution hygiene. See THIRD_PARTY_NOTICES.md and licenses/WORLD_BSD-3-Clause.txt.