Contributing to the Skin Catalog
How to submit your skin to the Provenance community catalog so it appears in the built-in Skin Browser
Provenance includes a built-in Skin Browser (Settings → Skins → Browse Catalog) that lets users discover and install community skins directly from the app. The catalog is maintained at github.com/Provenance-Emu/skins — a dedicated open-source repo anyone can contribute to.
Skins must be in .deltaskin or .manicskin format and hosted at a publicly accessible URL to be included.
Submission Methods
Option 1 — Web form (easiest)
Visit provenance-emu.com/skins/submit.html, paste your skin URL, and click Fetch Metadata. The page will auto-extract the name and system from your skin file, then let you submit with one click. A bot opens the PR for you within ~60 seconds.
Option 2 — GitHub Issue
Open a skin submission issue and paste your URL. The bot processes it automatically and comments back with a link to the pull request.
Supported URL types:
Direct
.deltaskinor.manicskinfileGitHub repo containing skin files (all skins imported at once)
GitHub release URL (all skin assets imported)
Option 3 — Pull Request (advanced)
Fork Provenance-Emu/skins, add a JSON file to skins/{system}/, and open a PR. CI validates your entry automatically on submission.
Generate a unique ID:
Minimal JSON entry (skins/gba/my-skin-name.json):
Option 4 — Register your repo for auto-crawl
If you maintain a GitHub repo of skins, register it. The weekly crawler will scan your repo every Monday and automatically open PRs for any new skins it finds — no manual submission needed per skin.
Hosting Your Own Skins on GitHub (Free)
GitHub is the best place to host skin files — it's free, permanent, and gives you stable download URLs.
Create a public repo at github.com (e.g.
yourname/skins)Upload your
.deltaskin/.manicskinfiles — drag and drop in the GitHub web UIGet the raw URL: click a file → Raw → copy the URL
Submit the repo or individual file URL via any method above
Raw URLs look like:
These URLs never change as long as the file stays in the same place. You can use GitHub Releases for versioned bundles.
Advantages over DeltaStyles: instant updates, version history, no account required on a third-party site, and new systems supported by Provenance are added to the catalog before DeltaStyles updates their system list.
Catalog JSON Schema
id
string
Yes
16-char hex. Generate with sha256("source:downloadURL")[:16].
name
string
Yes
Display name in the Skin Browser.
systems
array
Yes
System codes — see table below.
downloadURL
string
Yes
Direct .deltaskin or .manicskin URL.
source
string
Yes
Short identifier, e.g. "manual" or "yourname/repo".
author
string
No
Creator's name or handle.
gameTypeIdentifier
string
No
Delta-compatible GTI (auto-detected from skin file).
thumbnailURL
string
No
Preview image URL — strongly recommended.
screenshotURLs
array
No
Additional screenshots.
tags
array
No
e.g. "dark", "minimal", "landscape".
version
string
No
Skin version string.
fileSize
number
No
File size in bytes.
lastUpdated
string
No
ISO 8601 date.
Supported Systems
Provenance supports skins for all single-screen systems it emulates. The systems field in the JSON entry uses the short code below. The gameTypeIdentifier is the value inside the skin's info.json — both Delta (com.rileytestut.delta.game.*) and Manic (public.aoshuang.game.*) formats are accepted.
Nintendo
Code
System
gameTypeIdentifier
gb
Game Boy
com.rileytestut.delta.game.gbc
gbc
Game Boy Color
com.rileytestut.delta.game.gbc
gba
Game Boy Advance
com.rileytestut.delta.game.gba
nes
NES / Famicom
com.rileytestut.delta.game.nes
snes
Super Nintendo / Super Famicom
com.rileytestut.delta.game.snes
n64
Nintendo 64
com.rileytestut.delta.game.n64
nds
Nintendo DS
com.rileytestut.delta.game.ds
virtualBoy
Virtual Boy
public.aoshuang.game.vb
threeDS
Nintendo 3DS
public.aoshuang.game.3ds
gamecube
GameCube
public.aoshuang.game.gc
wii
Wii
public.aoshuang.game.wii
pokemonMini
Pokémon Mini
public.aoshuang.game.pm
Sega
Code
System
gameTypeIdentifier
genesis
Genesis / Mega Drive
com.rileytestut.delta.game.genesis
gamegear
Game Gear
com.rileytestut.delta.game.gg
masterSystem
Master System
com.rileytestut.delta.game.ms
sg1000
SG-1000
public.aoshuang.game.sg1000
segaCD
Sega CD / Mega-CD
public.aoshuang.game.mcd
sega32X
32X
public.aoshuang.game.32x
saturn
Saturn
public.aoshuang.game.ss
dreamcast
Dreamcast
public.aoshuang.game.dc
Sony
Code
System
gameTypeIdentifier
psx
PlayStation (PS1 / PS2 / PS3)
com.rileytestut.delta.game.psx
psp
PlayStation Portable
public.aoshuang.game.psp
NEC
Code
System
gameTypeIdentifier
pce
PC Engine / TurboGrafx-16
(Provenance internal)
pcecd
PC Engine CD-ROM
(Provenance internal)
pcfx
PC-FX
(Provenance internal)
sgfx
SuperGrafx
(Provenance internal)
Atari
atari2600
Atari 2600
atari5200
Atari 5200
atari7800
Atari 7800
jaguar
Atari Jaguar
jaguarcd
Atari Jaguar CD
lynx
Atari Lynx
atari8bit
Atari 8-bit (400/800/XL/XE)
atarist
Atari ST
SNK
neogeo
Neo Geo
ngp
Neo Geo Pocket
ngpc
Neo Geo Pocket Color
Bandai
wonderswan
WonderSwan
wonderswancolor
WonderSwan Color
Other Classics
vectrex
Vectrex
_3do
3DO
appleII
Apple II
c64
Commodore 64
cdi
Philips CD-i
colecovision
ColecoVision
cps1
Capcom CPS1
cps2
Capcom CPS2
cps3
Capcom CPS3
intellivision
Intellivision
macintosh
Mac Classic
mame
MAME arcade
megaduck
Mega Duck
msx
MSX
msx2
MSX2
odyssey2
Odyssey 2
supervision
Supervision
zxspectrum
ZX Spectrum
retroarch
RetroArch (any core)
Don't see your system? The catalog covers all 66 Provenance-supported systems. If you're targeting a system not in this list, open a GitHub issue on the skins repo and we'll add it. The unofficial system code is deprecated — all systems now have proper identifiers.
See Also
Skins Guide — Installing and using skins in Provenance
Contributing — General contribution guide
Need help? Ask on Discord.
Last updated