[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-79161":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":40,"readmeContent":41,"aiSummary":42,"trendingCount":16,"starSnapshotCount":16,"syncStatus":43,"lastSyncTime":44,"discoverSource":45},79161,"ASCII-Aquarium","POWER-PILL\u002FASCII-Aquarium","POWER-PILL","ASCII Aquarium turns your Cheap Yellow Display into an tiny animated ASCII fish tank. It renders a live aquarium scene with animated fish, bubbles, swaying seaweed, tap-to-feed food flakes, occasional octopus & seahorse visitors, selectable backgrounds, preferences, optional Wi-Fi clock sync, & More!","https:\u002F\u002Fpower-pill.github.io\u002FASCII-Aquarium\u002F",null,"C++",321,26,7,13,0,3,51,193,25,77.29,false,"main",true,[26,27,28,29,30,31,32,33,34,35,36,37,38,39],"3d-printing","arduino","ascii-art","ascii-art-generator","ascii-graphics","cheap-yellow-display","cyd","esp-web-tools","esp32","ili9341","makerworld","powerpill","tft-espi","xpt2046","2026-06-12 04:01:24","## Meet the ASCII Aquarium >\u003C(((°> \n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd width=\"45%\" valign=\"top\">\n\u003Cp>\n  A tiny animated ASCII fish tank for the ESP32-2432S028R Cheap Yellow Display.\n\u003C\u002Fp>\n      \u003Cp>\n      Flash it from the browser, tap to feed the fish, tune the tank, sync the clock over Wi-Fi, and let the punctuation swim.\n      \u003C\u002Fp>\n      \u003Cp>\n        \u003Ca href=\"https:\u002F\u002Fpower-pill.github.io\u002FASCII-Aquarium\u002F\">\n          Flash ASCII Aquarium CYD\n        \u003C\u002Fa>\n      \u003C\u002Fp>\n      \u003Cp>\n        ASCII Aquarium turns the common 320x240 CYD touchscreen into a living little\ndesktop aquarium with swimming ASCII fish, rising bubbles, swaying seaweed,\ntap-to-feed flakes, occasional octopus and seahorse visitors, touch controls,\nWi-Fi time sync, persistent settings, and SD-card screenshot capture.\n\u003C\u002Fp>\n\u003Cp>\n        It is not a video loop. The aquarium is rendered live on the ESP32, with fish\nthat wander, school, turn around, change brightness, avoid each other, and chase\nfood when you tap the glass.\n      \u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd width=\"55%\" valign=\"top\">\n      \u003Cimg\n        src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F34200303-25c9-45c5-a6eb-1e53a6c267d7\"\n        alt=\"ASCII Aquarium Title Screen\"\n        width=\"100%\">\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\nCheck out the article on Hackaday! https:\u002F\u002Fhackaday.com\u002F2026\u002F05\u002F24\u002Fadorable-ascii-aquarium-lives-on-your-desk\n\n## GIFs of the ASCII AQUARIUM in Action }>{{{{• >\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd width=\"50%\" valign=\"top\">\n    \u003Cimg\n        src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fb350f4ad-5aa9-4560-84a4-927dffa96d35\"\n        alt=\"Settings\"\n        width=\"100%\">\n    \u003C\u002Ftd>\n    \u003Ctd width=\"50%\" valign=\"top\">\n      \u003Cimg\n        src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F12696457-80b7-4ba0-9382-38a2e72ea84d\"\n        alt=\"Feeding the Fish\"\n        width=\"100%\">\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## ASCII Aquarium Web Flasher >)))'>\n\nThe easiest way to install ASCII Aquarium\n is with the browser flasher:\n\n[Flash ASCII Aquarium CYD](https:\u002F\u002Fpower-pill.github.io\u002FASCII-Aquarium\u002F)\n\nYou will need:\n\n- A supported [CYD board](https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005004971720824.html) connected by a USB data cable.\n- Chrome or Edge on a desktop computer.\n- The Arduino IDE Serial Monitor closed, if it was open.\n\nOpen the flasher page, click **Flash ASCII Aquarium**, choose the CYD serial\nport, and let the installer finish.\n\n## Supported Hardware >\u003C(((º>\n\nThis firmware is built for the [ESP32-2432S028R \"Cheap Yellow Display\" board](https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005004971720824.html):\n\n[https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005004971720824.html](https:\u002F\u002Fwww.aliexpress.com\u002Fitem\u002F1005004971720824.html)\n\n- ESP32\n- ILI9341 320x240 display\n- XPT2046 resistive touchscreen\n- Optional SD card support for BMP screenshots and frame capture\n\nOther CYD-style boards may look similar but use different display, touch, or SD\nhardware.\n\n## 3D Printed 2.8\" CYD Cases >\u003C((((>`\n- [Basic snapfit case by PowerPill.Prints](https:\u002F\u002Fmakerworld.com\u002Fen\u002Fmodels\u002F2835243)\n- [CYD Desk Buddy by annaglyph](https:\u002F\u002Fmakerworld.com\u002Fen\u002Fmodels\u002F2787810) \n\n## Features >(°)>\n\n- Animated ASCII fish with multiple glyph species, varied colors, depth shading,\n  smooth wraparound, schooling, wandering, and separation behavior.\n- Tap-to-feed flakes that nearby fish chase down.\n- Configurable fish population from 6 to 36.\n- Configurable bubble count from 0 to 50.\n- Animated bubbles and seaweed with adjustable sway, length, and randomness.\n- Visiting octopus and seahorse characters with selectable spawn rates.\n- Fish steer around visitors and each other.\n- Background styles: black, blue fade, purple fade, and randomized Spongebob style flower backdrop.\n- Touch settings menu with Tank, Seaweed, Clock, and Background tabs.\n- Optional on-screen clock with manual time or internet time.\n- 12-hour and 24-hour clock formats.\n- Timezone selection, small top or bottom clock, large ASCII clock style, and clock color picker.\n- Wi-Fi panel with network scan, saved credentials, on-screen keyboard, reconnect handling, and NTP time sync.\n- Persistent settings using ESP32 Preferences.\n- SD-card BMP screenshots and frame sequence capture.\n- Hidden HUD controls for setup, capture, Wi-Fi, settings, quick creature tests, respawn, and randomize.\n\n## Basic Controls >\u003C((((*>\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd width=\"50%\" valign=\"top\">\n \u003Cp>• Tap the top-left corner to reveal the hidden HUD.\u003C\u002Fp>\n \u003Cp>• Tap the tank to drop food.\u003C\u002Fp>\n \u003Cp>• Use the settings panel to tune fish, bubbles, visitors, seaweed, clock, and\n  backgrounds.\u003C\u002Fp>\n \u003Cp>• Use the Wi-Fi panel to connect to a network and sync internet time.\u003C\u002Fp>\n \u003Cp>• Use the capture panel to save BMP sequences to the SD Card. BEWARE - this is EXTREMELY slow since the fishtank simulation is slowed down to allow every frame to be captured.\u003C\u002Fp>\n \u003Cp>• Press and hold the BOOT button on the back of the CYD to save BMP screenshots to the SD card.\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd width=\"50%\" valign=\"top\">\n      \u003Cimg\n        src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F3a448574-69ee-40fb-a141-50961f769b09\"\n        alt=\"ASCII Aquarium Settings\"\n        width=\"100%\">\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## Using the Beam Splitter cube Display >\u003C>\n\nThis build can also use a 50 mm beam splitter cube to give the aquarium a little \"floating in glass\" look. \n\nA beam splitter cube is made from two glass prisms joined together with a partially reflective diagonal layer inside. When the CYD screen shines into the cube, some of that light passes through and some of it reflects off the internal 45-degree surface. To your eyes, the aquarium appears to hover inside the cube instead of just sitting flat on the display. It is basically a tiny optical tide pool.\n\nIf using the clock with the beam splitter cube, you will need to enable “flip clock” in the clock style settings window.\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd width=\"50%\" valign=\"top\">\n\u003Cp>• Use the 50 mm cube size for this printed stand.\u003C\u002Fp>\n\u003Cp>• Handle the cube by the edges and wipe fingerprints with a clean micro-fiber cloth. Smudges are the enemy of premium fish.\u003C\u002Fp>\n\u003Cp>• Seat the cube squarely in the holder so the clear face points toward the viewer.\u003C\u002Fp>\n\u003Cp>• Keep the display bright and the surrounding room a little dimmer if you want the fish to really pop.\u003C\u002Fp>\n\u003Cp>• A dark base or darker background behind the cube helps the reflection look cleaner.\u003C\u002Fp>\n\u003Cp>• If the image looks faint, doubled, or not quite centred, rotate or flip the cube and try again. Beam splitters can be a bit fin-icky about orientation.\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd width=\"50%\" valign=\"top\">\n      \u003Cimg\n        src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F36b6a33d-72d2-48c5-ae38-65e8de0e304c\"\n        alt=\"ASCII Aquarium Holo Cube\"\n        width=\"100%\">\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\nThe cube does not create the animation by itself; the CYD is still doing all the swimming, bubbling, clocking, and snack-chasing. The cube just splits and redirects the light so the tank feels more like a miniature glass aquarium and less like a bare screen. No water required, unless you count the tears of anyone who bought a real aquarium and then learned about water changes.\n\n## Build From Source >\u003C>\n\nThe main Arduino sketch lives here:\n\n```text\nASCII_Aquarium_CYD\u002FASCII_Aquarium_CYD.ino\n```\n\nThe sketch expects the CYD display and touch configuration used by the included\nTFT_eSPI setup files:\n\n```text\nUser_Setup.h\nUser_Setup_Select_CYD.h\n```\n\nTo build manually:\n\n1. Open `ASCII_Aquarium_CYD.ino` in the Arduino IDE.\n2. Select the same ESP32 board\u002Fsettings used for your CYD.\n3. Make sure TFT_eSPI is using the included CYD setup.\n4. Compile and upload through the Arduino IDE.\n\nFor browser flashing releases, use Arduino IDE's **Export Compiled Binary** and\npublish the generated merged firmware binary.\n\n\n## Project Notes >°>\n\nASCII Aquarium CYD is part clock, part screensaver, part tiny art object, and\npart excuse to make fish-shaped punctuation swim around like it has somewhere\nimportant to be.\n\nNo water changes. No tank cycling. No surprise snails. Just plug it in and let\nthe current take care of itself.\n","ASCII Aquarium 项目将廉价的黄色显示屏转变为一个迷你动态ASCII鱼缸。它利用C++编程语言，在ESP32微控制器上实时渲染包含游动的ASCII鱼、气泡、摇曳的海草等元素的生动水族馆场景，支持触摸投食、偶尔出现的章鱼和海马访客、可选背景及Wi-Fi时钟同步等功能。该项目特别适合拥有ESP32-2432S028R“廉价黄色显示屏”的用户，为桌面增添一份独特而有趣的装饰，同时也是一个很好的学习嵌入式系统开发与图形渲染技术的小型案例。",2,"2026-06-11 03:57:30","CREATED_QUERY"]