Meter Toolbar

Not Ready for Proofreading

Bill: There are a lot of issues raised on this page about getting sound into Audacity, how the sliders work and interact with the meters, and what to do if you're having problems. I think the place to put all these issues is Audacity Setup and Configuration. If people agree I will begin working on that page, which has suffered from a lack of attention anyway.
Gale: Although I agree with the principle, in practice I think people are going to appreciate a few pointers here especially if we link cold to this page in e-mail or Forum messages, as undoubtedly we will. Since this is the (none-too-obvious) place we switch monitoring on, I think monitoring has to be touched on, and since most people will expect audible monitoring, that has to be mentioned too.
People (on Win) not understanding why the output slider does not affect the meters is a common problem, so this seems the obvious place to address it. We could probably lose the stuff about the waveform and the gain sliders if we have that somewhere else. It's sort of there in Mixing but we were going to delete that. I think Playing and Recording, renamed to Playing, Recording and Mixing could be the place to contain some of that kind of overview information, and it's *very* weak on recording, so I've flagged it as ToDo. Again I'm going on the fact that many novices don't use the gain sliders and have no idea that they operate after the waveform.
I assume we still want to a short div note saying why -6 dB is a good idea, with somewhere to link to. Audacity Setup and Configuration may be the place to discuss overflow topics from meter and mixer toolbar. Should it be the place to link to instead of the Wiki "Mixer Toolbar Issues", so this information is local?
Is anything else on this page superfluous? We want the two meter channels points still, don't we? Again, common user questions.
Bill: Good points all, Gale, as usual. In summary I would say that if you can control it with the meter toolbar we document it here, so monitoring is in, which means we should mention playthrough. Perhaps I was over-reacting, reading all the stuff in the divs. It looks much better logged out!
I would simplify "Adjusting playback level" as you suggest, removing references to the waveform and the track gain sliders. I would emphasize the the playback meters show the level of the mix (what you will get when you export) and why this is good since it will show clipping that you won't see in individual tracks. Finally I would point out that the playback slider does not affect the level of the mix and therefore does not affect the playback meter. For those familiar with the terms I would comment that the playback slider is a "monitor" level control, not a master fader. Finally a link to Audacity Setup and Recording if you have an indication in the playback meters but can't hear anything.
Under "Adjusting and monitoring recording level" I would start by saying that the recording meter shows the level that will be recorded on the track. Then the 2 headroom sentences, then refer to the Mixer Toolbar page for the gory details. Finally a link to Audacity Setup and Recording if you can't get an indication on the recording meters. The Monitoring sub-section is fine.
The rest of the page is fine as is - I think we've provided enough details.

Meter Toolbar displays the amplitude of audio being played or recorded in the project. It is an easy way to see if the audio is clipped, which results in distortion.

The green bar shows the playback level, and the red bar shows recording level. L is the left channel and R is the right channel.

Gale: Is this getting too "Tutorial"? That said, most of what I've added is not available elsewhere AFIK.

Bill - Nov 22/09: My first impression is that we should describe on the mixer toolbar page how the sliders operate. Our goal here is to document the meters. Of course the two interact, but we need to document how the behaviour of the mixer sliders change according to whether or not they can control the system input and output sliders, and the place to do that is on the mixer toolbar page IMO.

Adjusting playback level

The playback level displayed in the Meter Toolbar reflects the amplitude of the mix of your project. Note that the output volume slider on the Mixer Toolbar does not affect the playback meter - the purpose of the meter is solely to indicate what the loudness of the project audio would be were you to export it as an audio file.

Bill - Nov 22/09: this is unfortunately incorrect (at the moment). If the playback slider has control of the system volume slider then adjusting the slides does affect the indication on the meters. I've been debating this on -devel, advocating that the meters should always be pre-slider, but this has not been implemented yet.

• Gale: On Windows XP and before, the output slider does not affect the meter and never has. Are you saying that it does on Mac? There should be no debate about this. The output slider does affect the meter on Linux in some circumstances and it's a P3 bug: "If Portmixer uses emulated playback volume rather than native, the Audacity output slider will affect the VU playback meters and these may not then reflect the actual volume level of the waveform".
• Bill: On Mac, if the playback slider controls and mirrors the system output volume slider, the meters are post-slider.

Gale: Please check if Al's fix which should be in the Nightly build 03:15 UTC 24Nov09 fixes this.

• Bill 25Nov09: playback meter is now pre-slider in all cases.

Adjusting and monitoring recording level

Use the input volume slider on the Mixer Toolbar to adjust the level of audio being recorded. In the image above, note that the blue lines in the recording meter (indicating the maximum peak level attained) are at about -6 dB. This is a sensible level to aim for when recording, because it gives you headroom to make edits affecting volume afterwards.

