Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xdityagr/project-discoverquotesdaily
DiscoverQuotesDaily Bot is a Python-based bot that generates and posts inspirational quotes daily on Twitter. It can fetch quotes from various categories and generate visually appealing images featuring these quotes, with scheduled posting and on-request generation.
https://github.com/xdityagr/project-discoverquotesdaily
image-generation quotes quotes-app quotes-generator twitter twitter-bot
Last synced: 2 days ago
JSON representation
DiscoverQuotesDaily Bot is a Python-based bot that generates and posts inspirational quotes daily on Twitter. It can fetch quotes from various categories and generate visually appealing images featuring these quotes, with scheduled posting and on-request generation.
- Host: GitHub
- URL: https://github.com/xdityagr/project-discoverquotesdaily
- Owner: xdityagr
- License: gpl-3.0
- Created: 2023-09-13T21:02:13.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-07T16:07:57.000Z (2 months ago)
- Last Synced: 2024-09-08T17:45:18.474Z (2 months ago)
- Topics: image-generation, quotes, quotes-app, quotes-generator, twitter, twitter-bot
- Language: Python
- Homepage: https://x.com/discoverdaily_q
- Size: 197 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DiscoverQuotesDaily Bot
DiscoverQuotesDaily Bot is a Python-based bot that generates and posts inspirational quotes daily on Twitter. It can fetch quotes from various categories and generate visually appealing images featuring these quotes. The bot schedules daily posts and interacts with the Twitter API to share the generated images.
## Features
- **Daily Inspirational Quotes**: Automatically posts a new quote each day.
- **Customizable Quotes**: Fetches quotes based on various tags from the Quotable API.
- **Image Generation**: Creates images with quotes using the Pillow library.
- **Twitter Integration**: Posts images and quotes on Twitter using Tweepy.
## Installation
### Prerequisites
- Python 3.6 or higher
- pip (Python package installer)
### Steps
1. **Clone the Repository**
```bash
git clone https://github.com/yourusername/DiscoverQuoteBot.git
cd DiscoverQuoteBot
```
2. **Install Dependencies**
Create a virtual environment (optional but recommended):
```bash
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```
Install the required packages:
```bash
pip install -r requirements.txt
```
3. **Configuration**
- **Quotes API**: No additional configuration required.
- **Twitter API**: Create a `twitterCredentials.json` file in the root directory with the following structure:
```json
{
"access_token" : "YOUR_ACCESS_TOKEN",
"access_token_secret" : "YOUR_ACCESS_TOKEN_SECRET",
"bearer_token": "YOUR_BEARER_TOKEN_SECRET",
"api_key":"YOUR_API_KEY",
"api_key_secret":"YOUR_API_KEY_SECRET",
"client_id":"YOUR_CLIENT_ID",
"client_secret":"YOUR_CLIENT_SECRET"
}
```
4. **Run the Bot**
Start the bot using:
```bash
python DiscoverQuoteBot.py
```
## Code Overview
- **DiscoverQuoteBot.py**: Main script that runs the bot, schedules daily posts, and handles image generation and Twitter posting.
- **bot_utils.py**: Contains utility classes for interacting with the Quotable API, generating quote images, and posting to Twitter.
### `DiscoverQuoteBot.py`
The main function `daily_post_loop` fetches a quote, generates an image with the quote, saves it, and posts it to Twitter. The bot is scheduled to run this function daily.
### `bot_utils.py`
- **Quote**: Retrieves a random quote from the Quotable API and handles tag selection.
- **QuoteImageGenerator**: Generates images with quotes using the Pillow library, adjusting text wrapping and font size dynamically.
- **TwitterConnHandler**: Manages Twitter API connections and handles posting of tweets with images.
## Usage
- The bot runs continuously and posts a new quote daily.
- Modify `tags.json` to change the categories of quotes.
- Adjust image generation settings by editing the `QuoteImageGenerator` class.
## Contributing
If you want to contribute to DiscoverQuoteBot, please follow these steps:
1. Fork the repository.
2. Create a new branch for your changes.
3. Commit your changes and push them to your fork.
4. Open a pull request with a clear description of your changes.
## License
This project is licensed under the GPL License. See the [LICENSE](LICENSE) file for details.
## Contact
For questions or feedback, please contact:
- **Email**: [email protected]
- **GitHub**: [xdityagr](https://github.com/xdityagr)
Enjoy using **DiscoverQuotesDaily!** Made with _<3_ In **India!**