Merge pull request #1389 from jacopotediosi/update-telegram

Author: jneilliii

_plugins/telegram.md

@@ -2,9 +2,8 @@
 layout: plugin
 
 id: telegram
-title: OctoPrint-Telegram
-description: A plugin to send and react on messages before, during and after a print
-  via Telegram Messenger.
+title: Telegram
+description: Control your printer and receive notification messages via Telegram Messenger.
 authors:
     - Jacopo Tediosi
     - Fabian Schlenz
@@ -16,34 +15,56 @@ homepage: https://github.com/jacopotediosi/OctoPrint-Telegram
 source: https://github.com/jacopotediosi/OctoPrint-Telegram
 archive: https://github.com/jacopotediosi/OctoPrint-Telegram/archive/master.zip
 
-# TODO set this to true if your plugin uses the dependency_links setup parameter to include
-# library versions not yet published on PyPi. SHOULD ONLY BE USED IF THERE IS NO OTHER OPTION!
-follow_dependency_links: false
+privacypolicy: https://github.com/jacopotediosi/OctoPrint-Telegram/blob/master/PRIVACY.md
 
 tags:
-- notification
+- control
+- filament
+- filament runout
+- lights
 - mobile
+- monitor
+- monitoring
+- notification
+- notifications
+- power
+- print status
 - progress
-- control
+- remote
+- remote camera
+- telegram
+- webcam
 
 screenshots:
-- url: /assets/img/plugins/telegram/features1.png
-  alt: Telegram notifications during print
-  caption: You can receive the current status with a webcam picture at user-definable
-    intervals.
-- url: /assets/img/plugins/telegram/features3.png
-  alt: Requesting the current status
-  caption: You can control OctoPrint via messages. E.g., sending /status lets the plugin
-    send you the current status.
-- url: /assets/img/plugins/telegram/features4.png
-  alt: Custom keyboards
-  caption: You can also abort the current print with /abort. A custom keyboard is
-    shown for confirmation.
-- url: /assets/img/plugins/telegram/features5.png
-  alt: Settings
-  caption: You can configure lots of settings via OctoPrint's settings. (Or you can
-    use /settings to change them via Telegram.)
-featuredimage: /assets/img/plugins/telegram/features3.png
+- url: /assets/img/plugins/telegram/screen_1.png
+  alt: Screenshot of the "Connection" tab in plugin settings
+  caption: Screenshot of the "Connection" tab in plugin settings
+- url: /assets/img/plugins/telegram/screen_2.png
+  alt: Screenshot of the "General settings" tab in plugin settings
+  caption: Screenshot of the "General settings" tab in plugin settings
+- url: /assets/img/plugins/telegram/screen_3.png
+  alt: Screenshot of the "Chats" tab in plugin settings
+  caption: Screenshot of the "Chats" tab in plugin settings
+- url: /assets/img/plugins/telegram/screen_4.png
+  alt: Screenshot of the "Notification messages" tab in plugin settings
+  caption: Screenshot of the "Notification messages" tab in plugin settings
+- url: /assets/img/plugins/telegram/screen_5.png
+  alt: Example of the /con and /files commands
+  caption: Example of the /con and /files commands
+- url: /assets/img/plugins/telegram/screen_6.png
+  alt: Example of a notification message containing photos, videos, and details of the print in progress
+  caption: Example of a notification message containing photos, videos, and details of the print in progress
+- url: /assets/img/plugins/telegram/screen_7.png
+  alt: Example of file details displayed in response to the /files command
+  caption: Example of file details displayed in response to the /files command
+- url: /assets/img/plugins/telegram/screen_8.png
+  alt: Example of commands to start, pause, and abort a print job
+  caption: Example of commands to start, pause, and abort a print job
+- url: /assets/img/plugins/telegram/screen_9.png
+  alt: Example of the /power and /cancelobject commands
+  caption: Example of the /power and /cancelobject commands
+
+featuredimage: /assets/img/plugins/telegram/logo.png
 
 compatibility:
   octoprint:
@@ -55,16 +76,24 @@ attributes:
 
 ---
 
-This plugin integrates Telegram Messenger into OctoPrint.
+This plugin integrates Telegram Messenger with OctoPrint.
+
+### Features
+
+<ul style="list-style-type:none">
+<li>🔔 Receive Telegram messages with print status, including snapshots and videos from your webcams</li>
+<li>📡 Remotely control your printer from Telegram (e.g., browsing and uploading files, starting, pausing, and aborting prints, tuning temperatures, etc.)</li>
+<li>🔌 Manage connected power devices (printers, lights, heaters, etc.) directly from Telegram</li>
+<li>🔐 Configure allowed commands and active notifications for each chat</li>
+<li>🧩 Integrations with many other plugins (e.g., manage filaments from Telegram, cancel single objects, control various brands of plugs, etc.)</li>
+</ul>
+
+### Documentation
+
+For full installation and usage instructions, available features, configuration guidance, and common troubleshooting steps, please refer to the [plugin’s Wiki](https://github.com/jacopotediosi/OctoPrint-Telegram/wiki).
 
-You can receive automatic notifications with webcam images before and after a print -
-and even during a print at customizable intervals, such as at specific heights or after a
-certain time (e.g., every 5 mm of height OR every 10 minutes — whichever comes first).
+### Support the project
 
-You can also control OctoPrint via messages. For example, send:
-- `/status` to receive the current printer status,
-- `/abort` to stop the ongoing print,
-- `/help` to get a list of all available commands.
+This project is distributed for free and maintained entirely by volunteers, who do their best to develop it in their spare time, gather feedback and reports from users, and fix issues.
 
-Please refer to [the documentation on GitHub](https://github.com/jacopotediosi/OctoPrint-Telegram/blob/master/README.md)  
-to learn how to register a Telegram bot - a required step for this plugin to work.
+If you'd like to support the maintainers of this project, you can donate via the [GitHub Sponsor page](https://github.com/sponsors/jacopotediosi) ❤️.