Reminder Telegram

Never miss a deadline again! Get Telegram notifications automatically when your Obsidian tasks are due.

Why This Plugin?

Do you manage tasks in Obsidian but sometimes forget to check them? This plugin bridges the gap between your note-taking and your daily workflow by sending timely Telegram reminders directly to your phone or desktop.

Whether you use YAML frontmatter for structured task management or prefer inline task lists, Reminder Telegram ensures you stay on top of your deadlines without constantly checking Obsidian.

Key Features

• 📋 YAML Frontmatter Support: Parse tasks from markdown files with structured frontmatter
• ✅ Inline Task Support: Works with traditional Obsidian task format (- [ ] Task 📅 2024-01-01)
• 🗂️ Flexible Scanning: Choose to scan your entire vault or a specific folder
• 📱 Telegram Integration: Instant notifications via Telegram Bot API
• ⏱️ Configurable Intervals: Check for due tasks every 30 minutes (or your preferred interval)
• 📦 Bulk Notifications: Get all due tasks in a single message
• 🚫 Duplicate Prevention: Smart tracking to avoid repeated notifications
• 🔔 Interactive Status Bar: Click the status bar icon to manually check for due tasks
• ⏰ Status Updates: See when the last check was performed in the status bar
• 🎨 Customizable Messages: Personalize Telegram notification text with templates and variables
• 📝 Markdown Support: Enable Telegram Markdown formatting for rich text notifications

Installation

From Obsidian Community Plugins

1. Go to Settings → Community plugins → Browse
2. Search for "Reminder Telegram"
3. Install and enable the plugin

Manual Installation

1. Clone this repository or download the latest release
2. Copy main.js, manifest.json, and styles.css to your vault's .obsidian/plugins/obsidian-reminder-telegram/ folder
3. Reload Obsidian and enable the plugin in Settings → Community plugins

Usage

Setting Up Telegram

1. Create a Telegram Bot:

   • Open Telegram and search for @BotFather
   • Send /newbot command
   • Follow instructions to name your bot and get the Bot Token

2. Get Your Chat ID:

   • Open Telegram and search for @userinfobot
   • Send /start command
   • It will reply with your Chat ID

3. Configure the Plugin:

   • Go to Settings → Reminder Telegram
   • Enter your Telegram Bot Token
   • Enter your Telegram Chat ID
   • Enable Notifications
   • Set your preferred Check Interval (default: 30 minutes)

Task Formats Supported

YAML Frontmatter (Recommended)

Create markdown files with YAML frontmatter:

---
status: open
priority: normal
scheduled: 2024-12-25
tags:
  - task
---

# My Task
Complete this task by Christmas

Supported Frontmatter Fields:

