Repository navigation
Closed
Labels
enhancementNew feature or requestNew feature or request
Description
Summary & Motivation
Traders frequently operate directly in front of the PC where in-app audio alert chimes are active and sufficient, making concurrent Telegram push notifications redundant or noisy. Currently, the topbar bell toggle pauses both in-app sound chimes and Telegram alerts simultaneously, while independent Telegram toggling requires navigating to the Settings modal. Traders need a dedicated topbar Telegram alert toggle icon (Telegram paper plane combined with a bell) to instantly mute or resume Telegram push notifications independently from local audio chimes with a single click.
Proposed Solution
- Add a second dedicated alert toggle button in the topbar (
#btn-telegram-alerts) adjacent to the audio bell button. - Design a custom Telegram paper plane combined with a bell SVG icon with clear active and muted states.
- Decouple the existing bell toggle (
#btn-mute) so it strictly controls local in-app audio chimes (alerts.mute), without suppressing Telegram alerts. - Wire
#btn-telegram-alertsto togglealerts.telegram_enabled, keeping it bidirectional and synchronized with Settings -> Alerts -> "Enable Telegram Alerts". - Update
app/screener.py,app/tape.py,app/api.py, andapp/telegram.pyso Telegram alert delivery is exclusively governed bytelegram_enabled(and tape-specific cooldowns), independent of local audio mute. - Synchronize
docs/SPEC.md, user guides, release documentation, wiki, and showcase screenshots.
Technical & UI Specifications
- Topbar UI: Add
#btn-telegram-alertsbeside#btn-muteinweb/index.html. - Icon Design: Custom SVG featuring Telegram paper plane combined with a bell, with active state and slashed/paused red-glow state.
- State Synchronization: Toggling updates
App.config.alerts.telegram_enabled, saves configuration, and updates Settings UI and topbar visual indicator immediately. - Backend Flow: In
screener.pyandtape.py, decoupletelegram_enabledfromis_paused(mute). - Persistence: Preserves existing
config.jsonschema (alerts.telegram_enabled).
Alternatives Considered
- Keeping a single combined alert toggle and requiring users to open Settings to toggle Telegram: Rejected due to unnecessary friction during active trading.
Additional Context
Requested by user to allow quick muting of Telegram push notifications while sitting in front of the workstation without silencing local audio alerts.
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request
Activity
github-actions commentedon Nov 6, 2026
✅ Issue Validation Passed
feat(alerts))This issue is well-structured and ready for work according to the Issue-First Protocol.
mlgitdev commentedon Nov 6, 2026
🚀 Resolution In Progress
A solution for this issue has been implemented and submitted in Pull Request #66.
The issue will automatically close upon PR merge into \main.
mlgitdev commentedon Nov 6, 2026
🔄 Additional Fix Added
Fixed the startup state synchronization bug where the topbar alert button defaulted to the active visual state on launch regardless of the persisted configuration:
mlgitdev commentedon Nov 6, 2026
✅ Release v2.12.0 Completed
Pull Request #66 has been successfully verified across all CI runners (Windows x64, macOS arm64, Linux x64) and squash-merged into \main.