Note that in some cases the input volume slider may not be visible, as described on the Mixer Toolbar page. In that case you will need to use your sound card's or operating system's input volume control to set the recording level in Audacity.

ToDo Bill - Nov 22/09: Do we want a glossary entry for "headroom"?

• Gale: Yes please. can you do that.

Also, if the recording slider does not have control of the system input volume it is now "disabled" - always jumps to maximum. See the discussion on -devel. This is a good thing since all it did in the past was scale the level indicated on the meters before passing the audio on to the track for recording. The disabling of the input level slider indicates to the user that they need to use their system input volume to control the recording volume.

• Gale: Way behind with reading -devel, but I've seen this happening on Linux, and this will have to be documented on the Mixer Toolbar page.
  
• Bill 25Nov09: Input volume slider now disappears if it cannot control the system input level. Documented on Mixer Toolbar page and here.

Monitoring

It is good practice to test the correct input level before recording for real. Monitoring lets you do this without actually having to record and then delete a test track. It also verifies that you are recording the input source you expect. There are two ways to turn monitoring on and off:

• Left-click on the recording meter to turn monitoring on. Click again to turn it off.
• Click on the downward-pointing arrow beside the microphone symbol to display the meter drop-down menu. Choose "Start Monitoring" or "Stop Monitoring" as appropriate.

You will probably want to hear the monitored audio as well as see it. To do this:

• on Windows unmute the playback of your input source in the playback side of the system mixer. If this does not work, enable "software playthrough" in the Transport Menu
• on Mac OS X, enable "software playthrough" in the Transport Menu.

Bill - Nov 22/09: OS X does not have a "system mixer". The only way to hear what you're recording on OS X is to use software playthrough.

Gale: Then how do you describe Audio MIDI Setup if it is not a system mixer? But you're correct the above is too simplistic for OS X and you'd have to enable Audacity playthrough. Does the Mac-only Audacity "hardware playthrough" work, and is it in the Transport menu as well as "software playthrough"?
Bill: Audio Midi Setup is a separate application that lives in the Utilities folder. Most Mac users will be unaware of it until they encounter it in the Audacity documentation. Audio Midi Setup cannot be used for playing your line input through your system speakers or routing it to your headphone jack.
I've never understood why "Hardware Playthrough" is in the preferences at all - this has not been available since OS 9. It is not in the Transport menu on Mac.
Gale: I know Mac has not supported hardware playthrough for a long time, I was just dog-tired and forgot that when I wrote the above. Why Audio MIDI Setup still has a "Thru" box is another mystery again?? But the point is that Hardware Playthrough was put into Preferences on Mac explicitly to remedy Apple's omission. So what I'm interested in is if you had your external mic connected to mic or line (as appropriate) and enabled hardware (but not software) playthrough in Audacity prefs, does it let you hear the monitoring? I do think this is the place to mention this, but I've seen comments that Audacity's hardware playthrough doesn't always work, so if that's true we should only mention software playthrough here.
My understanding is also that a lot of external devices won't work in Audacity unless set up in Audio MIDI setup, so that's the fail-safe line I take.
Bill: AFAIK the "hardware playthough" option in preferences does not work and I have never relied on it - I ignore it. I can't begin to understand how Audacity could provide hardware playthrough when Apple has disabled it. Even the folks at Rogue Amoeba (strange name, great software) can't do it, and they're Mac specialists. They make a little app called "Line In" [1] that does in software what OS 9 used to do in hardware. Yes the "Thru" checkboxes in Audio Midi setup seem to be permanently greyed out and a search in Help does not mention them.
Yes it is possible that to get some external devices to work one may need to use Audio Midi Setup, but I have not personally encountered any.
Is this the place to get into all this?
I edited the above note div, removing the link to the wiki about Audio Midi setup. I'm not sure at the moment where we want to talk about "getting sound into Audacity", but I don't think this is that place. Gale: That's fine. We don't need the link to Audio MIDI setup, but yes I regard the minimal note div as it is now to be essential. Look at how many people complain that they can't hear what they are trying to monitor.

What the bars and lines mean

The abbreviations used in the image below are explained in the following text.

