Donor Tracker is a Python-based Discord bot that helps you track donations and contributions within your server. It integrates seamlessly with NQN (Not Quite Nocturnal) to generate custom donation-related images, making it perfect for charity campaigns, fundraising, or community donation tracking.
- Donation Tracking: Track all donations made by server members and keep a log of each donation.
- NQN Integration: Automatically generate custom donation-related images using NQN, perfect for sharing donation stats and messages creatively.
- Donation Leaderboards: Display a leaderboard to recognize and encourage top donors.
- Customizable Commands: Tailor the bot's commands and notifications to suit your server's needs.
- Real-Time Updates: Get real-time updates when donations are made, keeping the community informed.
To get started with Donor Tracker, follow these steps to install and configure the bot in Python:
- A Discord bot token from the Discord Developer Portal.
- Python 3.8+ installed on your system.
- A valid NQN API key for integration with NQN.
- pip (Python package manager) installed.
-
Clone the repository:
git clone https://github.com/yourusername/donor-tracker.git cd donor-tracker
-
Create a virtual environment for the project (recommended):
python -m venv venv
-
Activate the virtual environment:
-
On Windows:
venv\Scripts\activate
-
On macOS/Linux:
source venv/bin/activate
-
-
Install the required dependencies:
pip install -r requirements.txt
-
Create a
.env
file in the root directory of your project to store your environment variables:DISCORD_TOKEN=your-discord-bot-token NQN_API_KEY=your-nqn-api-key
-
Run the bot:
python bot.py
Your Donor Tracker bot should now be up and running and ready to track donations!
We welcome contributions to Donor Tracker! If you have ideas for improvements or new features, feel free to open a pull request or report an issue.
- Fork the repository.
- Create a new branch for your feature.
- Make your changes.
- Commit and push your changes.
- Open a pull request with a description of your changes.
Donor Tracker is licensed under the MIT License. See LICENSE for more information.
If you have any questions or need help, feel free to join our support server or open an issue on GitHub.