shinkuan

shinkuan / Waifuland

Public

A Linux desktop Live2D model viewer that renders characters as transparent Wayland overlay windows using wlr-layer-shell.

desktop-pet hyprland live2d wayland wlr-layer-shell
19
0
100% credibility
Found Apr 11, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
C++
AI Summary

Waifuland displays interactive Live2D animated characters as transparent, click-through overlays always on top of your Linux Wayland desktop.

How It Works

1
🔍 Discover Waifuland

You stumble upon Waifuland, a delightful way to bring cute animated characters to life right on your Linux desktop as floating companions.

2
📥 Gather your pieces

Download the project files and pick up the official character animation toolkit from its website to get ready.

3
🔧 Follow the easy setup

Run the handy setup helper that checks everything and prepares your viewer in just a few moments.

4
🗂️ Add favorite characters

Drop folders of your beloved animated characters into the special spot so they can join your desktop.

5
🚀 Launch the magic

Fire it up with one simple command, and watch your character pop onto your screen as a see-through overlay!

6
🖱️ Play and interact

Drag your companion around, click parts for fun reactions like expressions or motions, scroll to resize, and switch outfits.

7
🖥️ Tweak on the fly

Hide it instantly with a shortcut when you need focus, or move it to another screen effortlessly.

❤️ Desktop buddy forever

Now your lively animated friend floats happily on your desktop, following your mouse and bringing joy all day.

Sign up to see the full architecture

6 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is Waifuland?

Waifuland runs Live2D characters as transparent overlays on your Linux desktop, using Wayland's wlr-layer-shell protocol for always-on-top rendering with click-through transparency—only the model catches mouse input. Drop models into a config folder (default ~/.config/waifuland/models/), launch via CLI with --models_dir for custom paths, and interact via drag (move/eyes follow cursor), taps (expressions/motions), right-click (next model), middle-click (skins), or scroll (zoom). Built in C++ with the Live2D Cubism SDK, it auto-detects compositors like Hyprland or Sway.

Why is it gaining traction?

In a linux desktops vergleich dominated by sparse customization, Waifuland delivers alice in waifuland-style desktop pets that feel native on linux desktop environments without X11 hacks or GLFW. Hyprland users get extras like global cursor tracking and cross-monitor drag, plus SIGUSR1/2 signals for toggle/hide or focus-monitor moves—perfect for keybinds in linux desktop manager configs. Low overhead when hidden keeps it snappy even as linux desktop market share grows.

Who should use this?

Wayland enthusiasts on Hyprland, Sway, or river wanting interactive companions on their linux desktop pc. Anime fans tweaking linux desktop files or distributions with Live2D models. Devs exploring overlays via linux github clone, especially those handling linux github ssh keys for quick repo pulls.

Verdict

Grab it via linux github desktop or CLI if you're on a supported compositor—solid for fun, low-commitment desktop hacks with good docs and an install.sh script. At 19 stars and 1.0% credibility, it's early but functional; test with your models before production overlays.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.