Skip to content
@GameWithPixels

Pixels - Electronic Dice

We build smart dice that light up and that you can connect to from an app or a website

Welcome!

This is the right place to start looking for information on how to integrate Pixels dice with an app or a website.

Two Pixels dice lighting up with multiple colors.

Two Pixels dice lighting up with multiple colors.

What Are Pixels Dice?

Pixels are full of LEDs, smarts and no larger than regular dice, they can be customized to light up when and how you desire. Check our website for more information.

All Pixels dice come with Bluetooth connectivity which enables a software developer to write code to connect to them from a mobile device or a computer. Once connected to a Pixel, an app or a website may read rolls and program colorful animations to be played on the dice LEDs.

An Open Source Ecosystem

The Pixels software ecosystem is open source. We publish the source code of our Pixels app, libraries and firmware.

Communications with a device such as a computer or a phone is made using Bluetooth Low Energy which is an open standard for short-range radio frequency communication.

This open knowledge and reliance on the Bluetooth standard enables developers to write code that communicates with Pixels using any combination of language and system they wish as long as the underlying platform supports Bluetooth Low Energy 4.2 or greater.

Community

If you have any question please join us on our Discord server.

This is the best place to reach out to us and also get help from the community.

All our Pixels software is open source and published on GitHub. We are open to contributions via pull requests.

If you find a bug with one of our package, please open an issue on the corresponding GitHub repository.

How To Start

Pixel App

If you are not already familiar with the Pixels terminology (profile, animation, design, etc.) you may want to read our Pixels App Guide to learn how to build an animation for a Pixel die.

Developers Guide

Before jumping into programming please make sure to read our Pixels developer's guide.

We've build this guide based on our own experience with developing apps and websites that connects to Pixels die.

Communicating with any wireless device can be challenging. In this document we list what we found out to be good practices as well as what to watch for when building software for Pixels dice.

Packages

We provide official support for a growing selection of platforms and will add more based on community feedback. Those libraries encapsulate the details of the Bluetooth protocol and Pixels message serialization so the developer only need to write a few lines of code without prior knowledge to start communicating with Pixels dice.

We currently provide packages for the following platforms/environments:

  • Web - link
  • React Native (iOS, Android) - link
  • Unity (iOS, Android & Windows) - link
  • Swift (iOS & MacOS) - link
  • C++ (Windows) - link

We are currently working on supporting these ones:

  • Kotlin/Java (Android)
  • .NET (Windows)
  • Python (Windows & Raspberry Pi)
  • Unity (MacOS)

Let us know on Discord if your looking for support on other platforms! We'll prioritize our development based on community feedback.

Going Further

The code architecture of the Pixels libraries is described in this document.

Although we recommend starting with one of our official package, it is entirely possible, to write custom software that connects to Pixels dice on any platform. See these Pixels communication protocol specifications to learn more about how to communicate with Pixels without using one of our library.

The Pixels dice run a bootloader and a custom firmware. Their respective repositories may be found here and there.

Pinned

  1. PixelsWebDemo PixelsWebDemo Public

    Web mini game using Pixels dice.

    TypeScript 2 1

  2. pixels-js pixels-js Public

    Pixels dice Typescript/JavaScript packages and apps.

    TypeScript 14

  3. swift-pixels-library swift-pixels-library Public

    Pixels dice package for Swift.

    Swift 2 1

  4. PixelsUnityPlugin PixelsUnityPlugin Public

    Pixels dice package for Unity.

    C# 10 2

  5. DiceFirmware DiceFirmware Public

    Pixels dice firmware code.

    C++ 13 1

  6. PixelsWinCpp PixelsWinCpp Public

    C++ Pixels dice library for Windows.

    C++

Repositories

Showing 10 of 15 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Most used topics

Loading…