chaseleantj/desktop-habitats
Living ecosystems you can interact with on your desktop
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
Have you always wanted an aquarium? Now you can have it, right on your desktop :) The fish react to your cursor and compete for food, while the plants sway in a slow current. I plan to add more environments soon. For now, there is only Riverscape, a planted freshwater aquarium. The scene is rendered live with Three.js and WebGL2. Everything runs locally, with no account or internet connection needed after setup. Desktop wallpaper support is macOS only for now; you can also try Riverscape in a browser. The app opens Riverscape directly. You need macOS 13 or newer and the Xcode command line tools. To install the tools, open Terminal and run: Wait for that installation to finish. Download and unzip this repository, or clone it, then open Terminal in the project folder and run: The script builds the app for your Mac, installs it at /Applications/Desktop Habitats.app, and…
Read the full README ↗ · Preview checked 2026-09-20T07:25:41.855Z
Inside the original README — Document outline
- Desktop Habitats
- Install on Mac
- Use the wallpaper
- FAQ
- Does it work on Windows or Linux?
- Will it drain my battery?
- Does it monitor my keystrokes?
- Does it need internet access or special permissions?
- Why have the fish stopped moving?
- Can I use multiple monitors?
- Do I need to leave Terminal open?
- How do I update it?
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
Living ecosystems you can interact with on your desktop
Repository facts
- Owner
- chaseleantj
- Primary language
- JavaScript
- Stars
- 208
- Forks
- 25
- Open issues + pull requests
- 6
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-09-18T08:31:55.000Z
- Last push
- 2026-09-21T06:27:13.000Z
Topics and intended use
No topics were included in the latest source metadata.
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-09-21T06:41:42.808Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.