How kamoteprice/lf-alerts works
LF Alerts is an Android app for scanning Telegram LF groups against shared keywords and alerting buyers about matches. The principal workflow starts in the Kivy app, activates a device-bound license, runs Telegram workers, and delivers matches through Telegram Saved Messages and phone notifications. The repository also includes seller-side license-key tooling, worker reliability features, and app-level support capabilities. The README documents the user workflow; several subsystem implementations were not sampled, so their internal links are omitted or marked unverified.
Main entry points: _lf_bootstrap.py Kivy app UI · worker.py Telegram workers · notifier.py Match notifications · license.py License manager
Components 19
App experience
- App entry
main.py - Kivy app UI
_src/_lf_bootstrap.py - Match banner
_src/banner.py - Themes
_src/themes.py
Telegram scanning
- Telegram workers
_src/worker.py - Chat blacklist
_src/blacklist.py - Match notifications
_src/notifier.py - App data
_src/db.py
Licensing and seller tools
- License manager
_src/license.py - Key generation
_src/keygen.py - Key inventory
_src/keystats.py
App support
- License telemetry
_src/telemetry.py - Seller activation pings
_src/pinger.py - Foreground service
_src/service.py - Stability controls
_src/stability.py - App updater
_src/updater.py
Other components
- Buyer
- Telegram
- License service
Connections 19
- Buyer → App entry: launches
README.md - App entry → Kivy app UI: starts
main.py - Buyer → Kivy app UI: configures workers
README.md - Kivy app UI → License manager: activates key
_src/_lf_bootstrap.py - Kivy app UI → Telegram workers: starts scanning
_src/_lf_bootstrap.py - Telegram workers → Telegram: scans groups
README.md - Telegram workers → Chat blacklist: checks exclusions
- Telegram workers → Match notifications: notifies matches
_src/worker.py - Match notifications → Telegram: sends Saved Message
README.md - Match notifications → Buyer: shows phone alert
README.md - Kivy app UI → Match banner: uses match modal
_src/_lf_bootstrap.py - License manager → License service: checks activation
_src/license.py - License manager → License telemetry: reports license events
_src/license.py - Kivy app UI → Seller activation pings: pings activation
_src/_lf_bootstrap.py - Key generation → Key inventory: tracks generated keys
- Kivy app UI → Foreground service: manages scanning notice
_src/_lf_bootstrap.py - Kivy app UI → Stability controls: uses reliability controls
_src/_lf_bootstrap.py - Kivy app UI → App updater: offers updates
_src/_lf_bootstrap.py - Kivy app UI → Themes: uses themes
_src/_lf_bootstrap.py