GUI Navigation

In the “Capture” tab from the left-hand menu, you will see a large box in the center of the screen showing either your capture window:

Or (if you do not have a deck connected or if the deck is off) the following message:

If the deck is successfully connected, the make and model of your DV deck should appear above the capture playback window. If you have more than one deck connected, multiple players will appear. Once you have specified a file location and name for your capture, the file name will also appear in the upper right hand corner of the corresponding deck being used to capture it.

The player buttons below the capture window can control the deck, and the icon to the right of the player buttons indicates the current status of the deck.

Counters underneath the player buttons track video by frame number, timecode, and the actual record time that has elapsed.

The graph underneath the counters tracks frames with error concealment for audio and video. If you hover your cursor over the graph, a tooltip will display the running total of frames containing errors.

When a tape is playing, DVRescue will detect the DV format recorded (DV SP, DV LP, DVCAM, DVCPRO, or HDV) and display a pink indicator lamp to the left of the deck control buttons.

Please note: that transferring HDV is not supported by the DVRescue project. Please see issue #53 for more details.

GUI Capture

1. In the dvrescue GUI, click on the “Capture” tab from the list on the left hand side. If you do not have a deck connected or if the deck is off, you will see the following message.
   
   

2. Turn on your DV deck. The make and model of the deck should appear above the capture playback window. While a tape is not playing, the screen will read “DECK CONNECTED” on the playback screening.
   
   

3. If you have more than one deck connected, multiple players will appear in the Capture tab. Please select the one you want to use by clicking on the name of the deck.
   
   

4. If your deck has a Remote/Local setting, make sure it is set to “Remote” before initiating the capture. Please note that some decks are known to have different behavior. See the DV Deck Guide for deck-specific information.

5. You can use the player buttons to control the deck and preview the content on the tape.
   
   

6. If you would like to enable the deck to rewind and recapture a frame when it encounters an error, click on the Settings. When dvcapture encounters an error, it has the capability to automatically rewind and try to capture the frames containing errors again. You can enable this feature by setting a number of times to rewind and recapture under the “Settings” tab. Click on the “Settings” tab and enter a number in the field (between 0-20, with the default set as zero). We reccomend 3-4 as any more than that can cause damage to the tape and don’t result in a better file. Please see the GUI Navigation section for more capture settings options. [more details on Capture settings coming soon.]
   
   

7. When ready, click the record button to initiate the transfer. Please note: For macOS set-ups, if you haven’t previously given DVRescue permission to use your camera, the following message will appear. Click “OK” to allow DVRescue to connect to the deck.
   
   

8. A pop-up window will open. Here you can navigate to the location where you would like to save the files created during capture, including the video file itself and all of the logs. Click the name listed in the field for the “output directory” and then select the directory.

9. Type in the tape identifier as the file name and click OK.
   
   

10. Deck control will automatically start recording the tape. While it records, you can preview the video in the GUI player. The record time, frame number and record date will display the information being captured from the tape. The graph will populate with audio and video errors detected, as well as frame containing error concealment.
    
    If you hover your cursor over the graphic it will tell you how many frames have been captured and how many of those frames contain error concealment.
    

11. If you wish to start a second recording, click on the player in the GUI window and follow the steps above to begin recording. You can monitor all of your simultaneous recordings.
    
    

12. When the recording ends or the deck reaches the end of the tape, DVRescue will stop capturing and automatically initiate rewinding the tape (if this function is available on your deck). If you would like to end the capture before the end of the tape or if there is a large chunk of recorded-over blank space, click “Stop” to end the capture. (DVRescue will continue to register blank tape as content if there is timecode or recording time left over from erasing or recording over previous content).

13. Once you are done capturing files, check the output folder to ensure the file contains all of the content that was recorded and that it plays back normally.

14. You can click on the “Analysis” tab to perform quality control on the files. All of the files captured during your current session will be populated in the list in the Analysis tab. Please see the dvanalysis documentation for instructions and tips for reviewing DV files.
    

Troubleshooting: If you are experiencing any issues capturing in the DVRescue GUI, please see our troubleshooting on the DVRescue documentation website.

Basic useage:
Below is the order you should type the commands for capturing using the CLI.

1. In the Terminal run dvrescue --list_devices to display the names of the devices connected to your computer. Note the name and device number of the one you want to use for capture. For example:
   $ dvrescue --list_devices
0x80458280022265: Panasonic DV [DV]

2. You can either type dvrescue at the start of the command or include the path to the version of dvrescue you want to use. Example: /usr/local/bin/dvrescue

3. If you only have one device connected, dvrescue will automatically select it. If you have more than one device connected, add the device number device://0x[device#] (for the corresponding deck you want to use for capture). Example (using the deck listed in step 1): dvrescue device://0x0x80458280022265

4. If you want dvrescue to rewind and recapture when it encounters an issue with a frame type -y --rewind-count and the number of attempts you want it to make before it moves on. Example if you wanted dvrescue to rewind and recapture 3 times: -y --rewind-count 3

5. Type -m to note you want to create a file.

6. Type the files name. Add a space. Example: filename.dv

7. Type -m - to note you want to merge the multiple capture attempts for problematic frames (dvrescue will automatically rewind and try to capture the frame again when it encouters a problematic frame).

8. To open a playback window during capture add | ffplay -

