User Interface overview - Zariep-Software/WiPersona GitHub Wiki

Each time you launch WiPersona, you are presented with a main menu consisting of three sections:

• Avatar Settings
• Draggable Images
• About

Menu Behavior

• Click anywhere on the page to open the menu.
• Click outside the menu to hide it.
• You can toggle the menu using the Esc key.
• The menu is scrollable on smaller screens.

---

UI Options & Controls

Value	Category	Type	Details
Avatar workspace	Avatar	Button	Select/manage avatar workspace configurations
Avatar (Mute)	Avatar	File	Select image to replace muted avatar
Avatar (Talking)	Avatar	File	Select image to replace speaking avatar
Avatar (Screaming)	Avatar	File	Select image to replace screaming avatar
Avatar at center	Avatar	Checkbox	Toggle centered avatar
X Position	Avatar	Number	Select avatar X Position if not centered
Y Position	Avatar	Number	Select avatar Y Position if not centered
Avatar Size (px)	Avatar	Number	Select avatar size
In-talk effect	Avatar	Select	Select/disable avatar in-talk animation (None, Bounce, Gelatine, Pulse, Shake, Swing, Swing from top)
Brightness effect	Avatar	Select	Select/disable avatar brightness behavior (None, Bright when speaking, Dim if muted)
Effect on Talk to Scream	Avatar	Checkbox	Toggle on scream animation
Background Color	Background	Color	Change background color
Image background	Background	Checkbox	Toggle image background
Select background	Background	File	Select background image if background is enabled
Request mic access	Voice	Button	Request Microphone access to web browser
Voice Status	Voice	Text	Show voice internal status to determine avatar image to use
Microphone List	Voice	Select	Select microphone device
Toggle Microphone	Voice	Button	Pause/Resume microphone
Speech Threshold	Voice	Range	Select minimum threshold to show speaking avatar
Scream Threshold	Voice	Range	Select minimum threshold to show screaming avatar
Enable extra images	Draggable	Checkbox	Enable draggable images feature
Choose file	Draggable	File	Import local images for draggable elements
Remote image URL	Draggable	URL	Add remote image by URL
Add remote image	Draggable	Button	Add the remote image to draggable elements
Clear All Images	Draggable	Button	Remove all draggable images
Export Positions	Draggable	Button	Export current positions of draggable images
Import Positions	Draggable	Button	Import previously saved positions
Create Workspace	Workspaces	Button	Create new avatar workspace
New workspace name	Workspaces	Text	Name for new workspace
Save config	Settings	Button	Save config using browser cookies
Restore defaults	Settings	Button	Restore config to default values and reload page
Show link to config	Settings	Button	Show a shareable config link
WiPersona	Info	Text	Title, informational
Credits	Info	Link	Go to credits page
Source code	Info	Link	Link to WiPersona source code
Online manual	Info	Link	Link to online documentation

---

Sections Breakdown

Avatar Settings

Customize your avatar’s behavior and visuals:

• Upload different expressions (mute, talk, scream).
• Center the avatar or place it manually.
• Add special effects when talking or screaming.
• Adjust size and brightness behavior.

Background Settings

• Change the background color.
• Upload a custom background image.
• Toggle background visibility.

Voice Settings

• Request microphone access to activate voice-based avatar states.
• Choose input device.
• Set speech/scream sensitivity thresholds.
• View real-time voice levels with animated bars.

Draggable Images

• Enable extra images that can be dragged around the screen.
• Import local images or add remote image URLs.