satsroad
← All packs

Paid pack · 21,000 sats ≈ $15.99

X Bookmarks → Obsidian

Automate archiving your X/Twitter bookmarks into an Obsidian vault. Full-text capture, image descriptions, Whisper video transcripts, LLM-tagged notes, and bidirectional topic links — runs as a cron.

What you get

A self-contained automation kit (zip) that continuously archives your X/Twitter bookmarks into a local Obsidian vault. Once set up it runs unattended on a schedule.

  • Full-text capture — each bookmarked post is saved as a Markdown note with author, date, and thread context
  • Image descriptions — images in bookmarks are downloaded and described via a vision model so they are searchable as text
  • Whisper video transcripts — video and audio attachments are transcribed with OpenAI Whisper and embedded in the note
  • LLM-tagged notes — each note is auto-tagged with topics and categories by an LLM, making your vault browsable by theme
  • Bidirectional topic links — related bookmarks are cross-linked via Obsidian [[wikilinks]] so you can navigate between ideas
  • Cron runner — a scheduler config that pulls new bookmarks on an interval you choose (hourly, daily, etc.)

Prerequisites

RequirementDetails
X / Twitter accountWith bookmarks you want to archive. You will need your auth cookies or API credentials.
ObsidianAny recent version. The pack writes standard Markdown; no community plugins required to view notes.
Python 3.11+Runtime for the archiver scripts. A requirements.txt is included.
OpenAI API keyUsed for Whisper transcription and LLM tagging. Can also be pointed at a local/compatible endpoint.
Disk space~50 MB base + ~1 MB per 100 bookmarks (varies with media).

How it works

  1. Fetch — the runner authenticates with X and pulls your latest bookmarks since the last sync
  2. Process — each bookmark is expanded into full text, media is downloaded, images are described, videos are transcribed
  3. Tag — an LLM reads each note and assigns topic tags + suggests links to related notes already in your vault
  4. Write — Markdown files are written (or updated) in your Obsidian vault directory with YAML frontmatter and wikilinks
  5. Schedule — a cron entry (or systemd timer) re-runs the pipeline on your chosen interval

Setup (after purchase)

  1. Unzip the pack into a working directory
  2. Copy .env.example to .env and fill in your X credentials, OpenAI key, and vault path
  3. Run pip install -r requirements.txt
  4. Run python run.py once to verify everything works
  5. Add the provided cron line to your crontab (crontab -e) for recurring syncs