Automated daily motivational quotes for your Discord server

# 📖 Quote Bot

> Automated daily motivational quotes for your Discord server

[![Discord](https://img.shields.io/badge/Discord-Add%20Bot-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/api/oauth2/authorize?client_id=1377996959893164052&permissions=19456&scope=bot%20applications.commands) [![Discord](https://img.shields.io/badge/Discord-Support%20Server-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/5jkADM2Wt5) [![Python](https://img.shields.io/badge/Python-3.11+-blue?style=for-the-badge&logo=python)](https://www.python.org/)

## ✨ Features

- 🕐 **Customizable Schedule** - Set any time and timezone
- ⏰ **Flexible Intervals** - Daily or custom intervals (24-168 hours), always anchored to your configured time - no drift
- 🔔 **Role Mentions** - Optional role pings with quotes
- 🌍 **Multi-Timezone Support** - Works for international communities
- 📖 **Quality Quotes** - Daily quotes from ZenQuotes API, delivered as a clean embed
- 😄 **Funny Fallbacks** - Entertaining quotes when the API is down
- ❤️ **Like Quotes** - Click the Like button under any quote to see your personal like count (only visible to you)
- ⭐ **Favorites** - React with ⭐ to save a quote, browse them anytime with `/favorites`
- 🎭 **Rotating Status** - The bot's status cycles between its default status, live server/user stats, and a custom list of funny statuses
- 🗳️ **Voting** - `/vote` shows quick links to support the bot on all major bot lists
- ⚡ **Simple Setup** - One command to get started

## 🚀 Quick Start

### For Server Owners

1. **[Invite the bot](https://discord.com/api/oauth2/authorize?client_id=1377996959893164052&permissions=19456&scope=bot%20applications.commands)** to your server
2. Use `/setup channel:#your-channel timezone:Europe/Brussels quote_time:08:00`
3. Done! Daily quotes will arrive automatically

## 📋 Commands

| Command | Description |
|---------|-------------|
| `/setup` | View current configuration |
| `/setup [options]` | Configure bot settings |
| `/help` | Show help and available commands |
| `/favorites` | Browse the quotes you've saved to your favorites |
| `/vote` | Get links to vote for the bot on all supported sites |

### Setup Options

- `timezone` - Timezone (e.g., `Europe/Brussels`, `America/New_York`)
- `quote_time` - Time in 24h format (e.g., `08:00`, `13:30`)
- `interval` - Hours between quotes (24-168)
- `channel` - Channel to send quotes to
- `role` - Role to mention (optional)

### Quote Reactions

- ❤️ **Like button** - Click it under any quote to get a private message showing how many quotes you've liked in total
- ⭐ **Favorite** - React with a star on any quote to save it to your favorites, then browse them with `/favorites`

## :star: Boosting the Bot

You can help the bot grow by voting for it on these sites, or just run `/vote` in Discord for quick links:

* [discordbotlist.com](https://discordbotlist.com/bots/quotes/upvote)
* [top.gg](https://top.gg/bot/1377996959893164052/vote)
* [Voidbots.net](https://voidbots.net/bot/1377996959893164052/vote)
* [discordlist.gg](https://discordlist.gg/bot/1377996959893164052/vote)
* [discordbots.net](https://discordbots.net/bot/3696-quotes)

## 💬 Support

- **Discord Support Server**: [Join here](https://discord.gg/5jkADM2Wt5)
- **Discord**: reneruts

## 📜 Legal

- **[Privacy Policy](PRIVACY_POLICY.md)** - How we collect and protect your data
- **[Terms of Service](TERMS_OF_SERVICE.md)** - Rules and guidelines for using the bot

By using Quote Bot, you agree to our Terms of Service and Privacy Policy.

## 🙏 Acknowledgments

- Quotes provided by [ZenQuotes API](https://zenquotes.io/)
- Built with [discord.py](https://github.com/Rapptz/discord.py)
- Inspired by the need for daily motivation

---

Made with ❤️ by [René Ruts](https://github.com/ReneRuts)

Voting for Quotes

Quotes