Skip to content

Commit 4bbc4dc

Browse files
author
Github Worflow
committed
Manual update 2023-11-02-16-34-45
1 parent 02097b7 commit 4bbc4dc

File tree

535 files changed

+4074
-2950
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

535 files changed

+4074
-2950
lines changed

manual/index.html

+19-19
Large diffs are not rendered by default.
15.9 KB
-49 Bytes
-13.8 KB
Binary file not shown.

manual/m/images/0/04/extramenu.png

-5.55 KB
Binary file not shown.
Binary file not shown.
-46.3 KB
Binary file not shown.
4.29 KB
7.35 KB
15.7 KB
-23 KB
Binary file not shown.
-25.4 KB
Binary file not shown.
Binary file not shown.
-212 Bytes
2.55 KB
-5.48 KB
-7.41 KB
-40.8 KB
Binary file not shown.
-48 Bytes
15.5 KB
10.4 KB
80.5 KB
11.7 KB
-18.4 KB
Binary file not shown.
81.7 KB
31.1 KB
-9.12 KB
29.1 KB
39.9 KB
38.9 KB
-16 Bytes
-35.7 KB
Binary file not shown.
-34.8 KB
Binary file not shown.
-30.9 KB
Binary file not shown.

manual/m/images/4/40/viewmenu.png

-9.52 KB
Binary file not shown.
-10 KB
Binary file not shown.
-49 Bytes
15.9 KB
Binary file not shown.
44.4 KB
15.9 KB
-13.6 KB
Binary file not shown.

manual/m/images/5/50/filemenu.png

-7.79 KB
Binary file not shown.
-30.2 KB
Binary file not shown.
Binary file not shown.
Binary file not shown.
5.79 KB
305 Bytes
Binary file not shown.
16.1 KB
-38.2 KB
Binary file not shown.
-34.9 KB
Binary file not shown.

manual/m/images/7/79/tracksmenu.png

20 KB
-10.2 KB
Binary file not shown.
21.5 KB
15.5 KB
-18.2 KB
Binary file not shown.
16.9 KB
58.6 KB
Binary file not shown.
-3.83 KB
-3.73 KB
Binary file not shown.
3.59 KB

manual/m/images/a/a6/keyboard_key.png

-27.6 KB
Binary file not shown.
61.3 KB
Binary file not shown.
29 KB
18.9 KB
1.26 KB
-5.25 KB
Binary file not shown.
-5.5 KB
Binary file not shown.
22.8 KB
Binary file not shown.
Binary file not shown.
Binary file not shown.
-28.2 KB
Binary file not shown.
-5.66 KB
Binary file not shown.
-8.9 KB
Binary file not shown.
Binary file not shown.
21.9 KB
Binary file not shown.
-13.5 KB
Binary file not shown.
Binary file not shown.
-4.2 KB
Binary file not shown.
Binary file not shown.
Binary file not shown.
-18.5 KB
Binary file not shown.
Binary file not shown.
8.98 KB
16.7 KB
19.8 KB

manual/man/aac_export_options.html

+34-24
Original file line numberDiff line numberDiff line change
@@ -33,54 +33,64 @@ <h1 id="firstHeading" class="firstHeading" lang="en">AAC Export Options</h1>
3333
<div id="jump-to-nav" class="mw-jump">Jump to: <a href="#column-one">navigation</a>, <a href="https://alphamanual.audacityteam.org/man/AAC_Export_Options#searchInput">search</a></div>
3434

3535

