ChatKeeper 1.2.0

April 6, 2025

Lots of little updates in this one, plus a couple of bigger things. Open AI continues to evolve their export format as they add new features, like the new GPT4o image generator, which this release supports. Here are the details:

Exporting Generated Images

ChatKeeper will now export your generated images, whether they were created by DALL-E or the amazing new GPT4o image generator. Just like with conversations, you can rename or move them, and ChatKeeper will find them and re-link them to your conversations (rather than re-export them) on subsequent runs.

You have some flexibility on where the images end up, via a new -i or --images option:

• --images none doesn’t export images at all. This is the default behavior.
• --images samedir exports each image into the same directory as the conversation that generated it.
• --images fixed:PATH exports all images into a fixed directory relative to your output directory. For example, if you run chatkeeper keep mychats.zip mydir --images fixed:pics, then all images will be exported to mydir/pics. If your path contains spaces, be sure to quote this argument, like so: --images "fixed:PATH WITH SPACES"
• --images subdir:PATH exports each image into a fixed subdirectory relative to the directory containing the conversation that generated it. That’s a mouthful, so here’s an example: If you specify --images subdir:pics and your export includes conversations that are saved in 2025/04/2025-04-06/Image Example 1.md and 2024/12/2024-12-25/Image Example 2.md, then the images for each conversation will be exported to 2025/04/2025-04-06/pics and 2024/12/2024-12-25/pics, respectively. If your path contains spaces, be sure to quote this argument, like so: --images "SUBDIR:PATH WITH SPACES"

If your markdown reader supports it, the result is that your images are displayed inline with your conversations regardless of where they were exported, just as you would want them.

Handling Unzipped Exports (thanks, Safari!)

Some browsers (ahem), will “helpfully” unzip the ChatGPT export file automatically after downloading it by default. This can be confusing for people who are already stepping out of their comfort zone to use a command line application. Earlier versions of ChatKeeper couldn’t handle this and generated a REALLY unhelpful error message.

ChatKeeper now handles these unzipped exports just like a .zip file. Users can simply specify on the command line, in place of the zip file, the path to the unzipped export directory or the conversations.json file it contains.

Smaller Stuff

• Support for Tasks. These are subtly different from “normal” conversations. For example, ChatGPT can take multiple conversations “turns” in a row.
• Added “Turn Count” to yaml front matter. ChatKeeper will note the the number of conversation “turns” as metadata that you can use as you wish.
• Improved detection and handling of corrupted or truncated download files. These have become much more likely now that export files have grown so large. There’s not much ChatKeeper can do with these, but now it at least provides a helpful error message if it encounters one.
• Improved rendering of search results and citations. ChatGPT provides both in several different ways, and ChatKeeper now handles the new ones I’ve seen, like in Deep Research results.
• Improved error reports when ChatKeeper runs into a real issue. In order to avoid excessive back and forth during support, the generated reports will include more information, such as os/architecture, some very limited parts of the environment (charset, locale, etc.), and the command line options provided at launch. The full error report is plain text, more informative than before, and can be viewed or redacted if you like before sending my way.
• Better handling of yaml “front matter”. ChatKeeper will no longer “step on” any front matter you add after an export. Earlier versions removed new front matter when updating an existing document.
• Lots of minor bug fixes and other enhancements.

Download ChatKeeper 1.2.0 for Windows (x86/64) (37,781,504 bytes) ⬅
SHA1 SHA256

Install ChatKeeper 1.2.0 for Mac via Homebrew

brew install martian-software-inc/chatkeeper/chatkeeper

Download ChatKeeper 1.2.0 for Mac (arm64) - executable (33,827,880 bytes) ⬅
SHA1 SHA256

Download ChatKeeper 1.2.0 for Mac (x86/64) - executable (34,523,992 bytes) ⬅
SHA1 SHA256

Download ChatKeeper 1.2.0 for Linux (x86/64) (10,095,212 bytes) ⬅
SHA1 SHA256