v1.2.0 — Now Playing 앨범아트 팔레트 · 비트/BPM · 자동 일시정지 · 재생목록 · 썸네일 갤러리 · 자동 업데이트 · GUI 고도화

차별화 3축 중 **1번(리액티브 데이터)**을 가장 깊게 판 릴리즈입니다. 배경이 지금 재생 중인 곡의 앨범아트 색으로 물들고, 박자에 맞춰 반응하며, 게임 중엔 알아서 조용해집니다.

🎵 Now Playing 앨범아트 팔레트 (킬러 기능)

Windows SMTC로 지금 재생 중인 곡의 제목·아티스트·앨범아트를 읽고, 앨범아트에서 대표색 4개를 추출해 셰이더로 흘려보냅니다. 기본 오로라 씬은 음악이 재생되면 그 앨범의 색으로 물들고 비트에 맞춰 펄스합니다. Spotify든 유튜브뮤직이든 틀기만 하면 배경이 반응 — Wallpaper Engine에도 없는 기능입니다.

🥁 비트/BPM 싱크

스펙트럴 플럭스 온셋 검출 + 자기상관 템포 추정으로 곡의 박자에 맞춰 씬이 반응합니다. 설정 패널에 실시간 "♩ NN BPM · 비트 감지" 표시. 새 셰이더 uniform: iBeat iBpm iBeatConf iOnset.

⏸️ 전체화면·배터리 자동 일시정지

게임/영상이 전체화면이거나 노트북이 배터리로 구동될 때 렌더를 멈춰 GPU·전력을 아낍니다. 옵트아웃/옵트인 플래그: --allow-when-fullscreen, --pause-on-battery.

🖼️ 씬 썸네일 갤러리 · 🔁 재생목록 자동 순환

텍스트 드롭다운 대신 8개 씬을 2열 썸네일 그리드로 골라 씁니다. "자동 순환" 체크박스로 N분마다(셔플 옵션 포함) 씬이 스스로 바뀝니다.

⬆️ 자동 업데이트

실행 시 GitHub 최신 릴리즈를 조회해 새 버전이 있으면 설정 패널에 배너로 알리고, 클릭 한 번으로 다운로드·설치·재시작합니다.

🎨 설정 GUI 전면 고도화

딥 네이비 반투명 패널 + 오로라틸 액센트 + 카드형 레이아웃으로 다시 디자인했습니다.

히어로(씬 갤러리)	전체 패널

🚀 사용법

zip을 풀고 real_live_wall.exe 더블클릭 → 씬 썸네일을 골라 "바탕화면에 적용". 음악을 재생 중이면 자동으로 그 곡의 앨범아트 색이 배경에 반영됩니다. 이후엔 트레이 아이콘으로 제어하고, **"자동 시작"**을 켜두면 로그인 때마다 자동 실행됩니다.

실측: Windows 11 · RTX 3060 · Vulkan · 4모니터.

전체 변경 내역: CHANGELOG.md

v1.1.0 — 기본 씬 전면 리마스터(판매급 화질) · 헤드리스 스크린샷

기본 제공 씬 8종을 "판매급" 화질로 전면 리마스터하고, 창 없이 씬을 검증하는 헤드리스 스크린샷 QA 파이프라인을 추가한 릴리즈입니다.

🔧 근본 버그 수정

일부 GPU에서 화면 전체에 사각 블록 아티팩트가 뜨던 문제를 해결했습니다. 원인은 fract(sin(x)*43758…) 형태의 해시 함수가 fp32 sin 정밀도 붕괴를 일으킨 것으로, sin-free 해시(Hoskins)로 8개 씬 전부 교체했습니다.

🎨 씬 8종 전면 리워크

• 기본(오로라) — 3겹 물결 커튼 + 세로 광선, 은하수, 3층 별(회절 스파이크), 산 실루엣 + 호수 반영
• ocean — 골든아워 바다, Fresnel 하늘 반사, 태양 글리터 기둥
• sunset_clouds — 역광 구름 3층 + 실버라이닝, 갓레이, 초저녁 별
• mountains — 황혼 능선 6겹 + 골짜기 안개, 능선 위 태양, 유성
• rain — 컨셉 변경: "유리창의 비" — 보케 야경 + 굴절되는 물방울 렌즈 + 빗줄기 + 번개
• forest_fireflies — 달무리 + 볼류메트릭 문라이트 + 침엽수 3겹 + 깊이별 반딧불
• plasma — 실크 잉크 유체(네이비→틸→오키드→골드 큐레이션 램프), 순수 Shadertoy
• audio_bars — 네온 스펙트럼 링 + 미러 바닥 + 베이스 코어 + 무음 idle 브리딩

fbm 옥타브 회전 추가, HDR 노출 예산을 재조정해 과노출도 제거했습니다.

🆕 헤드리스 스크린샷 QA

--screenshot <path> [--sim-time <sec>] — 창을 띄우지 않고 씬을 HDR 포스트FX(블룸·톤매핑)까지 그대로 오프스크린 렌더해 PNG로 저장 후 종료합니다. 씬 QA·README 스크린샷 갱신·향후 CI 회귀 검사에 사용됩니다.

naga 기반 셰이더 컴파일 테스트(cargo test)도 추가해 기본 WGSL 씬과 GLSL 7종 전체를 회귀 검증합니다.

🖼️ 씬 미리보기

🚀 사용법

zip을 풀고 real_live_wall.exe 더블클릭 → 씬 선택 후 "바탕화면에 적용". 이후엔 트레이 아이콘으로 제어하고, **"자동 시작"**을 켜두면 로그인 때마다 자동 실행됩니다.

실측: Windows 11 · RTX 3060 · Vulkan · 4모니터.

전체 변경 내역: CHANGELOG.md

v1.0.0 — 트레이 · 설정 저장 · 자동 시작 (첫 정식 릴리즈)

매일 쓰는 완성품 수준으로 제품 완성도를 끌어올린 첫 정식 릴리즈입니다.

✨ v1.0 신규

• 시스템 트레이 — 월페이퍼 실행 시 알림 영역에 아이콘이 상주합니다. 설정 창을 닫아도 트레이 메뉴에서 설정 열기 · 다음 씬 · 자동 시작 · 종료를 바로 제어.
• 로그인 자동 시작 — 설정 패널/트레이의 "자동 시작"을 켜면 Windows 로그인 시 마지막 씬으로 자동 실행.
• 설정 저장 — 씬/오디오/게인이 %APPDATA%\real_live_wall\config.toml에 자동 저장·복원.
• 단일 인스턴스 — 월페이퍼 중복 실행 방지.

📦 이전(0.x)부터의 핵심

• 연결된 모든 모니터에 각각 전체 장면 렌더 · 실행 중 원격 종료(--stop) + 바탕화면 복구
• 오디오 FFT(64밴드)·CPU/메모리 리액티브 · Shadertoy GLSL 무수정 호환 · HDR 블룸/톤매핑
• 시네마틱 자연 씬(ocean·sunset_clouds·mountains·rain·forest)

🚀 사용법

zip을 풀고 real_live_wall.exe 더블클릭 → 씬 선택 후 "바탕화면에 적용". 이후엔 트레이 아이콘으로 제어하고, **"자동 시작"**을 켜두면 로그인 때마다 자동 실행됩니다.

실측: Windows 11 · RTX 3060 · Vulkan · 4모니터.

전체 변경 내역: CHANGELOG.md

v0.4.0 — 멀티모니터 · 원격 종료 · 씬 화질 · 아이콘

✨ 새로운 기능

• 멀티모니터 지원 — 월페이퍼 모드에서 연결된 모든 모니터에 각각 전체 장면을 개별 렌더합니다. (모니터마다 서피스+후처리, GPU 디바이스/렌더러는 공유)
• 원격 종료 — 실행 중인 월페이퍼를 어디서든 끌 수 있습니다. 설정 패널의 "■ 월페이퍼 중지" 버튼 또는 real_live_wall.exe --stop. 프리뷰 창을 닫았다가 다시 열어도 종료 가능하며, 끄면 원래 바탕화면이 복구됩니다.
• 앱 아이콘 — 오로라 그라디언트 + 스펙트럼 바 아이콘을 exe에 임베드.

🎨 개선

• 자연 씬 화질 대폭 향상 — ocean · sunset_clouds · mountains · rain 재작성. 밝은 블룸 하이라이트(태양·물빛 글리터·번개), 도메인워프 fbm 디테일, 산 실루엣 안티에일리어싱, 대기 원근, 밴딩 제거 디더링.

