1 / 6
ASCII Genesis — A Little Ocean for Your Desk — image 1
1 / 6

ASCII Genesis — A Little Ocean for Your Desk

Order a print of this model

We calculate the final price from your selected file. You review and accept it before payment.

Saved on this device.

A peaceful ASCII ocean for your desk, powered by a Raspberry Pi, with a printed case and 20 sea creatures.

Rating
0 / 5
Likes
3
Downloads
3
Makes
0
Views
61
Reviews
0

Updated at source:

Model information

Category
Electronics
License
Creative Commons — Attribution — Share Alike

ASCII Genesis — An Ocean for Your Desk

I like making things that bring a little life to my desk. ASCII Genesis is a peaceful, scrolling ocean made from ASCII characters, running on a Raspberry Pi and a 7.9" display.

It started with the idea of turning the classic Asciiquarium into a physical desk decoration. Since then, it’s grown into an ocean with changing terrain, different habitats, and a variety of creatures passing through.

This is an ongoing project. I’m constantly adding ideas, creatures, and improvements. Suggestions are welcome, and the desktop update shortcut makes it easy to get the latest published version.

Features

- 20 creature designs, including fish, a squid, an octopus, and a sea turtle.

- Different swimming speeds, with creatures entering and leaving beyond the screen edges.

- Scrolling seabed terrain and seaweed in different heights and shades of green.

- Kelp meadow, rocky reef, and open sand habitats.

- An occasional diver with a small trail of bubbles.

- Brief predator pursuits where both animals speed up. Most prey escape; occasional catches include a simple feeding animation.

- Quiet mode to turn hunting off.

- A two-minute creature parade that brings the whole collection across the screen.

The ocean works offline without an API key. Optional OpenAI narration can describe the ecosystem, but it isn’t required.

Hardware

My working setup uses:

- Raspberry Pi 4 Model B

- Waveshare 7.9" HDMI capacitive touchscreen, running landscape at 1280 × 400

- A microSD card with Raspberry Pi OS

- Suitable power, HDMI, and USB connections

The printed enclosure is designed around this setup. Check the repository’s hardware instructions before buying parts.

Printing

PartQuantity

Case1

Leg2

Print at 100% scale. Both STL and 3MF files are included.

The model download contains the enclosure parts. Electronics and software are separate.

Software and Installation

GitHub repository — software, build instructions, and updates:

https://github.com/Mikepyt87/ascii-genesis

The repository includes installation instructions, hardware and printing information, a detailed ocean library, screenshots, and full project credits.

The installer adds ASCII Genesis and Update ASCII Genesis shortcuts to your Raspberry Pi desktop. Once installed, you can launch the ocean without opening a terminal.

Updates and Ideas

I’m continuing to develop this project with new creatures, behaviors, and ideas. The features listed here describe the current version; GitHub will have the latest additions.

Close the ocean and use the Update ASCII Genesis desktop shortcut to download published updates.

Have an idea for something that belongs in the ocean? Leave a comment or suggest it on GitHub.

Credits and Inspiration

ASCII Genesis builds on Asciiquarium, created by Kirk Baucom, and artwork shared by its contributors and the ASCII art community, including Joan Stark. Their work gave this project its foundation and much of its character.

OpenGhost helped inspire the project’s early direction before it developed into this direct-screen Raspberry Pi build.

Full credits and source information are included in the repository. Thanks to everyone who shared their work and made projects like this possible.

If you build one, post a make! I’d love to see it on someone else’s desk.

Tags