Skip to content

HammonDDDDD/antibars-bot

antibars-bot


License OSA-improved


Overview

This Telegram bot provides automated monitoring of Google Sheets data changes, particularly useful for tracking student grades. It notifies subscribed users about updates while also offering additional features like weather information and daily content. The solution helps users stay informed about important data changes through convenient messaging platform integration.


Table of Contents


Core Features

  1. Telegram Bot Integration: Asynchronous Telegram bot that handles multiple command types including weather information, daily quotes, news headlines, and subscription management with real-time message processing
  2. Google Sheets Monitoring: Automated monitoring of multiple Google Sheets for changes in student grades and data, with configurable polling intervals and change detection capabilities
  3. Subscription Management System: Database-driven subscription system that allows users to subscribe to specific identifiers (ISU numbers or names) and receive notifications when monitored data changes
  4. Change Detection and Notification: Advanced change detection algorithm that compares current spreadsheet data with previous state and sends formatted notifications when updates are detected
  5. Asynchronous Background Monitoring: Concurrent background task that continuously monitors data sources while simultaneously handling user interactions through the Telegram interface

Installation

Install antibars-bot using one of the following methods:

Build from source:

  1. Clone the antibars-bot repository:
git clone https://github.com/HammonDDDDD/antibars-bot
  1. Navigate to the project directory:
cd antibars-bot
  1. Install the project dependencies:
pip install -r requirements.txt

Contributing


License

This project is protected under the MIT License. For more details, refer to the LICENSE file.


Citation

If you use this software, please cite it as below.

APA format:

HammonDDDDD (2025). antibars-bot repository [Computer software]. https://github.com/HammonDDDDD/antibars-bot

BibTeX format:

@misc{antibars-bot,
    author = {HammonDDDDD},
    title = {antibars-bot repository},
    year = {2025},
    publisher = {github.com},
    journal = {github.com repository},
    howpublished = {\url{https://github.com/HammonDDDDD/antibars-bot.git}},
    url = {https://github.com/HammonDDDDD/antibars-bot.git}
}

About

Telegram bot with Google Sheets monitoring and Docker deployment

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published