Kabegame Image Manager

Translated by AI. 中文 | 日本語 | 한국어

A Tauri-based anime image manager! Crawl, organize, and set/rotate wallpapers—let your waifus (or husbandos) keep you company every day~ Plugin-extensible, so you can easily grab images from all kinds of anime wallpaper sites.

<div align="center"> <img src="docs/images/image2.png" alt="Kabegame mascot 1" width="256"/> <img src="docs/images/image1.png" alt="Kabegame mascot 2" width="256"/> </div>

Gallery Screenshots

<table> <tr> <td align="center" style="width: 300px;"> <img src="docs/images/main-screenshot-windows-gallery.png" alt="Kabegame Windows screenshot 1" width="300"/><br/> <small>Windows</small> </td> <td align="center" style="width: 300px;"> <img src="docs/images/main-screenshot-windows-preview.png" alt="Kabegame Windows screenshot 2" width="300"/><br/> <small>Windows</small> </td> <td align="center" rowspan="2" style="vertical-align: top; text-align: right; width: 200px;"> <img src="docs/images/main-screenshot-android-gallery.jpg" alt="Kabegame Android screenshot" width="200"><br/> <small>Android</small> </td> </tr> <tr> <td align="center" style="width: 300px;"> <img src="docs/images/main-screenshot3-macos.png" alt="Kabegame macOS screenshot" width="300"/><br/> <small>macOS</small> </td> <td align="center" style="width: 300px;"> <img src="docs/images/main-screenshot-linux.png" alt="Kabegame Linux screenshot" width="300"/><br/> <small>Linux</small> </td> </tr> </table>

Crawler Screenshots

| | | | --- | --- | | <div align="center"><img src="docs/images/crawler/pixiv.png" alt="Pixiv crawler" width="380"/><br/><small><a href="https://pixiv.net">Pixiv</a> (artist: <a href="https://www.pixiv.net/users/16365055">somna</a>)</small></div> | <div align="center"><img src="docs/images/crawler/anihonet.png" alt="anihonet crawler" width="380"/><br/><small><a href="https://anihonetwallpaper.com">anihonet</a> (yearly ranking)</small></div> | | <div align="center"><img src="docs/images/crawler/anime-pictures.png" alt="anime-pictures crawler" width="380"/><br/><small><a href="https://anime-pictures.net">anime-pictures</a> (keyword: Honkai: Star Rail)</small></div> | <div align="center"><img src="docs/images/crawler/konachan.png" alt="konachan crawler" width="380"/><br/><small><a href="https://konachan.net">konachan</a> wallpapers</small></div> | | <div align="center"><img src="docs/images/crawler/2dwallpaper.png" alt="2dwallpaper crawler" width="380"/><br/><small><a href="https://2dwallpapers.com">2dwallpaper</a> (Games → Genshin → Most viewed)</small></div> | <div align="center"><img src="docs/images/crawler/ziworld.png" alt="ziworld crawler" width="380"/><br/><small><a href="https://t.ziworld.top">ziworld</a> wallpapers</small></div> |

<p align="center">_{Supports many sites; plugins are extensible. Contributions welcome!}</p>

→ Crawler plugins repo

Name Origin 🐢

Kabegame is the romanization of the Japanese word 壁亀 (かべがめ), which sounds similar to 壁紙 (かべがみ, wallpaper). Like a quiet turtle resting on your desktop, it quietly guards your anime wallpaper collection—no fuss, just comfort. So you get a little comfort every day. Yay~ ✨

My philosophy: Embrace open source, build software by and for weebs.

Features

• 🔌 Crawler client: Use .kgpg plugins to crawl wallpapers from various sites; built-in plugin store for browse/install/manage; task progress with stop/delete; CLI to run plugins, import images, etc.
• 🎨 Wallpaper setter (image/video): Collect, manage, and rotate anime wallpapers; auto-switch desktop wallpaper from albums (random or sequential)
• 🖼️ Image manager (image/video): Gallery browsing, album organization, virtual disk (drive letter on Windows, virtual folder on macOS/Linux), drag-and-drop import for local images/videos/folders/archives or kgpg plugins

(Video support: mp4 and mov only as of v3.2.2)

Installation

Desktop Kabegame comes in two builds:

| Feature | Standard | Light | |---------|----------|-------| | Virtual disk | ✅ | ❌ | | CLI | ✅ | ❌ | | Use case | Daily use, CLI/virtual disk needed | Lightweight, basic features only | | Size | Larger | Smaller | | Trade-off | Full features, but OS-specific deps (see Installation) | Install and go, no virtual disk or CLI |

Pick the right package for your OS and needs.

View the latest GitHub Releases

| OS | Standard | Light | |----|----------|-------| | Windows | setup.exe | setup.exe | | macOS | dmg | dmg | | Linux | deb | deb |

• Android preview : apk on the same releases page.

Installation

Windows

1. Download: Choose Standard or Light setup.exe.
2. Run installer: Double-click and follow the wizard.
3. Virtual disk driver (Standard only):
   • If Dokan is not installed, the installer will prompt for admin rights.
   • Click "Yes" to install Dokan (required for virtual disk).
   • Light build does not include virtual disk, so no Dokan.
4. CLI (Standard only):
   • kabegame-cli.exe is installed in the app directory.
   • Add that directory to PATH, or use the full path.

Tip: The installer supports auto-update; run it again to upgrade.

macOS

Minimum: macOS 10.13 (High Sierra) or later.

1. Download DMG: Choose Standard or Light .dmg.
2. Install:
   • Open the .dmg.
   • Drag Kabegame.app to Applications.

[!IMPORTANT]

Fix: "Kabegame.app" is damaged and can't be opened

After installing to Applications, you need to bypass Gatekeeper (this is an open-source app and the author can't afford Apple's developer fee).

xattr -d com.apple.quarantine /Applications/Kabegame.app

3. Virtual disk / FUSE (Standard only):
   • Requires macFUSE: brew install macfuse
   • First mount will prompt for permission.
4. CLI (Standard only):
   • Located at: /Applications/Kabegame.app/Contents/Resources/resources/bin/kabegame-cli
   • To use globally:

   sudo ln -s "/Applications/Kabegame.app/Contents/Resources/resources/bin/kabegame-cli" /usr/local/bin/kabegame-cli
   

   • Then: kabegame-cli --help
   • Light build has no CLI.

Linux (Debian-based, e.g. Ubuntu)

Minimum: Ubuntu 24.04 or later.

1. Dependencies (Standard only):

   • Virtual disk needs fuse3:

   sudo apt update
   sudo apt install fuse3
   

   • Light build does not need fuse3.

2. Install:

   sudo dpkg -i Kabegame-<mode>_<version>_<arch>.deb
   

   • If dependencies fail: sudo apt-get install -f

3. CLI (Standard only):

   • Installed to /usr/bin/kabegame-cli: kabegame-cli --help
   • Light build has no CLI.

4. KDE Plasma Wallpaper Plugin (optional):

   • Requires: KDE Plasma 6; Kabegame must be installed first (hard dependency). See Kabegame installation.
   • Use Kabegame as the system wallpaper in Plasma 6. After installing the plugin deb, go to System Settings → Appearance → Wallpaper and select "Kabegame Wallpaper".
   • Install: Download the .deb from Releases (choose a release with plasma-v* tag), then:

     sudo dpkg -i kabegame-plasma-wallpaper_*_amd64.deb
     

     If dependencies fail: sudo apt-get install -f
   • Restart Plasma Shell (required after install or update):

     kquitapp6 plasmashell 2>/dev/null; kstart6 plasmashell &
     

     Or log out and log back in.
   • Source: Plasma Wallpaper Plugin

5. Workarounds (Linux):

   • Wayland: WebKit2GTK can feel laggy on Wayland. The app automatically forces GDK_BACKEND=x11 when running under Wayland (so the UI uses X11 and is smoother).

Main Features

🖼️ Gallery & Image Management

The gallery is the heart of Kabegame—all collected wallpapers show up here. Pagination, quick preview, multi-select, deduplication, and more. Drag in local files to import. Double-click for in-app preview with zoom, pan, and navigation, or open with your system viewer.

<div align="center"> <img src="docs/images/main-screenshot-macos-gallery1.png" alt="macOS gallery 1" width="400"/> <img src="docs/images/main-screenshot-macos-gallery2.png" alt="macOS gallery 2" width="400"/> </div>

📸 Albums

Organize wallpapers into custom albums. Add favorites, drag to reorder. Albums power wallpaper rotation and virtual disk layout. Each album has its own cover and description.

<div align="center"> <img src="docs/images/album.png" alt="Album list" width="400"/> <img src="docs/images/album-detail.png" alt="Album detail" width="400"/> </div>

🔌 Plugin System

Kabegame’s strength is its plugin-based crawler (local file import is a crawler plugin too). .kgpg plugins let you pull images from anime wallpaper sites. Plugins are written in Rhai. Built-in plugin store (plugin repo) for one-click install