A Sync Plugin for Obsidian & Telegram
A

A Sync Plugin for Obsidian & Telegram

A Sync Plugin for Obsidian & Telegram

669 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Sync Your Thoughts: An Obsidian Plugin for Telegram

If you're like most developers, ideas and code snippets hit you at the most random times. You might be in line for coffee, walking the dog, or—let's be honest—lying in bed at 2 AM. The challenge is capturing those fleeting thoughts before they vanish, and getting them into your trusted knowledge system, Obsidian. That's where this clever little plugin comes in.

Enter the Obsidian Telegram Sync plugin. It bridges the gap between the quick-capture convenience of Telegram and the powerful, linked-note environment of Obsidian. No more emailing yourself, copying to a temporary note, or losing the thought entirely.

What It Does

In a nutshell, this plugin creates a two-way sync between your Obsidian vault and Telegram. You can send messages, images, voice notes, or documents from any of your Telegram devices (phone, desktop, web) directly into a designated folder in your Obsidian vault. The plugin runs locally, acting as a bot that listens for your messages and neatly files them away as markdown notes and attachments.

Why It's Cool

The implementation is straightforward and developer-friendly. It uses the Telegram Bot API, so setup is a matter of getting a token from BotFather and telling the plugin which chat to monitor. Everything stays on your machine; your data isn't passing through a third-party sync service.

The real power is in the workflow it enables. Imagine:

  • Quick logging: Jot down a meeting takeaway on your phone during a call, and it's waiting in your daily note when you're back at your desk.
  • Code snippet capture: Share a brilliant snippet you found on your laptop's Telegram app directly into your code-snippets.md file.
  • Voice memo to text: Send a voice message with a complex idea, and the plugin can save the audio file and use OpenAI's Whisper to transcribe it into text (this is an optional feature).
  • Centralized attachments: Forward interesting PDFs, images, or documents from group chats straight into your knowledge base for later processing.

It turns Telegram into a ubiquitous, frictionless input device for your second brain.

How to Try It

The plugin is available in the Obsidian Community Plugins directory. Here's the quick start:

  1. Install: Open Obsidian, go to Settings > Community plugins > Browse, and search for "Telegram Sync."
  2. Get a Bot Token: Message @BotFather on Telegram to create a new bot and get your API token.

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Dec 3, 2025