• CR: Current RMS Level. The right-hand edge of the lighter part of the bar. This shows the average level of the audio and gives a general indication of its perceived loudness. It relates directly to the amplitude of the light blue shading in the waveform .
• CP: Current Peak Level. The right-hand edge of the darker part of the bar. This shows the current peak level of the audio, and relates directly to the dark blue shading in the waveform.
• RP: Recent Peak Level. These lines indicate the highest peak level attained in the last few seconds. They disappear after playback or recording is stopped.
• MP: Maximum Peak Level. The blue lines indicate the maximum peak level attained during the current playback or recording session. They remain visible after playback or recording is stopped, and are reset when a new playback or recording session is started, or if you left-click on the recording meters.
• Clip: Clipping warning. The red lines to right of the maximum value of the scale appear as soon as there are four or more consecutive samples of audio exceeding that maximum. Once they have appeared, the clipping lines remain visible throughout that playback or recording session. They are thus not an indication of current clipping, but an absolute indication that clipping occurred somewhere in the track. The lines remain visible after playback or recording is stopped, and are reset when a new playback or recording session is started or if you left-click on the recording meters.

To find the exact points where clipping exists in a track, enable View > Show Clipping or run Analyze > Find Clipping....

Gale: re the section below, if you set Audacity to record in mono does the meter ever show anything other than left channel? Is that the point we should be making? If people have stereo input and set recording to mono, then they may either get a mono mix of both channels or just the left. If they want to record two different mic channels from a stereo mixer, set Audacity to record 2 channels. If you want those channels to be mono, use "Split Stereo to Mono" by clicking the downward-pointing arrow in the track name. Which point do we want to make here?

Bill - Nov 22/09: Yes, I think that is correct.

• Gale: Which points are important here- all? Or better, just that if you record in mono only the Left channel of the recording meter displays?
• Bill: OK, I see what you were asking. Tough call. Is it "too tutorial" to include all the points above? I think we want to explain what the meters do, not what the computer's sound control panel might do. On that basis, leave it as it is below.

Meter channels

• When playing a mono track, Audacity sends the output to both left and right speakers. Therefore if you leave the pan slider on the Track Panel untouched, both channels of the playback meter will show an identical level. If you pan towards one channel, then the opposite channel will have its level reduced until a complete pan away from it will remove it.
• If you set Audacity to record in mono (for example, from a microphone), only the left channel recording meter will be active.

Bill - Nov 22/09: I think the above would be more accurate if you used the language in the div above. That is, if you set Preferences > Devices > Recording to mono, only the left channel recording meter will have an indication. On Mac using the internal microphone you can record in mono or stereo and in the latter case both meters will indicate. I don't know what happens when you use an external mic plugged into a mic jack.
Bill 25Nov09: above description updated.

Undocking and Resizing

Like all toolbars, Meter Toolbar can be undocked, but unlike the other toolbars, it can also be resized. Resizing gives longer scales for the meters and hence a more accurate view of the volume levels.

• If the meter is docked, you can resize it horizontally by clicking and dragging the right edge.
• To undock the meter, click the handle on the left edge and drag. You can drag outside the Audacity project window, too.
• To resize when undocked, click on the resize handle that appears at the bottom right of the toolbar and drag horizontally or vertically.
• When resizing vertically:
  • The meters display one above the other when the toolbar height allows this, but the height is less than the width
  • The meters display in vertical orientation when the toolbar height exceeds its width

Here are three examples of an undocked and resized Meter Toolbar:

Gale: ToDo how about if we put the vertically oriented image on the right, making a logical progression of increasing vertical drag?

• Peter 24Dec09: I think it would be much better as Gale suggests.
• Bill 10Jan10: Like this?

Horizontal (after dragging to right)
Horizontal (after dragging down a short distance)
	Vertical (after dragging the height down in excess of width)

Drop-down Menu

The drop-down menu lets you change the meter's visual orientation, the scale format and more. You can access it by right-clicking on either the playback or recording meter, or by clicking the downward-pointing triangle in either meter.

Disable and Monitoring

• Disable Meter/Enable Meter: Turns the individual playback or recording meter off or on. When the meter is disabled it is gray and does not operate.
• Start Monitoring/Stop Monitoring (recording meter only): Starts/stops monitoring of the input (recording) level without actually recording a track. You can also start and stop monitoring by left-clicking on the recording meter.

Meter Orientation

• Horizontal Stereo: Displays the meter at its default horizontal orientation, with the bars extending from left to right.
• Vertical Stereo: Displays the meter vertically, with the bars extending from bottom to top.

Scale

• Linear: Displays the meter with a linear scale where the maximum level before clipping is 1.0.
• dB: Displays the meter with a logarithmic scale where the maximum level before clipping is 0 dB. This is the default view giving more detail for fainter sounds, corresponding more closely to how sound is heard. The minimum value of the scale can be changed in the Interface Preferences.

Preferences

• Preferences: Opens the Meter Preferences window to set the refresh rate for the meters. A higher rate makes the meter show more frequent changes. Too high a rate can cause audio breakup on slower machines.