🎀 The kawaii-est tool for fetching anime-style images with moe moe kyun~ energy! 🎀
✨ Features • 🚀 Installation • 💖 Usage • 🤝 Contributing • 📜 License
- 🖼️ User-friendly GUI built with tkinter
- 🗂️ Customizable image categories
- 🔢 Adjustable download limits
- 🔞 NSFW content filter
- 🚀 Asynchronous downloads using threading
- 🛡️ Rate limiting to prevent API abuse
- 🔄 Error handling and retry functionality
- 🖼️ Image gallery display
- ⏯️ Pause and resume functionality
- Clone the repository:
git clone https://github.com/DuckyOnQuack-999/Fetch-Me-My-Waifus.git- Navigate to the project directory:
cd Fetch-Me-My-Waifuscd Fetch-Me-My-Waifus
- Install the required dependencies:
pip install -r requirements.txt
Execute the main script to run the application:
python Fetch-Me-My-Waifus.py
Customize your Fetch-Me-My-Waifus experience with these magical settings:
| Option | Description | Default | How to Change |
|---|---|---|---|
| Default Category | Initial category on startup | "waifu" | Modify self.category_var in __init__ |
| Download Limit | Max images per session | 10 | Adjust self.limit_var in __init__ |
| Rate Limit | Cooldown between API requests (seconds) | 1 | Change self.rate_limit in __init__ |
| NSFW Filter | Allow NSFW content by default | False | Set self.nsfw_var in __init__ |
We welcome contributions to Fetch-Me-My-Waifus! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create your feature branch (
git checkout -b feature/AmazingFeature) - 💻 Commit your changes (
git commit -m 'Add some AmazingFeature') - 🚀 Push to the branch (
git push origin feature/AmazingFeature) - 🔃 Open a Pull Request
Please read our Contributing Guidelines for more details.
This project is licensed under the GNU License - see the LICENSE file for details.
- waifu.im for providing the amazing API
- Tkinter for the GUI framework
- Pillow for image processing magic
- All the wonderful contributors who have helped improve this project
| Color | Hex Code | Description |
|---|---|---|
| Sakura Pink | #FFB7C5 |
For the sweetest UI elements |
| Magical Blue | #7EC8E3 |
For calm and soothing accents |
| Lemon Chiffon | #FFFACD |
For soft, warm backgrounds |
| Lavender Dream | #E6E6FA |
For mystical highlights |
This application is for educational and fanservice purposes only. Please respect the terms of service of the waifu.im API and use this tool responsibly. Remember, 2D waifus have feelings too!