diff --git a/docs/_sections/capture.md b/docs/_sections/capture.md index fa098d4f..cb945238 100644 --- a/docs/_sections/capture.md +++ b/docs/_sections/capture.md @@ -3,4 +3,107 @@ layout: post title: Capture --- +## DVRescue GUI +Step-by-step instructions for using the DVRescue graphic user interface to capture DV videotape formats. +
+ Details +
+ +## How to capture using the DVRescue CLI +Commands and useage for capturing DV tapes using the dvrescue command line tools (CLI). +
+ Useage of capture commands
+ +**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:
+Screenshot 2024-07-29 at 11 56 07 AM + +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``` + +4.) If you only have one device connected, dvrescue will automatically select it (device 0). If you have more than one device connected, add the device number ```device://1``` (for the corresponding deck you want to use for capture). Example (using the deck listed in step 1): ```dvrescue device://0``` + +5.) If you want dvrescue to rewind and recapture when it encounters an issue with a frame type ```--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: ```--rewind-count 3``` + +6.) Type ```-m``` to note you want to create a file. + +7.) Type the files name. Add a space. Example: ```filename.dv``` + +8.) 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). + +9.) To open a playback window during capture add ```| ffplay -``` + +
+ + +
+ Examples of frequently used capture commands
+ +**Basic capture (with only one deck connected)**
+```dvrescue -m filename.dv``` + +**Capture to a specific device:**
+```dvrescue device://0 filename.dv``` + +**Capture using rewind, recapture and merge:**
+```dvrescue --rewind-count 3 -m filename.dv -m``` + +**Capture using rewind, recapture and merge (3 attempts), show a preview window (with only one deck connected):**
+```dvrescue --rewind-count 3 -m filename.dv -m - | ffplay -``` +
+ +
+ Full list of capture commands + +All of these flags and options can also be viewed by typing dvrescue -h into the command line window. + +**--capture** = Launch capture.
+Is the default if no --cmd option is provided.
+Usable only if input is a device.
+Needs to be followed by the path and name for the output file. + +**--in-control** = Include an integrated command line input for controling the input.
+Usable only if input is a device. + +**--list_devices** = List detected devices and their indices. + +**--statusl** = 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. + +**--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. +
+ +## How capture using vrecord +To use dvcapture in vrecord, please see the [documentation]([url](https://github.com/amiaopensource/vrecord/blob/main/Resources/Documentation/dv_info.md)) on the vrecord GitHub repository.