Guide

How to use

On the site

  1. Open the herd, tick the ponies you want, and download the zip (or a single XML).

In the wallpaper

  1. In PonyPaper settings, use Add custom pony and pick the XML files or the zip. A previously exported library zip is accepted here too.
  2. Or use Import library to merge a zip of custom ponies (plus an optional background).
  3. 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.