SonaLab - Real-Time Vocal Analysis Software
(((GUIDE)))

Getting Started Guide

Turn your voice into visible imagery. Like looking in a mirror, see what happens inside your body when you sing.

🚀 Quick Start

No vocal knowledge needed — just follow along.

Step 1: Open SonaLab and Allow Microphone Access

On first launch, the system will ask whether to allow microphone access. Click "Allow".

If you're using an external mic or audio interface, click the 🎙 microphone button in the top-right corner and select your device.

Step 2: Click "Start Measuring"

Click the ▶ Start Measuring button in the toolbar. Speak or sing into your mic and the charts on screen start moving.

Like an EKG — you make sound, it responds.

Step 3: Sing an "Ah" and Watch What Changes

Sing a long, comfortable "Ah~" at an easy volume. You'll see:

  • the waveform rise and fall (the shape of your sound)
  • pitch display the note you're singing
  • the TA/CT Balance show the "thickness" of your voice
🪞 Imagine: SonaLab is a "mirror for your voice". A regular mirror shows your face — SonaLab shows how your voice is produced inside your body.
💡 Congrats! You've completed the basic operations. Next, let's get to know each area of the interface.

🗺️ Interface Overview

SonaLab's interface is like a car dashboard. You don't need to understand the engine — just know "which gauge means what".

The Four Areas at a Glance

Toolbar (very top)Start/stop measuring, pick your mic, switch tier levelThe car's ignition and dashboard switches
Sidebar (left)Check the charts you want to see (order them like a menu)The channel list on a TV remote
Chart Area (center, main area)Real-time display of your voice dataThe indicators on a health checkup report
Playback Bar (bottom)Record, play back, annotate on the timelineThe progress bar of a music player
📺 The sidebar is like a TV remote: check the "channel" (chart) you want to watch over on the left. Uncheck what you don't need and the interface gets cleaner.

Tier Levels Explained

SonaLab has four tier levels, like "unlockable stages" in a game. The higher the tier, the more charts you can see:

L0 Student (Free)✅ Vocal Health Score, ✅ Symptom DetectionFor complete beginners
L1 Basic✅ Pitch · TA/CT · Closure · Depth · Singer's Formant · WaveformFor serious vocal practice
L2 Advanced✅ Formant Tracking, ✅ Sagittal View · SpectrogramFor deep-diving research
L3 Expert✅ Three Balances analysis, ✅ Vibrato · AI DiagnosisFor vocal teachers & professionals
💡 Just starting out? L0 or L1 is plenty. Once you're comfortable with the basics, unlock more charts step by step.

⚙️ Engine View

This group of charts shows you "how your voice is produced". Like a car's engine monitor, it tells you the RPM, how deep the throttle goes, and whether the exhaust flows freely.

🚗 Picture your voice box as an engine: the vocal folds are the "cylinders", airflow is the "fuel", and sound is the "exhaust". The Engine View is this engine's dashboard.

🎵 Pitch — What Note Are You Singing?

This gauge tells you the name of the note you are singing (e.g., C4, A3) and how far off it is.

🎯 Like the bullseye in archery. Needle dead center = spot-on pitch; leaning left or right = a touch flat or sharp.
Note name + greenGreat intonationKeep it up!
Needle leans leftSlightly flatGently "aim" a bit higher — do not push
Needle leans rightSlightly sharpRelax a little — no need to tense up

🫘 TA/CT Balance — The "Thickness Dial" of Your Voice

An olive-shaped slider: TA (thick voice) on the left, CT (thin voice) on the right.

🎸 Think of guitar strings. Thick strings (TA) sound deep and rich; thin strings (CT) sound bright and slender. Your vocal folds are like a single string that can grow "thicker or thinner". The slider tells you which way your folds are leaning right now.
Leaning left (more TA)Thick, powerful, speech-likeLow register, speaking, belting
MiddleBalanced mix — most comfortableMid register, pop singing
Leaning right (more CT)Light, bright, hum-likeHigh register, falsetto, soft singing
💡 When you sing higher, the cursor naturally drifts to the right. That's normal! The key is a smooth transition — no sudden "jumps".

🤝 Vocal Fold Closure — How Tight Is the Tap?

Closure tells you whether your vocal folds come together exactly as much as they should.

🚿 Picture your vocal folds as a faucet. Screwed too tight (extrinsic compensation) = the flow chokes and the sound squeezes; too loose (insufficient closure) = water gushing out and the sound goes airy. The sweet spot is "just right" — the flow runs smooth and strong.
Pressed 🔴Tight throat, squeezed sound, tired voice after singingTry lip trills (brrr) to relax
Flowing 🟢Open, clear sound, comfortable to singGreat! Hold on to that feeling
Breathy 🟠Airy, leaking, no powerTry "Gug" exercises to firm up closure