📦 사용법

zip을 풀고 real_live_wall.exe를 더블클릭 → 설정 GUI에서 씬을 고르고 "바탕화면에 적용". 끄려면 패널 버튼 또는 real_live_wall.exe --stop.

실측: Windows 11 · RTX 3060 · Vulkan · 4모니터 동시.

전체 변경 내역: CHANGELOG.md

v0.3.0 — 시네마틱 화질(HDR 블룸/SSAA) + 월페이퍼 수정

real_live_wall v0.3.0 — 시네마틱 화질 + 월페이퍼 수정 🎬

"스팀에서 파는 라이브 월페이퍼급 퀄리티"를 목표로 렌더 파이프라인을 통째로 업그레이드했습니다.

✨ HDR 후처리 파이프라인 (프리미엄 룩)

모든 씬이 이제 시네마틱하게 출력됩니다:

• HDR 오프스크린 렌더 — 씬을 Rgba16Float 타깃에 그려 밝기 여유(HDR) 확보
• 블룸(Bloom) — bright-pass → 2회 핑퐁 가우시안 블러. 태양·반딧불·스펙트럼 팁·오로라가 부드럽게 빛납니다
• 슈퍼샘플 AA (SSAA) — 기본 1.5× 렌더 후 다운스케일. 계단현상·셰이더 반짝임 제거 (--ssaa 2.0로 최상, 1.0으로 끔)
• ACES 톤매핑 + 채도 + 비네트 — 영화 같은 색감/명암

🖥️ 월페이퍼 적용 버그 수정

• "위에만 조금 나오던" 문제 해결 — 이제 주 모니터를 정확히 꽉 채웁니다 (멀티모니터 가상 데스크톱 좌표 보정).
• 아이콘 가림 해결 — HWND_BOTTOM으로 데스크톱 아이콘·창 뒤에 배치. 아이콘이 정상적으로 위에 보입니다.
• Windows 11 WorkerW 탐색 폴백 추가.

🚀 사용

real_live_wall.exe 더블클릭 → 설정 GUI → 씬 고르고 "바탕화면에 적용". F1로 패널 토글.

⚠️ 알려진 한계

• 월페이퍼는 주 모니터만 덮습니다. 멀티모니터 개별 씬은 다음 계획.
• macOS/Linux 표면 미구현(창 모드로 실행).

전체 씬 목록·아키텍처: README · ARCHITECTURE

🤖 Generated with Claude Code

v0.2.0 — 설정 GUI + 자연 배경 씬

real_live_wall v0.2.0 — 설정 GUI 🎛️

이제 CLI 플래그 없이도 더블클릭 → GUI 창에서 라이브 월페이퍼를 설정하고 바탕화면에 적용할 수 있습니다.

✨ 새 기능

• egui 설정 패널 (F1로 토글) — 셰이더 위에 실시간 합성:
  • 씬/셰이더 선택 — 기본 오로라 + shaders/ 폴더의 모든 .glsl 자동 목록화
  • 오디오 소스(자동/루프백/입력/끄기) + 게인 슬라이더 (라이브 반영)
  • 실시간 미터 — FPS, 해상도, Bass/Mid/Treble/Volume, CPU/메모리
  • ▶ 바탕화면에 적용 / ■ 중지 — 현재 씬을 데스크톱 배경으로 실행
  • ↻ 리로드, 종료
• 콘솔 없는 GUI 앱 — release 빌드는 windows_subsystem = "windows". 더블클릭해도 검은 터미널이 뜨지 않습니다.
• 한글 UI — 시스템 폰트(맑은 고딕 등)를 런타임 로드해 한글이 깨지지 않습니다.
• 자연 배경 씬 5종 추가 — ocean(바다), sunset_clouds(노을 구름), mountains(산), rain(비), forest_fireflies(숲 반딧불). 모두 오디오 반응. GUI 드롭다운에서 바로 선택.

🔧 내부 변경

• 렌더러를 wgpu 29로 정렬(최신 egui-wgpu 0.35가 요구). GUI와 엔진이 하나의 wgpu 인스턴스를 공유합니다.
• 렌더 루프를 "씬 패스 → egui 패스(같은 프레임에 LoadOp::Load 합성)"로 분리.
• 오디오 게인 라이브 조정, 씬 핫스왑 API.

