Copy Hidden Track One Audio if found

New feature to copy Hidden Track One Audio (HTOA), if it exists. Not all optical drives can read HTOA. Defaults to off.
Resolves #5

Author: poddmo

Makefile

@@ -1,4 +1,4 @@
-abcde_version = abcde-2.11.0
+abcde_version = abcde-2.11.1
 INSTALL = /usr/bin/install -c
 
 prefix = /usr/local

README

@@ -27,6 +27,9 @@ MAJOR CHANGES
 
 (see changelog for more details)
 
+Changes in 2.11.1
+* New feature: read Hidden Track One Audio if found
+
 Changes in 2.11.0
 
 * Updates to FLAC comment tags - Comments are being seperated to User, Disc

README.md

@@ -1,8 +1,9 @@
 # Introduction
 This is a fork of [abcde](https://abcde.einval.com/wiki/):
 > abcde version 2.9.3 is the most recent download and was released on February 5th 2019.
+The starting point for this repository was [2.9.4-DEV](https://git.einval.com/git/abcde.git) with the last commit dated 2021-02-14.
 
-I've ripped many hundreds of CD's with abcde and wanted to fix some bugs and have a go at some enhancements - now up to version 2.11.0 released on April 13th 2025.
+I've ripped many hundreds of CD's with abcde and wanted to fix some bugs and have a go at some enhancements - now up to version 2.11.1 released on April 26th 2025.
 
 My ripping objective is to create lossless music tracks (flac) for listening and also to record as much information from the read process as possible for archival posterity, such as TOC, cue sheet, CD-TEXT, enhanced CD directory listing, media read progress/status/errors and metadata downloaded. Ideally the info should be stored in the audio file metadata.
 
@@ -58,19 +59,19 @@ Your feedback is very welcome. Please open an issue or pull request and I will l
 - Download the latest package or source code from: https://github.com/poddmo/abcde/releases/latest
 ## Package Installation
 ```
-wget https://github.com/poddmo/abcde/releases/download/2.11.0/abcde_2.11.0-1_all.deb
-dpkg -i abcde_2.11.0-1_all.deb
+wget https://github.com/poddmo/abcde/releases/download/2.11.1/abcde_2.11.1-1_all.deb
+dpkg -i abcde_2.11.1-1_all.deb
 ```
 
 ## Source Installation
 Download the source, extract it, create a package from it and then install your fresh package:
 ```
-wget -O abcde_2.11.0.tar.gz https://github.com/poddmo/abcde/archive/refs/tags/2.11.0.tar.gz
-tar zxf abcde_2.11.0.tar.gz
-cd abcde-2.11.0
+wget -O abcde_2.11.1.tar.gz https://github.com/poddmo/abcde/archive/refs/tags/2.11.1.tar.gz
+tar zxf abcde_2.11.1.tar.gz
+cd abcde-2.11.1
 dpkg-buildpackage -us -uc --build=binary
 cd ..
-dpkg -i abcde_2.11.0-1_all.deb
+dpkg -i abcde_2.11.1-1_all.deb
 ```
 
 # Testing

abcde

@@ -11,7 +11,7 @@
 # with this program; if not, write to the Free Software Foundation, Inc.,
 # 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 
-VERSION='2.11.0'
+VERSION='2.11.1'
 
 usage ()
 {
@@ -1120,7 +1120,7 @@ do_tag ()
 					*)   echo COMMENT="$USERCOMMENT";;
 				esac
 			fi
-			# use extended disc info for a FLAC comment tag
+			# use CDDB extended disc info for a FLAC comment tag
 			DISCCOMMENT="$(getcddbinfo DISC-INFO | munge_collapsewhitespace )"
 			if [ -n "$(eval echo '${DISCCOMMENT}')" ]; then
 				vecho DISCCOMMENT is "${DISCCOMMENT}" >&2
@@ -1129,7 +1129,15 @@ do_tag ()
 					*)   echo COMMENT="$DISCCOMMENT";;
 				esac	
 			fi
-			# use extended track info for a FLAC comment tag
+			# abcde generated track comment, eg hidden track notice
+			if [ -n "$(eval echo '${ABCDECOMMENT}')" ]; then
+				vecho ABCDECOMMENT is "${ABCDECOMMENT}" >&2
+				case "$ABCDECOMMENT" in
+					*=*) echo "$ABCDECOMMENT";;
+					*)   echo COMMENT="$ABCDECOMMENT";;
+				esac
+			fi
+			# use CDDB extended track info for a FLAC comment tag
 			COMMENTOUTPUT="$(getcddbinfo TRACK-INFO | munge_collapsewhitespace )"
 			if [ -n "$(eval echo '${COMMENTOUTPUT}')" ]; then
 				vecho COMMENTOUTPUT is "${COMMENTOUTPUT}" >&2