🏊 Depth — The "In-the-Water" Feel of Your Voice

Depth measures how "sunk-in" and "in-the-mic" your voice is. A voice with good depth sounds full and has real presence.

🔔 Strike a big bell vs. a small handbell. The big bell rings deep and full (good depth); the handbell is crisp but thin (not enough depth). Depth is how much "big bell" there is in your voice.

💎 Singer's Formant Monitor — The Carrying Power of Your Voice

The Singer's Formant Monitor measures whether your voice can "cut through" the accompaniment and reach the listener clearly.

📢 In a noisy restaurant, some people you can always hear clearly (good formant) while others get drowned in the din (insufficient formant). The singer's formant is that "carrying power" in a voice.
Good formant 🟢Voice carries, easily heard
Insufficient formant 🟠Muffled, lacking brightness
Excessive formant 🔴Sharp and piercing — too hot

🌊 Waveform · Loudness · Onset

Waveform — the "EKG" of your sound. Bigger waves = louder sound; denser waves = higher pitch.

Loudness — a simple volume meter. Green = healthy, red = too loud.

Onset Detective — every time you start a note, your vocal folds go through a "start-up" moment. The Onset Detective checks whether that start-up is healthy.

👏 Think of clapping. A hard smack (hard onset) = the sound attacks; hands gliding together to meet (balanced onset) = the sound starts naturally; hands slowing to a feather-touch (soft onset) = the sound comes out airy.
Hard onset 🔴Opens too hard — like a little "cough"
Balanced onset 🟢Natural, comfortable, clean
Soft onset 🟠Airy at the start — like a sigh

👄 Acoustic View

The Acoustic View lets you "see through" your mouth. Where is the tongue? Is the larynx riding high? Is the soft palate lifted? Things you can never watch directly — SonaLab visualizes them all.

🔬 If the Engine View watches the "engine", the Acoustic View watches the "shape of the exhaust pipe". After leaving the vocal folds, sound travels through the throat, the mouth and the nose before it becomes what listeners hear. The shape of your vocal tract decides the "flavor" of your sound.

🗣️ Formant Tracking — The Vowel Map

This is a "vowel map". Sing different vowels (ah, oh, ee, oo, eh) and the cursor moves to different spots on the map.

🗺️ It works like a "GPS for your mouth". The white cursor is "where you are now"; the colored dots are "where the reference vowels live". The closer the cursor sits to a dot, the closer your sound is to that vowel.

How to use it:

  • On "ah", the cursor should sit low on the map (jaw dropped wide)
  • On "ee", the cursor should sit toward the top right (wide mouth, tongue forward)
  • If the cursor keeps drifting away from the target vowel, your mouth shape or tongue position needs adjusting

🧠 Sagittal View — The "X-Ray" of Your Vocal Tract

The Sagittal View is one of SonaLab's coolest features. It renders a live side view of your head, showing what's happening inside your mouth in real time as you sing.

Three key structures move dynamically in the view:

Tongue 🟠Flesh pink, natural positionTurns red = tongue root tension (like swallowing an egg)
Soft palate 🟢Green, moderately liftedToo low = heavy nasality (like talking with a cold)
Larynx 🔵Blue, neutral positionToo high = tight sound; too low = muffled sound
🏠 Picture your mouth as a room. The tongue is the floor, the hard palate is the ceiling, the soft palate is the curtain at the back, and the larynx is the entrance to the basement. The shape of the room decides the "echo" your voice gets.
💡 If the tongue turns red while you sing, the tongue root is gripping. Try sticking your tongue out and singing "lah" to let it relax.

📋 Composite View

The Composite View rolls all the data into one "checkup report" so you can see the overall state of your voice at a glance.

💚 Vocal Health Score — How Does Your Voice Score?

A circular 0-100 gauge. It blends four dimensions — closure, singer's formant, stability and vibrato — into one overall score.

80-100 🟢Excellent — your voice is in great shape!
60-79 🟢Good — room to grow
40-59 🟠Fair — some areas need attention
0-39 🔴Needs work — targeted practice recommended

🩺 Symptom Detection — The "Checkup Report" for Your Voice

SonaLab automatically detects problems that may appear while you sing and presents them as "flip cards".

