/moody

GNU General Public License v3.0GPL-3.0

Moody

Moody is an Arduino project that displays a range of facial expressions on a small OLED display.

How It Works

The Moody project features a small OLED display that can show a variety of facial expressions. Each facial expression consists of two animation frames, and the display changes to a different facial expression after a certain amount of time. The facial expressions are arranged in a particular order so that only certain facial expressions can follow one another.

If you just want to build a Moody with the default configuration, head over to the moody-arduino repository

If you are interested in creating your own individual Moody with custom facial expressions and their order, you should continue reading.

Overview

The Moody project consists of three main components, each of which is contained in a separate sub-repository:

  1. moody-arduino: This repository contains all the code for the Arduino microcontroller, ready to be uploaded to an Arduino.
  2. moody-images: This repository includes all the images of the facial expressions.
  3. moody-mapper: This repository is a web-based tool for managing all the facial expressions and their order. Using it you can generate files to be used by the Arduino board.

If you want to get started with creating custom facial expressions and their configuration, I recommend cloning this repository including its submodules

git clone --recurse-submodules git@github.com:tsomic/moody.git

and read through the README file of the moody-mapper to get a better understanding of what to do next.

Contributing

Contributions are welcome! If you have ideas for new features, find any bugs, or would like to make improvements, please open an issue or submit a pull request to this repository or to any of the submodules.

License

The Moody project and all its submodules are licensed under the GNU GPLv3 license. See the LICENSE file for more information.