Skip to content

smtdev/tautulli-telegram-notifications

Repository files navigation

Tautulli notification templates, in order to inform you about any Plex library changes through a Telegram channel or group.

GitHub release GitHub last commit GitHub issues

This repository provides comprehensive notification templates for all 21 Tautulli triggers, available in both Spanish (es) and English (en). These templates are designed to send rich, informative notifications to your Telegram channels, groups, or private chats whenever events occur on your Plex Media Server.

🚀 Quick Setup

First, you need to get some basic Telegram information:

  • Bot Token: Contact @BotFather to create a new bot
  • Chat ID: Contact @myidbot to get your Chat ID, Group ID, or Channel Username

Once you have them, configure your notification agent in Tautulli:

Telegram bots setup

Select the events you want to monitor in the Trigger tab, then copy the appropriate template content into the Text tab.

📚 Available Templates

All templates are organized by category and language. Check the complete list here.

Spanish templates

Playback Events

Media Markers

User Activity

Library Changes

Server Status

Updates & Maintenance

English templates

Playback Events

Media Markers

User Activity

Library Changes

Server Status

Updates & Maintenance


🛠️ Contributing

We welcome contributions! Please see our Contributing Guidelines for details on how to submit improvements, bug reports, or new templates.

Template Validation

Before submitting changes, run our validation script:

bash validate-templates.sh

📝 Template Variables

Each template uses Tautulli's built-in variables. Common variables include:

  • {username} - Plex username
  • {title} - Media title
  • {year} - Release year
  • {show_name} - TV show name
  • {season_num} - Season number
  • {episode_num00} - Episode number (zero-padded)
  • {device} - Playback device
  • {platform} - Client platform

For a complete list, refer to Tautulli's documentation.

📄 License

This project is open source and available under the MIT License.

About

Telegram notification templates for Tautulli

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages