| .gitignore | ||
| index.html | ||
| LICENSE | ||
| preview.jpg | ||
| project.json | ||
| README.md | ||
Fishies · your aquarium as a live wallpaper
A web wallpaper for Wallpaper Engine that shows a Fishies aquarium on your desktop: the real, live tank, with no HUD and no sound.
Install
The easy way: open Fishies · live aquarium on the Steam Workshop and press Subscribe. Wallpaper Engine installs it; then do step 3 below.
By hand:
- Download fishies-wallpaper-engine.zip and unpack it. (The aquarium and its art are built from the game for each release, so this repository holds the page and its settings; the zip holds everything.)
- In Wallpaper Engine, open the Wallpaper Editor, choose Create Wallpaper and pick
index.htmlfrom the unpacked folder. (Or dragindex.htmlonto the Wallpaper Engine window.) - Select the wallpaper, open its settings on the right and type your Fishies handle: the name after
@in your aquarium's address,fishies.lol/@your-handle. Pasting the whole link works too.
Your fish appear as soon as the handle is in. Anyone's public aquarium works, so you can keep a friend's tank on a second monitor.
Settings
| Setting | What it does |
|---|---|
| Fishies handle | Whose aquarium to show: a handle, @handle or the aquarium's link |
| Aquarium | Aquarium 1, 2 or 3 of that keeper. One that is private or missing shows the keeper's first public aquarium. |
| Frames per second | 10 to 60, 30 by default. Lower is lighter on a laptop. |
| Show the fishies.lol mark | A small fishies.lol in the top right corner, on by default |
More than one monitor
- One wallpaper per monitor (Wallpaper Engine's default): every monitor has its own settings, so each can show a different keeper or a different aquarium, at its own frame rate.
- Span across monitors: choose the span layout in Wallpaper Engine and one aquarium stretches over all of them. Wide and tall screens are filled edge to edge, never stretched: an ultrawide (3440x1440), a 32:9 pair (3840x1080), a portrait monitor (1080x1920) and 4K all keep the fish at their own shape.
- High DPI screens draw at their full resolution.
How it behaves
- Everything it draws ships inside the wallpaper: the aquarium engine, the fish, the decorations and the tank art. The only thing it reads from the internet is the aquarium itself, from
https://fishies.lol/api/public/<handle>, once a minute. - The fish are the game's own: the same engine, rigs and swimming as in Fishies, at the frame rate you set.
- It stops drawing completely when Wallpaper Engine pauses it (for example while a game runs full screen), and the fish carry on from where they were when it comes back.
- No internet? It shows the last aquarium it saw and keeps trying. On its very first start without a connection it shows a small Fishies card that says what it is waiting for, and the tank appears as soon as fishies.lol answers.
- It is the game's read-only view: no sound, no menus, and nothing on it can be clicked.
- It is the live aquarium, so a fish that is hungry in the game is hungry on your desktop too.
Files
project.json· what Wallpaper Engine reads: the title, the four settings and the preview.index.html· the page. Open it in a browser asindex.html?handle=your-handleto try it without Wallpaper Engine (&aquarium=2,&fps=60and&mark=0work too).fishies-aquarium.js· the aquarium engine, built from the game (in the zip).game/· the art, one small script per picture so it loads straight from the wallpaper's folder (in the zip).preview.jpg· the picture in Wallpaper Engine's list.
How this repository is made
It is published from the game's own tooling at each release, one commit per release (Fishies <version>). This is the version for Fishies 0.8.14.
Found a problem, or built something?
Open an issue, or send a pull request: fixes, new settings and ports to other wallpaper apps are welcome. An accepted change is copied into the game's tooling so the next release keeps it. To talk to us, come to Discord.
More ways to show your aquarium
- On your own site: fishies-embed, an iframe, one HTML tag and a live README card.
- On your stream: fishies-stream-overlay, a browser source for OBS and Streamlabs.
Licence
The code is MIT: use it however you like. The aquariums it shows, the fish and tank art in the zip, and preview.jpg are © Fishies · they may be used to talk about or show Fishies; not for use in other games or products.