v4.0.3 – New default

CHANGELOG.md

@@ -1,5 +1,11 @@
 # autocue changelog
 
+### 2024-06-18 – v4.0.3
+
+- Changed default of `-x`/`--extra` and `settings.autocue.cue_file.overlay_longtail` from `-15.0` LU to `-12.0 LU`, requested by @RM-FM and the community. Together with the `-d`/`--drop` default change from `60.0` to `40.0`, this makes for a "tighter" playout and doesn’t lose too much of long or sustained endings.
+- Updated README and Presentation as well, to reflect the new default.
+
+
 ### 2024-06-16 – v4.0.2
 
 #### Bug fixes, enhancements

README.md

@@ -116,7 +116,7 @@ Here is a complete list you can copy, showing the default settings:
 # settings.autocue.cue_file.silence := -42.0  # LU below track loudness
 # settings.autocue.cue_file.overlay := -8.0  # LU below track loudness
 # settings.autocue.cue_file.longtail := 15.0  # seconds
-# settings.autocue.cue_file.overlay_longtail := -15.0  # extra LU
+# settings.autocue.cue_file.overlay_longtail := -12.0  # extra LU
 # settings.autocue.cue_file.sustained_loudness_drop := 40.0  # max. percent drop to be considered sustained
 # settings.autocue.cue_file.noclip := false  # clipping prevention like loudgain's `-k`
 # settings.autocue.cue_file.blankskip := 0.0  # skip silence in tracks
@@ -172,7 +172,7 @@ options:
                         endings intact (default: 15.0)
   -x EXTRA, --extra EXTRA
                         Extra LU below overlay loudness to trigger next track
-                        for songs with long tail (default: -15.0)
+                        for songs with long tail (default: -12.0)
   -d DROP, --drop DROP  Max. percent loudness drop at the end to be still
                         considered having a sustained ending. Such tracks will
                         be recalculated using --extra, keeping the song ending
@@ -314,7 +314,7 @@ We can see this would destroy an important part of the song’s end.
 
 #### <a name="a-long-tail"></a>A long tail! <a href="#toc" class="goToc">⇧</a>
 
-Finding that the calculated cross duration of `16.5` seconds is longer than 15 seconds (the `-l`/`--longtail` parameter), `cue_file` now _recalculates the overlay start position_ automatically, using an extra -15 LU loudness offset (`-x`/`--extra` parameter), and arrives at this:
+Finding that the calculated cross duration of `16.5` seconds is longer than 15 seconds (the `-l`/`--longtail` parameter), `cue_file` now _recalculates the overlay start position_ automatically, using an extra -15 LU loudness offset (`-x`/`--extra` parameter, defaults to `-12` in v4.0.3+), and arrives at this:
 
 ![Screenshot of Bohemian Rhapsody waveform, showing the newly calculated cross duration: 4.5 seconds before end – just right, not cutting off important parts of the song ending](https://github.com/Moonbase59/autocue/assets/3706922/9f9ec3af-89d4-4edc-9316-d53ed1fcf000)
 
@@ -372,7 +372,7 @@ settings.autocue.cue_file.target := -18.0  # LUFS
 settings.autocue.cue_file.silence := -42.0  # LU below track loudness
 settings.autocue.cue_file.overlay := -8.0  # LU below track loudness
 settings.autocue.cue_file.longtail := 15.0  # seconds
-settings.autocue.cue_file.overlay_longtail := -15.0  # extra LU
+settings.autocue.cue_file.overlay_longtail := -12.0  # extra LU
 settings.autocue.cue_file.sustained_loudness_drop := 40.0  # max. percent drop to be considered sustained
 settings.autocue.cue_file.noclip := false  # clipping prevention like loudgain's `-k`
 settings.autocue.cue_file.blankskip := 0.0  # skip silence in tracks

autocue.cue_file.liq

@@ -35,6 +35,8 @@
 #                           the user-defined settings.
 # 2024-06-15 - Moonbase59 - v4.0.1 - Sync with cue_file version
 # 2024-06-16 - Moonbase59 - v4.0.2 - Allow `-8.33dB` type values with no blank
+# 2024-06-18 - Moonbase59 - v4.0.3 - Changed overlay_longtail from -15 to -12,
+#                           most people seem to want transitions a bit tighter
 
 # Lots of debugging output for AzuraCast in this, will be removed eventually.
 
@@ -48,7 +50,7 @@ let settings.autocue.cue_file.version =
   settings.make(
     description=
       "Software version of autocue.cue_file. Should coincide with `cue_file`.",
-    "4.0.2"
+    "4.0.3"
   )
 
 # Internal only! Not a user setting.
@@ -121,7 +123,7 @@ let settings.autocue.cue_file.overlay_longtail =
     description=
       "Extra LU level below overlay loudness, to recalculate songs with long \
        tails.",
-    -15.0
+    -12.0
   )
 
 let settings.autocue.cue_file.sustained_loudness_drop =

cue_file

