Note -> for additional info about Blushy Avatars such as the latest changes / features etc, check out the blog category:

About Blushy avatars

Finding interesting ways to interact with viewers is something that can make streaming fun, so while I was wondering what project I would do next I came across Stream Avatars and wanted to make my own version with feedback and suggestions for features from the community and here we are.

In short Blushy avatars is free Stream Avatars clone that can be included as a browser source in OBS / SLOBS / Xsplit or any other live streaming software that supports browser functionality. Every viewer in a channel on Twitch is represented by an avatar and can perform actions that are defined in the avatar data file such as run, walk, idle etc, you can add as many custom actions as you want and when someone in the channel chats it will show the chat message and comes with optional text to speech that reads said chat.


  • each viewer / user in chat is represented as an (random) avatar
  • each avatar has one or more actions that are defined in its data file (its basically a plain text file containing avatar actions and properties)
  • adding avatars is as easy as creating a sprite sheet and corresponding text file
  • control your avatar using a command such as left, right, sit etc or any action that is defined in the avatar data file
  • users that are chatting will be shown as if the avatar is talking with text to speech (support for various voices but not included)
  • support for broadcaster / moderator actions such as removing / banning avatars or add random named avatars that do its own thing
  • support for unique avatars meaning that an avatar can 0nly be used by that user and no one else can (for example sub / vip avatars that can only be used by that sub / vip or specific name)
  • .. and more being worked on! Got feedback / suggestions? Let me know in our discord :)!

WIP / to do

  • customization options such as background / avatar settings
  • to do -> add a web interface to do configuration
  • to do -> channel currency for users to buy items such as accessories, effects and / or avatars to change between them!
  • to do -> configuration options such as giving users roles and currency gain vs (users with no role, VIP etc), item / avatar costs etc
  • to do -> support for Twitch emotes [done!]
  • random avatars that pop up and say something or perform an action(s) etc (configurable)
  • support for 3rd party API such as Streamlabs for donations (fire up an avatar action when someone donates etc)
  • support for mini games like moving to another avatar, throw a snowball, start a mini fight and watch other avatars cheer you on (or not) etc..
    -> for mini game ideas suggestions would be more than welcome!
  • .. and everything else that comes up during the development! Got feedback / suggestions? Let me know in our discord :)!

Random thoughts

  • with the idea of adding mini games would it be an idea to add additional avatar properties such as a health indicator so that avatars can do a game over animation etc?
  • Blushy Avatars supports multi channel so would it be an idea to add cross channel avatar meaning that the avatar looks the same in every channel where Blushy Avatars is used?
    -> this feature doesn’t really matter for broadcasters but for the viewer it might be cool to see their avatar do its thing and look the same (until the user changes it)

Things to know

  • channels with a large number of viewers (~400+) may show some lag. This is dependent on the PC it’s run on but any recent and decent should run without any issues.
  • the client can be fully customized (colors, avatar actions such as movement etc) and dev notes are added here and there to give an idea how things can be done
  • the user that chatted most recent will be shown first for visibility by default
  • there is no restriction for joining multiple channels to read other channels chat and show their avatar but keep in mind to ask for permission first
  • text to speech voices can be changed or fully turned off
  • to connect to your channel you need to setup Blushy Avatars by going to /setup/config.txt
  • no read me file is provided as it should be pretty straightforward but if you have questions feel free to join our discord for further help by our community
  • to add an avatar all there is to do is to draw a sprite sheet (or ask someone), create a text file with avatar actions and add it to the /Assets/avatar folder, that’s it!
    -> to add an action you can use the blushyface avatar file as template as that contains the latest info that is used to create actions

These and many more features are being worked on and if you want to follow the progress you can join our community discord to check out the relevant channel(s), say hi to the community and get up to date with the latest community news.

Download Blushy Avatars

Blushy Avatars can be download here for free as soon as I have implemented the minimum features in the to do / features list, until then there are Insider builds available (basically early WIP builds) for those that are supporting my creative content that you can can download in the general Insiders chat channel or ask me for the latest build there. Click here to download the Insider builds in our Discord server.

Not an Insider yet? Read about how to become an Insider to support my creative content here!

Insiders build notes and things to know

  • Insider builds can be treated as early previews, “as is” and updates are based on feedback / suggestions
  • includes at least the following avatars: blushyface, jellybean (and variations), pillow, rippy the tire and the snail all with their basic actions
  • front end can be edited how ever you want if you are into that, there are notes here and there in the html file to show how things can be done
  • runs on port 8090 by default (I have not made it configurable yet but if there is a need I’ll add it)
  • you need a valid Twitch OAuth token with at least the following scope: “chat_login” that can be generated here
  • if you want to use text to speech chat you need to provide your own TTS or use the default OS TTS (if supported)
  • requires around ~5mb disk space (depending on how many avatars you have / add) and at least .net framework version 4.7.x

Work in Progress / screenshots




Share this: