toolbox/extras/characterai-dumper
11b d638bb5625 feat: update userscript to allow dumping of definitions as well 2022-12-21 16:03:13 -03:00
..
example-images feat: update userscript to allow dumping of definitions as well 2022-12-21 16:03:13 -03:00
README.md feat: update userscript to allow dumping of definitions as well 2022-12-21 16:03:13 -03:00
characterai-dumper.user.js feat: update userscript to allow dumping of definitions as well 2022-12-21 16:03:13 -03:00

README.md

CharacterAI Dumper Userscript

This userscript allows you to download your saved messages with any bot you've ever talked to, given you can reach their chat history page. If you're a bot creator, it also allows you to separately download your bot's definitions.

How to use

  • Install a userscript manager.
    • Personally I tested this with Violentmonkey on Firefox, but I think Greasemonkey and Tampermonkey should work as well.
  • Install the userscript from here.
  • Now, while you're talking to a character, click on "View Saved Chats" to go to their histories page: Where to find "View Saved Chats"
  • After a few seconds, a Download link should pop up next to the "Your past conversations with so-and-so" header: What the download link looks like
  • Clicking on the link will download a .json file containing the bot's basic info (name, description, greeting) and all the interactions you've ever had with it.
  • If you're a bot creator, you can also head over into the Character Editor to download a bot's definitions: Where to find the definitions download

NOTE 1: If you've never used the "Save and Start New Chat" feature, you won't have the "View Saved Chats" option shown in the first screenshot.

That's fine, it just means you'll need to manually access the histories page by replacing the /chat path with /histories in the URL. For example, if you're at:

https://beta.character.ai/chat?char={{BOT_ID_HERE}}

Just rewrite the URL so it reads:

https://beta.character.ai/histories?char={{BOT_ID_HERE}}

And you'll reach the page that should show the Download link.


NOTE 2: The script attempts to anonymize the dumped data (it scrubs known sensitive fields and attempts to replace any instances of your name within messages), but if you're paranoid, you should open the downloaded JSON and search for your username/email/display name just to make sure.

Troubleshooting

If the Download link doesn't show up after a few seconds and you're on the proper page, check the DevTools console for errors.

The most probable causes of breakage are:

  • You have some browser extension which stopped the userscript from loading its external dependencies properly; or
  • CharacterAI changed their API around in ways the script didn't expect, and I'll need to release an update.