Repository navigation
Releases
v1.1.1
v1.1.0
v1.0.0
Vita Theme Creator v1.0.0
A cross-platform (Electron + React + TypeScript) reimplementation of
ThemeBUILDER by
AntHJ, for building custom PS Vita home-screen
themes on macOS/Windows/Linux instead of the original Windows-only tool.
Full credit to AntHJ for the original tool and the underlying
reverse-engineering of the Vita theme format, and to
LiEnby/Sony-ThemeTool for the
decompiled ATRAC9 header validation this app's audio pipeline is ported
from.
Highlights
- Landing page & library — Create a theme, load/edit an existing
project, build a standalone 17-icon set, or manage every theme you've
previously built (list/edit/delete/re-export) from one place. - Full theme editor — lockscreen, 10 home-screen pages, 17 system
icons, clock/notification/status-bar colors, background music, and
package metadata, all through native file pickers. - Vita-accurate live preview — lockscreen and home-page previews,
including a real status-bar strip (wifi/home/battery/notification icons)
and wave-pattern page backgrounds, corrected against real exported
ThemeBUILDER output rather than guessed from generic phone-UI
conventions. - Crop/zoom image editor — every image slot can be stretched (the
original's only option) or cropped via an interactive drag-to-pan/
scroll-to-zoom cover-fit editor, with identical crop math shared by the
editor, the live preview, and the export pipeline. - New customization options the original never exposed — custom
page-indicator dots, and independently-replaceable lockscreen/LiveArea
preview screenshots. - Real, installable export — converted/masked PNGs, generated
theme.xml, composited system icons, ATRAC9bgm.at9encoding, and a
zipped package matching the community themes repo's expected layout. - No missing-asset export failures — every optional image slot falls
back to a sensible default (matching the original tool's own bundled
defaults where one exists) so exporting never fails just because a slot
was left untouched.
Corrections against the original tool's domain-logic report
Validated against a real third-party PS Vita theme validator, which
surfaced two domain-logic corrections (notification icons ship at 120×110,
not 40×37; theme.xml omits a page's background-file references entirely
when no image is set) and two implementation bugs since fixed (a
theme.xml serialization bug that corrupted page backgrounds on-device,
and incorrect alpha-masking of notification icons). See CLAUDE.md's
"Known corrections against the domain report" for the full evidence trail.
Known limitation
ATRAC9 encoding (WAV/MP3 → .at9) shells out to the original tool's
bundled Windows at9tool.exe — it runs natively on Windows or through Wine
elsewhere, since no legal open-source ATRAC9 encoder exists. .at9
passthrough and the bundled default audio track work on every platform
without Wine.
Installing
This release is source-only — no prebuilt binaries are attached (code
signing for macOS/Windows requires paid developer certificates not yet set
up for this project). To run it:
git clone https://github.com/BrayLaf/VitaThemeCreator.git
cd VitaThemeCreator
npm install
npm run devSee the README for
full setup, build, and packaging instructions.