commit 4d96337aec8343fc55b3d9eef1a7290c1c1f4895 Author: CRTkafa Date: Tue Nov 3 11:31:27 2026 +0000 Fishies 0.8.14 diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..80c9601 --- /dev/null +++ b/LICENSE @@ -0,0 +1,27 @@ +MIT License + +Copyright (c) 2026 Fishies (CRTkafa) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +The MIT licence covers the code in this repository, except the built aquarium +wallpaper-engine/fishies-aquarium.js. That file, the art in wallpaper-engine/game/, +the picture wallpaper-engine/preview.jpg and the aquariums the code displays are +© Fishies: they may be used to talk about or show Fishies, not in other games +or products. diff --git a/README.md b/README.md new file mode 100644 index 0000000..4affa20 --- /dev/null +++ b/README.md @@ -0,0 +1,64 @@ +
+ +# Fishies · your aquarium as a stream overlay + +Fishies fish and decorations swimming over a streamer's scene, with no water behind them + +Put your [Fishies](https://fishies.lol) aquarium on your stream: the real, live tank as a browser source for OBS Studio, Streamlabs or any other streaming app, with no menus and no sound. + +
+ +## The address + +`https://fishies.lol/overlay/your-handle` is your aquarium as a browser source: no menus, no sound, no loading screen over your scene, and a frame rate capped at 30 so it stays light beside your encoder. With `?bg=transparent` the water is gone and only the fish and the decorations are drawn, so they swim over your own scene. + +## Add it in OBS Studio + +**In OBS Studio** (the same steps work in Streamlabs Desktop and any other browser source): + +1. In **Sources**, press **+** and choose **Browser**. +2. Paste `https://fishies.lol/overlay/your-handle?bg=transparent` into **URL**. +3. Set **Width** and **Height** to the size you want it to cover, for example 1920 and 1080. Leave **Custom CSS** as it is: nothing needs changing, the page already has a transparent background. +4. Press OK, then move and resize the source in your scene like any other. If it ever stops, right-click the source and choose **Refresh**. + +## Let the game write it + +The game writes this address for you: **Embed & cards** in My Aquarium has a **Stream overlay** card where you pick the aquarium, **With water** or **Fish only**, and the name plate, with a preview, and copies the address with your handle in. + +## Options + +| Option | What it does | Default | +| --- | --- | --- | +| `bg=transparent` | Fish and decorations only. Leave it out for the whole aquarium with its water | the whole aquarium | +| `fps=20` | Frames per second, 10 to 60 | 30 | +| `fish=12` | Draw at most this many fish (the rest stay home, which saves work) | all of them | +| `size=70` | The aquarium's scale inside the source, 25 to 200 percent, centred | 100 | +| `plate=1` | The aquarium's name and your level, bottom left, set straight on the picture with its own shadow (no box behind it). It grows with the source and with `size` | off | +| `aquarium=2` | Which of your aquariums, 1 to 3 (a missing or private one shows the one your address opens) | the one your address opens | + +For example, `https://fishies.lol/overlay/your-handle?bg=transparent&fish=15&plate=1`. + +![The same overlay with its water, at 70 percent](images/overlay-water.webp) + +## How it behaves + +The overlay shows public aquariums only and cannot change anything. If yours is private it says so in the middle of the source, with what to do, and the aquarium appears by itself within a minute of you opening it to visitors. It stops drawing while the source is hidden in every scene, so a hidden overlay costs your stream nothing. It reconnects by itself when your network drops, and if it could not load at all it tries again after twenty seconds. Add `lang` in the path (`https://fishies.lol/tr/overlay/your-handle`) for the little text it can show in another language. + +Your **handle** is the name after `@` in your aquarium's address (`fishies.lol/@your-handle`). Replace `your-handle` with it in the examples above. + +## How this repository is made + +It is published from the game's own tooling at each release, one commit per release (`Fishies `). This is the version for Fishies 0.8.14. + +## Found a problem, or built something? + +[Open an issue](https://git.crt.fyi/PlayFishies/fishies-stream-overlay/issues), or send a pull request: fixes, set-up steps for other streaming apps and scene ideas 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](https://discord.gg/fishies). + +## More ways to show your aquarium + +- **On your own site:** [fishies-embed](https://git.crt.fyi/PlayFishies/fishies-embed), an iframe, one HTML tag and a live README card. +- **On your desktop:** [fishies-wallpaper-engine](https://git.crt.fyi/PlayFishies/fishies-wallpaper-engine), a live wallpaper for Wallpaper Engine. + +## Licence + +The examples are [MIT](LICENSE): use them however you like. The aquariums the overlay shows and the pictures in `images/` are © Fishies · they may be used to talk about or show Fishies; not for use in other games or products. diff --git a/images/overlay-transparent.webp b/images/overlay-transparent.webp new file mode 100644 index 0000000..6957e98 Binary files /dev/null and b/images/overlay-transparent.webp differ diff --git a/images/overlay-water.webp b/images/overlay-water.webp new file mode 100644 index 0000000..8e89fa3 Binary files /dev/null and b/images/overlay-water.webp differ