Software Setup User Guide
The DomesdayDuplicator application is a complete graphical user interface for the Domesday Duplicator USB 3.0 capture device. The application is designed for the Ubuntu distribution and is GPLv3 open-source. The application supports one-click LaserDisc RF capture as well as a host of additional features for more advanced capture requirements and control automation.
The DomesdayDuplicator Application
As well as supporting high-speed USB 3.0 communication with the Domesday Duplicator board, the application also provides advanced serial control of the Pioneer LD-V4300D and CLD-V2800 LaserDisc players.
Serial control allows the application to provide fully automatic capture of LaserDiscs either in part or as a whole.
The developed for environment for the application is currently Ubuntu 20.04 LTS. The application usually works well on other GNU/Linux distributions alongside MacOS and Windows.
If you are reporting a problem, please try to reproduce it in the supported environment first.
Windows Installation
There is already pre-compiled ready to deploy
Simply install the WinUSB driver via ZigZag and no further setup is required.
MacOS Installation
Tested on macOS 14 Sonoma
brew install qt@5 libusb
mkdir ~/github
cd ~/github
git clone https://github.com/simoninns/DomesdayDuplicator
cd ~/github/DomesdayDuplicator/Linux-Application
cmake -DQT_DIR=/opt/homebrew/opt/qt@5/lib/cmake/Qt5 -DQt5_DIR=/opt/homebrew/opt/qt@5/lib/cmake/Qt5 -DCMAKE_INSTALL_PREFIX=/Applications .
make -j8
make install
Linux Installation
Currently there is no appimage for the DdD app and building it with cmake is required alongside setup.
To compile the software on Ubuntu 22.04, (and simmaler Linux builds) you will need to run the following command to install the required dependencies:
sudo apt install --no-install-recommends git cmake libgl-dev qt6-base-dev libqt6serialport6-dev libusb-1.0-0-dev qt6-multimedia-dev build-essential
The application source-code is available from the Domesday86 project Github. It is recommended to install the application under the home directory of your Ubuntu user account. To get a copy of the application's source code, use the following commands from the Ubuntu terminal window:
git clone https://github.com/simoninns/DomesdayDuplicator
Once the software is downloaded, simply issue the following commands to compile the application:
cd ~/DomesdayDuplicator/Linux-Application
cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo .
make -j8
sudo make install
This will allow you to run the application using the following command:
~/DomesdayDuplicator/Linux-Application/DomesdayDuplicator/DomesdayDuplicator &
By default CMake will install into /usr/local. To install into /some/dir instead, add -DCMAKE_INSTALL_PREFIX=/some/dir to the cmake command.
In order for the GUI application to connect to the Domesday Duplicator USB device it is necessary to provide permissions for user-level access. For this you need to create a file called 40-domesdayduplicator.rules in the /etc/udev/rules.d directory (requires root permissions). The contents of the file should be as follows:
# 1d50:603b - Domesday Duplicator
SUBSYSTEM=="usb", ATTRS{idVendor}=="1d50", ATTRS{idProduct}=="603b", MODE="0666"
Once the file has been created, issue the following command to reload the USB configuration rules:
sudo udevadm control --reload-rules
If you wish to use the automatic capture feature a serial connection between the Ubuntu PC and the laser video disc player is required (you will need an appropriate cable and USB to RS232 adapter). In order to access a serial device the Ubuntu user account must given the 'dialout' group permissions. This can be added to the current user account using the following command:
sudo usermod -a -G dialout $USER
Note that this permission does not become active until the user account has logged out and logged back in again.
The DomesdayDuplicator application will automatically make use of real-time scheduling, if it is available on your system. When capturing data over USB, the application sets the capture thread to have real-time priority, so the operating system will run it before other threads that are trying to use the CPU -- this makes it less likely that capture will fail because the application could not service USB transfers quickly enough.
Similarly, the application tries to lock its capture buffers into RAM -- this stops the operating system from paging them out to disk when memory is required for other programs or disk cache.
Real-time scheduling and memory locking are commonly used by audio and video applications, so most distributions either enable them by default or have an easy way to do so. See JACK: How do I configure real-time scheduling? for a detailed guide.
The duplicator has only one point of physical control this is a 4 DIP switch that controls the gain state of the amplifier.
0000 is 1-2-3-4 dips, In orientation to bottom numbers up is 1 and down is 0
All selected in this up position is 1111 or 2.02 Minimum Gain When dip’s 2-3-4 are down it's 1000 this is the maximum gain of 8.5, the table below shows all possible positions.
| Configuration | Switch Position | Gain |
|---|---|---|
| 15 | 1111 | 2.02 |
| 7 | 0111 | 2.17 |
| 11 | 1011 | 2.27 |
| 13 | 1101 | 2.45 |
| 3 | 0011 | 2.54 |
| 14 | 1110 | 2.59 |
| 5 | 0101 | 2.79 |
| 6 | 0110 | 3.02 |
| 9 | 1001 | 3.04 |
| 10 | 1010 | 3.34 |
| 1 | 0001 | 3.8 |
| 12 | 1100 | 4 |
| 2 | 0010 | 4.4 |
| 4 | 0100 | 6 |
| 8 | 1000 | 8.5 |
The first time you use the Domesday Duplicator application, it is important to ensure that your configuration is correct. To configure the application simply select 'Edit' from the menu bar and click on 'Preferences'. You will see the following window:
Domesday Duplicator - Preferences - Capture
Firstly, configure your desired capture directory. When you capture LaserDiscs using the application, the files are automatically named and placed in a single target directory. Create a directory called 'Capture' using the file explorer in Ubuntu and then, in the preferences window, click on 'Browse'. You should then use the file dialogue to select your capture directory. Once selected the file path will be shown in the preferences window.
The Domesday Duplicator supports two different capture formats.
The '10-bit packed unsigned data' is recommended as it provides the smallest possible file size for captures.
The '16-bit signed scaled data' format uses more disk space, but is directly compatible with sample editors such as Audacity and is therefore useful when setting up, testing a capture system or analysing results from a capture.
Of note 10-bit Packed to 16-bit FLAC (.lds to .ldf) is the most read/write and space saving workflow and editor compatible.
All builds after 2023 now include amplitude messuremetn taking 1000 samples of data producing realtime graphing using mean amplitude (QCP) levels this tells you the level of your signal.
-
0 Nothing
-
0.5 Decent Level
-
1 Signal Clipped.
The second tab in the preferences window is the USB configuration as shown in the following picture:
Domesday Duplicator - Preferences - USB
This window allows you to change the VID and PID of the capture USB device. For normal use it's recommended to leave these values as per the default.
The third tab in the preferences window is the Player Control configuration as shown in the following picture:
Domesday Duplicator - Preferences - Player control
This window allows you to configure the application for player control (if you have a supported player and the necessary serial hardware).
The serial device drop-down box lists the available serial devices seen by the application. All serial devices available on your computer will be listed; ensure you select the right device for your player's serial connection.
The serial speed sets the speed at which the application will communicate with the player. This is generally 4800 or 9600 depending on your player, however it is possible to set different speeds on the player, so it is prudent to check the configuration of the player according to the user-manual.
The player model drop-down allows you to select the type of player you have connected. Currently the supported players are the Pioneer LD-V4300D and the Pioneer CLD-V2800.
Once you have finished setting your preferences you can simply click 'Save' in order to store the settings on your machine (the application will remember them between uses). If you want to exit the preferences window without saving, click 'Cancel'. The 'Restore Defaults' button will set the preferences to their default values.
To capture a LaserDisc (or part of a LaserDisc) with the application the player should be set up either ready to play or with the player on still-frame/pause at the required start address of the disc. There is no need to configure the application for CAV/CLV or PAL/NTSC since all capture is performed at the same speed by the Duplicator board.
You should ensure that the Domesday Duplicator board is correctly connected to the host PC and that the application shows "Domesday Duplicator is connected via USB" in the status bar of the main application window.
Once the player and Duplicator board are ready, simply click the 'Start Capture' button in the application. During capture the button will turn red as shown in the following picture:
Capturing a LaserDisc
Note that the 'player information' is only available if the player is connected via serial to the application.
During capture the application shows the capture duration (in hh:mm:ss format), the number of USB transfers that have been performed and the approximate size of the capture file in MiBs.
To stop the capture click again on the red button; the application will stop the capture process and write out the remaining data to the capture file. The capture file will be located in the capture directory (defined in Preferences->Capture) and will have a file-name automatically assigned as follows:
RF-Sample_yyyy-MM-dd_hh-mm-ss.lds
Where yyyy-MM-dd is the date and hh-mm-ss is the time at which the capture started. The file extension '.lds' is based on the configured capture file format. The files will be '.lds' for 10-bit packed (Laser Disc Sample) and '.raw' for 16-bit signed captures (for compatibility with sample editing software).
If you wish to limit the maximum duration of a capture, simply tick the 'Limit Duration' check box and enter the required maximum capture length in hh:mm:ss format before starting the capture. The application will automatically stop the capture and save the file once the specified duration has elapsed.
If you wish to have more control over the file names used when performing captures, the application provides an advanced file naming dialogue that provides more options. To open the window select 'View' from the menu bar and then click on 'Advanced naming'. The following window is shown:
The advanced capture naming window
Simply tick the check-boxes next to the extra information you would like to include and select from either the available options or type in the text box as appropriate (note that the text box entries are limited to A-Z, a-z, 0-9, space, minus and underscore). The advance capture naming mechanism provides the ability to add more detail to the capture files name whilst maintaining a standard file-naming convention to make it easier to sort and identify captures. The format of the capture file name (with all advanced options selected) is as follows:
Disc title_Disc type_format_Disc side_notes_date_time.lds
So the example shown above would produce a file name similar to the following:
Jason and the Argonauts_CAV_PAL_side4_Testcard3_2018-10-10_10-22-34.lds
Any parts which are not selected are simply omitted from the file name. Note that the settings in the advanced capture naming window apply even if you close the window. To return to the default file name convention, simply clear the check boxes.
For testing purposes the Domesday Duplicator hardware provides a function where the RF capture data is replaced by a pattern of data generated by the Duplicator board itself. This can be useful (along with the 16-bit capture format) for verifying the Domesday Duplicator board before attempting to connect to a LaserDisc player's RF output. To enable the test data generation simply click on the option in the 'Edit' menu as shown in the following picture:
Test data mode selection
For normal capture operation the 'Test mode' check-box should remain unchecked. If you check the 'Test mode' option, the capture button will show 'Test data capture' to warn you that no real capture data will be generated. In test mode the settings of the advanced capture naming window are ignored and the resulting capture files are always named as follows (with .lds or .raw depending on the configured sample format):
TestData_yyyy-MM-dd_hh-mm-ss.lds
The player remote control windows provides a software remote control interface for a serial connected LaserDisc player. The form and function of the remote is based on a Pioneer CU-V113A remote control and (wherever possible) the buttons function like the original remote. To open the remote control select 'View' from the menu bar and click on the 'Player remote' option. The remote control window is shown in the following picture:
Player remote control
If the player remote control window is selected when no player is connected using serial, the buttons will be disabled. The remote can also be used to select a chapter, frame or time-code (note: chapters can be available on either CAV or CLV discs but frames are CAV only and timecodes are CLV only). To use the feature first click the 'Chap/Frame' button to select the type of addressing you want (the currently selected address type is shown in the top-left of the window), enter the desired address using the number buttons and then click 'Search'. Clicking the 'Clear' button will clear the currently entered address.
The 'Display' button turns on and the player's on screen display (the status of the OSD is shown in the top-right of the window) and the 'Audio' button selects from the possible audio options provided by the player and the disc.
When using multi-fwd and multi-rev on a CAV disc (this option is not available for CLV discs) you can also select the desired playback speed using the 'Speed-' and 'Speed+' buttons. The currently selected speed is shown in the middle-top of the window.
The automatic capture window provides a fully automated capture system for a serial connected LaserDisc player. To open the automatic capture window select 'View' from the menu bar and click on the 'Automatic capture' option. The automatic capture window is shown in the following picture:
Automatic capture window
The automatic capture system uses serial control of the player to both command the player during capture as well as monitor the progress of the capture based on the frame/timecode position reported. Note that the frame/timecode position reporting is not 'instant', so an automatic capture may overrun the required end address slightly due to communication lag.
The method of addressing is based on the disc format, with CAV using frame number and CLV using time codes. The availability of the fields in the window is based on the selected capture option. The three capture options are described below.
The 'whole disc capture' option is the simplest of the three options and is designed to capture a whole disc from lead-in to the end. To use whole disc capture, select the capture option and then click 'Start CAV Capture' or 'Start CLV Capture' according to the disc type present in the LaserDisc player. The capture process is as follows:
- The disc is placed into play mode and the the disc type is confirmed
- The player is instructed to move to the last frame/time code on the disc and the length of the disc is recorded
- The player is 'spun-down' to a complete stop
- Capture begins
- The player is 'spun-up' and begins playing (so the lead-in is captured)
- Capture continues until the player reaches the frame/time code recorded in step 2
- Capture is stopped
Note that the player is responsible for pausing or stopping playback at the end of the disc. If the player has an option to 'auto repeat side' or similar, it is recommended that this is turned off.
The 'partial disc capture' option is the most flexible of the three options as it is possible to specify both the start and end address of the capture. Since a start address is used, this option cannot be used to capture lead-in information. The capture process is as follows:
- The player is 'spun-up' and placed into play mode (if it's not already playing or paused)
- The player is instructed to move to the last frame/time code on the disc and the length of the disc is recorded
- The player seeks to the required start address and pauses
- Capture begins
- The player switches to play mode
- Capture continues until the end address is reached (or the end of the disc)
- Capture is stopped
The 'lead-in to address' capture option allows capture of the disc from the lead-in to a specified end-address (no start address is allowed since the lead-in is always at the start of the disc). The functionality is the same as 'partial disc capture' as described above, with the exception that the player is spun-down before capture begins.
The about window shows information about the application including software license details. The about window is shown in the following picture:
The About window
For more information click on the 'Licensing' or 'Credits' tabs at the top of the window.
If you find a bug in the capture application please make one on the Github Issues tab.
If you'd like to request new features please use the Github issue reporting tool and describe clearly your requirements and, if possible, the justification for inclusion.
If you'd like to support the development of this application you are welcome to contribute code via Github, or simply make a donation using the Donations page.