@@ -1983,6 +1991,7 @@ do_playlist ()
 				CDDBTRACKNUM=$(expr $UTRACKNUM - 1) # Unpad
 				getcddbinfo TRACKNAME
 				splitvarious
+				if [ "$UTRACKNUM" = "00" ]; then TRACKNAME="Hidden Track" ; fi
 				TRACKFILE="$(mungetrackname "$TRACKNAME")"
 				ARTISTFILE="$(mungeartistname "$TRACKARTIST")"
 				ALBUMFILE="$(mungealbumname "$DALBUM")"
@@ -2177,7 +2186,7 @@ abcde.mkcue () {
 		printf "  TRACK %02i AUDIO\n" $i
 		if [ "$i" -eq 1 ] && [ "$1" -ne 150 ] ; then
 			if [ "$MODE" = PREGAP ] ; then
-				echomsf "    PREGAP " $(($"OFFSET" - 150))
+				echomsf "    PREGAP " $(("$OFFSET" - 150))
 			else
 				echo    "    INDEX 00 00:00:00"
 			fi
@@ -2338,7 +2347,7 @@ do_discid ()
 			log info "The disc does not contain any tracks. Giving up..."
 			exit 0
 		fi
-		echo -n "Grabbing entire CD - tracks: "
+		echo -n "Grabbing entire CD - "
 		if [ ! "$PADTRACKS" = "y" ] ; then
 			TRACKNUMPADDING=$(echo -n $TRACKS | wc -c | tr -d ' ')
 		fi
@@ -2351,7 +2360,22 @@ do_discid ()
 			TRACKQUEUE="$TRACKQUEUE $PT"
 			X=$(($X + 1))
 		done
-		echo "$TRACKQUEUE"
+
+		# if the pregap to track1 > 150 frames (2 Secs) then there is probably Hidden Track One Audio (HTOA)
+		# cdparanoia can rip it by specifying track zero.
+		if [ "$CDROMREADERSYNTAX" = "cdparanoia" ] ; then
+			if [ "${READHIDDENTRACK:-n}" = "y" ]; then
+				X=$(echo "$CDPARANOIAOUTPUT" | awk '$1=="1." {if ($4 > 150) print "y"; else print "n"};')
+				if [ "$X" = "y" ]; then
+					# hidden track exists so prepend it to TRACKQUEUE
+					echo -n 'Hidden track found - ' >&2
+					X=$(printf "%0.${TRACKNUMPADDING}d" 0)
+					TRACKQUEUE=$(echo $X $TRACKQUEUE)
+				fi
+			fi
+		fi
+
+		echo "Tracks queued: $TRACKQUEUE"
 	else
 		TRACKS=$(echo "$CDDBTRACKINFO" | cut -f2 -d' ')
 		# User-supplied track queue.
@@ -3736,7 +3760,10 @@ do_cdread ()
 	if [ "$1" = "onetrack" ]; then
 		echo "Grabbing ${PIPE_MESSAGE}tracks $UTRACKNUM - $LASTTRACK as one track ..." >&2
 	else
-		if [ -r "$CDDBDATA" ]; then
+		if [ "$UTRACKNUM" = "00" ]; then
+			TRACKNAME="Hidden Track"
+			echo "Grabbing ${PIPE_MESSAGE}track $UTRACKNUM: $TRACKNAME..." >&2 
+		elif [ -r "$CDDBDATA" ]; then
 			getcddbinfo TRACKNAME
 			echo "Grabbing ${PIPE_MESSAGE}track $UTRACKNUM: $TRACKNAME..." >&2
 		else
@@ -3753,6 +3780,8 @@ do_cdread ()
 		cdparanoia|libcdio)
 			if [ "$USEPIPES" = "y" ]; then
 				nice $READNICE $CDROMREADER -"$CDPARANOIACDROMBUS" "$CDROM" "${READTRACKNUMS:-$UTRACKNUM}" "$FILEARG"
+			elif [ "$UTRACKNUM" = "00" ]; then
+				nice $READNICE $CDROMREADER -Z -"$CDPARANOIACDROMBUS" "$CDROM" "${READTRACKNUMS:-$UTRACKNUM}" "$FILEARG" >&2
 			else
 				nice $READNICE $CDROMREADER -"$CDPARANOIACDROMBUS" "$CDROM" "${READTRACKNUMS:-$UTRACKNUM}" "$FILEARG" >&2
 			fi
@@ -4017,6 +4046,7 @@ NOCDDBQUERY=n
 FLACTAGSTARTCASE=n
 FLACTAGALBUMARTISTTAGNAME="ALBUMARTIST"
 FLACTAGALBUMARTISTVALUE="Various Artists"
+READHIDDENTRACK=n
 
 # If using scsi devices, cdda2wav/icedax needs a CDROMID, instead of a device node
 # i.e. CDROMID="1,0,0"
@@ -5670,7 +5700,12 @@ do
 	## FIXME ## Add here
 	## run_command "tagtrack-$OUTPUT-$1" $METAFLAC $METAFLACOPTS ${IMPORTCUESHEET:+--import-cuesheet-from="${ABCDETEMPDIR}/$CUEFILE"} --import-tags-from=- "${ABCDETEMPDIR}/track$1.$FLACOUTPUTCONTAINER"
 	# Set TRACKNUM, TRACKNAME
-	if [ -e "$CDDBDATA" ]; then
+	if [ "$UTRACKNUM" = "00" ]; then
+        	# hidden track one audio
+        	TRACKNAME="Hidden Track"
+        	TRACKARTIST="$DARTIST"
+        	ABCDECOMMENT="Hidden Track One Audio"
+	elif [ -e "$CDDBDATA" ]; then
 		if [ "$ONETRACK" = "y" ]; then
 			TRACKNAME="$DALBUM"
 			TRACKNUM="$FIRSTTRACK"
@@ -5719,6 +5754,9 @@ do
 		fi
 	fi
 	) &
+
+	# Clean up our abcde track comments
+	unset ABCDECOMMENT
 done
 
 

abcde.1

@@ -1,4 +1,4 @@
-.TH abcde 1 "13 April 2025" "abcde 2.11.0"
+.TH abcde 1 "26 April 2025" "abcde 2.11.1"
 .SH NAME
 abcde \- Grab an entire CD and compress it to Ogg/Vorbis, MP3, FLAC, Ogg/Speex, AAC, 
 WavPack, Monkey's Audio (ape), MPP/MP+(Musepack), True Audio (tta), MP2 format
@@ -556,6 +556,10 @@ playlists, etc.
 If set, the resulting playlist will have CR-LF line endings, needed by some
 hardware-based players.
 .TP
+.B READHIDDENTRACK
+If your CD drive can read into the pregap of track 1 then set this to y to  
+copy Hidden Track One Audio (HTOA), if it exists. (Currently only used with cdparanoia)
+.TP
 .B FLACTAGSTARTCASE
 If set to y, artist name, album title and track title FLAC tags will be
 piped through the munge_Startcase function so all words begin with a capital

abcde.conf

@@ -1,12 +1,13 @@
-# System defaults for abcde version 2.11.0
+# System defaults for abcde version 2.11.1
 # Nothing in this file is uncommented by default.
 #
 # If you wish to override these system-wide settings, create your own
 # .abcde.conf file in your home directory.
 
 # Explicitly define the locale character encoding to get consistency across
-# the various utilities
-#export LC_ALL=en_AU.UTF-8
+# the various utilities. Be sure to update this to your locale.
+# Use the locale command to find your current settings.
+#export LC_ALL=en_US.UTF-8
 
 # CDDB options
 
@@ -138,6 +139,11 @@
 #READNICE=10
 #DISTMP3NICE=10
 
+# Copy Hidden Track One Audio (HTOA) if it exists.
+# If your CD drive can read into the pregap of track 1 then set this to y:
+# (Currently only used with cdparanoia)
+#READHIDDENTRACK=n
+
 # Paths of programs to use
 
 # Encoders: