diff --git a/README.md b/README.md index 822baae..d976408 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,82 @@ # LFGScout ![](https://i.imgur.com/aEgp7Qo.png) +![GitHub top language](https://img.shields.io/github/languages/top/djstompzone/lfgscout) +![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/DJStompZone/LFGScout) +[![CodeQL](https://github.com/DJStompZone/LFGScout/actions/workflows/codeql.yml/badge.svg)](https://github.com/DJStompZone/LFGScout/actions/workflows/codeql.yml) + ## About -Discord bot that allows you to get notifications in your Discord server when members are playing your server's favorite games! Can be configured for a variety of games, and offers users the ability to opt out if they do not wish to participate. +LFGScout is a Discord bot designed to monitor and notify when members of a guild start playing a specific game. The bot uses the Disnake (a Python wrapper for the Discord API) and SQLite3 for database management. + +![Static Badge](https://img.shields.io/badge/OS-Windows-White?style=flat&logo=Windows&logoColor=White&label=%20&labelColor=black) +![Static Badge](https://img.shields.io/badge/OS-Linux-White?style=flat&logo=Linux&logoColor=White&label=%20&labelColor=black) +![Static Badge](https://img.shields.io/badge/OS-Mac%20OS-White?style=flat&logo=Apple&logoColor=White&label=%20&labelColor=black) + +## Features +- Monitor members' game activities in real-time. +- Notify a specified channel when someone starts playing a watched title. +- Admin commands to configure the notification channel and watched titles. +- Users can opt-out of notifications. +- Cooldown feature to prevent spamming notifications. + +## Setup & Installation +1. Clone the repository: + ```bash + git clone https://github.com/DJStompZone/LFGScout + cd LFGScout + ``` + +2. Set up a virtual environment (recommended): + ```bash + python3 -m venv venv + source venv/bin/activate + # On Windows use: venv\Scripts\activate + ``` + +3. Install the required dependencies + ```bash + pip install -r requirements.txt + ``` + +4. Configure your environment + + Copy the example.env file to .env and fill out the DISCORD_TOKEN and TEST_GUILD_IDS with appropriate values. + +6. Run the bot + ```bash + python bot.py + ``` + +## Commands + +### Admin Commands: + +- `/lfgchannel <#channel>`: Set the channel where notifications will be sent. + +- `/watchtitle