9. The full string to capture to the example device, create a file named “filename”, using the rewind and recapture feature (with 3 attempts) and view the playback during capture would be:
   dvrescue device://0x0x80458280022265 -y --rewind-count 3 -m filename.dv -m - | ffplay -
   For example:
   dvrescue device://0x800460104ce2bad -y --rewind-count 3 -m /Users/libbyshopfauf/Desktop/12345.dv -m - | ffplay -
   

For more examples of frequently used dvcapture command strings, please see the section below.

Capture from a specific device:
dvrescue device://0xdevicename -m /pathtofile/filename.dv
For example:
dvrescue device://0x800460104ce2bad -m /Users/libbyshopfauf/Desktop/12345.dv

Capture from a specific device and show a preview window:
dvrescue device://0xdevicename -m /pathtofile/filename.dv -m - | ffplay -
For example:
dvrescue device://0x800460104ce2bad -m /Users/libbyshopfauf/Desktop/12345.dv -m - | ffplay -

Capture from a specific device using rewind, recapture and merge (you can only specify a number of times to rewind and recapture if you specify a device):
dvrescue device://0xdevicename -y --rewind-count 3 -m filename.dv -m -
For example:
dvrescue device://0x800460104ce2bad -y --rewind-count 3 -m /Users/libbyshopfauf/Desktop/12345.dv -m -

Capture from a specific device using rewind, recapture and merge (3 attempts), show a preview window (with only one deck connected):
dvrescue device://0xdevicename -y --rewind-count 3 -m filename.dv -m - | ffplay -
For example:
dvrescue device://0x800460104ce2bad -y --rewind-count 3 -m /Users/libbyshopfauf/Desktop/12345.dv -m - | ffplay -

All of these flags and options can also be viewed by typing dvrescue -h into the command line window.

--help, -h
    Display this help and exit.

--version
    Display DVRescue version and exit.

--cc-format value
    Set Closed Captions output format to value.
    value can be 'scc', 'screen', 'srt'.
    If there is more than one instance of this option,
    this option is applied to the next --cc-output option.

--cc-output value | -c value
    Store Closed Captions output to value (file name).
    File extension must be the format name (see above)
    if --cc-format is not provided.
    if content is different between Dseq and/or has more than 1 field,
    extension is prefixed by 'dseq%dseq%.' and/or 'field%field%.'.
    There can be more than one instance of this option.

--cc-tc value
    Set Closed Captions output start time code to value.
    Used for SCC output.
    value format is HH:MM:SS;FF, or 'dv' (for DV first frame time code).

--webvtt-output value | -s value
    Store WebVTT output to value (file name).

--xml-output value | -x value
    Store XML output to value (file name).

--merge value | -m value
    Merge all input files into value (file name),
    picking the best part of each file.

--merge-log value
    Store merge log to value (file name).

--merge-output-speed
    Report and merge frames having speed not meaning normal playback
    Is default (it will change in the future).

--merge-ignore-speed
    Do not report and do not merge frames having speed not
    meaning normal playback.

--merge-output-concealed
    Report and merge frames having all blocks concealed.
    Is default (it will change in the future).

--merge-ignore-concealed
    Do not report and do not merge frames having all blocks concealed.

--merge-log-missing
    Report frames considered as missing (due to time code jump etc).
    Is default if information output format is not CSV.

--merge-hide-missing
    Do not report frames considered as missing (due to time code jump etc).
    Is default if information output format is CSV.

--merge-log-intermediate
    Display additional lines of information
    about intermediate analysis during files merge.
    Is default if information output format is not CSV.

--merge-hide-intermediate
    Hide additional lines of information
    about intermediate analysis during files merge.
    Is default if information output format is CSV.

--csv
    Output is in CSV format rather than human readable text.

--caption-presence-change value
    Split XML "frames" elements when there is a caption presence
    change (value = "y") or do not split (value = "n").
    Default is "n".

--verbosity value | -v value
    Verbosity of the output set to value:
    0: no output.
    5: summary only.
    7: information per frame if there is a problem + summary.
    9: information per frame + summary.

--timeout value
    Time out limit for the device or pipe input ("-" file name) set to value (in seconds)

--capture
    Launch capture.
    Is the default if no --cmd option is provided.
    Usable only if input is a device.

--in-control
    Include an integrated command line input for controlling the input.
    Usable only if input is a device.

--list_devices
    List detected devices and their ID.

--list_devices_json
    List detected devices and their ID (JSON output).

--status
    Provide the status (playing, stop...) of the input.
    By default device://0 is used.
    Usable only if input is a device.

--cmd value
    Send a command to the input.
    By default device://0 is used.
    Usable only if input is a device.
    value may be:
    play      Set speed to 1.0 and mode to play.
    srew      Set speed to -1.0 and mode to play.
    stop      Set speed to 0.0 and mode to no-play.
    rew       Set speed to -2.0 and mode to play.
    ff        Set speed to 2.0 and mode to play.

--foreground
    With --cmd or --speed, wait for the device to stop.
    Usable only if input is a device.

--mode value
    Send a command to the input with the specified mode.
    By default device://0 is used.
    By default value is n if speed is 0 else p.
    Usable only if input is a device.
    value may be:
    n         Set mode to no-play.
    p         Set mode to play.

--speed value
    Send a command to the input with the specified speed (float).
    By default device://0 is used.
    By default value is 0 if mode is no-play else 1.
    Usable only if input is a device.

--rewind-count value
    Automatically rewind to last good frame and capture again,
    value times.
    Usable only if input is a device.

--rewind
    Same as --rewind-count 1

--rewind-basename value
    Base name of files storing buggy frames per take
    Default is output file name.