[#46] Extract CD/SACD (ISO)

Author: jesperpedersen

CMakeLists.txt

@@ -99,6 +99,13 @@ else()
   message(FATAL_ERROR "gtk3 needed")
 endif()
 
+pkg_check_modules(CDIO REQUIRED libcdio)
+if (CDIO_FOUND)
+  message(STATUS "libcdio found")
+else()
+  message(FATAL_ERROR "libcdio needed")
+endif()
+
 find_package(Rst2man)
 if (RST2MAN_FOUND)
   message(STATUS "rst2man found")

doc/CLI.md

@@ -19,6 +19,7 @@ Options:
   -I, --sample-configuration Generate a sample configuration
   -i, --interactive          Text UI mode
   -m, --metadata             Display metadata of the files
+  -e, --extract              Extract ISO file
   -s, --status               Status of the devices
       --dop                  Use DSD over PCM
   -q, --quiet                Quiet the player
@@ -97,6 +98,22 @@ Display metadata information about the files
 hrmp -m
 ```
 
+## -e
+
+Extract supported disc images or devices instead of playing them.
+
+Currently this mode accepts:
+
+* device paths under `/dev/...` for Red Book extraction
+* `.iso` files for Scarlet Book extraction
+
+Any other input is rejected as unsupported.
+
+```sh
+hrmp -e /dev/sr0
+hrmp -e my-disc.iso
+```
+
 ## -s
 
 Show the status of the configured devices

doc/GETTING_STARTED.md

@@ -20,6 +20,7 @@ Options:
   -I, --sample-configuration Generate a sample configuration
   -i, --interactive          Text UI mode
   -m, --metadata             Display metadata of the files
+  -e, --extract              Extract ISO file
   -s, --status               Status of the devices
       --dop                  Use DSD over PCM
   -q, --quiet                Quiet the player

doc/man/hrmp.1.rst

@@ -45,6 +45,9 @@ OPTIONS
 -m, --metadata
   Display metadata of the files
 
+-e, --extract
+  Extract supported disc devices or ``.iso`` files instead of playing them
+
 -s, --status
   Status of the devices
 

doc/manual/04-getting_started.md

@@ -22,6 +22,7 @@ Options:
   -I, --sample-configuration Generate a sample configuration
   -i, --interactive          Text UI mode
   -m, --metadata             Display metadata of the files
+  -e, --extract              Extract ISO file
   -s, --status               Status of the devices
       --dop                  Use DSD over PCM
   -q, --quiet                Quiet the player

doc/manual/05-cli.md

@@ -21,6 +21,7 @@ Options:
   -I, --sample-configuration Generate a sample configuration
   -i, --interactive          Text UI mode
   -m, --metadata             Display metadata of the files
+  -e, --extract              Extract ISO file
   -s, --status               Status of the devices
       --dop                  Use DSD over PCM
   -q, --quiet                Quiet the player
@@ -99,6 +100,22 @@ Display metadata information about the files
 hrmp -m
 ```
 
+## -e
+
+Extract supported disc images or devices instead of playing them.
+
+Currently this mode accepts:
+
+* device paths under `/dev/...` for Red Book extraction
+* `.iso` files for Scarlet Book extraction
+
+Any other input is rejected as unsupported.
+
+```sh
+hrmp -e /dev/sr0
+hrmp -e my-disc.iso
+```
+
 ## -s
 
 Show the status of the configured devices

src/CMakeLists.txt

@@ -23,6 +23,7 @@ include_directories(
   ${LIBSNDFILE_INCLUDE_DIR}
   ${OPUS_INCLUDE_DIRS}
   ${FAAD2_INCLUDE_DIRS}
+  ${CDIO_INCLUDE_DIRS}
 )
 
 #
@@ -34,6 +35,7 @@ link_libraries(
   ${LIBSNDFILE_LIBRARY}
   ${OPUS_LIBRARIES}
   ${FAAD2_LIBRARIES}
+  ${CDIO_LIBRARIES}
 )
 
 set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -Wl,--no-undefined")

src/include/extract.h

@@ -0,0 +1,43 @@
+/*
+ * Copyright (C) 2026 The HighResMusicPlayer community
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+#ifndef HRMP_EXTRACT_H
+#define HRMP_EXTRACT_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <hrmp.h>
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdlib.h>
+
+/**
+ * Extract a device or a file
+ * @param d The device
+ * @return 0 upon success, otherwise 1
+ */
+int
+hrmp_extract(char* d);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

src/include/hrmp.h

@@ -43,9 +43,9 @@ extern "C" {
 #define UPDATE_PROCESS_TITLE_MINIMAL 2
 #define UPDATE_PROCESS_TITLE_VERBOSE 3
 
-#define HRMP_CACHE_FILES_OFF     0
-#define HRMP_CACHE_FILES_MINIMAL 1
-#define HRMP_CACHE_FILES_ALL     2
+#define HRMP_CACHE_FILES_OFF         0
+#define HRMP_CACHE_FILES_MINIMAL     1
+#define HRMP_CACHE_FILES_ALL         2
 
 #define DEFAULT_BUFFER_SIZE          131072
 #define ALIGNMENT_SIZE               512

src/include/redbook.h

@@ -0,0 +1,43 @@
+/*
+ * Copyright (C) 2026 The HighResMusicPlayer community
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+#ifndef HRMP_REDBOOK_H
+#define HRMP_REDBOOK_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <hrmp.h>
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdlib.h>
+
+/**
+ * Extract a device
+ * @param d The device
+ * @return 0 upon success, otherwise 1
+ */
+int
+hrmp_extract_redbook(char* d);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif