DVBsVCR2 Command Line
The DVBsVCR2 program can be started and controlled via various command-line options. The following section describes these options and their use.
Syntax:
| dvbsvcr2 | [ generic_option ]... [ command ] |
where
| generic_option | : | /viewer /noviewer /dev device_number /boot /fw firmware_path |
| command | : | RECORD program_name [ mpg_file ] [ options ] TUNER program_name PLAY EPG [ database ] [ options ] CLOSE |
/viewer Option
Open the viewer window.
/noviewer Option
Close the viewer window.
/dev Option
If more than one DVB card is present, control the DVB card with the given number, starting at number 1.
/boot Option
On program start download and reboot the DVB card's firmware. This setting overrides the default setting stored in the registry. Note: When another copy of this program is already running (for this DVB card instance) the command line is simply passed to the other copy and this option is ignored.
/fw Option
Specify an alternate firmware for download into the DVB card. Note: This option does not force a reboot of the cards firmware. See also /boot. Note: When another copy of this program is already running (for this DVB card instance) the command line is simply passed to the other copy and this option is ignored.
RECORD Command
Enter record mode. Start recording of the specified program into the given file. If the filename is omitted or a directory is specified, the name is automatically built based on the current date, time and program.
Syntax
| RECORD program_name [ mpg_file ] [ option ]... |
where
| option |
: |
/t rec_time /ei event_id /en event_name /ec /ef /lang [ language [ , language ]... ] /close /noclose |
Description
| program_name | Specify the name of the sender to record. If the name contains blanks or special characters it must be enclosed in double quotes. |
| mpg_file | Specify the name of the destination file or directory for recording. If the name contains blanks or special characters it must be enclosed in double quotes. See here for a description of the options and the handling of this file name. |
/t Option
(RECORD Command)
Specify recording time duration.
Syntax
| /t rec_time |
where
| rec_time | : | [[ hh : ] mm : ] ss |
Description
| hh | Specify hours of recording time duration. |
| mm | Specify minutes of recording time duration. If hours are present, minutes are restricted to 0-59. |
| ss | Specify seconds of recording time duration. If minutes are present, seconds are restricted to 0-59. |
/ei Option
(RECORD Command)
Record event with given ID. The ID is a number that is arbitrarily chosen by the sender. This option is mainly for use with automatically generated command lines.
Syntax
| /ei event_id |
Description
| event_id | Event ID number. It may be given in decimal, octal preceded with "0" or hexadecimal preceded with "0x". |
/en Option
(RECORD Command)
Record event with given name. If the name contains blanks or special characters it must be enclosed in double quotes.
Syntax
| /en |
/ec Option
(RECORD Command)
Record current (present) event.
/ef Option
(RECORD Command)
Record following (next) event.
/lang Option
(RECORD Command)
Set the languages for recording. More than one languages can be selected for recording. The first language in the list that is available will become the primary language. If no language is given at all, all available languages at the time of record start are recorded. It is possible to specify AC3 streams for recording, but the language text must appear exactly as shown in the language combo box, that is including the " (AC-3)" at the end. Using the "PID=nnn" feature it is possible to force recording of a language stream that is not available at the time of recording start.
Syntax
| /lang [ language [ , language ]... ] |
where
| language | : | language_description | ISO_639_lang_id | PID=pid |
Description
| language_description | The language description as it appears in the language combo box. Any language whose description starts with the given text is selected. If the name contains blanks or special characters it must be enclosed in double quotes. |
| ISO_639_lang_id | The three letter language code as specified in the ISO 639 document. |
| pid | An integer number specifying the PID ID of the audio channel to record. It is not possible to specify AC3 streams with this option. |
/close Option
(RECORD Command)
Close DVBsVCR2 application after recording if no other commands are pending.
/noclose Option
(RECORD Command)
Do not close the application after recording.
Notes
Options are case sensitive. There must be a space between an option and its argument.
If a recording is requested while another recording is running, this request is queued and the recording
will start as soon as the current recording stops. The number of queued recording requests is not limited.
If a timed recording (/t option) is queued because another recording is currently running, its time will be
reduced accordingly so that it will end at the expected time.
When using event controlled recording (/ei, /en, /ec
or /ef options), recording will start when the state of the
specified event changes to "running". When its state change to anything
different than "running" or "paused", timer record mode is entered. This
means that using the /t option it is possible to specify the time
that recording continues after the event ends. If the /t option
is not used, recording ends immediately.
The options /close and /noclose make sure that the program is closed or is not closed after an
automatic recording. The default is to close the program if it is not running at the recording start, and not to close
the program if it is already running at the recording start time.
Examples
| RECORD "3sat" /t 30:00 |
| Record 30 minutes from sender "3sat". MPEG or PVA file (depends on current setup) is created in the current working folder. |
| RECORD "3sat" "E:\Recordings\" /ei 0xA60B |
| Record the event with the ID 0xA60B from sender "3sat". File is created in the folder "E:\Recordings" which is created if it does not exist already. |
| RECORD "3sat" "E:\Recordings\Nano" /en "Nano" |
| Record the event with the name "Nano" from channel "3sat" and then quit.
If there is a folder "E:\Recordings\Nano", the file is created with a default name in this directory,
otherwise the file is named "Nano.mpg" in the folder "E:\Recordings" which is created if it
does not exist already. |
TUNER Command
Enter tuner mode. Tune to the specified program and keep the program active, but do not start recording. The program can be closed later on with the CLOSE command.
Syntax:
| TUNER program_name [ option ] |
where
| option | : | /lang language |
/lang Option
(TUNER Command)
Select the language that is set.
Syntax
| /lang language |
where
| language | : | language_description | ISO_639_lang_id | PID=pid |
Description
| language_description | The language description as it appears in the language combo box. If the name contains blanks or special characters it must be enclosed in double quotes. |
| ISO_639_lang_id | The three letter language code as specified in the ISO 639 document. |
| pid | An integer number specifying the PID ID of the audio channel to set. |
Examples
| TUNER "3sat" |
| Tune to sender "3sat" and remain active. |
PLAY Command
Enter player mode.
Syntax:
| PLAY |
EPG Command
Start EPG scan of the given programs and update the EPG database.
Syntax:
| EPG [ database ] [ option ]... |
where
| option | : | /i program_name |
Description
| database | Specify the database file to be updated. If omitted, the last database file used is updated. |
/i Option
(EPG Command)
Specify the name of the sender to scan for EPG data. If one or more /i options are given, only the senders specified are scanned. If no /i option at all is given, all the senders that have already EPG data in the database are scanned.
Syntax
| /i program_name |
Description
| program_name | Specify the program name (the sender) that is scanned and updated in the database. If the name contains blanks or special characters it must be enclosed in double quotes. |
Examples
| EPG |
| Update the current EPG database and quit. |
| EPG epgdb.mdb |
| Update the EPG database file "epgdb.mdb" and quit. |
| Update the EPG info of the sender "3sat" in the current EPG database and quit. |
CLOSE Command
Close program. For remote-control only, ignored on the first program instance.
Syntax:
| CLOSE |
