PNG to JSON character card converter

PNG → JSON: extract the definition

The converter reads embedded metadata, not pixels. A supported PNG card produces separate V2 and V3 JSON files in the downloaded archive. Open a JSON copy in a text editor to inspect the fields, or use a compatible character app to import it.

The archive also includes a card PNG and readable character information. A chat history is separate: converting a character PNG does not generate conversation messages. Add a supported chat file if you want that transcript included in the backup.

JSON → PNG: embed a card

A supported JSON card can be packaged into a PNG even when you have no portrait. If the import includes an existing character PNG, the exporter retains that image while rewriting its card chunks. A JSON-only input uses the exporter's default image; this tool does not generate artwork or fetch an avatar URL.

The PNG writes both V2 chara and V3 ccv3 data. Apps differ in the fields they use, so inspect the result in your destination app. Keep the untouched source JSON for recovery and use the separate V3 JSON when a destination needs V3-specific fields.

Can I convert a normal PNG portrait to a character?

No. PNG-to-JSON conversion requires embedded card data. The converter does not invent a character sheet from a picture.

Where is the converted JSON?

Unzip the downloaded backup. Each recognised character has a directory containing .card-v2.json and .card-v3.json files, alongside its PNG and readable copies.