36-
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="intro"><b>AAC</b> is a <i><b><a href="glossary.html#lossy" title="Glossary">lossy</a></b></i>, <i><b><a href="glossary.html#compressed_format" title="Glossary">compressed</a></b></i> audio format. It is the default audio format for Apple Music/iTunes\xc2\xae, iPhone\xc2\xae, iPad\xc2\xae and iPod\xc2\xae
36+
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="intro"><b>AAC</b> is a <i><b><a href="glossary.html#lossy" title="Glossary">lossy</a></b></i>, <i><b><a href="glossary.html#compressed_format" title="Glossary">compressed</a></b></i> audio format. It is the default audio format for Apple Music/iTunes\xc2\xae, iPhone\xc2\xae, iPad\xc2\xae and iPod\xc2\xae
3737
<div style="margin-top:12px; margin-bottom:12px; margin-left:24px; margin-right:24px">
3838
<table style="background:#FEFFD0; color:black; border:1px solid #999999; padding-left:12px; padding-right:12px" width="100%" align="center">
3939

4040
<tr>
4141
<td width="30px" valign="top" align="center"><img alt="Advice" src="../m/images/b/ba/warningicon.png" title="Advice" width="24" height="24" />
4242
</td>
43-
<td align="left" valign="top"><b>FFmpeg</b> is not shipped with Audacity but you can download it and then export as AAC by following <a rel="nofollow" class="external text" href="https://support.audacityteam.org/basics/installing-ffmpeg"><b>these instructions</b></a>.
44-
</td></tr></table></div>
43+
<td align="left" valign="top"><b>FFmpeg</b> is required for AAC export but it is not shipped with Audacity but you can download it and then export as AAC by following <a rel="nofollow" class="external text" href="https://support.audacityteam.org/basics/installing-ffmpeg"><b>these instructions</b></a>.
44+
</td></tr></table></div> </div>
4545
<div style="margin-top:12px; margin-bottom:12px; margin-left:24px; margin-right:24px">
4646
<table style="background:#FFCCCC; color:black; border:1px solid #CC0000; padding-left:12px; padding-right:12px" width="100%" align="center">
4747

4848
<tr>
4949
<td width="30px" valign="top" align="center"><img alt="Alert" src="../m/images/6/6c/stopicon.png" title="Alert" width="24" height="24" />
5050
</td>
5151
<td align="left" valign="top">Please be aware that there is a bug in Audacity whereby the bit rate setting that you make in an AAC export is <i><b>not</b></i> always honored by Audacity. See <a rel="nofollow" class="external text" href="https://github.com/audacity/audacity/issues/4309"><b>this logged bug</b></a> for more details.
52-
<ul><li>For stereo <b>all</b> selected bit rates of 196kbps export at 196kbps - this includes the default bit rate setting of 160 kbps</li>
53-
<li>Settings in the range 200kbps to 224kbps are closely honored on export.</li>
54-
<li>On Mac higher bit rate settings are honored but not so on Windows where settings of 256kbps and 320kbps produce files of 233kbps and 235kbps.</li></ul>
52+
<ul><li>For stereo <b>all</b> selected bit rates of 196kbps or less export at 196-198kbps,</li>
53+
<li>Settings in the range 200kbps to 320kbps are reasonably closely honored on export.</li></ul>
5554
<div style="margin-top:12px; margin-bottom:12px; margin-left:24px; margin-right:24px">
5655
<table style="background:#FEFFD0; color:black; border:1px solid #999999; padding-left:12px; padding-right:12px" width="100%" align="center">
5756

