[{"data":1,"prerenderedAt":102},["ShallowReactive",2],{"blog-character-card-png-not-importing":3},{"post":4,"coverPortrait":62,"characters":63,"related":73},{"slug":5,"title":6,"description":7,"date":8,"updated":8,"category":9,"tags":10,"cover":15,"featured":16,"characters":17,"readingMinutes":19,"html":20,"headings":21,"faq":43},"character-card-png-not-importing","Character card PNG not importing? Causes and fixes","A card PNG that won't import has usually lost the hidden data that holds the character. How to check a PNG for chara or ccv3 data and get a working copy.","2026-10-26","guides",[11,12,13,14],"character cards","png","troubleshooting","sillytavern","jinhee",false,[15,18],"hana-sato",8,"\u003Cp>\u003Cstrong>A character card PNG won&#39;t import when the image no longer carries the card. The character lives in a hidden text chunk inside the PNG (\u003Ccode>chara\u003C\u002Fcode> for V2 cards, \u003Ccode>ccv3\u003C\u002Fcode> for V3) holding base64-encoded JSON, and a screenshot, a conversion to JPG or WebP, or a re-save by an app that recompresses images throws it away. Download the original file from the card&#39;s page again, check it with one of the methods below, or skip files and import the card by link.\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>The face survives all of this, which is what makes it confusing: the picture looks identical, and the character inside is gone.\u003C\u002Fp>\n\u003Ch2 id=\"quick-diagnosis\">Quick diagnosis\u003C\u002Fh2>\n\u003Cdiv class=\"blog-table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>What you see\u003C\u002Fth>\n\u003Cth>Most likely cause\u003C\u002Fth>\n\u003Cth>Fix\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>&quot;No character data&quot; or an error on import\u003C\u002Ftd>\n\u003Ctd>The file is a plain picture: a screenshot or a saved preview\u003C\u002Ftd>\n\u003Ctd>Download the card again from its page\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>A character appears with an empty description\u003C\u002Ftd>\n\u003Ctd>The data was stripped, or the importer only found an image\u003C\u002Ftd>\n\u003Ctd>Re-download; try the JSON version\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>The importer rejects the file type\u003C\u002Ftd>\n\u003Ctd>It&#39;s a WebP or JPG renamed to .png\u003C\u002Ftd>\n\u003Ctd>Find the real PNG (or see SillyTavern&#39;s tip below)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Works in one app, not in another\u003C\u002Ftd>\n\u003Ctd>Format version: a V3-only card, a CHARX file, or an app that expects V2\u003C\u002Ftd>\n\u003Ctd>Export a V2 PNG or JSON from an app that reads V3\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>&quot;Invalid JSON&quot; or a parse error\u003C\u002Ftd>\n\u003Ctd>The data was edited by hand or cut short\u003C\u002Ftd>\n\u003Ctd>Re-download, or fix the JSON\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>The site refuses the card after reading it\u003C\u002Ftd>\n\u003Ctd>Its content rules, or a private definition\u003C\u002Ftd>\n\u003Ctd>Check the site&#39;s policy; ask the creator\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>You have a link but no file\u003C\u002Ftd>\n\u003Ctd>Nothing wrong at all\u003C\u002Ftd>\n\u003Ctd>Import by link where the app supports it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Ch2 id=\"how-the-character-hides-inside-a-png\">How the character hides inside a PNG\u003C\u002Fh2>\n\u003Cp>A PNG file is a stack of chunks: the image data, plus optional text chunks with a keyword and a value. Character cards use that space. SillyTavern&#39;s \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FSillyTavern\u002FSillyTavern\u002Fblob\u002Frelease\u002Fsrc\u002Fcharacter-card-parser.js\" rel=\"nofollow noopener noreferrer\" target=\"_blank\">card parser\u003C\u002Fa> looks for a text chunk named \u003Ccode>ccv3\u003C\u002Fcode> first, then \u003Ccode>chara\u003C\u002Fcode>, and base64-decodes whichever it finds into the card&#39;s JSON. When it writes a PNG, it removes the old card chunks and writes both: \u003Ccode>chara\u003C\u002Fcode> with the card as stored, and \u003Ccode>ccv3\u003C\u002Fcode> with the same data labeled as a V3 card.\u003C\u002Fp>\n\u003Cp>The \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fkwaroran\u002Fcharacter-card-spec-v3\u002Fblob\u002Fmain\u002FSPEC_V3.md\" rel=\"nofollow noopener noreferrer\" target=\"_blank\">V3 spec\u003C\u002Fa> makes the \u003Ccode>ccv3\u003C\u002Fcode> name a requirement, encodes the JSON as UTF-8 then base64, lets apps fall back to a \u003Ccode>chara\u003C\u002Fcode> chunk, and says an app that finds both should use \u003Ccode>ccv3\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>None of this is part of the picture itself. Any tool that rebuilds the image from its pixels, rather than copying the file, writes a new PNG (or a JPG, or a WebP) without those chunks. That&#39;s the whole problem in one sentence.\u003C\u002Fp>\n\u003Ch2 id=\"the-usual-causes\">The usual causes\u003C\u002Fh2>\n\u003Ch3 id=\"1-it-s-a-screenshot-or-a-saved-preview\">1. It&#39;s a screenshot or a saved preview\u003C\u002Fh3>\n\u003Cp>A screenshot is a brand-new image of your screen: it has never contained the card. Saving a thumbnail from a list page or a gallery does the same thing more quietly, because sites often serve resized copies, sometimes in WebP, for previews. Always use the site&#39;s own download option. On Chub, the Download button on a character&#39;s page offers PNG or JSON.\u003C\u002Fp>\n\u003Ch3 id=\"2-it-was-converted-or-re-saved\">2. It was converted or re-saved\u003C\u002Fh3>\n\u003Cp>Opening the card in an image editor and saving it again, running it through an &quot;optimizer&quot;, cropping it in your phone&#39;s photo app, or converting it to JPG or WebP all rebuild the image and drop the text chunks. SillyTavern&#39;s \u003Ca href=\"https:\u002F\u002Fdocs.sillytavern.app\u002Fusage\u002Ffaq\u002F\" rel=\"nofollow noopener noreferrer\" target=\"_blank\">FAQ\u003C\u002Fa> puts it plainly: &quot;Some programs or file managers will strip the embedded definitions from the card when you save them.&quot; Converting a JPG back to PNG doesn&#39;t bring anything back; once the chunk is gone, it&#39;s gone.\u003C\u002Fp>\n\u003Ch3 id=\"3-a-site-or-app-recompressed-it\">3. A site or app recompressed it\u003C\u002Fh3>\n\u003Cp>Social networks and many chat apps re-encode the images you post, and image hosts often do the same. If someone shared a card as an image in a feed, assume the data didn&#39;t survive. In chat apps, download the attachment itself rather than saving the preview shown in the conversation. The safest way to share a card is the JSON file, a zip, or simply the link to its page.\u003C\u002Fp>\n\u003Ch3 id=\"4-it-isn-t-really-a-png\">4. It isn&#39;t really a PNG\u003C\u002Fh3>\n\u003Cp>A file named \u003Ccode>.png\u003C\u002Fcode> can be something else: a WebP that was renamed, or even an error page saved when a download failed (that one is usually tiny, a few kilobytes). SillyTavern&#39;s FAQ lists the renamed-WebP case and suggests renaming the file to .webp before importing it, or finding a true PNG version.\u003C\u002Fp>\n\u003Ch3 id=\"5-the-format-version-doesn-t-match\">5. The format version doesn&#39;t match\u003C\u002Fh3>\n\u003Cp>Cards have evolved. V2 lives in a \u003Ccode>chara\u003C\u002Fcode> chunk; V3 lives in \u003Ccode>ccv3\u003C\u002Fcode>, and CHARX is a zip file with a \u003Ccode>card.json\u003C\u002Fcode> inside. An older tool that only reads \u003Ccode>chara\u003C\u002Fcode> won&#39;t see a card that carries only \u003Ccode>ccv3\u003C\u002Fcode>, and a PNG-only importer won&#39;t open a CHARX file. RisuAI reads V2 and V3 and can export a V2 PNG, a V3 PNG, CHARX or JSON (\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fkwaroran\u002FRisuAI\u002Fblob\u002Fmain\u002Fsrc\u002Fts\u002FcharacterCards.ts\" rel=\"nofollow noopener noreferrer\" target=\"_blank\">source\u003C\u002Fa>), which makes it a handy converter.\u003C\u002Fp>\n\u003Ch3 id=\"6-the-data-is-broken\">6. The data is broken\u003C\u002Fh3>\n\u003Cp>If someone edited the JSON by hand, one stray comma makes it unreadable. A download that stopped halfway leaves the end of the base64 missing. Both show up as parse errors rather than &quot;no data&quot;.\u003C\u002Fp>\n\u003Ch3 id=\"7-the-importer-read-it-and-said-no\">7. The importer read it and said no\u003C\u002Fh3>\n\u003Cp>Sites apply their own rules after reading a card. Goony, for one, checks every imported card against its content policy and refuses those that break it, anything involving minors for a start. And on sites where a creator&#39;s full definition sits behind a login, such as JanitorAI, an importer may only get the public part.\u003C\u002Fp>\n\u003Ch2 id=\"how-to-check-whether-a-png-still-has-a-card\">How to check whether a PNG still has a card\u003C\u002Fh2>\n\u003Ch3 id=\"the-text-editor-check\">The text-editor check\u003C\u002Fh3>\n\u003Cp>Open the PNG in a plain text editor (or any viewer that shows raw bytes) and search for \u003Ccode>chara\u003C\u002Fcode> and \u003Ccode>ccv3\u003C\u002Fcode>. Text chunks aren&#39;t compressed, so the keyword is readable among the binary noise. Right after it you should see a long run of letters and digits, usually starting with \u003Ccode>eyJ\u003C\u002Fcode>, which is how a JSON object beginning with \u003Ccode>{&quot;\u003C\u002Fcode> looks in base64. No keyword, no card.\u003C\u002Fp>\n\u003Ch3 id=\"the-script-check\">The script check\u003C\u002Fh3>\n\u003Cp>If you have Python installed, this short script reads the chunks and prints the card&#39;s spec and name. It uses only the standard library and changes nothing.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-python\">import sys, struct, base64, json\n\ndata = open(sys.argv[1], &#39;rb&#39;).read()\nif data[:8] != b&#39;\\x89PNG\\r\\n\\x1a\\n&#39;:\n    sys.exit(&#39;Not a real PNG (a renamed WebP or JPG, or an error page)&#39;)\npos, found = 8, False\nwhile pos &lt; len(data):\n    length, kind = struct.unpack(&#39;&gt;I4s&#39;, data[pos:pos + 8])\n    body = data[pos + 8:pos + 8 + length]\n    if kind == b&#39;tEXt&#39;:\n        key, _, value = body.partition(b&#39;\\x00&#39;)\n        if key.lower() in (b&#39;chara&#39;, b&#39;ccv3&#39;):\n            card = json.loads(base64.b64decode(value))\n            print(key.decode(), card.get(&#39;spec&#39;, &#39;v1&#39;), card.get(&#39;data&#39;, card).get(&#39;name&#39;))\n            found = True\n    pos += 12 + length\nif not found:\n    print(&#39;No card data in this file&#39;)\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Save it as \u003Ccode>checkcard.py\u003C\u002Fcode> and run \u003Ccode>python3 checkcard.py yourcard.png\u003C\u002Fcode>. A healthy V2 card prints something like \u003Ccode>chara chara_card_v2 Name\u003C\u002Fcode>; a file exported by SillyTavern prints two lines, one per chunk. &quot;No card data&quot; means the file is only a picture. A crash on the JSON line means the data is there but damaged.\u003C\u002Fp>\n\u003Ch3 id=\"the-app-check\">The app check\u003C\u002Fh3>\n\u003Cp>Import the file into an app that reads cards, then open the character and read its description. Empty fields mean empty data. If you use SillyTavern or RisuAI already, this is the fastest test.\u003C\u002Fp>\n\u003Ch2 id=\"fixes-that-actually-work\">Fixes that actually work\u003C\u002Fh2>\n\u003Col>\n\u003Cli>\u003Cstrong>Download it again from the source.\u003C\u002Fstrong> Go back to the card&#39;s page and use the site&#39;s download option, not a right-click on the image. If you can&#39;t remember where it came from, search the character&#39;s name on Chub; you may also find a newer version.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Take the JSON instead.\u003C\u002Fstrong> Where a site offers JSON, take it. It holds the same definition with no image to damage, and every major card app reads it. Keep the PNG for the portrait.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Ask the creator\u003C\u002Fstrong> for the original file, sent as a file or a zip, not pasted as an image.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Re-export from an app that can read it.\u003C\u002Fstrong> If one app reads the card and another doesn&#39;t, export a fresh V2 PNG or JSON from the one that works.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Rebuild it.\u003C\u002Fstrong> If the data is truly gone and you remember the character, the fields are short enough to retype: name, description, personality, scenario, first message, a few example lines.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2 id=\"or-skip-the-file-and-import-by-link\">Or skip the file and import by link\u003C\u002Fh2>\n\u003Cp>Most of these problems belong to files. A link-based importer fetches the card from the site that hosts it, so there&#39;s no image to recompress and no chunk to lose. SillyTavern can import by link from six card sites. Goony works only this way: paste a chub.ai, JanitorAI, AICharacterCards.com, Perchance, RisuRealm or TelegAI link or ID into \u003Ca href=\"\u002Fcharacters\u002Fimport\">Import a character\u003C\u002Fa>, and it reads the card (Tavern\u002FSillyTavern V2 and V3, Risu and Perchance formats) on its server. It has no PNG or JSON upload, so a card you only have as a file needs its page link instead. The full walk-through is in our guide to \u003Ca href=\"\u002Fblog\u002Fhow-to-import-a-character-card\">importing a character card\u003C\u002Fa>, and Chub cards are one click away in \u003Ca href=\"\u002Fcommunity\">the community catalogue\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>Imports on Goony default to Local: characters you create or import locally, and your Offline chats, live in your browser, not in Goony&#39;s database. Each reply is still generated on Goony&#39;s servers. If you&#39;re comparing where your cards work best, our \u003Ca href=\"\u002Fblog\u002Fjanitor-ai-vs-chub-ai\">Janitor AI vs Chub AI\u003C\u002Fa> and \u003Ca href=\"\u002Fblog\u002Fsillytavern-alternatives\">SillyTavern alternatives\u003C\u002Fa> pieces cover the main options.\u003C\u002Fp>\n\u003Ch2 id=\"faq\">FAQ\u003C\u002Fh2>\n\u003Ch3 id=\"why-does-my-card-import-as-a-blank-character\">Why does my card import as a blank character?\u003C\u002Fh3>\n\u003Cp>The importer found an image but no card data inside it, or only part of it. Download the card again from its page, preferably as JSON, and check the new file for a chara or ccv3 text chunk.\u003C\u002Fp>\n\u003Ch3 id=\"can-i-convert-a-webp-or-jpg-card-back-to-png\">Can I convert a WebP or JPG card back to PNG?\u003C\u002Fh3>\n\u003Cp>You can convert the image, but the character won&#39;t come back. The card data lived in a PNG text chunk that the conversion threw away, so you need the original file or the card&#39;s page.\u003C\u002Fp>\n\u003Ch3 id=\"what-s-the-difference-between-the-chara-and-ccv3-chunks\">What&#39;s the difference between the chara and ccv3 chunks?\u003C\u002Fh3>\n\u003Cp>The chara chunk holds a V2 card and the ccv3 chunk holds a V3 card, both as base64-encoded JSON. The V3 spec says apps that find both should use ccv3, and SillyTavern writes both when it exports a PNG.\u003C\u002Fp>\n\u003Ch3 id=\"is-a-json-card-safer-than-a-png-card\">Is a JSON card safer than a PNG card?\u003C\u002Fh3>\n\u003Cp>For keeping the definition intact, yes. A JSON file can&#39;t lose its data to image compression, though it carries no portrait. Keeping both is the safest habit.\u003C\u002Fp>\n\u003Ch3 id=\"can-goony-read-my-png-card-file\">Can Goony read my PNG card file?\u003C\u002Fh3>\n\u003Cp>No. Goony imports cards by link or ID from six card sites and has no file upload. Find the card&#39;s page on one of those sites and paste the link, or rebuild the character in the creator.\u003C\u002Fp>\n\u003Ch3 id=\"why-does-a-card-work-in-sillytavern-but-not-in-another-app\">Why does a card work in SillyTavern but not in another app?\u003C\u002Fh3>\n\u003Cp>Usually a version mismatch: the card may be V3-only or a CHARX file, and the other app may read only V2 PNGs. Export a V2 PNG or a JSON copy from SillyTavern and import that instead.\u003C\u002Fp>\n",[22,25,28,31,34,37,40],{"id":23,"text":24},"quick-diagnosis","Quick diagnosis",{"id":26,"text":27},"how-the-character-hides-inside-a-png","How the character hides inside a PNG",{"id":29,"text":30},"the-usual-causes","The usual causes",{"id":32,"text":33},"how-to-check-whether-a-png-still-has-a-card","How to check whether a PNG still has a card",{"id":35,"text":36},"fixes-that-actually-work","Fixes that actually work",{"id":38,"text":39},"or-skip-the-file-and-import-by-link","Or skip the file and import by link",{"id":41,"text":42},"faq","FAQ",[44,47,50,53,56,59],{"question":45,"answer":46},"Why does my card import as a blank character?","The importer found an image but no card data inside it, or only part of it. Download the card again from its page, preferably as JSON, and check the new file for a chara or ccv3 text chunk.",{"question":48,"answer":49},"Can I convert a WebP or JPG card back to PNG?","You can convert the image, but the character won't come back. The card data lived in a PNG text chunk that the conversion threw away, so you need the original file or the card's page.",{"question":51,"answer":52},"What's the difference between the chara and ccv3 chunks?","The chara chunk holds a V2 card and the ccv3 chunk holds a V3 card, both as base64-encoded JSON. The V3 spec says apps that find both should use ccv3, and SillyTavern writes both when it exports a PNG.",{"question":54,"answer":55},"Is a JSON card safer than a PNG card?","For keeping the definition intact, yes. A JSON file can't lose its data to image compression, though it carries no portrait. Keeping both is the safest habit.",{"question":57,"answer":58},"Can Goony read my PNG card file?","No. Goony imports cards by link or ID from six card sites and has no file upload. Find the card's page on one of those sites and paste the link, or rebuild the character in the creator.",{"question":60,"answer":61},"Why does a card work in SillyTavern but not in another app?","Usually a version mismatch: the card may be V3-only or a CHARX file, and the other app may read only V2 PNGs. Export a V2 PNG or a JSON copy from SillyTavern and import that instead.","https:\u002F\u002Flwdy-fansite.b-cdn.net\u002Fcharacters\u002Fb9b65855-f860-43b6-a51d-822a5489cc24\u002Fportrait-1786990943836.jpg",[64,68],{"slug":15,"name":65,"portrait":62,"tagline":66,"age":67},"Jinhee","Shy on stream, shamelessly direct once the camera goes dark",24,{"slug":18,"name":69,"portrait":70,"tagline":71,"age":72},"Hana Sato","https:\u002F\u002Flwdy-fansite.b-cdn.net\u002Fcharacters\u002Fc0b23ada-4710-465b-b229-22f71cb1098a\u002Fportrait-1792774346982.png","Your gamer roommate needs a photographer for her new cosplay. It's… a bold costume",23,[74,82,92],{"slug":75,"title":76,"description":77,"date":78,"updated":78,"category":9,"tags":79,"cover":15,"featured":16,"readingMinutes":19,"coverPortrait":62},"sillytavern-on-iphone","Can you run SillyTavern on iPhone? Options in 2026","SillyTavern can't run on an iPhone itself. How to reach it from Safari (home computer, VPN or tunnel, cloud server), and when a hosted card site is simpler.","2026-11-01",[14,80,11,81],"iphone","setup",{"slug":83,"title":84,"description":85,"date":86,"updated":86,"category":9,"tags":87,"cover":90,"featured":16,"readingMinutes":19,"coverPortrait":91},"what-is-a-character-card","What is a character card? V2, V3 and PNG cards explained","A character card is a portable AI character: JSON fields, usually hidden inside a PNG. The V1, V2 and V3 formats, field by field, and how apps use them.","2026-10-29",[11,88,89,14],"tavern card","character card v2","kiri","https:\u002F\u002Flwdy-fansite.b-cdn.net\u002Fcharacters\u002F39f24d33-eb53-4079-af62-a4bd8c16721c\u002Fportrait-1792773993928.png",{"slug":93,"title":94,"description":95,"date":96,"updated":96,"category":9,"tags":97,"cover":90,"featured":16,"readingMinutes":101,"coverPortrait":91},"how-to-import-a-character-card","How to import a character card (Chub, Janitor & more)","Import a character card from a PNG, a JSON file or a link. What SillyTavern, RisuAI, SpicyChat and PolyBuzz accept, and how Goony imports by link.","2026-10-25",[11,98,99,100,14],"import","chub ai","janitorai",7,1794970727942]