The .charx converter — both directions.
A .charx file is a ZIP container: card.json in the V3 spec, plus an assets folder for the avatar and any extra media. RisuAI reads and writes it natively; almost nothing else does. This page converts both ways — drop a .charx to unpack it into PNG or JSON, or drop any V1/V2/V3 card to package it as .charx.
Convert a card
Drop in a card and download. Everything runs locally in your browser — nothing is uploaded.
PNG, JSON, or .charx. Converted entirely in your browser — the file never leaves your device.
Importing to a hub (RisuRealm / Chub)? .charx or V2 PNG are accepted most widely. A bare V3 JSON has no embedded avatar, so some hubs reject it.
Conversion notes
Pick a card and a target format, then convert. Any fields that don't survive are listed here so you can review them before downloading.
The route
Drop any card file below
A .charx is unpacked; a PNG or JSON is read for packaging. Detection is automatic.
Pick the direction
.charx is preselected for packaging. Unpacking? Choose V3 PNG for SillyTavern or V3 JSON for editing.
Review the asset report
Going to PNG, only the icon survives as the image — other assets are listed. Going to .charx, the source image becomes the icon asset.
Questions
- What exactly is inside a .charx file?
- Rename it to .zip and look: card.json holding a V3 spec card, and an assets directory. This converter reads and writes the same structure — no proprietary extras.
- Why did RisuAI introduce .charx instead of using PNGs?
- A PNG can carry one image and limited metadata. V3 cards can reference multiple assets — emotion images, audio — and a ZIP container holds them all next to the card data.