🏥 Like a hospital checkup, where the doctor tells you "blood pressure is a bit high" or "blood sugar is normal". Symptom Detection is the "checkup doctor" for your voice — it tells you what needs attention.
Extrinsic CompensationThe muscles beside your neck are helping produce soundLip trills, straw phonation
Insufficient ClosureFolds not closing firmly — air leaks out"Gug" arpeggios, humming
Register BreakThe voice suddenly "snaps" moving from low to highOctave slides, sirens
Tongue RetractionThe tongue root pulls back and blocks the sound channel"Nay" arpeggios, tongue trills
Excessive NasalityToo much sound escaping through the nose"Gah" exercises, soft palate training
💡 Click a symptom card to flip it over — the back shows teaching advice and recommended exercises.

⏱️ Vocal Load — How Long Have You Practiced Today?

Below the health score sits a "Today's Vocal Load" progress bar. It tracks how long you have been voicing today, so you can avoid over-practicing.

🏃 Like a sports watch counting the kilometers you run. Run too much and you get injured; sing too much and your voice gets tired. This bar is the "activity tracker" for your voice.
Room to spare 🔵Fine to keep practicing
Near the limit 🟠Take breaks, slow the pace
Limit reached 🔴Enough for today — come back tomorrow!
⚠️ If you see the "sustained high-intensity high notes too long — rest recommended" alert, take it seriously. Sustained high-intensity phonation can damage your vocal folds.

⚖️ Vocal Balance — The Three Balances at a Glance (L3 Expert)

This is the core idea of the SonaLab vocal analysis method: a good voice needs balance in three dimensions.

🎸 Everyday analogies for the Three Balances:
① Vocal Balance = the tension of a guitar string. Too tight sounds shrill, too loose sounds dull — tuned just right, it sings.
② Dynamic Balance = a speaker's volume and quality. Not just loud — also clear, with carrying power.
③ Airflow Balance = a faucet's stream. No leaks, no blockage — the water flows smooth and strong.

🎯 Common Scenarios

Not sure which charts to watch? Find your situation and follow along.

😤 "I want high notes without squeezing — what do I watch?"

Squeezing on high notes is the most common problem. Usually the vocal folds fail to "thin out" in time, or the external laryngeal muscles are "helping" in the worst way.

Open these charts:

  • TA/CT Balance — on high notes the cursor should drift naturally to the right (CT). If it stays stuck on the left, your folds aren't thinning.
  • Vocal Fold Closure — if it reads "Pressed" (red), you are squeezing. Try easing off.
  • Sagittal View (L2) — check whether the larynx has climbed. A slight rise on high notes is normal; climb too far and the sound jams.
  • Symptom Detection — look for "Extrinsic Compensation" or "Register Break" cards.
💡 The secret of high notes: it isn't "pushing harder upward" — it's letting the folds thin out naturally. Imagine you're humming a song, not shouting.

✨ "I want a clearer, more ringing tone — what do I adjust?"

A closed-off sound usually comes from "not enough singer's formant" or a "retracted tongue root".

Open these charts:

  • Singer's Formant Monitor — if it reads "insufficient formant" (orange), your sound lacks high-frequency energy and gets muffled.
  • Depth — depth and the singer's formant must work as a team. Formant without depth = shrill; depth without formant = muffled.
  • Sagittal View (L2) — watch whether the tongue is turning red (tongue root tension). A retracted tongue blocks the sound channel.
  • Formant Tracking (L2) — see whether the cursor drifts off the target vowel. Big drift means the mouth shape needs adjusting.
💡 The key to a ringing tone: keep the space inside your mouth open (imagine a small egg tucked in there) while the tongue stays relaxed, not pulled back.

😩 "How do I know if my voice is getting tired?"

Vocal fatigue sends clear signals. SonaLab can spot them "before the damage is done".

Watch these indicators:

  • Vocal Load bar — the most direct indicator. When it approaches orange, it's time to rest.
  • Vocal Health Score — if the score keeps sliding during practice, the voice is getting tired.
  • Vocal Fold Closure — closure drops with fatigue (from "Flowing" to "Breathy"), because the fold muscles are tiring out.
  • Voice Stability (L3) — a tired voice starts to wobble and the stability score falls.
  • Symptom Detection — look for "Extrinsic Compensation" cards. Once the voice tires, the body quietly recruits the neck muscles to help.
⚠️ Stop practicing immediately if any of these appear: the Vocal Load bar turns red, the health score drops below 40, a "sustained high-intensity high notes too long" warning appears, or closure keeps reading "Pressed".
💡 Tired voice? Click the 🍃 Warm-Up / Cool Down button in the top-left corner and follow a set of relaxation exercises.

💨 "I always run out of breath when I sing — what do I check?"

Running out of breath usually isn't about lung capacity — it's about air not being used efficiently.

