Tool Open source

Paper Aquarium

Paper Aquarium is a home game that turns a child's marker-colored A4 sheet into a 3D fish swimming in a browser aquarium, with a phone used to capture the sheet and a large screen used for viewing. Four black corner markers identify the sheet and its species while allowing the capture code to locate it in the photo and undo perspective distortion. The system then crops the drawing along the species contour, removes the printed outline, and maps the result as a texture onto a Three.js fish model; the aquarium positions fish within a camera-frustum-shaped volume and infers their orientation from the animation's tail movement. It includes ready-made fish, food, coloring sheets, backgrounds, multiple aquariums, and phone-to-TV handoff through a QR code, link, or five-digit code. The server uses plain Node with no dependencies, with Three.js stored in the repository; it requires Node 18 or later.

View repository Mentioned in 1 video ↓

What Paper Aquarium is used for

1 use taken from transcripts — each links to the moment in the video.

  • A system that turns a child's paper coloring into a swimming 3D fish. A phone camera identifies and corrects the drawing, maps it onto an animated Three.js model, and supports phone-to-TV viewing.

Videos mentioning Paper Aquarium

1 in the library.