Setup guide · About 2 minutes

Save your first post.

Connect X once, pair the Obsidian plugin, and your mentions become markdown notes.

Step 01

Sign in with X

Open Save2Obsidian and choose Sign in with X. X will ask you to authorize basic read access so we can identify your account. We do not ask for permission to post, like, follow, or send direct messages.

Sign in with X
Screenshot coming soon
Authorize app
Step 02

Copy your personal key

After signing in, you will land on the dashboard. Find your API key, choose Show if you want to inspect it, then choose Copy key.

Keep it private. Your key lets the plugin access notes saved to your account. Do not post it or include it in screenshots.

Screenshot coming soon
API KEY x56•••••••••••••••••••••••• Copy key
Step 03

Install the Obsidian plugin

Choose either method below. The Community plugins store is the simplest option once the listing is available.

Recommended

Community plugins store

  1. In Obsidian, open Settings → Community plugins.
  2. Turn off Restricted mode if Obsidian asks.
  3. Choose Browse and search for Save2Vault.
  4. Choose Install, then Enable.
Alternative

Manual GitHub install

  1. Download the latest plugin files from GitHub Releases.
  2. Create .obsidian/plugins/save-to-vault/ inside your vault.
  3. Place main.js, manifest.json, and styles.css in that folder.
  4. Reload Obsidian, then enable Save2Vault under Community plugins.
Open plugin repository →
Step 04

Paste the key in plugin settings

Open Settings → Save2Vault, paste the key into the API key field, and click Test connection to confirm it works. Then click Sync now to run your first sync — after that, the plugin also checks for new notes automatically every 30 minutes while Obsidian is open.

Screenshot coming soon
Save2Vault settings API key x56•••••••••••••••••••••••• Save settings
Step 05

Mention the bot under a post

On X, open any post you want to keep. Reply with @save2obsidian. That is all you need—there is no special command syntax.

A useful post

The idea you want to revisit, with its context and images.

@save2obsidian
Step 06

Look in your vault

Give the service and plugin a short moment to process and sync. A new markdown note will appear in your configured Save2Obsidian folder, ready to edit, link, tag, or move.

You can also check Recent saves on the dashboard to confirm that the post reached your account.

First save complete Your X post is now a markdown note.
FAQ

A few useful details

How long does a note take to appear?

Usually a short moment. Processing time can vary with the post and how often your Obsidian plugin is checking for new notes. If nothing appears after several minutes, confirm that the plugin is enabled and the key is correct, then check Recent saves on your dashboard.

Does Save2Obsidian support video?

For now, video posts are saved with their link, text, and available context. Video transcription is planned for a later release.

Can I choose where notes are stored?

Yes. Use the Save2Vault plugin settings to choose the destination folder inside your vault.

How do I unlink my X account?

Account unlinking will move to a self-service settings page in a future update. For now, email support@save2obsidian.com and ask us to remove the link.