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

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

Manual Installation

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

Usage

Setting Up Telegram

Create a Telegram Bot:
- Open Telegram and search for @BotFather
- Send /newbot command
- Follow instructions to name your bot and get the Bot Token
Get Your Chat ID:
- Open Telegram and search for @userinfobot
- Send /start command
- It will reply with your Chat ID
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:

Whole Vault (default): Scans all markdown files in your entire vault
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

On startup: If periodic checking is enabled
On interval: Every N minutes (configurable)
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