gitwtfhub

wtf is zhuzhiliao?

imsai-sh/zhuzhiliao — explained in plain English

Analysis updated 2026-08-13

2,702HTMLAudience · generalComplexity · 1/5LicenseSetup · easy

TL;DR

A single file web version of a traditional Chinese spinning toy that makes a real recorded croaking sound as you spin it.

Mindmap

mindmap
  root((Zhuzhiliao))
    What it does
      Web version of a spinning toy
      Real recorded toy sound
      Works on mobile and desktop
    How it works
      Single HTML file
      Canvas and Web Audio API
      Rope and pendulum physics
    Use cases
      Relive a childhood toy online
      Study single file web app design
      Learn recorded audio looping tricks
    Tech stack
      HTML
      Canvas 2D
      Web Audio API
    Audience
      General users
      Web developers
      Curious tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Play a nostalgic spinning toy simulation directly in a browser.

REASON 2

Study how a single HTML file can hold a full audio and physics simulation with no dependencies.

REASON 3

Learn how to loop a real audio recording seamlessly for a web app.

REASON 4

See an example of mobile motion sensor input driving an on screen animation.

What's in the stack?

HTMLCanvasWeb Audio API

How it stacks up

imsai-sh/zhuzhiliaonexu-io/html-anythingbozhoudev/codex-orange-book
Stars2,7022,7342,579
LanguageHTMLHTMLHTML
Last pushed2026-06-24
MaintenanceMaintained
Setup difficultyeasyeasyeasy
Complexity1/52/51/5
Audiencegeneralvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Not open source, the license only permits local personal use, not redistribution or public deployment.

Source is public for reading and personal local use only, redistribution, public deployment elsewhere, and commercial use are not allowed.

Wtf does this do

Zhuzhiliao is a web version of a traditional Chinese spinning toy that makes a croaking sound when you twirl it, called zhuzhiliao. The whole thing is built as a single HTML file with no external dependencies, and it is designed to work on mobile phones first. You can try it live at the project's official site, or open the index.html file directly in a browser with no build step and no internet connection required. You can play with it by dragging a finger or mouse across the screen the way you would spin the real toy, and it also supports letting it spin on its own. On a phone, holding the device and tilting it can drive the spinning motion directly through the phone's motion sensors, once you grant permission for that. The sound is not a synthetic beep. The creator recorded audio from a real zhuzhiliao toy, took a short clip timed to loop cleanly, and blended the start and end so it repeats cleanly with no audible gap, embedded directly inside the HTML file. The playback speed changes to match how fast you are spinning it, so spinning faster makes it sound faster and more urgent, closer to how the physical toy actually behaves. The underlying motion is simulated with simple rope and pendulum style physics rather than being purely decorative. A small counter on the page counts how many times you personally have spun it, stored only in your browser's local storage, with nothing sent to any server. The README is explicit that this is not an open source project in the licensing sense, even though the source code is publicly visible. Reading and studying the code, and running it locally for personal or learning purposes, is allowed, but redistributing it, deploying it publicly under another domain, or using it commercially is not permitted. The only authorized deployment is the project's own official website.

Yoink these prompts

Prompt 1
Explain how this project loops a real audio recording seamlessly inside a single HTML file.
Prompt 2
Show me how the rope and pendulum physics simulation works in this code.
Prompt 3
Help me understand how mobile device motion sensors are used to spin the toy.
Prompt 4
Walk me through what the license here does and does not allow.

Frequently asked questions

wtf is zhuzhiliao?

A single file web version of a traditional Chinese spinning toy that makes a real recorded croaking sound as you spin it.

What language is zhuzhiliao written in?

Mainly HTML. The stack also includes HTML, Canvas, Web Audio API.

What license does zhuzhiliao use?

Source is public for reading and personal local use only, redistribution, public deployment elsewhere, and commercial use are not allowed.

How hard is zhuzhiliao to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is zhuzhiliao for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.