Did you know Bot Libre also provides free hosted forums for your own website or mobile app?
Docs : User Manual : Avatars



The avatar tab lets you choose your bot's avatar. An avatar is the physical representation of your bot, and can include images, video, audio, and animation. You can choose an avatar from our open avatar directory, or create your own.


You can create your own avatar from the browse avatars page. To create an avatar, just give it a name, description, and category to categorize it under. You can either make the avatar private and choose who can access it, or make it public and accessible by anyone. You can also choose what license you wish to release its content under.


Properties Description
Avatar Name Enter an Avatar name.
Description Optional description.
Details You can enter optional additional information.
Disclaimer You can enter optional legal information.
License Optional license to release the avatar and all of its content under.
Website If this avatar has its own website, you can enter it here.
Categories Comma separated list of categories to categorize the avatar under.
Tags Optional comma separated list of tags to tag the avatar under.
Private A private avatar is not visible to the public, only to the user and users grant access.
Hidden A hidden avatar is not displayed in the browse directory.
Access Mode Define who can access this avatar.
Fork Access Mode Define who can fork(copy) this avatar.
Content Rating Rate the avatar.
Ad Code You can display ads on your avatar's pages.

Avatar Editor

The avatar editor allows you to upload or import images, video, and audio files for your avatar, and tag them with emotions, actions, and poses. You can add as many images, videos, or audio as you want, and they will be randomly selected if not tagged. If tagged, they will only be used when the bot expresses the tagged emotion, action, or pose. You should have at least a 'talking' pose tagged, this will be displayed when the bot is talking.

To edit the avatar, click on the Editor button. The avatar editor lets you import video, audio, and image files. You can associate each media with an emotion, action, or pose. For example if you have a video that makes the avatar talk, you would associate the pose for the video to talking. The emotions let the avatar express different emotions, and will let the bot using the avatar express itself. There are a fixed set of emotions, but you can create any actions and poses that you wish. You can have multiple media for a emotions, action, or pose, and one will be chosen at random. For actions, and poses, you can have an audio element in addition to a video element. Audio can be used to make your avatar perform actions such as laugh, or used as background music or noise for a pose.

Toolbar Menu Section

Icon Property Name Description
Save Save the current changes.
Select Select all media.
Delete Delete the selected media.
Upload Upload images, video, or sound files for the avatar.

Toolbar Background Section

Icon Property Name Description
Upload Upload a background image to overlay video on (this can reduce the video flicker).
Clear Clear the background image.

Media Section

Property Name Description
Emotions Comma separated list of emotions to trigger the media.
Actions Comma separated list of actions to trigger the media.
Poses Comma separated list of poses to trigger the media.

Embed Avatar

The avatar embed page allows you test the avatar and generate embedding code to add the avatar to your own website.


Properties Description
Speech The text for the avatar to speak.
Guest User Guest user to connect as, you need to add this user to your avatar's users (do not use your own user id).
Password Password for guest user (not secure).
Token Token for guest user (this will expire, use a guest user/password instead).
Server Voice More than 30 server voices.
Voice Modifier Several voice modifier.
Native Voice The name of the native voice. A native browser voice can be used on Chrome or browses that support the HTML Speech API.
Responsive Voice Use the third party voice API from ResponsiveVoice.
Language The language code for the native voice.
Width The width (in pixels) of the avatar box.
Height The height (in pixels) of the avatar box.
Background Color The background color to use.
Emotion Emotion for avatar to express.
Action Action for avatar to perform.
Pose Pose for avatar to hold.

See Also