Skip to content

README.md

Latest commit

 

History

History
102 lines (74 loc) · 2.21 KB

README.md

File metadata and controls

102 lines (74 loc) · 2.21 KB

🤖 Discord Bet Tracker Bot (Google Sheets Integration)

Python automation tool that monitors Discord chats in real-time and automatically logs bets/signals into a Google Sheets spreadsheet.

Project Demo


🚀 Features

  • Real-Time Monitoring: Listens to Discord channels 24/7.
  • Smart Filter: Ignores common conversations and captures only messages with specific keywords (e.g., !bet, U$, Green).
  • Cloud Integration: Connects to the Google Sheets API to save data instantly.
  • Structured Log: Logs Date, User, Message, and Channel.

    flowchart TD
            A[👤 Discord User] -->|Sends Message| B(🤖 Python Bot / Discord.py)
            B --> C{Contains Keyword?}
            C -- No --> D[❌ Ignore Message]
            C -- Yes --> E[📝 Extract Data]
            E --> F[🔌 Google Sheets API]
            F --> G[(📊 Google Sheet)]
            
            subgraph Bot Logic
            B
            C
            D
            E
            end
            
            style A fill:#5865F2,stroke:#333,stroke-width:2px,color:white
            style G fill:#0F9D58,stroke:#333,stroke-width:2px,color:white
            style B fill:#FFD700,stroke:#333,stroke-width:2px,color:black
Loading

🛠️ Tech Stack

  • Python 3.12
  • Discord.py (Async)
  • Google Sheets API (gspread)

🔒 Security

This repository contains the source code logic. API keys (creds.json and Tokens) were not included for security reasons.


⚙️ Installation & Setup

Prerequisites

  • Python 3.12+
  • A Google Cloud Platform account (for Sheets API)
  • A Bot created in the Discord Developer Portal

Step-by-Step

  1. Clone the repository
    git clone gh repo clone armando-desouza/botDiscord-Python
    cd botDiscord-Python
  1. Run
    python bot_discord.py

👨‍💻 Author

Francisco A. de Souza Python Developer & Data Scientist | Data Specialist