5857
<tr>
5958
<td width="30px" valign="top" align="center"><img alt="Tip" src="../m/images/d/d7/bulbicon.png" title="Tip" width="32" height="32" />
6059
</td>
61-
<td align="left" valign="top">The workaround is to export as uncompressed WAV or AIFF and use iTunes/Music to make the AAC conversion, see <a href="tutorial_exporting_to_itunes.html#conversion" title="Tutorial - Exporting to iTunes"> this page</a> for information regarding this.
60+
<td align="left" valign="top"><b>The <i>strongly recommended</i> workaround is to export as uncompressed WAV or AIFF and use iTunes/Music, where you have greater control of the settings, to make the AAC conversion.</b>
61+
<ul><li>See <a href="tutorial_exporting_to_itunes.html#conversion" title="Tutorial - Exporting to iTunes"> <b>Exporting to iTunes</b></a> for information regarding this.<b> </b></li></ul>
6262
</td></tr></table>
6363
</div>
64-
64+
6565
</td></tr></table>
66-
</div> </div>
67-
<dl><dd>Accessed by: <span class="menu">File &gt; Export &gt; <a href="file_menu_export.html#exportaudio" title="File Menu: Export">Export Audio...</a></span> then choosing <b>M4A(AAC) Files FFmpeg</b> from the <b>Save as type</b> dropdown menu</dd></dl>
68-
<dl><dd><span title="AAC Export Options at the bottom of the Export Audio dialog"><img alt="Export AAC dialog 3-3-0.png" src="../m/images/3/3d/export_aac_dialog_3_3_0.png" width="632" height="583" /></span></dd></dl>
69-
<dl><dd>Also accessed by: <span class="menu">File &gt; Export &gt; <a href="file_menu_export.html#exportmultiple" title="File Menu: Export">Export Multiple...</a></span> then choosing <b>M4A(AAC) Files FFmpeg</b> from the <b>Save as type</b> dropdown menu. <p>In this case the options dialog will appear in the center of the Export Multiple dialog.</p></dd></dl>
66+
</div>
67+
<dl><dd><b>Accessed by:</b> <span class="menu">File &gt; <a href="file_export_dialog.html" title="File Export Dialog">Export Audio</a></span> then choosing <b>M4A(AAC) Files FFmpeg</b> from the <b>Format</b> dropdown menu.</dd>
68+
<dd><span title="AAC Export Audio dialog"><img alt="Export M4A AAC 3-4-0.png" src="../m/images/2/2d/export_m4a_aac_3_4_0.png" width="497" height="427" /></span></dd></dl>
7069
<p><br />
7170
</p>
7271
<div id="setup"></div>
73-
<h2><span class="mw-headline" id="Format_Options">Format Options</span></h2>
74-
<ul><li><b>Quality:</b> This box controls the quality (bit rate in kbps) of the output AAC file. The Maximum bit rate (best quality) is 320 kbps (stereo) 160 kbps (mono) and the minimum is 98 kbps (mono).<p>You can use the up/down arrow-heads to change the required value or you can simply type it in. </p> <p>The default quality setting of 160 typically produces a similar sized, but slightly higher quality file compared to an <i><b><a href="glossary.html#mp3" title="Glossary">MP3</a></b></i> at Audacity's default 128 kbps constant <i><b><a href="glossary.html#bit_rate" title="Glossary">bit rate</a></b></i>. A stereo file is always produced, but a file exported from a mono track will have about half the bit rate <i>(and hence half the file size)</i> of one exported from a stereo track.</p></li></ul>
75-
<div style="margin-top:12px; margin-bottom:12px; margin-left:24px; margin-right:24px">
76-
<table style="background:#FEFFD0; color:black; border:1px solid #999999; padding-left:12px; padding-right:12px" width="100%" align="center">
77-
78-
<tr>
79-
<td width="30px" valign="top" align="center"><img alt="Advice" src="../m/images/b/ba/warningicon.png" title="Advice" width="24" height="24" />
80-
</td>
81-
<td align="left" valign="top">On Mac please only use the <b>up/down arrows</b> to set your required bit rate as there is a bug whereby if you type a value Audacity will ignore that and use the last previously used value instead.
82-
83-
</td></tr></table></div>
72+
<h2><span class="mw-headline" id="Audio_Options">Audio Options</span></h2>
73+
<div id="channels"></div>
74+
<h3><span class="mw-headline" id="Channels">Channels</span></h3>
75+
<p>Sets the number of channels for the exported audio file. There are three options
76+
</p>
77+
<ul><li><span style="font-weight: bold; font-size:118%">Mono:</span> single channel</li>
78+
<li><span style="font-weight: bold; font-size:118%">Stereo:</span> stereo pair with left and right channels - <i>this is the default setting even if you only have mono tracks for exporting</i></li>
79+
<li><span style="font-weight: bold; font-size:118%">Custom mapping:</span> use this to export multi-channel (surround sound) files or to make customized assignments between Audacity tracks and the channels in the exported file.
80+
<ul><li>Selecting this and clicking on the <span class="button">Configure</span> button causes the <b><a href="advanced_mixing_options.html" title="Advanced Mixing Options">Advanced Mixing Options</a></b> dialog to appear. For details please see <a href="advanced_mixing_options.html" title="Advanced Mixing Options">Advanced Mixing Options</a>.</li></ul></li></ul>
81+
<div id="rate"></div>
82+
<h3><span class="mw-headline" id="Sample_Rate">Sample Rate</span></h3>
83+
<p>Sets the sample rate for the exported file. Default setting is 44100 Hz, which is CD quality.
84+
</p>
85+
<div id="quality"></div>
86+
<h3><span class="mw-headline" id="Quality">Quality</span></h3>
87+
<p>This box controls the quality (bit rate in kbps) of the output AAC file.
88+
</p>
89+
<ul><li>The default setting is 256 kbps which is that quality that Apple now uses for audio files sold in iTunes/Apple Music. </li>
90+
<li>The Maximum bit rate (best quality) is 320 kbps (stereo) 160 kbps (mono) and the minimum is 98 kbps (mono).</li>
91+
<li>You can use the up/down arrow-heads to change the required value or you can simply type it in. </li></ul>
92+
<p>A quality setting of 160 typically produces a similar sized, but slightly higher quality file compared to an <i><b><a href="glossary.html#mp3" title="Glossary">MP3</a></b></i> at Audacity's default 128 kbps constant <i><b><a href="glossary.html#bit_rate" title="Glossary">bit rate</a></b></i>. A stereo file is always produced, but a file exported from a mono track will have about half the bit rate <i>(and hence half the file size)</i> of one exported from a stereo track.
93+
</p>
8494
<div class="note">Like <i><b><a href="glossary.html#ogg" title="Glossary">OGG</a></b></i>, AAC encoding is a form of <i><b><a href="glossary.html#vbr" title="Glossary">VBR</a></b></i> or variable bit rate encoding, as opposed to the <i><b><a href="glossary.html#cbr" title="Glossary">CBR</a></b></i> or constant bit rate encoding used by default when exporting MP3 files. <p>This means that in order to maintain consistent quality throughout a track, a higher bit rate will be used when encoding a complex piece of audio (such as a full orchestral passage) than when encoding a solo voice or instrument. A recording which has more complex audio will produce a larger file. Increasing the <i><b><a href="glossary.html#sample_rate" title="Glossary">sample rate</a></b></i> in <a href="audio_settings_preferences.html" title="Audio Settings Preferences">Audio Settings Preferences</a> will increase the bit rate and so the file size (and vice versa). </p></div>
8595

