Master branch: 1.0.2 (Stable Release) dev-modular branch: 2.0.0-alpha.1 - Refactoring in progress
The Nexus AI Chat Importer Plugin simplifies the process of importing ChatGPT conversations from export files into Obsidian.
The Nexus AI Chat Importer Plugin for Obsidian allows you to seamlessly import your AI chat conversations from export files into your Obsidian vault. This plugin organizes your ChatGPT conversations into readable Markdown files, making them easily accessible and searchable within Obsidian.
- Import conversations from export files directly into Obsidian
- Automatically organize conversations by date
- Create individual Markdown files for each conversation
- Update existing conversations with new messages
- Detailed import reports for tracking the import process
- Click on the conversation title to open the chat in the original web app
- One-time upgrade check to ensure users are up-to-date
- Open the original ChatGPT conversation directly from Obsidian with a single click
- Improved import reports with more accurate and detailed information
- Download the contents of the
distfolder from the repository. - In your Obsidian vault, navigate to the
.obsidian/plugins/directory. - Create a new folder called
nexus-ai-chat-importer. - Copy the downloaded files into the
nexus-ai-chat-importerfolder. - Open Obsidian and go to Settings > Community Plugins.
- Disable Safe Mode if it's enabled.
- Refresh the list of plugins.
- Find "Nexus AI Chat Importer" in the list and enable it by toggling the switch.
Note: You may need to restart Obsidian after installing the plugin for it to appear.
For detailed installation instructions, please refer to the README file included in this release.
- Go to Settings > Nexus AI Chat Importer
- Set the "Nexus AI Chat Importer Folder" to specify where imported conversations will be stored
- Optionally, enable "Add Date Prefix to Filenames" and choose a date format
- Log in to ChatGPT (chat.openai.com)
- Click on your user icon and select "Settings & Beta"
- Go to "Data Controls" and click on "Export Data"
- Click "Export" and wait for an email with the download link
- Download the ZIP file containing your ChatGPT data
- In Obsidian, open the Command Palette (Cmd/Ctrl + P)
- Search for and select "Nexus AI Chat Importer: Select export archive"
- Choose the ZIP file you downloaded from ChatGPT
- The plugin will process the file and import your conversations
- New conversations will be created as individual Markdown files
- Existing conversations will be updated with new messages (if any)
- An import report will be generated in the archive folder, detailing the results
- Open the Command Palette (Cmd/Ctrl + P)
- Search for and select "Reset Nexus AI Chat Importer Catalogs: Reset Catalogs"
- Confirm the action when prompted
The import report provides a summary of the import process, including:
- Total number of existing conversations
- Number of new conversations imported
- Number of conversations updated
- Number of new messages added
It also includes detailed tables for created, updated, and skipped notes.
- If the import fails, check the console log for error messages
- Ensure you have write permissions for your Obsidian vault
- Verify that the ZIP file is a valid ChatGPT export
- This version introduces new metadata parameters required for certain features. Users are advised to re-import their conversations to ensure full functionality.
- The plugin has been officially renamed to "Nexus AI Chat Importer" to better reflect its functionality.
- For users upgrading from previous versions, it's recommended to delete old data and re-import conversations with this new version for optimal performance and feature compatibility.
For more detailed information about the latest release, please refer to the Release Notes.