WallpaperJS: HTML, CSS, JS로 바탕화면 꾸미기

WallpaperJS: HTML, CSS, JS로 바탕화면 꾸미기 프로그램입니다. APACHE 2.0

WallpaperJS

HTML · CSS · JavaScript로 만드는 나만의 데스크톱.

웹으로 만든 장면을 매일의 바탕화면으로.

⭐다운로드 링크⭐

내 코드로 채우는 화면

로컬 HTML, CSS, JavaScript 프로젝트를 가져와 실제 바탕화면에서 실행하세요. 짙은 배경과 라벤더 포인트의 관리 화면에서 프로젝트와 디스플레이를 선택하면 됩니다.

익숙한 웹 기술 — 직접 만든 웹 프로젝트를 바탕화면으로 사용합니다.
여러 화면, 하나의 장면 — 여러 디스플레이에 적용하고, Windows에서는 하나의 넓은 장면으로 이어 표시합니다.
작업에 맞춘 재생 — 30·60 FPS 설정과 일시정지를 지원합니다.
조용한 백그라운드 실행 — 창을 닫아도 바탕화면 재생이 유지되며, 앱을 다시 열어 제어할 수 있습니다.
한국어와 영어 — 시스템 언어 또는 원하는 언어를 선택할 수 있습니다.

다운로드

v0.1.2 · HTML 가져오기 수정 프리릴리즈 — 아래에서 운영체제와 CPU에 맞는 설치 파일을 선택하세요. 기본 바탕화면 카탈로그는 포함하지 않으며, 라이브러리는 빈 상태로 시작합니다.

운영체제	CPU	설치 파일
Windows	Intel / AMD (x64)	다운로드 .exe
Windows	ARM64	다운로드 .exe
macOS 14.2+	Apple Silicon (M-series)	다운로드 .dmg
macOS 14.2+	Intel (x64)	다운로드 .dmg

SHA-256 체크섬 · 릴리즈 노트

v0.1.2에서는 재생 중 다른 HTML 프로젝트를 가져왔을 때 미리보기와 바탕화면이 빈 화면으로 뜨는 문제를 수정했습니다. 렌더러를 다시 시작하지 않아도 새 HTML·CSS·JavaScript 리소스를 불러옵니다. macOS Dock 숨김은 유지합니다.

설치 안내

Windows: .exe를 실행하고 설치 위치를 선택합니다. 이번 빌드는 코드 서명이 없어 SmartScreen 경고가 표시될 수 있습니다.

macOS: .dmg를 열고 WallpaperJS를 응용 프로그램 폴더로 옮깁니다. 이번 빌드는 Developer ID 서명·Apple 공증을 받지 않았으므로 Gatekeeper가 실행을 차단할 수 있습니다. 다운로드 출처를 확인한 뒤 macOS의 시스템 설정 → 개인정보 보호 및 보안에서 차단 안내를 확인하세요. 관리되는 기기에서는 실행이 제한될 수 있습니다.

업데이트 전 기존 앱을 다시 열어 재생 중지 및 종료로 백그라운드 제어기와 렌더러까지 종료하세요. 업데이트 설치 후 WallpaperJS를 다시 실행하면 됩니다. 가져온 프로젝트와 저장한 적용 설정은 유지됩니다.

첫 바탕화면 시작하기

로컬 HTML 파일 또는 HTML·CSS·JavaScript와 리소스가 들어 있는 프로젝트 폴더를 준비합니다.
HTML·ZIP은 파일 가져오기, 프로젝트 폴더는 폴더 가져오기를 사용합니다.
적용할 디스플레이를 선택하고 바탕화면을 적용합니다.
Windows에서는 여러 디스플레이를 체크한 뒤 하나의 세트로 이어 표시할 수 있습니다.

관리 창을 닫아도 별도 백그라운드 프로세스가 재생을 유지합니다. WallpaperJS를 다시 실행해 제어하고 재생 중지 및 종료로 완전히 종료하세요. 현재 버전에는 상주 트레이·메뉴 막대 아이콘이 없습니다. macOS의 관리 앱과 HTML 렌더러는 Dock에 표시하지 않습니다.

플랫폼과 알려진 제한

기능	Windows	macOS
HTML / CSS / JS 바탕화면	지원	지원
WebM 동영상 배경화면	외부 mpv 필요	외부 mpv 필요
디스플레이별 적용	지원	지원
여러 화면에 걸친 단일 장면	디스플레이 세트	미지원
잠금화면 이미지	스냅샷 또는 별도 이미지	미지원
한국어 / 영어	지원	지원

Windows 잠금화면은 정지 이미지만 지원하며 장치 정책에 따라 변경이 제한됩니다.
HTML은 실시간으로 실행하므로 시계와 애니메이션이 동작합니다. 30/60 FPS 설정은 requestAnimationFrame에 적용되며 CSS 애니메이션과 HTML 안의 동영상에는 적용되지 않습니다. 일시정지 후 HTML을 다시 재생하면 프로젝트를 다시 불러옵니다. WebM은 영상의 FPS를 따릅니다.
단일 HTML 가져오기는 해당 파일만 복사합니다. 상대 경로 리소스는 폴더·ZIP으로 가져오세요. 외부 네트워크 접근은 차단하므로 날씨 API 연결에는 별도 설계가 필요합니다.
WebM 재생에는 외부 mpv가 필요하며 설치 파일에 포함하지 않습니다. macOS는 brew install mpv, Windows는 mpv.exe를 PATH에 추가하거나 WALLPAPERJS_MPV에 절대 경로를 지정하세요. HTML에는 mpv가 필요하지 않습니다.
Windows 11 x64에서 HTML 실행 수명 주기와 압축 해제된 앱을 검증했습니다. Windows·macOS 빌드 러너에서 패키지와 Dock 표시 여부를 확인하며, 이는 실제 기기의 설치 검증을 대신하지 않습니다. macOS Spaces·Mission Control·다중 디스플레이와 Windows 혼합 DPI 세트는 추가 검증이 필요합니다.
Linux는 지원하지 않습니다.

라이선스

이 저장소는 공식 다운로드와 배포 안내를 제공합니다. 프로그램 소스는 별도의 비공개 저장소에서 관리합니다.