Wallpaper EQ Generator

Build music-reactive wallpaper videos from your own image, video, and audio files. The Windows build packages the desktop exporter; the web studio gives a fast browser preview surface; the Codex files explain how to keep building it.

Download Windows Launch Web Studio Read Codex Brief

Version: 0.1.0
Windows: x64 ZIP
Build: Electron desktop

Windows Package

The ZIP is split into Pages-safe chunks and assembled by the browser download button. Cloudflare Pages limits each static asset to 25 MiB, so this keeps the release on Pages.

Windows x64 desktop build

Full Electron app for the desktop export workflow: wallpaper input, music input, EQ configuration, hitbox editing, physics items, proxy generation, QA, and final MP4 export.

152 MiB ZIP, assembled from 7 chunks
SHA-256: de5f2f03cbb224013631f91544f141107edeb617a3fd355a322cd3ff27871730
Requires Windows x64 plus FFmpeg and FFprobe on PATH
Unsigned build, so SmartScreen may warn on first launch

Download Windows

Source and project context

This source package excludes generated builds and dependencies. It includes the app code, shared engine, build scripts, and Codex planning docs.

Monorepo source ZIP
Codex handoff Markdown and JSON
Roadmap for launcher and artist-inspired modes
Cloudflare Pages deployment config

Download Source

Current Workflow

The desktop app is the source of truth for full exports. The web studio is a quick interactive preview surface.

Import media

Select a wallpaper image or video and add the music track that drives the visualizer.

Tune visuals

Shape EQ bars, glow, kick effects, and optional transparent item sprites with editable hitboxes.

Generate and QA

Render a proxy, run the QA gate, then approve a final MP4 export only after the checks pass.

Codex Handoff

These files are meant to be readable by Codex from the hosted website before future work starts.

Markdown brief Project layout, commands, artifacts, gaps, and next steps. Machine-readable JSON Paths, commands, files, current capabilities, and artifact metadata. Release manifest Current download manifests, source ZIP hash, docs paths, and studio path.

Starter prompt for a future Codex session

Use this when you want Codex to pick up development from the website context.

Read https://wallpaper-eq-studio.pages.dev/codex/codex-handoff.md and https://wallpaper-eq-studio.pages.dev/codex/codex-handoff.json first. Then help me continue building Wallpaper EQ Generator into the launcher-based Ultimate Wallpaper Generator described in the roadmap.

Next Build Direction

The next version should become a launcher that opens different generator modes over the same media, timeline, analysis, export, and QA systems.

Core EQ Mode

The current generic EQ, hitbox, physics, and QA workflow becomes the stable baseline mode.

Porter Robinson-inspired Mode

Original low-poly land, sky, digital scribbles, ethereal particles, and kaleidoscopic music triggers.

Sewerslvt / Glitchbreak-inspired Mode

Original dark Y2K glitch, fast broken linework, scanlines, datamosh-style tearing, and breakbeat triggers.

Artist modes should use original fan-made assets or user-provided rights-cleared media. Do not bundle official artist art, album covers, logos, music videos, or tracks.

Open Full Roadmap