Skip to content
yurisuika edited this page Jun 14, 2026 · 5 revisions

Introduction

You can give your waifu a home in your library! Supports random image selection, adjustable placement, and more.

This guide serves to show you how to configure your waifus.

ハッろ ワイフ

The first step to bringing your waifu home is to make a choice (of course!).

Screenshot 2026-05-26 000048

Choosing Your Waifus

To get past some limitations and ensure results are pretty similar on your system, Zehn now uses JSON to store a list of images. You may list your waifus in this JSON array stored at ~/waifus.json within the skin.

Because Millennium replaces skins with its update feature, Zehn also first checks for a JSON stored at https://steamloopback.host/waifus/waifus.json. You can safely configure your waifus here and update your skin whether on SFP or Millennium without having to back up anything.

Where the Hell Is That?

Steam uses C:\Program Files (x86)\Steam\steamui as its loopback host root directory on Windows by default. This will vary depending on your installation location and OS.

So, https://steamloopback.host/waifus/waifus.json would be at C:\Program Files (x86)\Steam\steamui\waifus\waifus.json in this case.

Adding Waifus

The JSON contains a simple array. Every entry is a waifu waiting for you.

[
  "/waifus/lain.png",
  "https://steamloopback.host/waifus/lain.png"
]

In the default examples, both point to the same location at C:\Program Files (x86)\Steam\steamui\waifus\lain.png (depending on your installation).

Important

Please note that if you are using Millennium 3.x you cannot use a relative directory, as in this version themes are hosted outside of the Steam loopback host.

image

Of course, you are not limited to using images hosted within the Steam loopback directory. You can use anything hosted on the web or on your home network, as long as it is being served somehow.

Add as many images as you like! One will be randomly chosen every time the library window is loaded.

Tip

You can convert your image to a data URI and store it directly as an entry in waifus.json.

This may not fare well with images of substantial size. For example, my personal 512x512 Lain PNG comes out to a 300k character data URI.

Additional Behavior

Read up more on the options for additional behavior.

Clone this wiki locally