Peraravatar+
Make a PNGTuber in your browser and export it for OBS
A tool built on the open-source Peraravatar with more features. Make your avatar in the browser, export it as a single HTML and use it in an OBS browser source. There are two ways to build: "Prepare each image" and "Build from one image". With "Build from one image", eye and mouth parts are layered on one base image to create blinking and lip sync. For lip sync, choose "By vowel", which changes the mouth shape with the vowels (a, i, u, e, o), or "By volume", which opens the mouth wider the louder you are. Decorations, custom expressions, and switching expressions with an OBS hotkey script or a dock (controller) are supported too.
* Peraravatar+ is built on the open-source Peraravatar with more features. Unlike the original, it downloads the finished avatar as a single HTML, so even if you are not confident with PCs, adding it to OBS is easy.
Unless you have a specific reason, we recommend Peraravatar+.
Getting started
Allow mic → choose how to build → choose how lip sync works → upload images → register vowels (if lip sync uses vowels) → adjust the motion → export as HTML → add to OBS
If you don’t have artwork of your own, you can open a free avatar from Free Avatars in Peraravatar+ and use it as is, or adjust it to your voice and taste.
Mic
- Allow mic: starts using the mic. Pick the mic to use in the dropdown next to it (default:
Default mic) - The exported HTML looks for the mic chosen here by name (if not found, it uses the computer’s default mic)
- Volume: the current volume. The marks are the thresholds
- Auto calibrate: measures silence and your speaking voice and sets the thresholds automatically
- Volume test: moves the volume by hand without the mic to check the lip sync (only with “By volume”)
- Register vowels: say a, i, u, e, o one at a time so it learns the vowels of your voice (register it if lip sync uses vowels)
- On the right, the mouth shown at the current volume (such as
Mouth: closed) and the current vowel (such asVowel: A) appear
Auto calibrate
- Measuring room noise: stay quiet and wait
- Measuring your voice: while the bar fills, keep talking in your usual streaming voice
- Results: the blue marks on the meter are the new values. If they look right, press “Apply”
It changes the lip sync stages, the loud reaction and each expression’s trigger volume together. Once done, the button becomes “Recalibrate”.
Register vowels
Say “ah”, “ee”, “oo”, “eh”, “oh” one at a time and hold each. “Registration results” shows how often your voice was recognized correctly; if it looks right, press “Apply”. Once done, the button becomes “Re-register vowels”.
Basics tab
Choose how to build
What differs is how blinking, lip sync and expressions are made.
| Method | Images to prepare |
|---|---|
| Prepare each image | Normal, blink, lip sync… one image each |
| Build from one image | One base image + eye and mouth parts |
With “Build from one image”, custom expressions can also be made by combining eye and mouth parts (a single image per expression works too). Decorations are available only with “Build from one image”.
How lip sync works
| Choice | Description |
|---|---|
| By vowel | Changes the mouth shape with the vowels (a, i, u, e, o). Whether the mouth opens is decided by volume. Before using it, register your voice with “Register vowels” under the meter (until then, the mouth moves with the “A” shape) |
| By volume | Opens the mouth wider the louder you are. Prepare a mouth image for each stage; each stage’s value (the lowest volume that shows that mouth) decides which one appears. “Auto calibrate” sets the stage values together |
“Lip sync” on the Basics tab has these values with either method.
| Item | Description |
|---|---|
| Silence threshold | Volume below this value counts as silence and closes the mouth |
| Mouth interval (s) | After the mouth shape changes, it doesn’t change again for this long |
| Volume following (%) | Shown only with “By volume”. At 100 the stage follows the volume; at 0 a random stage shows while you talk |
With “By volume”, the value of stage 1 also serves as the “Silence threshold”. Below it, the mouth closes.
Prepare each image
Images to prepare
Recommended image specs:
- Size: 600 × 900 to 1080 × 1620px (portrait, 2:3)
- Format: PNG or WebP with a transparent background (JPEG and BMP can’t be transparent)
- PNG / JPEG / BMP are optimized automatically when imported
- “Position & size” adjusts the position and size of each image
The “Look away (left)” and “Look away (right)” images go in Look away on the Expressions tab.
Drop images all at once
If a file name contains one of these words (separated by underscores or hyphens), it goes into that slot automatically (not case-sensitive; if several match, rows higher in the table take priority).
| Slot | Words in the file name |
|---|---|
| Mouth “A” to “O” (by vowel) | mouth_a / mouth_i / mouth_u / mouth_e / mouth_o |
| Mouth stages 1–9 (by volume) | mouth1–mouth9 (mouth_1 and mouth-1 also work) |
| Mouth stage 1 (by volume) | mouth_o / mouth_u |
| Mouth stage 2 (by volume) | mouth_i / mouth_e |
| Mouth stage 3 (by volume) | mouth_a |
| Mouth, largest stage (by volume) | open (image with the mouth open) |
| Mouth “A” (by vowel) | open (image with the mouth open) |
| Sleeping | sleep / sleeping / asleep / 寝 / 眠 |
| Blink (eyes closed) | blink / close / eye_closed / 瞬き / まばたき / 目閉 / 閉眼 |
| Look away (left) | left / 左 |
| Look away (right) | right / 右 |
| Normal | normal / default / base / idle / closed (image with the mouth closed) / 通常 |
| Custom expression | Anything that matches none of the above (the file name becomes the expression name) |
Buttons for each image
| Button | Action |
|---|---|
| Position & size | Adjust the image position |
| Clear | Return the image to unset |
| Preview | Stop the motion and show only that image |
Stop motion to check: press one of the buttons in the row (Normal, Blink (eyes closed), mouths, etc.) to stop the motion and show only that image. Press the selected button again, or “Exit preview” above the avatar, to release it. While stopped, use “Fit”, “Face”, ”−” and ”+” above the avatar or the wheel to zoom, and drag an empty area to pan the view.
Lip sync
- By vowel: the five mouths “A” to “O”
- By volume: Mouth stage 1 and up. Each stage’s value (
Volume ≥) is the lowest volume that shows that mouth (kept in ascending order). Put several images in one stage and one of them is picked. Add more with ”+ Add stage”
Build from one image
Base image
Eye and mouth parts are layered on this one image to create blinking and lip sync. It doesn’t work with a full-body image where the face is small (as a guide, the eyes should be at least 40px wide).
Drop base, look-away and expression images all at once
Layered parts (eyes, brows, mouth) can’t be added here. Put them in “Layered parts” below. A name with left / right / 左 / 右 becomes a look-away image (e.g. normal_left is Look away (left)).
| Slot | Words in the file name |
|---|---|
| Base image | normal / default / base / idle / closed (image with the mouth closed) / 通常 |
| Look away (left) | left / 左 |
| Look away (right) | right / 右 |
| Custom expression | Anything that matches none of the above (the file name becomes the expression name) |
Images named like mouth or close aren’t used with this method; they are kept as images for “Prepare each image”. Switch the method to “Prepare each image” and they are used as they are.
Base image type
| Type | Description |
|---|---|
| Blank face | Use an image with no eyes or mouth drawn. Even if the eyes and mouth are drawn, choose this when the layered part images cover the original eyes and mouth |
| Eyes and mouth drawn in (*not recommended) | The drawn eyes and mouth are covered with the skin color, then the parts are layered on top. * Depending on the base image, they may not be hidden cleanly |
Eye and mouth positions
Check “Move brows separately” and the heading becomes “Eye, brow and mouth positions”, with Left brow and Right brow added.
For a character with no mouth, it works fine without setting the mouth position, and likewise for a character with no eyes without setting the eye positions.

- Press “Set” and a frame appears over the avatar
- Drag from edge to edge where you want the part. The part is placed at the center of the frame and sized to its width
- While the frame is shown, the round handles adjust the size, tilt and height (Esc cancels the pick). Use the wheel to zoom and drag an empty area to pan the view
- When you’re done, press “Done” above the avatar or on that part’s button to close the editor
- Even while setting a part, pressing an existing frame lets you move that frame. Dragging an empty area draws a new one
Shift/Ctrl+ click selects multiple frames (Ctrl+Aselects all). Drag any selected frame or press↑↓←→(10px withShift) to move them together- “Left eye” and “Right eye” mean left and right as you see the screen, not from the character’s point of view
- “Fit”, “Face”, ”−” and ”+” above the editor change the zoom (“Face” zooms to the face)
Move brows separately
- Layer brow images on a blank-face base to move them separately from the eyes in expressions and blinks
- Leave it unchecked if your eye images include the brows, or if brows are drawn on the base
Left eye, Right eye, Mouth (plus Left brow and Right brow when moving brows separately)
- “Position & size” lets you fix
X (px)/Y (px)/Width (px)/Height (px)/Tilt (°)as numbers - “Delete” removes that position
- Make symmetric: makes the left and right eyes (and brows when moving them separately) symmetric. Size and height become the average of both sides, tilt is mirrored, and the left-right positions stay
- Move all: moves the eye, brow, mouth and chest frames, the skin color point and the decorations together. Use it when the picture shifts because you extended or cropped the base image. The eye, brow and mouth parts and the decorations are shown on the base image, so you can line them up by eye. Drag to move, drag a corner to resize, or adjust with
X (px)/Y (px)/Size (×) - Delete all positions: removes all positions (part images, look-away settings and chest bounce frames stay)
Skin color for hiding the eyes and mouth
Shown when the base image type is “Eyes and mouth drawn in (*not recommended)”.
- The original eyes and mouth are filled with this color, then the part images are layered on top
- Choose skin that isn’t covered by hair or brows (press “Set” for “Skin color” and click on the image)
- Outside the frame, only areas close to this color are painted (brows and hair aren’t erased)
- Edge feather (px) blurs the painted edge
Layered parts
Images for layered parts
- Format: transparent PNG / WebP
- Size: just large enough to hold the eye or mouth cut out from the base image (about 200 × 200px for a 1024 × 1536px base image). Keep the part roughly centered
- Your own images are shown at their original size (presets are scaled to the frame width)
- Placed automatically to fit the frame. Left-right, up-down, size and tilt can be adjusted per image with “Position & size”
- For eyes and brows, a screen asks whether the image is the left or right one when you add it. Unless the eyes are asymmetric (odd eyes, one eye closed, etc.), one eye is enough
Eyes
| Item | Description |
|---|---|
| Set the eyes separately (odd eyes, one eye closed, etc.) | When checked, the eyes split into “The eye on your left” and “The eye on your right”. When unchecked, one eye’s image is used for both |
| Open eyes | If no image is set, the base image is used as is |
| Half-open | Added with ”+ Add eye image” |
| Closed eyes | The image when the eyes close in a blink |
| Sleepy eyes | Used in sleepy mode |
Brows
| Item | Description |
|---|---|
| Brows | Shown only with “Move brows separately” |
| Blink brow drop (%) | Shown only with “Move brows separately” |
Mouth
| Item | Description |
|---|---|
| Closed mouth | The image while the mouth is closed. If no image is set, the base image is used as is |
| Sleepy mouth | The mouth image for sleepy mode |
| Mouth “A” to “O” | A mouth image for each vowel (a, i, u, e, o) |
| Item | Description |
|---|---|
| Closed mouth | The image while the mouth is closed. If no image is set, the base image is used as is |
| Sleepy mouth | The mouth image for sleepy mode |
| Mouth stage 1 and up | A mouth image for each volume level. Added with ”+ Add mouth image” |
Buttons for each part
| Button | Action |
|---|---|
| Presets | Pick from the default presets. For half-open, “Squash the open eyes” squashes the open eyes into half-open ones. Sleepy eyes use the same presets as the closed eyes, and the sleepy mouth the same presets as the closed mouth |
| Position & size | X (px) / Y (px) / Size (×) / Tilt (°) |
| Color | Eye and brow images only. Choose from As is / Same as normal eyes (Same as normal brows for brows) / Set color separately. With Set color separately, set it with Color code or Hue (°) / Saturation (%) / Brightness (%). When you enter a color code, the hue, saturation and brightness are set so that the image’s color becomes that color. The open eyes and the layered-parts brows don’t have Same as normal eyes (Same as normal brows) |
| Clear | Return the image to unset |
| Preview | Stop the motion and show only that image |
Color
Same as normal eyesuses the color of the open eyes. With “Set the eyes separately”, it uses the open eye on the same side- By default, preset images are
Same as normal eyesand your own images areAs is(the open eyes and the layered-parts brows areAs is). Set a color on the open eyes and the preset closed eyes follow it - For odd eyes, turn on “Set the eyes separately” and set a color on each open eye
- Eyes and brows added in custom expressions and look-away also have “Color”
Stop motion to check: press one of the buttons in the row (Normal, Closed eyes, Closed mouth, mouths, etc.) to stop the motion and show only that image. Press the selected button again, or “Exit preview” above the avatar, to release it. While stopped, use “Fit”, “Face”, ”−” and ”+” above the avatar or the wheel to zoom, and drag an empty area to pan the view.
Delete all layered parts: removes all layered part images (eye and mouth positions stay).
Lip sync
| Item | Description |
|---|---|
Mouth stage 1 and up (Volume ≥) | Shown only with “By volume”. Sets the volume at which each mouth image above appears |
Expressions tab
Custom expressions
Assign any expression you like, such as smiling, crying or angry. Add one with ”+ Add expression”.
- Press the key button, then press the key you want (Shift combinations are OK. Backspace for no key, Esc to cancel)
- Keys assigned here work in the editor and the controller (dock). They’re separate from OBS hotkeys (Switch even during games)
Keys you can use
- A single key, or a key combined with Shift (such as
Shift+Z) - Keys combined with Ctrl or Alt can’t be used, because they overlap with editor actions such as
Ctrl+Zand with browser actions - H (show / hide the menu) and Y (look away) can’t be assigned as single keys (
Shift+HandShift+Ycan) - An expression added with ”+ Add expression” gets a free key in this order: Z / X / C / V / B / N / M → 1–0 → A / S / D / F / G. When all of these are used, the same keys combined with Shift are used in the same order
By default, Surprised (Z, Recoil (pull back)) / Happy (X, Bounce (light hops)) / Crying (C, Shake (small tremble)) are included.
Card items
| Item | Options |
|---|---|
| Action (right of the key button) | None / Hop (jump up) / Recoil (pull back) / Shake (small tremble) / Bounce (light hops) / Wobble (sway side to side) / Nod (up and down) / Head shake (side to side) |
| Hold mode | Only while held / Until pressed again / For a set time (Show for (s)) |
| Trigger by volume | Don’t trigger / Once when it crosses (1 s) / While above the threshold |
| Trigger volume | Triggers when the volume goes above this value |
| Voice pattern | ”🎤 Add recording” records a voice pattern. You can record several; any match triggers it |
| Match strictness | Shown only after recording a voice pattern. The higher the value, the closer the match must be to trigger |
“Preview” and “Delete” are at the top right of the card. Fine-tune each action in Expression switching and actions below.
Method
With “Build from one image”, “Method” chooses between combining parts and using a single image. With “Prepare each image”, it’s a single image only.
| Item | Options |
|---|---|
| Eyes | As is / Reshape eyes / Add eyes. “Reshape eyes” isn’t shown when the base image state is “Blank face” and no open-eye image is set |
| Set left and right separately (Add eyes) | When checked, the eyes split into “Left eye” and “Right eye”. If you fill only one, the other stays open (for a wink, etc.) |
| Style (Reshape eyes) | Wide open (surprised) / Narrow (sleepy), Amount |
| Brows (Move brows separately) | As is / Reshape brows / Add brows |
| Style (Reshape brows) | Raise / Lower / Worried brows / Angry brows, Amount |
| Mouth | As is / Add mouth |
The added eye, brow and mouth images have “Layered parts” (eyes and mouths only), “Presets”, “Position & size”, “Color” (eyes and brows only) and “Clear”.
| Item | Description |
|---|---|
| Image | Click or drop the expression image into the box on the left of the card |
| Chest bounce | Bounce / No bounce / Left only / Right only (only when the Chest bounce frames are set) |
| Chest position | ”Set” redraws the chest frames on this image. “Reset” goes back to the base image’s frames |
- Once an image is in, “Position & size” and “Clear” appear at the top right of the card
- While a single-image expression is shown, lip sync and blinking stop
- Switching to or back from a single-image expression is instant, with no fade
Look away
How often it looks away automatically is set under “Look away” on the Motion tab.
Prepare each image
Add the “Look away (left)” and “Look away (right)” images. The buttons for each image are the same as for the images in Prepare each image.
Build from one image
Set it up if you need it. Check “Look away (left)” and “Look away (right)” to use them. “Preview” is at the top right of the card.
“Method” chooses between combining parts and using a single image.
| Item | Options |
|---|---|
| Eyes | As is / Add eyes |
| Left eye / Right eye (Add eyes) | Add the left and right eyes (as you see them) separately so the pupils point the same way |
| Mouth | As is / Add mouth |
The added eye and mouth images have “Presets”, “Position & size” and “Clear”. Eyes also have “Color”.
| Item | Description |
|---|---|
| Image | Click or drop the look-away image into the box on the left of the card |
| Chest bounce | Bounce / No bounce / Left only / Right only (only when the Chest bounce frames are set) |
| Chest position | ”Set” redraws the chest frames on this image. “Reset” goes back to the base image’s frames |
Once an image is in, “Position & size” and “Clear” appear at the top right of the card.
Expression switching and actions
When switching to an expression or look-away, the previous image fades out briefly (0 switches instantly). In “Build from one image”, custom expressions made from a single image switch instantly without a fade.
| Item | Description |
|---|---|
| Switch fade (s) | How long the fade takes |
| Hop / recoil | Height (px) / Duration (s) / Recoil depth (×) (Recoil depth only for Recoil) |
| Shake | Range (px) |
| Bounce | Range (px) / Period (s) |
| Wobble | Range (px) / Period (s) / Rotation (°) |
| Nod | Range (px) / Period (s) / Rotation (°) |
| Head shake | Range (px) / Period (s) / Rotation (°) |
From Hop / recoil to Head shake, these fine-tune the actions chosen on each custom expression card. Only the actions chosen on at least one custom expression are shown.
Decorations tab
Decorations
Available with “Build from one image” (the Decorations tab appears only with “Build from one image”).
- Layer images such as glasses, cat ears or hair clips anywhere you like (format: transparent PNG / WebP)
- Aim for up to 16. More than that may make the motion heavy (over 16, a warning appears under the list)
- An image the same size as the base image is placed exactly where it was drawn
- Prepare the “Swap image” at the same size as that decoration’s image
- Items lower in the list are drawn in front (“Up” / “Down” to reorder)
Placement

Add one with ”+ Add decoration” or press “Place” to move it directly on the avatar.
| Control | Action |
|---|---|
| Click | Select a part |
Shift / Ctrl + click | Select multiple parts. Drag any selected part to move them together |
Ctrl + A | Select all parts |
| Drag | Move. Near the face center line, the eye height or another part’s center, a pink guide line appears and it lines up with it |
| Drag a corner square | Size (keeps the aspect ratio) |
| Drag the bottom circle | Tilt |
| Drag the red cross | Center of motion (the axis for swinging and spinning) |
Shift + drag | Move only vertically or horizontally / tilt in 15° steps |
Alt + drag | Move ignoring guides |
↑ ↓ ← → | Move 1px |
Shift + ↑ ↓ ← → | Move 10px |
Delete | Delete the selected parts |
Esc | Done |
When you’re done, press “Done” above the avatar or on that part’s button to close the editor.
Card items
| Item | Description |
|---|---|
| Layer | Behind the base / In front of face parts |
| Show | Always / While a chosen custom expression shows / While a switch is ON / While a switch is OFF. With “While a chosen custom expression shows”, it appears only during the checked custom expressions (e.g. show 💢 only with an angry expression). With “While a switch is ON” or “While a switch is OFF”, it follows the decoration switch chosen in “Switch” |
| Hide while a single-image expression is shown | When checked, it isn’t shown while a single-image custom expression is shown. Use it for bangs and the like layered to fit the blank base. Not shown when “Show” is “While a chosen custom expression shows” |
| Mirror to the other side | Places a copy at the mirrored position, using the middle of the two eyes as the axis. With only one eye area, the middle of that area is the axis; with no eye area, the middle of the image width is |
| Position & size | X (px) / Y (px) / Size (×) / Tilt (°) |
| Motion | Motion table |
| Follow body motion (physics) | Swing sensitivity. Not shown when the motion is “Flow” |
| Squish (bounces with body motion) | Bounciness / Softness / Squash (%) |
| Swap image | ”Place”, “Position & size”, “Clear”, “Preview” |
| Swap timing | Off / Now and then (Avg. interval (s), Random intervals, Show for (s)) / While talking / While a chosen custom expression shows (Custom expression) / While a switch is ON (Switch) |
Motion
| Motion | How it moves | Values |
|---|---|---|
| None | Doesn’t move | |
| Wobble | Sways left and right around the center of motion | Swing (°) / Period (s) / Random period |
| Wiggle (bends as it sways) | Bends more toward the tip, with the center of motion as the root (tails, etc.) | Swing (°) / Period (s) / Random period |
| Flow (tips sway, root stays put) | Bends more toward the tips, with the center of motion as the root. The tips follow the body’s motion a little late (hair, etc.). When chosen, the center of motion is placed at the top center | Constant swing (°) / Period (s) / Random period / Swing sensitivity |
| Twitch (now and then) | Twitches now and then | Swing (°) / Interval (s) / Random intervals |
| Sway with your voice | Sways more the louder your voice | Swing (°) / Period (s) / Random period |
| Wag (while talking) | Wags only while you talk | Swing (°) / Period (s) / Random period |
| Twitch (when a chosen custom expression starts) | Twitches when one of the checked custom expressions starts | Swing (°) / Custom expression |
| Twitch (on blink) | Twitches on each blink | Swing (°) |
| Float (bob up and down) | Slowly bobs up and down | Up-down range (px) / Period (s) / Random period |
| Bounce (light hops) | Hops up and comes back down, over and over | Up-down range (px) / Period (s) / Random period |
| Shake (small tremble) | Jitters slightly up, down and sideways | Range (px) |
| Pulse (size throbs) | Its size throbs around the center of motion | Size range (%) / Period (s) / Random period |
| Spin (keeps turning) | Keeps turning around the center of motion | Time per turn (s) / Reverse |
The options that depend on “a chosen custom expression” can’t be selected unless there is a custom expression with an image or parts. The options that depend on a switch can’t be selected unless there is a decoration switch.
“Delete all decorations” removes them all.
Decoration switches
- Switch decorations separately from expressions, like putting glasses on and off or changing outfits (up to 4)
- On each decoration, choose which switch to follow in “Show” or “Swap timing”
- Turn a switch ON and OFF with its key, or with OBS hotkeys and the dock buttons. All switches go back to OFF when reopened
Add one with ”+ Add switch”. Switching custom expressions doesn’t change whether a switch is ON or OFF.
Card items
| Item | Description |
|---|---|
| Name | Shown on the dock button, in the OBS hotkey items and in the “Switch” options of decorations |
| Key button | Press it, then press the key you want. The keys you can use are the same as for custom expressions. A new switch gets a free key in the order A / S / D / F |
| ON / OFF button | Press to turn ON and OFF (goes back to OFF when reopened) |
| Delete | Deletes the switch. Decorations that followed it go back to “Always” for “Show” and “Off” for “Swap timing” |
Motion tab
Motion for the whole avatar. Decoration motion is set on each part in the “Decorations” tab.
| Heading | Items |
|---|---|
| Idle motion | Natural / Calm / Floaty / Lively |
| Breathing / sway | Breathing height (px) / Breathing period (s) / Sway range (px) / Sway period (s) |
| Hop while quiet | Hop height (px) / Period (s) |
| Squish | Off / Each time you talk / The whole time you talk / With volume Squash (%) / Hop height (px) / Softness |
| Chest bounce | Shown only with “Build from one image”. See Chest bounce below |
| Outline fur sway | Shown only with “Build from one image”. See Outline fur sway below |
| Blink | Min interval (s) / Max interval (s) / Eyes closed for (s) |
| Head tilt while talking | Max angle (°) / Change interval (s) / Follow speed |
| Idle gaze drift | Sideways range (px) / Period (s) / After silence (s) |
| Loud reaction (quick zoom) | Trigger volume / Zoom strength (%) |
| Look away | Min interval (s) / Max interval (s) / Show for (s) / Head tilt angle (°) |
| Sleepy mode | Sleepy after (min) / Fully asleep after (min) / Breathing depth (×) |
- Idle motion: adjusts the related parameters automatically. Pressing one sets the values of Breathing / sway, Hop while quiet and Idle gaze drift together. Natural is the default. Moving any of those values leaves none of them selected
- Hop while quiet: while you’re quiet, the avatar keeps hopping in place, and it stops when you start talking. It doesn’t hop while a custom expression is shown or in sleepy mode. By default the hop height is 0, so it doesn’t hop
- Squish: the avatar squashes, stretches and bounces like mochi when you talk. It also wobbles when the body moves, such as with a custom expression’s action
- Loud reaction: when you shout, the avatar briefly zooms in. Its trigger volume is also used by Squish and the decoration motion that sways with your voice
- Look away: looks away now and then. A look-away made with “Combine parts” also happens while the mouth is moving. One made with “Single image”, or any look-away in “Prepare each image”, happens only while you’re quiet. It also looks away when you press the Y key (except while fully asleep or showing a custom expression)
- Sleepy mode: if silence continues, blinks get longer until the eyes stay closed. Setting “Sleepy after” to 0 turns it off. While a custom expression is shown, it doesn’t go into sleepy mode, and the count starts again after the expression ends. If you add “Sleepy eyes” and “Sleepy mouth” (“Sleeping” in Prepare each image), they’re used in sleepy mode
Chest bounce
Shown only with “Build from one image”. Bounces the chest of the base image with the body’s motion. The base image inside the frame is warped to bounce, so you don’t need a separate chest image.
- Press “Set” on “Left chest” and drag from edge to edge of the chest to draw a frame (same as the eye and mouth positions)
- The inside of the frame moves a lot while keeping its shape, and the area up to the dotted line around it stretches and squashes. Hair or clothes inside the dotted line are warped too
- When you’re done, press “Done” above the avatar or on that part’s button to close the editor
- Mirror left and right: checked at first. When you draw the left chest frame, a mirrored frame is added for the right chest automatically (the dashed frame). To give the right chest a different position or shape, uncheck it and set “Right chest”
- “Position & size” and “Delete” work the same as in Eye and mouth positions
- It also bounces with the body’s motion, such as “Squish”, “Breathing / sway” and custom expression actions
- Even big bounces are kept small enough that the image doesn’t break
- Decorations placed on the chest (ribbons, etc.) don’t bounce with the chest
- Single-image expressions and look away: “Chest bounce” on the card chooses whether the chest bounces and which side. Use it for expressions where an arm hides one side, for example. Press “Set” under “Chest position” to move the left and right chest frames on that image. They start at the base image’s frames, and left and right are set separately regardless of “Mirror left and right”. The bounce settings are the same as the base image’s
| Item | Description |
|---|---|
| Bounciness | How much it bounces with the body’s motion |
| Bounce period (s) | How long one bounce takes. Making it longer for bigger chests makes them bounce slowly and heavily |
| Rebound (%) | How far it swings back to the other side after the first bounce. At 0 it returns without swinging back |
| Upward bounce (%) | How far it moves up, as a share of how far it moves down. Smaller looks heavier |
| Firmness (%) | Higher keeps the chest’s shape as it moves; lower makes the chest itself stretch and squash |
| Left-right delay (s) | How far apart in time the left and right chests bounce. Which one goes first changes with each bounce. At 0 both bounce together |
Outline fur sway
Shown only with “Build from one image”. For characters covered in fluffy fur, such as kemono characters. Bends the fur outside the outline while keeping the roots in place. You don’t need a separate fur image.
- Check “Sway the outline fur”
- Adjust the sway angle, tuft width and period
- For places you don’t want to sway, such as ears and hands, press “Set” on “Keep-still area 1” and drag from edge to edge of that part to enclose it (same as the eye and mouth positions)
- The farther from the edge of the body, the more it moves, and the roots don’t move. It reads the direction of the fur strands from the image and sways them across the strands. Where the strands aren’t clear, it sways along the outline
- The timing and size of the sway change irregularly from place to place
- The outlines of decorations and custom expression images sway as well
- You can set up to 8 keep-still areas. Each time you set one, the next slot appears. “Position & size” and “Delete” work the same as in Eye and mouth positions
- The fur doesn’t sway until you set the eye or mouth area
| Item | Description |
|---|---|
| Sway angle (deg) | How much the fur tips bend |
| Tuft width (px) | Parts sticking out thinner than this sway as fur. Make it smaller if parts you don’t want to move, such as fingers, sway, and larger if the fur doesn’t sway |
| Period (s) | Roughly how long one sway takes |
Export tab
Export HTML
- Avatar name: if you use more than one avatar, give each a name. It goes into the exported file names, the OBS hotkey items and the top line of the controller (Peraravatar+ Controller (name)) (Using more than one avatar)
- Export avatar as HTML: exports the current state as a single HTML (
peraravatar-plus-avatar.html, orperaravatar-plus-name.htmlwhen the avatar has a name). Settings can’t be adjusted inside the exported HTML. For adding it to OBS, see Adding to OBS - Keep the background in the export: the exported HTML has a transparent background. Check this to export with the background chosen in “Display” in the header (for example, to export a solid color and key it out in OBS)
- If there is something to check before exporting (vowels not registered, sample images in use, expressions with no key, etc.), a confirmation appears. To ignore it, export with “Export anyway”
Switch expressions while streaming
Export OBS hotkey script: saves a script (peraravatar-plus-hotkeys.lua) that switches expressions with OBS hotkeys. For how to use it, see Switch expressions while streaming
To press an OBS hotkey from a tool such as Streamer.bot, specify a name from the list below the button (“Copy” copies it). For how to use it, see Switch from other tools
Transfer & backup
Save your settings to a file to move them to another device or in case your browser data is lost.
- Export JSON file: saves
peraravatar-plus-config.json. It includes everything, even what isn’t shown on screen, such as the images and settings of the method you aren’t using - Load JSON / HTML file: loads a saved JSON or an exported avatar HTML. Your current settings and images are replaced with the file’s contents. Loading from HTML restores only the images and settings of the method used when it was exported
URL parameters
Add these to the end of the URL of the exported HTML.
| Parameter | Description |
|---|---|
?custom=z | Always show the expression assigned to the Z key (Surprised by default) |
?custom=Happy | You can also use the expression name |
?controller | Switch with buttons |
Adding to OBS
-
Export the HTML: “Export avatar as HTML” on the “Export” tab
-
OBS launch flag: to use the mic, OBS needs the launch flag
--use-fake-ui-for-media-stream. Without this flag, the browser source can’t get mic permission.Right-click the OBS shortcut (desktop, etc.) → Properties → edit “Target” like this.
"C:\Program Files\obs-studio\bin\64bit\obs64.exe" --use-fake-ui-for-media-stream --autoplay-policy=no-user-gesture-requiredIf “Start in” is empty, set it to
C:\Program Files\obs-studio\bin\64bit.Start OBS by running this command in Terminal. You need to do this every time you start it.
open -a OBS --args --use-fake-ui-for-media-stream --autoplay-policy=no-user-gesture-requiredAllow OBS to use the mic in the OS settings (System Settings → Privacy & Security → Microphone).
If you save this command in a
.commandfile and make it executable withchmod +x file-name, you can start OBS by double-clicking it. You can also add the other apps you use for streaming to the same file.- Not tested
Start OBS by running this command in a terminal. You need to do this every time you start it.
obs --use-fake-ui-for-media-stream --autoplay-policy=no-user-gesture-requiredFor the Flatpak version, use this command.
flatpak run com.obsproject.Studio --use-fake-ui-for-media-stream --autoplay-policy=no-user-gesture-requiredIf you save this command in a shell script and make it executable with
chmod +x file-name, you can start OBS from that one file (whether double-clicking runs it depends on your file manager settings). You can also add the other apps you use for streaming to the same file.- Not tested
-
Add a “Browser” source: leave “Local file” unchecked and put the location of the exported HTML in the URL field (checking it disables the mic)
-
How to write the URL: write the location of the exported HTML like this.
Not as
C:\Users\…\peraravatar-plus-avatar.html, but withfile:///in front and\turned into/:file:///C:/Users/…/peraravatar-plus-avatar.htmlPut
file://in front of/Users/(user name)/…/peraravatar-plus-avatar.html:file:///Users/(user name)/…/peraravatar-plus-avatar.html- Not tested
Put
file://in front of/home/(user name)/…/peraravatar-plus-avatar.html:file:///home/(user name)/…/peraravatar-plus-avatar.html- Not tested
-
Size: set the OBS browser source to the same aspect ratio as the avatar to fit it with no margins (the “Export” tab shows the current image size). If decorations move beyond the base image, transparent margins are added to the sides and top to cover their range of motion

The mic chosen in the editor is looked up by name (if not found, the computer’s default mic is used).
Default mic and export again. When you plug in or swap a webcam or game controller, a device other than your usual mic can become the default mic. Switch expressions while streaming
An OBS browser source doesn’t receive keyboard input, so switch expressions in one of these ways.
Switch even during games
- Save
peraravatar-plus-hotkeys.luawith “Export OBS hotkey script” on the “Export” tab - Add it in OBS “Tools → Scripts” and an item for each expression appears in “Settings → Hotkeys”. The assigned keys work even when OBS isn’t focused
- By default,
Ctrl+Shift+1–8are expressions,Ctrl+Shift+9is look away andCtrl+Alt+1–4are the decoration switches (change them in “Settings → Hotkeys”)



After adding, removing or renaming custom expressions or switches, peraravatar-plus-hotkeys.lua needs updating too. Export it again, overwrite the old peraravatar-plus-hotkeys.lua and reload it in “Tools → Scripts” (assigned keys are kept).
Switch with buttons
In OBS “Docks → Custom Browser Docks”, add the browser source URL with ?controller at the end to get a panel of expression buttons (Peraravatar+ Controller).
file:///C:/Users/…/peraravatar-plus-avatar.html?controller 


The controller dock can be placed anywhere, just like any other dock.
- Press a button to switch to that expression; press it again to go back
- Each switch button turns ON and OFF with every press (the button shows the current state as ON / OFF)
- There is also a “Look away (Y)” button
- You can also click anywhere in the dock and press the keys shown on the buttons
- If
Connected to the avatardoesn’t appear at the top right, the setup isn’t working - Opening the controller URL in a regular browser such as Chrome doesn’t switch the avatar in OBS. Add it as an OBS dock and use it there
If you close the controller dock by mistake, it is listed at the bottom of the “Docks” menu, so open it from there.

