Recent changes to Settings Panel

Settings Panel modified by Alexander Groß

Alexander Groß — Wed, 01 Aug 2018 16:07:36 -0000

--- v7
+++ v8
@@ -21,7 +21,7 @@
     * **with constant bitrate:** The bitrate to use for constant bitrate encoded mp3-files.
     * **with quality:** The quality to use for variable bitrate encoded mp3-files.
 * **Normalize track volume:** Adjust the volume of every track so that they sounds similar (see [ffmpeg](http://ffmpeg.org/ffmpeg-filters.html#volume) and [aacgain](http://aacgain.altosdesign.com) for details), ffmpeg and aacgain avoid clipping of the peaks when setting the gain.
-    * **modify gain by:** Set the desired volume adjutsment, this could be a negative or positive float in increments of 0.5, you can set the modification in a range of -10.0 to +10.0. Be aware, that output values are clipped to the maximum value when using this feature when encoding.
+    * **modify gain by:** Set the desired volume adjutsment in decibel, this could be a negative or positive float in increments of 0.5, you can set the modification in a range of -10.0 to +10.0. Be aware, that output values are clipped to the maximum value when using this feature when encoding.

 Mostly you will use exported tracks on a mp3-player or on a stick for use in your car, so it's not useful to have the same quality as in iTunes, so you can lower the bitrate to save space.

Settings Panel modified by Alexander Groß

Alexander Groß — Wed, 01 Aug 2018 16:07:00 -0000

--- v6
+++ v7
@@ -17,11 +17,11 @@

 [[img src=SettingsEncodingRC3.jpg alt=SettingsEncodingRC3.jpg]]

-* **Reencode tracks:** Forces re-encoding of every track exported. Use this setting if you want to have a lower quality or to save space on the target device. If this setting is not checked, only tracks, which are not mp3-file, are re-encoded.
+* **Reencode tracks:** Forces re-encoding of every track exported. Use this setting if you want to have a lower quality or to save space on the target device. If this setting is not checked, only tracks, which are not mp3-file, are re-encoded to there average bitrate with VBR mode.
     * **with constant bitrate:** The bitrate to use for constant bitrate encoded mp3-files.
     * **with quality:** The quality to use for variable bitrate encoded mp3-files.
-* **Gain track volume:** Adjust the volume of every track to given dB.
-    * **allow clipping:** Allow clipping of high peaks when adjusting volume (not recommended)
+* **Normalize track volume:** Adjust the volume of every track so that they sounds similar (see [ffmpeg](http://ffmpeg.org/ffmpeg-filters.html#volume) and [aacgain](http://aacgain.altosdesign.com) for details), ffmpeg and aacgain avoid clipping of the peaks when setting the gain.
+    * **modify gain by:** Set the desired volume adjutsment, this could be a negative or positive float in increments of 0.5, you can set the modification in a range of -10.0 to +10.0. Be aware, that output values are clipped to the maximum value when using this feature when encoding.

 Mostly you will use exported tracks on a mp3-player or on a stick for use in your car, so it's not useful to have the same quality as in iTunes, so you can lower the bitrate to save space.

Settings Panel modified by Alexander Groß

Alexander Groß — Wed, 01 Aug 2018 16:00:23 -0000

--- v5
+++ v6
@@ -15,7 +15,7 @@

 This tab configures the way how the tracks are encoded.

-[[img src=SettingsEncoding.jpg alt=SettingsEncoding.jpg]]
+[[img src=SettingsEncodingRC3.jpg alt=SettingsEncodingRC3.jpg]]

 * **Reencode tracks:** Forces re-encoding of every track exported. Use this setting if you want to have a lower quality or to save space on the target device. If this setting is not checked, only tracks, which are not mp3-file, are re-encoded.
     * **with constant bitrate:** The bitrate to use for constant bitrate encoded mp3-files.

Settings Panel modified by Alexander Groß

Alexander Groß — Mon, 18 Jun 2018 13:34:25 -0000

--- v4
+++ v5
@@ -4,12 +4,12 @@

 ## Structure

-The Structure Tab manages the setting which configures the how the files where organized in the target folder.
+The Structure Tab manages the setting which configures how the files where organized in the target folder.

 [[img src=SettingsStructure.jpg alt=SettingsStructure.jpg]]

-* **Create folders:** If you select **None** alls track files will be placed inside the target folder whith no structure, selecting **Playlists** will create a seperate folder for each playlist, where the file are stored (it's possible, that the same track, which appears in different playlists, is copied or encoded several times.
-* **Number Tracks**: If this setting is checked, every mp3-file is prefixed with the track number of it's occurrence in the playlist. You can choose where to start with the numbering and the leading zeros of the digits.
+* **Create folders:** If you select **None** all track files will be placed inside the target folder with no structure, selecting **Playlists** will create a separate folder for each playlist, where the file are stored (it's possible, that the same track, which appears in different playlists, is copied or encoded several times.
+* **Number Tracks**: If this setting is checked, every mp3-file is prefixed with the track number of its occurrence in the playlist. You can choose where to start with the numbering and the leading zeros of the digits.

 ## Encoding

@@ -17,7 +17,7 @@

 [[img src=SettingsEncoding.jpg alt=SettingsEncoding.jpg]]

-* **Reencode tracks:** Forces re-encoding of every track exported. Use this setting if you want to have a lower quality or to save space on the target device. If this setting is not checked, only tracks, which are not an mp3-file, are re-encoded.
+* **Reencode tracks:** Forces re-encoding of every track exported. Use this setting if you want to have a lower quality or to save space on the target device. If this setting is not checked, only tracks, which are not mp3-file, are re-encoded.
     * **with constant bitrate:** The bitrate to use for constant bitrate encoded mp3-files.
     * **with quality:** The quality to use for variable bitrate encoded mp3-files.
 * **Gain track volume:** Adjust the volume of every track to given dB.
@@ -31,9 +31,9 @@

 [[img src=SettingsPlaylist.jpg alt=SettingsPlaylist.jpg]]

-* **Create M3U playlists:** If checked this setting produces a M3U playlist in the top-level of your folder structure. M3U playlists are text files, which organizes the tracks. Which kind of playlist you use is mostly a question of what your player supports.
+* **Create M3U playlists:** If checked this setting produces a M3U playlist in the top-level of your folder structure. M3U playlists are text files, which organizes the tracks. What kind of playlist you use is mostly a question of what your player supports.
     * **M3U:** Standard for most players.
-    * **M3UEXT:** Extended M3U playlist, provides more information about a song (not soppurted by any device).
+    * **M3UEXT:** Extended M3U playlist, provides more information about a song (not supported by any device).
     * **M3U8:** Extended M3U playlist encoded in UTF-8 (not supported by any device).
 * **Prefix file path:** Some players requires, that the file path is prefixed, e.g. C:  or file:/ . Consult your players documentation for details.
 * **Path separator:** The path separator depends on your player, so please consult the documentation (standard / )
@@ -45,7 +45,7 @@
 [[img src=SettingsTagging.jpg alt=SettingsTagging.jpg]]

 * **Rename Files:** Renames the exported files to the track title stored in ID3 tags.
-    * **Save File Names:** Make the changed name file system save by elemination any non-ascii character.
+    * **Save File Names:** Make the changed name file system save by elimination any non-ascii character.
     * **Character Set:** **strict-ascii** only ascii character are used, **loose-ascii** ascii characters and some punctuation characters are used. It depends on the player. 
 * **Change ID3 track tag:** Changes the ID3 track number tag to the track number used for numbering the file.
 * **Add track number to ID3 Title:** Prefixes the ID3 title with the track number.
@@ -54,7 +54,7 @@

 ## Application

-These are some settings changing the behaviour of iTunesExport.
+These are some settings changing the behavior of iTunesExport.

 [[img src=SettingsApp.jpg alt=SettingsApp.jpg]]

Settings Panel modified by Alexander Groß

Alexander Groß — Mon, 18 Jun 2018 12:17:24 -0000

--- v3
+++ v4
@@ -4,4 +4,62 @@

 ## Structure

+The Structure Tab manages the setting which configures the how the files where organized in the target folder.

+[[img src=SettingsStructure.jpg alt=SettingsStructure.jpg]]
+
+* **Create folders:** If you select **None** alls track files will be placed inside the target folder whith no structure, selecting **Playlists** will create a seperate folder for each playlist, where the file are stored (it's possible, that the same track, which appears in different playlists, is copied or encoded several times.
+* **Number Tracks**: If this setting is checked, every mp3-file is prefixed with the track number of it's occurrence in the playlist. You can choose where to start with the numbering and the leading zeros of the digits.
+
+## Encoding
+
+This tab configures the way how the tracks are encoded.
+
+[[img src=SettingsEncoding.jpg alt=SettingsEncoding.jpg]]
+
+* **Reencode tracks:** Forces re-encoding of every track exported. Use this setting if you want to have a lower quality or to save space on the target device. If this setting is not checked, only tracks, which are not an mp3-file, are re-encoded.
+    * **with constant bitrate:** The bitrate to use for constant bitrate encoded mp3-files.
+    * **with quality:** The quality to use for variable bitrate encoded mp3-files.
+* **Gain track volume:** Adjust the volume of every track to given dB.
+    * **allow clipping:** Allow clipping of high peaks when adjusting volume (not recommended)
+
+Mostly you will use exported tracks on a mp3-player or on a stick for use in your car, so it's not useful to have the same quality as in iTunes, so you can lower the bitrate to save space.
+
+## Playlists
+
+Configures which kind of playlist is used and customizes the path specifications, which depends on the kind of player used for playback.
+
+[[img src=SettingsPlaylist.jpg alt=SettingsPlaylist.jpg]]
+
+* **Create M3U playlists:** If checked this setting produces a M3U playlist in the top-level of your folder structure. M3U playlists are text files, which organizes the tracks. Which kind of playlist you use is mostly a question of what your player supports.
+    * **M3U:** Standard for most players.
+    * **M3UEXT:** Extended M3U playlist, provides more information about a song (not soppurted by any device).
+    * **M3U8:** Extended M3U playlist encoded in UTF-8 (not supported by any device).
+* **Prefix file path:** Some players requires, that the file path is prefixed, e.g. C:  or file:/ . Consult your players documentation for details.
+* **Path separator:** The path separator depends on your player, so please consult the documentation (standard / )
+
+## Tagging
+
+Regards to the ID3 tagging of the mp3-files exported.
+
+[[img src=SettingsTagging.jpg alt=SettingsTagging.jpg]]
+
+* **Rename Files:** Renames the exported files to the track title stored in ID3 tags.
+    * **Save File Names:** Make the changed name file system save by elemination any non-ascii character.
+    * **Character Set:** **strict-ascii** only ascii character are used, **loose-ascii** ascii characters and some punctuation characters are used. It depends on the player. 
+* **Change ID3 track tag:** Changes the ID3 track number tag to the track number used for numbering the file.
+* **Add track number to ID3 Title:** Prefixes the ID3 title with the track number.
+
+These settings are not very common and are only useful in specific cases.
+
+## Application
+
+These are some settings changing the behaviour of iTunesExport.
+
+[[img src=SettingsApp.jpg alt=SettingsApp.jpg]]
+
+The settings are mostly self explaining and concern to warnings displayed by the application. 
+
+The **Verbosity** setting only appears in **Beta** releases, it will be removed in production.
+
+[iTunesExport Help]([iTunesExportHelp])

Settings Panel modified by Alexander Groß

Alexander Groß — Mon, 18 Jun 2018 11:43:36 -0000

--- v2
+++ v3
@@ -2,4 +2,6 @@

 The settings panel provides access to the application preferences.

-## 
+## Structure
+
+

Settings Panel modified by Alexander Groß

Alexander Groß — Mon, 18 Jun 2018 11:42:57 -0000

Settings Panel modified by Alexander Groß

Alexander Groß — Mon, 18 Jun 2018 11:42:28 -0000

The Settings Panel

The settings panel provides access to the application preferences.