🖥️ 검증

Windows 11 · RTX 3060 · Vulkan에서 GUI 패널 + 오로라/스펙트럼 씬 렌더 확인.

🚀 사용

1. 아래 real_live_wall-v0.2.0-windows-x64.zip을 받아 압축 해제 (real_live_wall.exe + shaders/).
2. real_live_wall.exe 더블클릭 → 설정 창.
3. 씬·오디오를 고르고 "바탕화면에 적용". F1로 패널을 숨기면 순수 배경만 남습니다.

⚠️ 알려진 한계

• 월페이퍼 표면은 아직 Windows(WorkerW)만. macOS/Linux는 창 모드로 실행됩니다.
• "적용"은 별도 월페이퍼 프로세스를 스폰합니다. GUI를 닫아도 배경은 유지되지만, 다시 "중지"하려면 GUI를 다시 열어야 합니다.
• Shadertoy iChannel0 오디오 텍스처 완전 호환, 멀티모니터, 멀티패스는 다음 계획입니다.

전체 변경/아키텍처: docs/ARCHITECTURE.md

🤖 Generated with Claude Code

v0.1.0 — 리액티브 라이브 월페이퍼 엔진

real_live_wall v0.1.0 — 첫 동작 버전 🎉

리액티브 · 크로스플랫폼 라이브 월페이퍼 엔진의 첫 릴리즈입니다. 시중 제품이 "영상·웹페이지를 배경에 트는 재생기"에 머무는 것과 달리, 바탕화면이 재생 중인 음악 · 시스템 상태 · 시간에 실시간 반응하고 Shadertoy GLSL 셰이더를 무수정으로 돌립니다.

✨ 주요 기능

• GPU 네이티브 렌더링 — wgpu 30 (Vulkan/DX12/Metal). 풀스크린 프래그먼트 셰이더 1패스.
• Shadertoy GLSL 호환 — mainImage(out vec4, in vec2)를 그대로 로드 (naga GLSL 프론트엔드). iResolution·iTime·iMouse 등 표준 uniform 지원.
• 리액티브 데이터 — cpal 루프백 오디오 캡처 + rustfft 64밴드 스펙트럼, sysinfo CPU/메모리. 셰이더 확장: iBass/iMid/iTreble/iVolume/iSpectrum(x)/iCpu/iMem.
• 오디오 반응 기본 씬 — 오로라 + 별 + 64밴드 스펙트럼 이퀄라이저 (WGSL, 첫 실행부터 렌더 보장).
• 월페이퍼 모드 — Windows WorkerW 부착으로 데스크톱 아이콘 뒤에 렌더. 개발용 --preview 창 모드.
• 핫리로드 — --watch로 GLSL 파일 저장 시 즉시 반영.
• 견고성 — 오디오 장치 없음·잘못된 셰이더·서피스 로스트 등 모든 실패를 로그만 남기고 계속 동작.

🖥️ 검증 환경

Windows 11 · NVIDIA RTX 3060 · Vulkan 백엔드에서 기본 씬과 plasma.glsl 셰이더 렌더 확인.

🚀 빠른 시작

cargo run --release                                             # 기본 오로라 씬 (preview)
cargo run --release -- --shader shaders/audio_bars.glsl --watch # Shadertoy GLSL + 핫리로드
cargo run --release -- --mode wallpaper -s shaders/plasma.glsl  # 실제 데스크톱 월페이퍼

또는 아래 real_live_wall-v0.1.0-windows-x64.zip을 받아 압축을 풀고 real_live_wall.exe를 실행하세요 (같은 폴더에 shaders/ 필요).

⚠️ 알려진 한계 / 로드맵

• macOS·Linux 월페이퍼 표면은 아직 미구현 (창 모드로 실행됨).
• 오디오는 현재 uniform 스펙트럼 방식 — Shadertoy iChannel0 오디오 텍스처 완전 호환은 예정.
• 멀티모니터 개별 씬, 멀티패스 셰이더, 날씨/캘린더 리액티브 소스, 전체화면·배터리 자동 일시정지 예정.

전체 아키텍처: docs/ARCHITECTURE.md

🤖 Generated with Claude Code