Nexus AI Chat Importer Plugin for Obsidian

Overview

Version 1.0.3 of the Nexus AI Chat Importer Plugin for Obsidian introduces a major new feature: support for importing advanced voice mode conversations. This update significantly enhances the plugin’s capabilities while maintaining its stability and performance.

Table of Contents

1. About
2. Overview
3. Features
4. Installation
5. Configuration
6. Usage
   1. Exporting ChatGPT Data
   2. Importing into Obsidian
   3. Import Results
   4. Resetting the Import Catalog
7. Understanding the Import Report
8. More Features
   1. Opening Conversation in its Original Webapp
9. Troubleshooting
10. Important Notes

About

Master branch: 1.0.3 (Stable Release)
dev branch: refactor/2.0.0-alpha.3 - Refactoring in progress

The Nexus AI Chat Importer Plugin simplifies the process of importing ChatGPT conversations from export files into Obsidian.

Overview

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.

Features

• 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
• One-time upgrade check to ensure users are up-to-date
• Improved import reports with more accurate and detailed information

Installation

1. Enable Community Plugins in Obsidian settings.
2. Browse the Community Plugins list and search for "Nexus AI Chat Importer".
3. Click "Install" to install the plugin.
4. Enable the plugin in the Plugins settings.

Configuration

1. Go to Settings > Nexus AI Chat Importer
2. Set the "Nexus AI Chat Importer Folder" to specify where imported conversations will be stored

Usage

Exporting ChatGPT Data

1. Log in to your ChatGPT account.
2. Click your user icon (usually, a circle with your initials)
3. Navigate to the "Settings" then "Data controls" section.
4. Click the "Export" button next to "Export data". You will soon receive an email with a download link

Importing into Obsidian

1. Open the Nexus AI Chat Importer plugin in Obsidian.
2. Click the "Import" button or call the .
3. Select the exported JSON file.
4. Choose the destination folder for the imported conversations.
5. Click "Import" to start the import process.

Usage

Exporting ChatGPT Data

1. Log in to ChatGPT (chat.openai.com)
2. Click on your user icon and select "Settings & Beta"
3. Go to "Data Controls" and click on "Export Data"
4. Click "Export" and wait for an email with the download link
5. Download the ZIP file containing your ChatGPT data

Importing into Obsidian

1. In Obsidian, open the Command Palette (Cmd/Ctrl + P), search for and select "Nexus AI Chat Importer: Select export archive", or click the "Nexus AI Chat Importer" icon in the left sidebar
2. Choose the ZIP file you downloaded from ChatGPT
3. The plugin will process the file and import your conversations

Import Results

• 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

Resetting the Import Catalog

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.

1. Open the Command Palette (Cmd/Ctrl + P)
2. Search for and select "Reset Nexus AI Chat Importer Catalogs: Reset Catalogs"
3. Confirm the action when prompted

Understanding the Import Report

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.

More Features

Opening Conversation in its Original Webapp

By clicking the note title, you will be directed to the original conversation webapp directly in your default browser. Be aware that:

1. The conversation must still exist in your account history.
2. You need to be authenticated in your browser.
3. You may require an active subscription to access your chat history.

Troubleshooting

• 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.

Important Notes

• 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.