Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Turn your devices into buckets. Impress your friends with "magic" :-)
branch: master


latest commit 991ba75a52
@xat authored

Bucket Balls

Bucket Balls lets you connect multiple devices (Smartphones, Laptops,...). Each device becomes a "Bucket". You can create some colored balls inside a bucket. If the device supports the "deviceorientation"-event you can slop the balls from one bucket into another. You can create rulesets to define which bucket is allowed to drop its balls in which other buckets.

Wanna see Bucket Balls in action?

Have a look at this Video on YouTube:

Bucket Balls on YouTube


Simply clone the project and run npm install inside the projects directory.


You can setup bucket balls within the config.js file. There you can define rulesets and and map client IDs to them.


When everything is setup you can start the server with node app.js. Afterwards connect the devices ('buckets') by calling http://[host:port]/client/[clientID] in their browsers. You can then init client 1 for example with 30 balls by typing this command into the bucket command line:

Something went wrong with that request. Please try again.