How to Set Up Obsidian Vault Sync

Connecting your Obsidian vault to Draggen allows you to bridge the gap between your structured notes and your visual moodboards. By using the Kadima Obsidian plugin, you can browse your markdown files and assets directly within the Draggen interface, making it easy to reference project briefs, character descriptions, or world-building notes while you design.

Step 1: Verify Your Subscription Tier

Before starting the setup, ensure your account is eligible for this feature. The Obsidian Vault Sync is an advanced integration available exclusively to users on the Creator (Pro) and Archivist tiers. To check your current status, navigate to the Dashboard and select the Account & Plan section.

If you are currently on the Guest or Explorer tier, you will need to click Upgrade and complete the subscription process via Stripe to unlock the integrations panel. Once your account reflects the Creator or Archivist status, the necessary settings will become visible.

Step 2: Access the Integrations Menu

Once you have the correct subscription, head to your Dashboard. In the side navigation or account dropdown, click on Account & Integrations. This area serves as the central hub for connecting external services and managing your API Keys.

Scroll down until you see the Obsidian Vault Sync section. Here, you will find the configuration details and the link to the required plugin.

Step 3: Install the Kadima Obsidian Plugin

The sync requires a bridge on your local machine to communicate with the Draggen web app. Click the link in the integrations menu to visit the GitHub repository for the Kadima Obsidian plugin. Follow the installation instructions to add the plugin to your Obsidian application.

After installing the plugin in Obsidian, you will need to enable it in your Community Plugins settings. The plugin is responsible for indexing your obsidianVaults and entries and securely populating that data so it can be viewed within Draggen.

Step 4: Connect Your Vault

With the plugin active in Obsidian, navigate to the settings screen.

Select the "Connect Kadima" button to start the pairing process Select the "Create" button (and optionally enter a different name) to create a new remote vault to sync your details to, or use the "Connect" button to synchronize the vault with one that you previously created on a different device.

Finally double check everything on the review screen and press accept. Your sync is now active.

Step 5: Browse Your Vault in Draggen

Now that the sync is active, you can access your notes at any time from the Dashboard. Click on the Vault tab located at the top of the project list. This interface allows you to browse through your folders and files just as they appear in Obsidian.

From this view, you can read the content of your notes to gather inspiration for your moodboards. This is particularly useful for users utilizing Note Cards or the RPG Campaign Visual Generator, as it allows you to keep your written lore side-by-side with your visual direction.

Tips

• Stay Organized: Draggen reflects the folder structure of your vault. Keep your inspiration images and project notes in dedicated folders within Obsidian to make them easier to find in the Vault tab.
• Refresh Sync: If you've recently added new files to Obsidian and don't see them in Draggen, ensure the Kadima plugin is active and has finished its local indexing process.
• Use for Reference: Keep a note open in a separate window or tab while using the AI Prompt Bar to help you describe specific elements you want to add to your canvas based on your written descriptions.

Conclusion

By setting up the Obsidian Vault Sync, you have turned Draggen into a powerful companion for your note-taking workflow. You can now seamlessly navigate between your text-based world-building in Obsidian and your visual design work on the Draggen canvas. Remember that this integration is a "browser" experience, allowing you to pull inspiration from your vault into your design process without disrupting your local file structure.