• status: open, done, in-progress, completed, cancelled, archived
• scheduled: Deadline date (ISO format: YYYY-MM-DD or YYYY-MM-DDTHH:MM)
• due: Alternative deadline field
• tags: Array of tags (must include task or #task to be recognized)
• completedDate: If set, task is considered completed

Inline Tasks

Traditional Obsidian task format within any markdown file:

- [ ] Complete project by 📅 2024-12-25
- [ ] Review notes due:: 2024-12-20
- [ ] Meeting scheduled:: 2024-12-15

Supported Date Formats:

• 📅 YYYY-MM-DD
• due:: YYYY-MM-DD
• scheduled:: YYYY-MM-DD
• starts:: YYYY-MM-DD
• Plain dates: YYYY-MM-DD, MM/DD/YYYY, DD-MM-YYYY

Scan Configuration

Choose what to scan:

1. Whole Vault (default): Scans all markdown files in your entire vault
2. Specific Folder: Scans only files in a specified folder

To use a specific folder:

• Set Scan Mode to "Specific Folder"
• Enter the folder path (e.g., Tasks or Meta/TaskNotes/Tasks)

Commands

• Check reminders now: Manually trigger a deadline check
• Send test Telegram notification: Verify your Telegram configuration

Message Template Customization

Customize the content and format of your Telegram notifications:

Available Template Variables

Bulk Message Template (for multiple tasks):

• {count}: Number of due tasks
• {tasks}: List of formatted tasks

Individual Message Template (for single tasks):

• {taskName}: Task name/text
• {fileName}: File name containing the task
• {deadline}: Task deadline date
• {filePath}: Full path to the file
• {taskId}: Unique task identifier

Example Templates

Bulk Notification:

📋 You have {count} pending tasks due today:

{tasks}

Please check your Obsidian vault!

Individual Notification:

🔔 REMINDER: {taskName}
📁 File: {fileName}
📅 Due: {deadline}

Test Notification:

✅ Reminder Telegram plugin is working!
This is a test from your Obsidian vault.

Markdown Formatting

Enable Markdown formatting in settings to use Telegram's Markdown syntax for rich text formatting:

• *bold* for bold text
• _italic_ for italic text
• `code` for monospace text
• [link](https://example.com) for links

Settings

Setting	Type	Default	Description
Telegram Bot Token	string	''	Bot token from @BotFather
Telegram Chat ID	string	''	Your chat ID for notifications
Notifications Enabled	boolean	true	Enable/disable notifications
Check Interval (minutes)	number	30	How often to check for due tasks
Scan Mode	dropdown	whole-vault	Scan entire vault or specific folder
Target Folder	string	''	Folder to scan (when Scan Mode is "Specific Folder")
Bulk Message Template	string	"You have {count} task(s) due:\n\n{tasks}"	Template for multiple tasks
Individual Message Template	string	"Task Reminder\n\nTask: {taskName}\nFile: {fileName}\nDeadline: {deadline}"	Template for single tasks
Test Message Template	string	"Test notification from reminder telegram plugin"	Template for test notifications
Use Markdown Formatting	boolean	false	Enable Telegram Markdown formatting

Notification Content

Bulk Notification (Multiple Tasks)

⏰ You have X task(s) due:

• Task 1 (2024-01-01) - file1.md
• Task 2 (2024-01-02) - file2.md

Individual Notification

⏰ Task Reminder

📝 Task name
📁 File name
📅 Deadline

Test Notification

✅ Reminder Telegram plugin is working!

This is a test notification from your Obsidian vault.

When Notifications Are Sent

1. On startup: If periodic checking is enabled
2. On interval: Every N minutes (configurable)
3. Manual trigger: Via command palette or status bar

Notifications are sent for tasks that are:

• Due today
• Overdue (past deadline)

Completed tasks (status: done or [x]) are skipped.

Future Improvements

Here are some planned enhancements for future versions:

• Advanced filters: Exclude specific folders or patterns from the scan
• Message templates: Customization of Telegram notification text ✅ IMPLEMENTED
• Timezone aware: Explicit time zone management for precise deadlines
• Recurring support: Recognition of recurring tasks (daily, weekly)
• Snooze / Postpone: Inline interaction on Telegram to postpone a task
• Advance notifications: Alert N days before the deadline

Development

Prerequisites

• Node.js 18+
• npm

Install Dependencies

npm install

Development Mode (Watch)

npm run dev

Production Build

npm run build

Lint

npm run lint

Contributing

Pull requests are welcome! Please open an issue first for significant changes.

License

This plugin is licensed under the GNU General Public License version 3 (GPLv3). See LICENSE for details.

Credits

• Inspired by the Obsidian Tasks plugin
• Built with Obsidian Plugin API

Message Template Customization

Customize the content and format of your Telegram notifications:

Available Template Variables

Bulk Message Template (for multiple tasks):

• {count}: Number of due tasks
• {tasks}: List of formatted tasks

Individual Message Template (for single tasks):

• {taskName}: Task name/text
• {fileName}: File name containing the task
• {deadline}: Task deadline date
• {filePath}: Full path to the file
• {taskId}: Unique task identifier

Example Templates

Bulk Notification:

📋 You have {count} pending tasks due today:

{tasks}

Please check your Obsidian vault!

Individual Notification:

🔔 REMINDER: {taskName}
📁 File: {fileName}
📅 Due: {deadline}

Test Notification:

✅ Reminder Telegram plugin is working!
This is a test from your Obsidian vault.

Markdown Formatting

Enable Markdown formatting in settings to use Telegram's Markdown syntax for rich text formatting:

• *bold* for bold text
• _italic_ for italic text
• `code` for monospace text
• [link](https://example.com) for links