@@ -56,13 +56,15 @@
 #                       - Use max. LUGS of longtail & right end for sustained
 #                       - Default SUSTAINED_LOUDNESS_DROP to 40.0% instead of 60.0%,
 #                         for slightly tighter/denser playout (community wish)
+# 2024-06-18 Moonbase59 - v4.0.3 Change LONGTAIL_EXTRA_LU from -15 to -12,
+#                         most people seem to want transitions a bit tighter
 #
 # Originally based on an idea and some code by John Warburton (@Warblefly):
 #   https://github.com/Warblefly/TrackBoundaries
 # Some collaborative work with RM-FM (@RM-FM): Sustained ending analysis.
 
 __author__ = 'Matthias C. Hormann'
-__version__ = '4.0.2'
+__version__ = '4.0.3'
 
 import os
 import sys
@@ -109,7 +111,7 @@ SILENCE = -42.0  # LU below average for cue-in/cue-out trigger ("silence")
 OVERLAY_LU = -8.0  # LU below average for overlay trigger (start next song)
 # more than LONGTAIL_SECONDS below OVERLAY_LU are considered a "long tail"
 LONGTAIL_SECONDS = 15.0
-LONGTAIL_EXTRA_LU = -15.0  # reduce 15 dB extra on long tail songs to find overlap point
+LONGTAIL_EXTRA_LU = -12.0  # reduce 15 dB extra on long tail songs to find overlap point
 SUSTAINED_LOUDNESS_DROP = 40.0  # max. percent drop to be considered sustained
 BLANKSKIP = 5.0  # min. seconds silence to detect blank
 NICE = False  # use Linux/MacOS nice?

docs/presentation/autocue.html

@@ -356,7 +356,7 @@ <h2>Long tails</h2>
 <li>Check if calculated overlay duration &gt; <strong>15 s</strong> (a
 “long tail”).</li>
 <li><code>settings.autocue.cue_file.longtail</code></li>
-<li>If so, reduce overlay level by an extra <strong>-15 LU</strong> and
+<li>If so, reduce overlay level by an extra <strong>-12 LU</strong> and
 repeat the calculation.</li>
 <li><code>settings.autocue.cue_file.overlay_longtail</code></li>
 <li>We now start the next song much later, keeping the song’s “long
@@ -550,7 +550,7 @@ <h1>Settings</h1>
 # settings.autocue.cue_file.silence := -42.0  # LU below track loudness
 # settings.autocue.cue_file.overlay := -8.0  # LU below track loudness
 # settings.autocue.cue_file.longtail := 15.0  # seconds
-# settings.autocue.cue_file.overlay_longtail := -15.0  # extra LU
+# settings.autocue.cue_file.overlay_longtail := -12.0  # extra LU
 # settings.autocue.cue_file.sustained_loudness_drop := 40.0  # max. percent drop to be considered sustained
 # settings.autocue.cue_file.noclip := false  # clipping prevention like loudgain&#39;s `-k`
 # settings.autocue.cue_file.blankskip := 0.0  # skip silence in tracks

docs/presentation/autocue.md

@@ -231,7 +231,7 @@ _Nirvana: Something in the Way / Endless, Nameless_
 
 - Check if calculated overlay duration > **15 s** (a "long tail").
 - `settings.autocue.cue_file.longtail`
-- If so, reduce overlay level by an extra **-15 LU** and repeat the calculation.
+- If so, reduce overlay level by an extra **-12 LU** and repeat the calculation.
 - `settings.autocue.cue_file.overlay_longtail`
 - We now start the next song much later, keeping the song’s "long tail" intact!
 - `liq_longtail` shows if a long tail was detected.
@@ -391,7 +391,7 @@ You _can_ fine-tune everything, but the defaults are great for nearly all use ca
 # settings.autocue.cue_file.silence := -42.0  # LU below track loudness
 # settings.autocue.cue_file.overlay := -8.0  # LU below track loudness
 # settings.autocue.cue_file.longtail := 15.0  # seconds
-# settings.autocue.cue_file.overlay_longtail := -15.0  # extra LU
+# settings.autocue.cue_file.overlay_longtail := -12.0  # extra LU
 # settings.autocue.cue_file.sustained_loudness_drop := 40.0  # max. percent drop to be considered sustained
 # settings.autocue.cue_file.noclip := false  # clipping prevention like loudgain's `-k`
 # settings.autocue.cue_file.blankskip := 0.0  # skip silence in tracks

test_autocue.cue_file.liq

@@ -38,7 +38,7 @@ settings.autocue.cue_file.timeout := 120.0
 # settings.autocue.cue_file.silence := -42.0
 # settings.autocue.cue_file.overlay := -8.0
 # settings.autocue.cue_file.longtail := 15.0
-# settings.autocue.cue_file.overlay_longtail := -15.0
+# settings.autocue.cue_file.overlay_longtail := -12.0
 # settings.autocue.cue_file.sustained_loudness_drop := 40.0
 settings.autocue.cue_file.noclip := true  # clipping prevention
 settings.autocue.cue_file.blankskip := 5.0