Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

Awesome Lists containing this project

README

        

# 🌸✨ Fetch-Me-My-Waifus ✨🌸


GitHub Downloads

Windows 11
Python

πŸŽ€ The kawaii-est tool for fetching anime-style images with moe moe kyun~ energy! πŸŽ€

[✨ Features](#-features) β€’ [πŸš€ Installation](#-installation) β€’ [πŸ’– Usage](#-usage) β€’ [🀝 Contributing](#-contributing) β€’ [πŸ“œ License](#-license)

300

## 🌟 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 Request

Please 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!