8696

@@ -159,7 +169,7 @@ <h3>Useful Links</h3>
159169
<a href="https://www.mediawiki.org/"><img src="../m/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/m/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /m/resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31"/></a>
160170
</div>
161171

162-
<div align="center"><ul id="f_list"><li>This version created on 2023-05-24 - <a href="https://alphamanual.audacityteam.org/man/AAC_Export_Options">Check current version of this page (development Manual)</a></li></ul></div>
172+
<div align="center"><ul id="f_list"><li>This version created on 2023-11-02 - <a href="https://alphamanual.audacityteam.org/man/AAC_Export_Options">Check current version of this page (development Manual)</a></li></ul></div>
163173
</div>
164174
</div>
165175
</body></html>

manual/man/ac3_export_options.html

+24-10
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,9 @@ <h1 id="firstHeading" class="firstHeading" lang="en">AC3 Export Options</h1>
3333
<div id="jump-to-nav" class="mw-jump">Jump to: <a href="#column-one">navigation</a>, <a href="https://alphamanual.audacityteam.org/man/AC3_Export_Options#searchInput">search</a></div>
3434

3535

36-
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
37-
<div class="intro"><b>AC3</b> is a <i><b><a href="glossary.html#compressed_format" title="Glossary">compressed</a></b></i> audio format developed by Dolby Laboratories, often used in DVD production. </div>
38-
<dl><dd>Accessed by: <span class="menu">File &gt; Export &gt; <a href="file_menu_export.html#exportaudio" title="File Menu: Export">Export Audio...</a></span> then choosing <b>AC3 Files (FFmpeg)</b> from the <b>Save as type</b> dropdown menu.</dd></dl>
39-
<dl><dd><span title="AC3 Export Options dialog at the bottom of the Export Audio dialog"><img alt="Export AC3 dialog 3-0-0.png" src="../m/images/7/76/export_ac3_dialog_3_0_0.png" width="715" height="623" /></span></dd></dl>
40-
<dl><dd>Also accessed by: <span class="menu">File &gt; Export &gt; <a href="file_menu_export.html#exportmultiple" title="File Menu: Export">Export Multiple...</a></span> then choosing <b>AC3 Files (FFmpeg) </b> from the <b>Save as type</b> dropdown menu. In this case the options dialog will appear in the center of the Export Multiple dialog.</dd></dl>
36+
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="intro"><b>AC3</b> is a <i><b><a href="glossary.html#compressed_format" title="Glossary">compressed</a></b></i> audio format developed by Dolby Laboratories, often used in DVD production. </div>
37+
<dl><dd><b>Accessed by:</b> <span class="menu">File &gt; <a href="file_export_dialog.html" title="File Export Dialog">Export Audio</a></span> then choosing <b>AC3 Files (FFmpeg)</b> from the <b>Format</b> dropdown menu.</dd>
38+
<dd><span title="AC3 Export Audio dialog"><img alt="Export AC3 3-4-0.png" src="../m/images/0/0c/export_ac3_3_4_0.png" width="497" height="427" /></span></dd></dl>
4139
<div style="margin-top:12px; margin-bottom:12px; margin-left:24px; margin-right:24px">
4240
<table style="background:#FEFFD0; color:black; border:1px solid #999999; padding-left:12px; padding-right:12px" width="100%" align="center">
4341

