A modern, cross-platform image & video downloader with a glass-morphism web UI.
Supports Rule34, Safebooru, Gelbooru, Zerochan, Waifu.im, Nekos.best, Nekos.life, Yande.re, Konachan, and Danbooru with real-time logging, a built-in discovery engine, advanced tag filtering, anti-ban protections, and Hydrus sidecar file support.
- Multi-Platform -- Built-in modules for 10 imageboard APIs (including Danbooru)
- Modern Web UI -- Glass-morphism dark & light themes, opens in your default browser
- Discovery Engine & Archives -- Live extraction of tags and artists from downloaded media, displayed in a dedicated Image Archive tab.
- Favorites & Search History -- Add tags to your favorites list for one-click search automation, and maintain a log of your search history.
- Video & GIF Support -- Exclusively target
.mp4,.webm, or GIF files via format filtering. - GIFs Only Filter -- Rule34 supports a dedicated GIFs Only mode alongside Images/Videos/All.
- Real-Time Logs -- Live console output via WebSocket (Socket.IO) with per-tab clear button
- Full UI Customization -- Custom colors for text, accents, buttons, and tab backgrounds; per-tab wallpapers with dark/light mode
- Advanced Search -- AND/OR tag queries, exclusions (
-video,-image), custom sorting, category-based browsing - Anti-Ban Engine -- Tactical delays, retry loops, rate-limit handling
- Proxy Support -- Full proxy configuration from the UI (v2rayN, Clash, etc.)
- API Key Management -- Manage Rule34 credentials directly from the Web UI
- Tag Auto-Suggest -- Live autocomplete for all platforms including offline Konachan tag DB
- Hydrus Sidecar Files -- Auto-generates
.filename.txtsidecar files with tags, artists, and source for Hydrus Network import - Persistent Settings -- Proxy, API keys, and download settings saved in
.env
git clone https://github.com/RemLover-Dev/RemGodCatcher.git
cd RemGodCatcherpip install flask flask-socketio requests urllib3 python-dotenv rule34PyEdit .env or use the Options tab in the Web UI:
RULE34_API_KEY=your_api_key_here
RULE34_USER_ID=your_user_id_here
USE_PROXY=false
PROXY_URL=http://127.0.0.1:10808
VERIFY_TLS=false
API_TIMEOUT=10
RETRY_WAIT=5
ANTI_BAN_PAUSE=3.0python Rem_catcher.pyThe Web UI opens automatically at http://127.0.0.1:5000.
Rem God Catcher/
├── Rem_catcher.py # Python backend (Flask + Socket.IO)
├── shared.py # Core utilities, tag handler, and logging bridge
├── workers/ # API-specific download modules
├── tags.json # Waifu.im tag database (name -> slug mapping)
├── database/ # Tag databases & user data
│ ├── dan_tag_names.json # Danbooru offline tag database
│ ├── safe_tag_names.json # Safebooru offline tag database
│ ├── yande_tag_names.json # Yande.re offline tag database
│ ├── kona_tag_names.json # Konachan offline tag database (82k+ tags)
│ ├── tag_history.json # Search history database (git-ignored)
│ ├── fav_tags.json # User favorites database (git-ignored)
│ ├── image_history.json # Per-image tag archive (git-ignored)
│ └── ui_config.json # Theme & wallpaper config (git-ignored)
├── .env # API keys & proxy config (git-ignored)
├── .gitignore
├── LICENSE
├── README.md
├── README_fa.md # Persian documentation
├── CHANGELOG.md
└── web/
├── index.html # Main HTML (tabs, forms, archives, settings)
├── script.js # Frontend logic (Socket.IO + fetch API)
├── style.css # Glass-morphism dark theme (Inter font)
├── Fonts/ # Offline fonts (Playfair, MonoLisa)
└── wallpaper/ # Background images per tab (dark/light mode)
| Platform | Tags | NSFW | Notes |
|---|---|---|---|
| Rule34 | Full search with AND/OR, exclusions, sorting, video format support | Yes | Requires API key for best results |
| Safebooru | Standard tag search, video format support, artist extraction | No | May require proxy (Cloudflare) |
| Gelbooru | Full search, format exclusions, video/GIF support, artist extraction | Yes | Danbooru-style rating system (Safe/Sensitive/Questionable/NSFW) |
| Danbooru | Full tag search, rating filter, artist extraction, offline tag DB, video/image separation | Yes | Sorts into Safe/Sensitive/Questionable/NSFW folders, separates videos |
| Zerochan | Tag search with live suggestions | No | Built-in retry & rate limiting |
| Waifu.im | Name-to-slug conversion, NSFW toggle | Yes | Uses local tags.json for suggestions |
| Nekos.best | Category-based (PNG / GIF) | No | Multiple format support |
| Nekos.life | Category-based with type indicators (GIF/Static/Mixed) | Yes | Animated neko, hug, pat, cuddle, and more |
| Yande.re | Full tag search, rating filter, artist extraction, local tag DB | Yes | Moebooru API, images only, sorts into Safe/Moderate/NSFW folders |
| Konachan | Full tag search, rating filter, artist extraction, local tag DB, video/GIF format filtering | Yes | Moebooru API, sorts into Safe/Moderate/Explicit folders |
- Register at rule34.xxx
- Go to My Account -> Settings
- Find the API Key section -> Generate API Key
- Copy your User ID from the profile URL
- Enter both in the Options tab of the Web UI
Never share your API keys publicly.
- Register at gelbooru.com
- Go to My Account -> Options
- Under Miscellaneous Options, find API Key and click Generate API Key
- Copy your User ID from the profile URL (e.g.
gelbooru.com/index.php?page=account&s=options&uid=YOUR_USER_ID) - Enter both in the Options tab of the Web UI or add to
.env:
GELBOORU_API_KEY=your_api_key_here
GELBOORU_USER_ID=your_user_id_hereGelbooru limits results to 100 posts per page without an API key. With a key, you get access to all results and faster queries.
This software is provided for educational and archiving purposes only. Some supported APIs index NSFW content -- users must be of legal age in their jurisdiction. Please respect API rate limits and do not aggressively spam requests.