Administration Guide
Restricted Access
This page is reserved for community administrators.
Please sign in with your official Telegram account.
Privacy Warning
This website is hosted on GitHub Pages. While this page is protected by a login gate, the source code of this page is public in the GitHub Repository. Do not store sensitive passwords or private keys directly in this file.
This page is for community administrators and moderators. It explains how to manage the dynamic parts of the TCL Firmware Hub, such as the announcement banner.
Managing the Announcement Banner
We use a GitHub Actions workflow to update the news banner without touching the code. This ensures even non-developers can push critical updates.
1. Triggering the Update
-
Go to the GitHub Actions Tab.
-
Click the "Run workflow" button on the right.
-
Fill in the fields:
- Show Banner?: Uncheck to hide the banner.
- Banner Text: The message to display. (e.g., "New V562 Firmware is out!")
- Link URL: Optional. Link to the Telegram post or download.
- Date Override: Use
YYYY-MM-DDif you want to push a message with a specific timestamp.
2. How it works
-
When you click "Run", the workflow updates
docs/assets/news.json. -
The website fetches this file instantly for every visitor.
-
Persistence: If a user clicks "Close" on the banner, they won't see it again until you change the Date. The modern
banner.jsuseslocalStorageto remember the dismissal status based on the date string.
Maintaining Chipsets
If a new TV model or chipset is released:
-
Open
docs/chipsets.mdin the GitHub editor. -
Add the new entry to the Mapping Table.
-
Commit the changes. The site will rebuild automatically in ~2 minutes.
Safety & Community Reports
- Scam Alerts: If a new Telegram scam and targeting the group is reported, use the Banner (see above) to push a warning immediately.
- Broken Links: If the
@FirmwareTCLbotis down or links are broken, update the banner to inform users while the dev team works on a fix.
Rose Bot Administration
The Rose Bot (@MissRose_bot) is our primary automation tool for moderation, filters, and welcome messages. This section explains how admins can interact with and configure the bot.
1. Connecting to the Bot
To manage group settings privately or via the web dashboard, you must first connect your account:
- Start the Bot: Message @MissRose_bot and press
/start. - Request Connection: In the TCL Discussion Group, type
/connect. - Confirm: Rose will send you a PM with a button to confirm the connection. Once connected, you can send commands to her PM instead of the group, keeping the chat clean.
2. Management via Private Message (Recommended)
While you can use commands in the group, we recommend managing settings via Private Messages to keep the public chat clean:
- Use the
/connectcommand as described above. - Once connected, you can send any configuration command (like
/filteror/setwelcome) directly to Rose's PM. - The bot will apply those settings to the TCL Discussion Group automatically.
3. Core Admin Commands
Here are the most common commands you'll need. You can find the full documentation at missrose.org.
| Command | Purpose | Official Guide |
|---|---|---|
/rules |
View or edit the group rules. | Rules Guide |
/setwelcome |
Update the randomized welcome msg. | Notes/Welcome |
/filter |
Add a new keyword trigger. | Filters Guide |
/config |
Access the general bot configuration. | General Setup |
/adminlist |
See all authorized group admins. | β |
Avoid Chat Spam
Whenever possible, use the Web Dashboard or Private Messages to Rose for configuration. Only use commands in the main group for testing or immediate moderation actions.
Telegram Welcome Message (Randomized)
Copy this entire block. The %%% markers allow the bot to pick a random variation each time a new member joins.
/setwelcome
Welcome to {chatname}, {username}! πβ¨
Before posting read [this pinned message](https://t.me/tclupdates_discussion/273156).
π **Your Journey Starts Here:**
- π [Installation Guides](https://FaserF.github.io/TCL-Discussion-Telegram/guides)
- π§ [Chipset & Platform Database](https://FaserF.github.io/TCL-Discussion-Telegram/chipsets)
- π [Rooting & Custom ROMs](https://FaserF.github.io/TCL-Discussion-Telegram/rooting)
π‘ **STAY SAFE:** Admins and Mods will **NEVER** PM you to sell anything. Protect yourself by reading our [Safety Guide](https://FaserF.github.io/TCL-Discussion-Telegram/safety).
β οΈ **English Only** | π **Search Before Asking**
[Open Documentation Hub](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/)
[Updates Channel](buttonurl://https://t.me/tclupdates)
[Firmware Bot](buttonurl://@FirmwareTCLbot)
%%%
Hey {username}, welcome aboard {chatname}! ππ»
We're glad to have you here! Before posting read [this pinned message](https://t.me/tclupdates_discussion/273156).
Before you dive in:
- π [Help & FAQ](https://FaserF.github.io/TCL-Discussion-Telegram/faq/)
- βοΈ [Update Notes](https://FaserF.github.io/TCL-Discussion-Telegram/guides)
π£ **Note:** This group is English-only.
π **Pro Tip:** Millions of questions have been answeredβuse the search button first!
[Documentation Hub & FAQ](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/faq/)
[Check Updates](buttonurl://https://t.me/tclupdates)
[Firmware Bot](buttonurl://@FirmwareTCLbot)
%%%
Greetings {username}! Welcome to {chatname}. π
Looking for the latest firmware or technical support? Before posting read [this pinned message](https://t.me/tclupdates_discussion/273156).
π **Quick Links:**
- [Firmware Installation Masterclass](https://FaserF.github.io/TCL-Discussion-Telegram/guides)
- [Official Safety & Anti-Scam Guide](https://FaserF.github.io/TCL-Discussion-Telegram/safety)
Remember: This is an English-only community. Please use the search function before posting new questions.
[Visit Documentation Hub](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/)
[Join Channel](buttonurl://https://t.me/tclupdates)
[Firmware Bot](buttonurl://@FirmwareTCLbot)
Rose Bot Filters
Use these commands to set up automatic responses for common questions. We use Rose's multi-trigger syntax to keep the group clean.
How to use: Copy and paste these blocks directly into the Telegram group.
1. Firmware & Update Assistance
Triggers when people ask about versions, changelogs, where to find software, or "can I update" questions.
/filter ("is my tv software outdated?", "where to look for firmware", "where to look for software", "where i can download", "software update for", "latest firmware", "latest version", "latest update", "what changes", "last update", "patch notes", "what is new", "change log", "what's new", changelog, "can i update", "any new update", "soft update", "new sw", "sw version", "firmware link", "google tv update", "android tv update")
Looking for the latest firmware or wondering if your TV is up to date? π
Check our **Firmware Database** for all chipsets and current versions. Also, keep an eye on the **Updates Channel** for real-time notifications.
[Open Firmware Database](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/chipsets/)
[Join Updates Channel](buttonurl://https://t.me/tclupdates)
[Use Firmware Bot](buttonurl://@FirmwareTCLbot)
2. Installation & USB Troubleshooting
Triggers for flashing, upgrading, and common USB recognition issues.
/filter ("how to install", "how to upgrade", "issues installing", "no file on usb", "how to flash", "flash firmware", "update via usb", "usb update", "install firmware", "how to update", "usb not found", "file not found")
Need help installing a firmware update? π
Whether you are using a Local Update (OTA) or an IMG file, our **Installation Masterclass** covers all steps and common pitfalls (like "no file found").
[Installation Guide](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/guides/)
[Troubleshooting FAQ](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/faq/)
3. Downgrading & Shop Reset
Triggers for safety-critical operations like rolling back or resetting specialized modes.
/filter (downgrade, "down grade", "reset shop", "shop reset", "go back to old", "roll back", "rollback", "previous version")
Thinking about downgrading your software? β οΈ
Downgrading can be tricky and might require a **factory reset** or a **Shop Reset**. Please read our guide on how to safely return to an older version.
[Downgrade Guide](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/faq/#how-to-downgrade)
[Shop Reset Guide](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/reset-shop/)
4. Root, Bootloader & Custom ROMs
/filter (root, "unlock bootloader", "custom rom", "rooting")
Interested in rooting your TCL TV? π
Rooting allows for deeper customization but carries risks. Check our dedicated section for verified methods and warnings.
[Rooting & ROMs Guide](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/rooting/)
5. Technical Optimizations & Features
Triggers for Performance, Gamebar, 5G Wi-Fi, and Play Store issues.
/filter ("speed up", country, gamebar, 5g, "play store shortcut", "playstore", "tv slow", "tv lagging", "high ping", "factory reset", "hard reset")
Looking for specific features or optimizations? β‘οΈ
We have sections covering Wi-Fi issues (5G), the Gamebar feature, and tips on how to speed up your Android TV experience.
[Optimization & FAQ](buttonurl://https://FaserF.github.io/TCL-Discussion-Telegram/faq/)