@@ -46,10 +44,26 @@ <h1 id="firstHeading" class="firstHeading" lang="en">AC3 Export Options</h1>
4644
</td>
4745
<td align="left" valign="top">FFmpeg is not shipped with Audacity but you can download it and then export as AC3 by following <a href="faq_installation_and_plug_ins.html#ffdown" title="FAQ:Installation and Plug-Ins">these instructions</a>.
4846
</td></tr></table></div>
49-
<div id="setup"></div>
50-
<h2><span class="mw-headline" id="AC3_Export_Setup">AC3 Export Setup</span></h2>
51-
<ul><li><b>Bit Rate:</b> Choose a <i><b><a href="glossary.html#bit_rate" title="Glossary">bit rate</a></b></i> from 32 kbps to 640 kbps (defaults to 160 kbps). Larger bit rates give higher quality but produce larger files.</li></ul>
52-
47+
<p><br />
48+
</p>
49+
<div id="options"></div>
50+
<h2><span class="mw-headline" id="Audio_Options">Audio Options</span></h2>
51+
<div id="channels"></div>
52+
<h3><span class="mw-headline" id="Channels">Channels</span></h3>
53+
<p>Sets the number of channels for the exported audio file. There are three options
54+
</p>
55+
<ul><li><span style="font-weight: bold; font-size:118%">Mono:</span> single channel</li>
56+
<li><span style="font-weight: bold; font-size:118%">Stereo:</span> stereo pair with left and right channels - <i>this is the default setting even if you only have mono tracks for exporting</i></li>
57+
<li><span style="font-weight: bold; font-size:118%">Custom mapping:</span> use this to export multi-channel (surround sound) files or to make customized assignments between Audacity tracks and the channels in the exported file.
58+
<ul><li>Selecting this and clicking on the <span class="button">Configure</span> button causes the <b><a href="advanced_mixing_options.html" title="Advanced Mixing Options">Advanced Mixing Options</a></b> dialog to appear. For details please see <a href="advanced_mixing_options.html" title="Advanced Mixing Options">Advanced Mixing Options</a>.</li></ul></li></ul>
59+
<div id="rate"></div>
60+
<h3><span class="mw-headline" id="Sample_Rate">Sample Rate</span></h3>
61+
<p>Sets the sample rate for the exported file. Default setting is 44100 Hz, which is CD quality.
62+
</p>
63+
<div id="bitrate"></div>
64+
<h3><span class="mw-headline" id="Bit_Rate">Bit Rate</span></h3>
65+
<p>Choose a <i><b><a href="glossary.html#bit_rate" title="Glossary">bit rate</a></b></i> from 32 kbps to 640 kbps (defaults to 160 kbps). Larger bit rates give higher quality but produce larger files.
66+
</p>
5367