Open these charts:

  • Vocal Fold Closure — if it reads "Breathy" (orange), the folds aren't closing firmly and air is leaking away for nothing.
  • Onset Detective — if onsets keep reading "soft" (orange), every note-start is leaking air.
  • Breathiness Detection (L3) — tells you the degree of leakage directly. The thicker the fog, the more air is escaping.
🎈 Imagine inflating a balloon. If the neck isn't pinched tight (insufficient closure), no amount of blowing will fill it. The fix isn't "blow harder" — it's "pinch the neck".

👃 "People say I sound nasal — how do I fix it?"

Nasality comes from the soft palate (the "curtain" at the back of the mouth) failing to lift, so the sound escapes into the nose.

Open these charts:

  • Sagittal View (L2) — watch the soft palate (the green part). If it sits low, sound exits through the nose.
  • Symptom Detection — check for an "Excessive Nasality" card.
🪟 The soft palate is a curtain at the back of your mouth. Curtain drawn (palate lifted) = sound exits the mouth; curtain open (palate dropped) = sound exits the nose. While singing, you mostly want the curtain drawn.
💡 Try pinching your nose while singing "ah". If the sound changes a lot, the nasality is real. Practicing "Gah Gah" helps lift the soft palate.

📋 Quick Reference

High notes without squeezingTA/CT Balance + Vocal Fold ClosureCursor drifting right? Pressed?
Clearer, ringing toneSinger's Formant + Depth + Sagittal ViewEnough formant? Tongue turning red?
Is the voice tired?Vocal Load + Health Score + ClosureBar color? Score dropping?
Running out of breathVocal Fold Closure + Onset DetectiveLeaking air? Onsets too soft?
Too nasalSagittal View + Symptom DetectionSoft palate position? Nasality card?
Wobbly / unstable voiceVoice Stability + Vibrato TrackerStability score? Regular vibrato?
Overall state at a glanceVocal Health Score + Symptom DetectionTotal score and four sub-scores
Deep-dive into vowelsFormant Tracking + Sagittal ViewCursor position? Vocal tract shape?

🍃 Vocal Health & Protection

Singing is a "sport". Just as you warm up before a run and stretch afterwards, your voice deserves care before and after singing.

🔥 Before Practice: Warm Up

Click the 🍃 Warm-Up / Cool Down button on the left side of the toolbar, and SonaLab will guide you through a warm-up routine.

🏃 Like warming up before exercise. You wouldn't open with an all-out sprint — your voice shouldn't open with top notes either. Wake the folds gently with soft exercises first.

Recommended warm-up sequence:

  1. Lip trills (brrr) — relax the lips and face
  2. Humming (mm~) — gently wake up the vocal folds
  3. Slides (low to high and back) — stretch the folds
  4. Simple scales — ease into full voice

❄️ After Practice: Cool Down

When you're done, run a cool-down routine to help the folds recover.

  1. Gentle humming — let the folds "cool down" slowly
  2. Sigh-like phonation (hah~) — release throat tension
  3. Sip warm water — keep the folds hydrated
  4. Rest quietly for 10-15 minutes — let the folds fully recover

🚦 SonaLab's Safety Signals

🟢 Green lightAll good — keep practicing
🟡 Yellow lightTake breaks, slow the pace
🔴 Red lightStop practicing — your voice needs rest
⚠️ SonaLab is a companion tool and cannot replace professional medical diagnosis. If you have persistent throat pain or hoarseness for over two weeks, please see a doctor.

📚 Glossary

If you bump into these terms elsewhere, here they are translated into plain English:

TermIn SonaLabPlain English
TA MuscleTA/CT Balance (left)Thickens vocal folds — like a thick guitar string
CT MuscleTA/CT Balance (right)Thins vocal folds — like a thin guitar string
NAQ / ClosureClosure GaugeHow tightly the vocal folds close
SPRSinger's Formant GaugeVoice carrying power
Formants F1/F2Formant TrackingMouth shape determines voice "flavor"
Larynx HeightSagittal ViewHow high or low your Adam's apple sits
Soft PalateSagittal ViewThe "curtain" at the back of your mouth
Jitter / ShimmerVoice StabilityHow steady your voice is
VibratoVibrato TrackingRegular, healthy voice oscillation
GNE (Glottal Noise Excitation)Breathiness DetectionHow much "airy noise" lives in your voice
BeltingStrong MixPowerful high notes
Mix VoiceMixBlend of chest and head voice
Head VoiceHead VoiceLight, bright high notes

SonaLab Getting Started Guide · Based on the SonaLab Vocal Analysis Method

Questions? Every chart has an ℹ️ button — click for details.