Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/duckyonquack-999/fetch-me-my-waifus
Gotta catch em all
https://github.com/duckyonquack-999/fetch-me-my-waifus
anime anime-api anime-downloader anime-pictures anime-scraper nsfw python python-script waifu waifu-pics
Last synced: about 1 month ago
JSON representation
Gotta catch em all
- Host: GitHub
- URL: https://github.com/duckyonquack-999/fetch-me-my-waifus
- Owner: DuckyOnQuack-999
- License: gpl-3.0
- Created: 2024-11-14T18:24:19.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-24T16:35:36.000Z (about 2 months ago)
- Last Synced: 2024-11-24T17:27:13.303Z (about 2 months ago)
- Topics: anime, anime-api, anime-downloader, anime-pictures, anime-scraper, nsfw, python, python-script, waifu, waifu-pics
- Homepage:
- Size: 22.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# πΈβ¨ Fetch-Me-My-Waifus β¨πΈ
π The kawaii-est tool for fetching anime-style images with moe moe kyun~ energy! π
[β¨ Features](#-features) β’ [π Installation](#-installation) β’ [π Usage](#-usage) β’ [π€ Contributing](#-contributing) β’ [π License](#-license)
## π Features
- πΌοΈ 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## π₯ Installation
1. Clone the repository:
```bash
git clone https://github.com/DuckyOnQuack-999/Fetch-Me-My-Waifus.git
```
2. Navigate to the project directory:
```shellscript
cd Fetch-Me-My-Waifuscd Fetch-Me-My-Waifus
```
3. Install the required dependencies:```shellscript
pip install -r requirements.txt
```## π Usage
Execute the main script to run the application:
```shellscript
python Fetch-Me-My-Waifus.py
```## π οΈ Configuration
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__`## π€ Contributing
We welcome contributions to Fetch-Me-My-Waifus! Here's how you can help:
1. π΄ Fork the repository
2. πΏ Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. π» Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. π Push to the branch (`git push origin feature/AmazingFeature`)
5. π Open a Pull RequestPlease read our [Contributing Guidelines](CONTRIBUTING.md) for more details.
## π License
This project is licensed under the GNU License - see the [LICENSE](LICENSE) file for details.
## π Acknowledgments
- [waifu.im](https://waifu.im/) for providing the amazing API
- [Tkinter](https://docs.python.org/3/library/tkinter.html) for the GUI framework
- [Pillow](https://python-pillow.org/) for image processing magic
- All the wonderful contributors who have helped improve this project## π£ Disclaimer
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!