5468

5569

@@ -126,7 +140,7 @@ <h3>Useful Links</h3>
126140
<a href="https://www.mediawiki.org/"><img src="../m/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/m/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /m/resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31"/></a>
127141
</div>
128142

129-
<div align="center"><ul id="f_list"><li>This version created on 2023-05-24 - <a href="https://alphamanual.audacityteam.org/man/AC3_Export_Options">Check current version of this page (development Manual)</a></li></ul></div>
143+
<div align="center"><ul id="f_list"><li>This version created on 2023-11-02 - <a href="https://alphamanual.audacityteam.org/man/AC3_Export_Options">Check current version of this page (development Manual)</a></li></ul></div>
130144
</div>
131145
</div>
132146
</body></html>

manual/man/accessibility.html

+3-2
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,8 @@ <h1 id="firstHeading" class="firstHeading" lang="en">Accessibility</h1>
3434

3535

3636
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr">
37-
<div class="intro">{{{1}}}</div>
37+
<div class="intro">This page discusses accessibility issues in Audacity for visually- and motion-impaired users.
38+
<ul><li> Technical support for visually impaired users is provided on the <a rel="nofollow" class="external text" href="https://www.freelists.org/list/audacity4blind?utm_content=cmp-true">audacity4blind mailing list</a>.</div></li></ul>
3839
<div id="shortcuts"></div>
3940
<h2><span class="mw-headline" id="Keyboard_shortcuts">Keyboard shortcuts</span></h2>
4041
<p>A large number of keyboard shortcuts are available for those who cannot use a mouse, and for those who find it quicker to use the keyboard. These keyboard shortcuts are described throughout the manual, and in the <a href="keyboard_shortcut_reference.html" title="Keyboard Shortcut Reference">Keyboard Shortcut Reference</a>. They can be customized on the <a href="keyboard_preferences.html" title="Keyboard Preferences">Keyboard page</a> of the Preferences dialog.
@@ -148,7 +149,7 @@ <h3>Useful Links</h3>
148149
<a href="https://www.mediawiki.org/"><img src="../m/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" srcset="/m/resources/assets/poweredby_mediawiki_132x47.png 1.5x, /m/resources/assets/poweredby_mediawiki_176x62.png 2x" width="88" height="31"/></a>
149150
</div>
150151

151-
<div align="center"><ul id="f_list"><li>This version created on 2023-05-24 - <a href="https://alphamanual.audacityteam.org/man/Accessibility">Check current version of this page (development Manual)</a></li></ul></div>
152+
<div align="center"><ul id="f_list"><li>This version created on 2023-11-02 - <a href="https://alphamanual.audacityteam.org/man/Accessibility">Check current version of this page (development Manual)</a></li></ul></div>
152153
</div>
153154
</div>
154155
</body></html>

0 commit comments

Comments
 (0)