Version 1.0.5 of the Nexus AI Chat Importer Plugin for Obsidian introduces support for multiple file imports, allowing batch processing of conversation exports while maintaining data consistency.
- About
- Overview
- Features
- Installation
- Configuration
- Usage
- Understanding the Import Report
- More Features
- Troubleshooting
- Important Notes
Master branch: 1.0.7 (Stable Release)
The Nexus AI Chat Importer Plugin simplifies the process of importing ChatGPT conversations from export files into Obsidian.
The plugin allows you to seamlessly import your AI chat conversations from export files into your Obsidian vault. It organizes your ChatGPT conversations into readable Markdown files, making them easily accessible and searchable within Obsidian. With support for multiple file imports and iOS devices, you can efficiently manage your conversations across all platforms.
- Import multiple conversations from multiple export files directly into Obsidian
- Process multiple exports in chronological order
- 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
- One-time upgrade check with dynamic release notes integration
- Direct links to original chat conversations in both title and header
- Improved import reports with more accurate and detailed information
- iOS support for managing conversations on mobile devices
- Modular architecture preparing for multiple provider support
- Enable Community Plugins in Obsidian settings.
- Browse the Community Plugins list and search for "Nexus AI Chat Importer".
- Click "Install" to install the plugin.
- Enable the plugin in the Plugins settings.
- Ensure you have the latest version of Obsidian installed on your iOS device.
- Follow the same steps as above to enable and install the Nexus AI Chat Importer plugin.
- The plugin will now be available for use on your iOS device.
- Go to Settings > Nexus AI Chat Importer
- Set the "Nexus AI Chat Importer Folder" to specify where imported conversations will be stored
- Log in to your ChatGPT account.
- Click your user icon (usually, a circle with your initials)
- Navigate to the "Settings" then "Data controls" section.
- Click the "Export" button next to "Export data".
You will soon receive an email with a download link
- Click the "AI Chat Importer - import new file" (chat icon with a + sign) button or open the command prompt (CTRL/Command P) and search for Nexus AI Chat Importer: Select ZIP file to process
- Click Continue Select one or multiple archive files you have downloaded from the chat provider platform
- Files will be processed in chronological order to maintain data consistency
- Close the sidebar if it's open by sliding to the left and click on the menu icon at the bottom right of the screen
- Select the "AI Chat Importer - import new file" option (chat icon with a + sign)
- Select the archive file you have previously downloaded from the chat provider platform
- The plugin is designed to work seamlessly across multiple devices and platforms.
- You can use it on your desktop computer or iOS device however, it is imperative to ensure any type of synching in place has been completed prior to importing new files.
- A tree of years/months will be created in the destination folder you selected in the configuration step
- New conversations will be created as individual Markdown files
- A date prefix will be added to each NEW conversation according to the selected date format
- Existing conversations will be updated with new messages (if any)
- An import report will be generated in the Reports subfolder, detailing the results
If you encounter issues with the import process or want to start fresh, you can reset the import catalog. This will clear the list of imported conversations, allowing you to import the same data again.
- Open the Command Palette (Cmd/Ctrl + P)
- Search for and select "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.
By clicking the note title, you will be directed to the original conversation webapp directly in your default browser. This feature works only once indexing is completed.
Beware:
- The conversation must still exist in your account history.
- You need to be authenticated in your browser.
- You may require an active subscription to access your chat history.
- 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.
- When importing multiple files, ensure they have valid timestamps in their filenames for proper ordering
- Version 1.0.2 has 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.
I'd like to thank the following contributors for their valuable contributions to our project:
- GitHub user @drainch: Added iOS support, making changes to
manifest.json,README.md,package.json,esbuild.config.mjs, and updated the release notes inv1.0.4_RELEASE_NOTES.md.