MotorsportNotifier

Motor Sport Notifier is a premium Discord bot purpose‑built for motorsport fans who never want to miss a session. Designed entirely around slash commands and interactive Direct Message flows, it delivers personalised, beautifully formatted race reminders straight to your DMs. Covering Formula 1, NTT IndyCar Series, NASCAR Cup Series, and MotoGP, the bot keeps you on the pace week after week — with zero configuration needed beyond a few clicks.

🔔 Intelligent, Customisable Reminders At the heart of the bot is a powerful subscription engine. Users initiate the process with a single /subscribe command, which posts a public button in any channel. Clicking it opens a DM‑based setup wizard:

Multi‑series selection — choose one or multiple championships at once via an intuitive dropdown (Formula 1, IndyCar, NASCAR Cup Series, MotoGP).

Tailored reminder offsets — specify exactly how many minutes before each session you want to be reminded (e.g. 60, 30, 15 minutes) and how many of those reminders to actually send.

Editable preferences — at any time, use /reminders to change your default offsets, /mysubs to review all active subscriptions, or /unsubscribe to remove individual series via a multi‑select menu.

Once subscribed, the bot silently monitors the full season schedule in Eastern Time (EDT/EST), converts everything to UTC for accuracy, and automatically pushes a reminder to your DM whenever a session’s start time matches one of your chosen offsets. No more missed practice sessions, qualifying shootouts, or green flags.

🖼️ Beautiful, Informative Embeds Every reminder is a rich Discord embed containing:

The series logo and round name

The session type (Race, Qualifying, Sprint, FP1–FP3, etc.)

The circuit name and a circuit image (placeholder URLs can be replaced with actual track maps)

The local start time converted to your time zone (defaults to US/Eastern, but easily extended)

A colour‑coded accent: red for races, blue for all other sessions

All messages are professionally formatted, easy to read at a glance, and carry a consistent “Motor Sport Notifier” branding.

📊 Live Status Dashboard For server administrators, the bot provides a self‑updating status panel using the /status command. Once activated, it posts a permanent embed in the chosen channel that refreshes every 60 seconds with:

Current bot presence (Online, Idle, Do Not Disturb, Offline)

Uptime of the current session (e.g., “3h 15m 42s”)

Total accumulated downtime across all previous shutdowns

WebSocket latency in milliseconds

Number of guilds (servers) the bot is serving

Online since timestamp in human‑readable natural language

The status message survives bot restarts and can be cleared with /status_clear. It’s an essential health monitor for any server running the bot 24/7.

🎮 Fun & Community Features Beyond the core notifications, Motor Sport Notifier includes a suite of interactive motorsport-themed commands to engage your community:

/vroom – Makes engine noises and shows a random racing GIF.

/garage – Displays a random race car or bike with a description and image.

/racetrivia – Sends a trivia question about motorsport history (answer hidden behind spoiler tags).

/pitstop – Simulates a pit stop time and gives a performance rating (from “Lightning fast!” to “Disaster!”).

/racequote – Shares a famous quote from legendary drivers.

/driverfact – Tells an interesting fact about a well‑known driver.

These commands add a layer of garage‑style banter and keep the atmosphere lively between sessions.

🛠️ Under‑the‑Hood Database – All data (user profiles, subscriptions, status config, downtime metrics) is stored in a persistent SQLite database via aiosqlite, ensuring zero data loss across restarts.

Scheduler – A custom asyncio loop checks the hardcoded season schedules every 60 seconds and triggers reminders when offsets match. Duplicate prevention ensures no user receives the same reminder twice.

Timezone handling – The entire schedule is defined in Eastern Time; the pytz library handles EDT (UTC‑4) and EST (UTC‑5) transitions automatically.

Modern Discord API – Built on discord.py 2.x with full support for slash commands, buttons, select menus, modals, and persistent views.

Systemd service – The bot is designed to run on Linux (including Chromebook Linux) as a systemd service with automatic restart on failure, guaranteeing 24/7 uptime.

🚀 Deployment & Extensibility Motor Sport Notifier is self‑hosted and fully open‑source. It runs on any Linux machine, including a Chromebook’s Linux environment. Setup is as simple as cloning the repository, installing dependencies, and creating a .env file with your Discord bot token. A step‑by‑step tutorial is included.

The bot is built with extensibility in mind:

Add new series by simply appending a dictionary to the schedule file.

Replace placeholder circuit images with real track maps.

Implement live timing integration via external APIs.

Extend the status panel with additional metrics (e.g., active subscriptions count).