rotejin/tomari-guruguru

This is a browser-based animated character avatar built for streaming, specifically designed around a character named Tomari. It runs in a web browser and is intended to be used as an overlay in streaming software such as OBS. The README is written in Japanese. The avatar has two modes. In the first mode, called Guruguru, the character's face turns to follow the mouse cursor across 25 directions (a 5x5 grid of horizontal and vertical angles). In the second mode, called Talk, the character lip-syncs in real time to microphone input or an audio file, with the mouth switching between closed, half-open, and fully open states depending on the volume level. When the character is speaking, the eyes also shift to closed-blinking images. The character images are organized as sprite sheets: six full sheets, each containing a 5x5 grid of poses for one of the six facial states. The app swaps between individual frames depending on where the mouse is pointing and what volume level the audio input is at. A Tweaks panel in the corner of the screen lets you adjust microphone sensitivity, how fast the mouth closes after silence, how closely the character follows the mouse, and the background color. Setting the background to a chroma-key green makes it easy to cut out in OBS. The project is hosted on GitHub Pages. To use a custom character instead of the default Tomari, you need to create six new sprite sheets (one per facial state), run a slicing script included in the repository to cut them into individual frames, and update a configuration file. Instructions for that process are included in the docs folder. The code is MIT licensed, the character art has a separate license that limits commercial use.