Switch from other tools
Tools such as Streamer.bot can switch expressions by specifying the name of an OBS hotkey.
- Add the script to OBS by following Switch even during games
- In the list below “Export OBS hotkey script” on the Export tab, press “Copy” for the expression you want to switch to
- Specify the copied name in the tool’s settings
Setting the expression’s “Hold mode” to “For a set time” returns it to the original expression after that time.
Deleting and recreating an expression changes its name, so specify it again in the tool’s settings.
Using more than one avatar
To use more than one avatar in the same OBS, give each avatar a name and export it. Expression and switch changes reach only that avatar.
- In the editor, enter a name in “Avatar name” on the Export tab, then export with “Export avatar as HTML” and “Export OBS hotkey script”. The name goes into the file names (e.g.
peraravatar-plus-Sample.html,peraravatar-plus-Sample-hotkeys.lua) - Add a “Browser” source for each avatar (Adding to OBS)
- In “Tools → Scripts”, add a script for each avatar

- The avatar name goes into the item names in “Settings → Hotkeys”. A script added later doesn’t use keys that other hotkeys already use as its default keys. Assign keys to the empty items in “Settings → Hotkeys”

- Add a dock for each avatar too, with
?controllerat the end of each HTML’s URL (Switch with buttons). You name the dock yourself. The top line of the controller shows the avatar name (e.g. Peraravatar+ Controller (Sample))

