Guide
How to use
On the site
- Open the herd, tick the ponies you want, and download the zip (or a single XML).
In the wallpaper
- In PonyPaper settings, use Add custom pony and pick the XML files or the zip. A previously exported library zip is accepted here too.
- Or use Import library to merge a zip of custom ponies (plus an optional background).
- Recommended: set a character library folder you own (for example Documents/PonyPaper) and drop the XML files there. Opening settings syncs them. Unchecking a pony only hides it; use Remove custom pony to delete the file.
Need the wallpaper or the desktop editor? GitHub releases (APK + CustomEditor JAR).
File format
One pony per XML. Each <action> holds left/right sprite strips (base64 PNG) and timings in hundredths of a second. Omit direction (or use both) to share one strip and timings across facings; a directed tag still overrides that side. An action may set <spritesfrom> to reuse another action’s strip and timings (no chains). The wallpaper slices sheetWidth / timings.length — no gutters between frames. The herd shows a prebuilt clip of one action; the character page plays the XML strips, including aliases.
Optional <effect> entries are Desktop Ponies–style prop/VFX sprites. Each effect names a trigger <action>, optional duration (seconds; 0 = until that action ends), repeatdelay, follow, and noloop, plus left/right placement / centering attach points and their own image strips. Apparent motion (falling apples, shaking trees) lives in the sheet — not physics. Character detail previews composite effects onto the trigger action using the same attach math as the wallpaper.