Even with several avatars in the same scene, each one switches separately with its own dock and hotkeys.

- HTML and scripts exported with an earlier version can’t tell avatars apart. To use more than one avatar, export them again
- The same avatar placed in several scenes is treated as one avatar, and its switches stay in sync
Language / view settings
Everything below is switched from the header and persisted in localStorage:
- Language: 日本語 / English — the UI text. The exported avatar HTML, the controller and the OBS script use the language at the time of export
- Theme: Dark / Light / Fancy / Handcraft — the editor colors only (the avatar is unaffected)
- Display: under “Menu”, Text size (90% / 100% / 110% / 125% / 150%) / Menu position (Right / Left); under “Background (for checking transparency)”, Background type (Transparent (for OBS) / Checkerboard / Solid color) / Background color
Data storage
- Settings and images are saved in the browser automatically
- ↶ Undo / ↷ Redo:
Ctrl+Z/Ctrl+Y - Reset (initialize): returns all settings (including images) to the defaults of the current method. Registered vowels and the mic choice are kept. “Reset with no images” in the confirmation leaves every image unset and also removes the custom expressions and the eye, brow and mouth positions
- For backups, see Transfer & backup
Shortcuts
| Key | Action |
|---|---|
| Keys assigned to custom expressions | That expression |
| Keys assigned to switches | Turns that switch ON and OFF (with “Build from one image”) |
H | Show / hide the menu |
Y | Look away (except while fully asleep or showing a custom expression) |
Ctrl+Z / Ctrl+Y | Undo / Redo |
Esc | Cancel the pick, Done, or show the hidden menu and header |
For the keys you can assign to custom expressions and switches, see “Keys you can use” in Custom expressions. For shortcuts while placing decorations, see Decorations.
Q&A
Can I use it on a mobile device?
There is a mobile UI, but using it on mobile isn’t recommended. Please operate it on a PC.
Peraravatar+ is a PNGTuber tool, made on the assumption that it is ultimately operated on a PC to put the avatar in OBS. It can be operated on mobile devices too, but it hasn’t been tested on actual devices. Since some people seem to use it from mobile, actions that could only be done with a keyboard now show buttons and such on mobile devices.
With large images, it can get heavy on some devices, and the avatar may not move smoothly.
Can I use the avatar after a reset (initialize) as it is?
Yes, you can use it as it is.
…Wait, are you sure? You don’t mind having no personality, or looking like everyone else…? I’ve written articles for people like you, so don’t you feel like giving it a try…?
Editing artwork in FireAlpaca with just a mouse You can edit artwork with just a mouse. Removing the background, smoothing jagged lines, and erasing the eyes and mouth in FireAlpaca.
- For details, see Terms of use on the top page
Someone advised me, “Even if it looks like someone else’s, people who find it a hassle to make their own will use a free avatar.” So I made free avatars too.
Can two mics move two different avatars?
In theory, yes (I didn’t have two mics on hand, so I haven’t tried it). If you choose a different mic for each avatar and export, each one reacts to its own mic.
- The avatar uses the Windows mic directly. It doesn’t use the mic in OBS “Settings → Audio” or an “Audio Input Capture” source, so you don’t need to add a mic to OBS
- For each avatar, choose the mic in the dropdown next to “Allow mic” in the editor, then export (Using more than one avatar)
- The mics need to show up as separate recording devices in the Windows sound settings. Two mics plugged into one audio interface often show up as one mic, and then they can’t be split per avatar
- If the chosen mic isn’t found, the computer’s default mic is used
Can the avatar react to the person I’m calling?
In theory, yes, with a virtual audio cable (I had no one to experiment with, so I haven’t tried it). The avatar only reacts to mics (recording devices), while the other person’s voice is sound played on your speakers or headphones (playback devices).
A virtual audio cable such as VB-CABLE or VoiceMeeter turns played sound into a recording device. Point the call app’s output to this virtual device, choose the virtual device as the mic for the other person’s avatar and export, and it should react to their voice.
- It can’t tell several people apart. It works per app’s audio, so it’s one avatar per app
- Registered vowels match the voice of whoever registered them, so for the other person’s avatar, set how lip sync works to “By volume”, or set the editor’s mic to the virtual device and have them say the vowels over screen sharing to register them
- For how to use a virtual audio cable, see each app’s instructions
The outline fur doesn’t sway
The outline fur doesn’t sway while hardware acceleration is off.
- In the editor, turn on hardware acceleration in your browser. In Chrome, turn ON “Settings → System → Use graphics acceleration when available”
- In OBS, separately from the browser setting, check “Enable Browser Source Hardware Acceleration” under “Settings → Advanced → Sources”. Even if the fur sways in the browser, it won’t sway in OBS while the OBS setting is off
- The exported avatar runs with the OBS setting, so you can turn the browser setting back after exporting
Changelog
2026-11-09 v1.6.4
- Added a list of OBS hotkey names to the Export tab (for tools such as Streamer.bot)
- Renamed the custom expressions’ “Hold” to “Hold mode”
2026-11-03 v1.6.3
- Added “Outline fur sway” to the Motion tab. For characters covered in fluffy fur, such as kemono characters, it bends the fur outside the outline while keeping the roots in place. Enclose places you don’t want to sway, such as ears and hands, with a “Keep-still area” (Outline fur sway)
- With only one eye area (a single eye, or a mosaic over both eyes, etc.), the middle of that area is now the axis of symmetry. It’s used by the decorations’ “Mirror to the other side” and the chest bounce’s “Mirror left and right”
- Fixed images you set to the layered parts drifting 0.5px and blurring, so they didn’t line up exactly with the original picture, when the frame and the image differed in odd/even width (height)
- Fixed the eyes not blinking when the base image state was “Blank face” and no open-eye image was set. If no images are set for the open eyes and closed mouth, the eyes and mouth drawn in the base image are used as is
- Added “Reset with no images” to the Reset (initialize) confirmation. Use it when you want to set images one by one instead of starting from the default images
- The tilt of the eye, brow, mouth and chest areas can now be changed up to ±90° (previously ±45°)
- Fixed the avatar changing size and position on the edit screen when a decoration’s motion was changed
- Fixed decorations not being added at the image’s own size
- Fixed the “Not working yet” warning showing for characters with no eyes or no mouth
- Added color code input to “Set color separately” for eye and brow images in the layered parts and custom expressions
- Widened the minimum and maximum of the motion parameters (expression motions, breathing, sway, head tilt, idle gaze, look-away, decorations, etc.)
2026-10-22 v1.6.2
- Added “Flow (tips sway, root stays put)”, a decoration motion for hair. The root stays put while the tips bend more, and the tips follow the body’s motion a little late (Decorations)
- Added “Hide while a single-image expression is shown” to decorations. Bangs and the like layered to fit the blank base no longer show doubled over a single-image expression (Decorations)
- In a custom expression’s “Add mouth”, you can now choose from the layered parts’ mouths (Custom expressions)
- The half-open eye preset “Squash the open eyes” can now be chosen with a blank base too. It squashes the open eye image
- The chest bounce’s “Upward bounce (%)” can now go down to 0 (Chest bounce)
2026-10-21 v1.6.1
- On mobile devices, custom expressions and look away can now be switched with the buttons below the avatar. Press to switch, and press again to go back
- On mobile devices, when the menu is hidden, “Show menu” at the top right brings it back
- On mobile devices, added a “Select all” button to “Eye and mouth positions” in place of
Ctrl + A - On mobile devices, the key assignment buttons are no longer shown
- On mobile devices, a notice now says the tool is designed for OBS and keyboard use when you open it
- On narrow screens, language, theme and display settings in the header are now grouped in a ”⋯” menu
- Fixed the preview bar and the buttons on the eye part row going off the screen on narrow screens
- Made drawing the chest bounce and the decoration “Wiggle” motion lighter
2026-10-17 v1.6.0
- Split the editor tabs into “Basics”, “Expressions”, “Decorations”, “Motion” and “Export”. Custom expressions, look away and expression switching and actions are on the Expressions tab, decorations on the Decorations tab, and chest bounce on the Motion tab
- Added “Decoration switches” to switch decorations separately from expressions. Turn them ON and OFF with the assigned key, the dock buttons or OBS hotkeys (Decoration switches)
- Removed the limit on the number of decorations. Over 16, a warning says the motion may get heavy
- Added “Idle motion” and “Hop while quiet” to the Motion tab (Motion tab)
- You can now use more than one avatar in the same OBS. Give each a name in “Avatar name” on the Export tab and export it (Using more than one avatar)
- Custom expressions and switches can now use keys combined with Shift (Custom expressions)
- A look-away made with “Combine parts” now also happens automatically while the mouth is moving
- It no longer goes into sleepy mode while a custom expression is shown
- Removed “Clear expression” (the dock button and the OBS hotkey
Ctrl+Shift+0). Press the expression again to go back - The mic volume smoothing and the speed of “Head tilt while talking” now match between the editor and OBS
- Fixed an expression triggered by volume staying on after the mic stopped
- Fixed custom expressions added later not getting default keys in the OBS script
2026-10-15 v1.5.2
- Fixed the previous image overlapping at the wrong size while switching to or from a single-image look away
- When the base image size changes, the confirmation now reminds you to set again any chest frames set for each expression or look away
2026-10-15 v1.5.1
- Custom expressions and look away made from a single image can now choose the chest bounce:
Bounce/No bounce/Left only/Right only. Each one can also redraw its own chest frames (Chest bounce) - Switching to or back from a single-image custom expression is now instant, with no fade
2026-10-15 v1.5.0
- Your own images for layered parts and for custom expression and look-away parts are now shown at their original size, so eyes and mouths cut out from the base image are layered at the same size. Images you already added look the same as before (Layered parts)
- Removed the parts template (psd) download
2026-10-07 v1.4.1
- “Eye and mouth positions” and decoration placement now support selecting multiple items with
Shift/Ctrl+ click. Move the selected items together by dragging or with the arrow keys (Eye and mouth positions)
2026-10-07 v1.4.0
- Added “Move all” to “Eye and mouth positions”. It moves and resizes the eye, brow, mouth and chest frames, the skin color point and the decorations together. Use it after extending or cropping the base image (Eye and mouth positions)
- The prompt shown when the base image size changes can now start “Move all”
2026-10-06 v1.3.0
- Added “Sleepy eyes” and “Sleepy mouth” to the layered parts in Build from one image, and “Sleeping” to Prepare each image. They’re used in sleepy mode (Layered parts)
- Drop images all at once now assigns images named
sleepand similar to “Sleeping” - “Sleepy after” and “Fully asleep after” in the Motion tab are now in minutes with 0.5-minute steps, and both go up to 15 minutes. Setting “Sleepy after” to 0 turns sleepy mode off
2026-10-06 v1.2.0
- Added “Chest bounce” to Build from one image. Set a frame on the chest of the base image and it bounces with the body’s motion. You can change how it bounces, such as the period and firmness, to suit the chest size (Chest bounce)
- While setting or resetting the eye, brow and mouth positions, pressing an existing frame now lets you move that frame
2026-10-05 v1.1.1
- Eye and brow colors are now set per image. Choose
As is/Same as normal eyes/Set color separatelywith “Color” on each image. Brow colors can be changed too (Layered parts) - Removed the shared “Eye color”, “Use different colors for left and right (odd eyes, etc.)” and the custom expressions’ “Eye color”. Values set in “Eye color” in v1.1.0 are no longer used, so set them again with “Color” on the open eyes
- Grouped the layered parts into “Eyes”, “Brows” and “Mouth”
2026-10-05 v1.1.0
- Added “Eye color” to the layered parts. You can change the hue, saturation and brightness of the eye images, so even the preset eyes can match your character (Layered parts)
- “Use different colors for left and right (odd eyes, etc.)” lets you give the left and right eyes different colors
- Each custom expression can change the eye color, for example to make the eyes red when angry (Custom expressions)
Credit
Crediting the tool in your streams or personal projects is not required, but it is always encouraging.
Standard format
Peraravatar+ by Ichigyun
https://gyungyun.com/en/works/peraravatar-plus Short format
Avatar: Peraravatar+ (gyungyun.com) / @zkmy_kuro For the terms covering bundled images and works created with the tools, see Terms of use on the top page.
Contact
Bug reports & Feature requests
Report bugs and request features for Peraravatar+ here. Including your environment and steps to reproduce helps a lot.
Contact form ▶
Business & Other inquiries
For work requests and other inquiries, please email me.
Email ▶
Feedback & Cheers
Send me an anonymous one-liner. Even just "I'm using it" makes me happy.
Marshmallow ▶