previous next

Chapter 4: Using the Command Line

You use the command line for all functions associated with RealProducer Plus. You can set up your input/output options, encoding options, preferences, and video codec options using the command line.

Command Line Description

The command line gives you the conversion and broadcasting capability of the RealProducer Plus main interface, but also allows you to create a batch file and record multiple .rm files with a single command.

To use the command line encoder:

  1. Open a command line window.

  2. Change the directory to the main RealProducer Plus directory.

  3. Type realproducer <options> where <options> are the recording options you specify to record your media. See the tables below for more details.

    Note
    You must specify an input by using one of the -i or -l options.

  4. The command line RealProducer Plus converts the specified input into RealAudio or RealVideo once you press Enter.

Options

The following tables describe each flag that you can use on the command line. These flags are divided into Input/Output options, Encoding options, and Preferences options..

Input/Output Options
Syntax Description Default Value Example
-i <input file> name and directory of the input file no default

-i /tmp/sample.avi
-l <audio>,<video> specifies live audio and video input(s), where <audio> and <video> represent the values assigned to an audio card driver and a video card driver; ignores the -i option 0,0

0 - primary audio card
0 - primary video card

-l 3,1
-o <output file> name of the output file <input file>.rm

-o /tmp/sample.rm
-s "<server[:port]>/<file>" name of the output server, port, and file port defaults to 4040; output file must be specified

-s "myserver:6060/sample.rm"
-u <user name> the user name to log on to the server no default

-u myname
-p <password> the password for the user name no default

-p mypassword
-x <hh>:<mm>:<ss> maximum amount of time to record continuous

-x 01:20:30
-tp 0 or 1 turns on two-pass encoding
0 - off
1 - on
0 - off

-tp 1

Encoding Options
Syntax Description Default Value Example
-t <target1>,<target2>,... target audiences for the recording; use any of the following numbers:
0 - 28 Kbps Modems
1 - 56 Kbps Modems
2 - single ISDN
3 - dual ISDN
4 - DSL/cable modem
5 - corporate LAN
6 - 256K DSL/cable modem
7 - 384K DSL/cable modem
8 - 512K DSL/cable modem
0 - 28 Kbps modem

-t 1,2,3
-a 0, 1, 2, or 3 audio format; use one of the following numbers:
0 - voice only
1 - voice with background music
2 - music
3 - stereo music
0 - voice only

-a 2
-v 0, 1, 2, or 3 video quality; use one of the following numbers:
0 - normal motion
1- smoothest motion
2 - sharpest image
3 - slide show
0 - normal motion

-v 2
-f 0 or 1 file type; use one of the following numbers:
0 - Single Rate
1- SureStream
1 - SureStream

-f 0
-m <file> use the specified settings configuration file; overrides -t and -a; see below for more information none

-m mysettings.txt
-b <title> the title for the recorded clip none

-b "The Title"
-h <author> the author for the recorded clip none

-h "Joe Schmoe"
-c <date> the copyright owner and date for the recorded clip none

-c "My Company 2000"
-y 0 or 1 enable audio recording;
0 - no
1 - yes
1- yes

-y 0
-z 0 or 1 enable video recording;
0 - no
1 - yes
1 - yes

-z 0
-vx <width>,<height> input video capture size (in pixels) 176,144

-vx 160,120
-os <width>,<height> output video size (in pixels) original size

-os 144,32
-q <description> a brief description of the clip; use quotes if spaces are used none

-q "a gripping
story about a
man and his pet
banana slug"
-n <keywords> words that will help search engines locate your clip none

-n "pets slugs"

Preferences Options
Syntax Description Default Value Example
-k 0 or 1 allow download;
0 - no
1 - yes
0 - no

-k 1
-ar 1, 2, 3, or 4 audience rating;
1 - general, all ages
2 - parental guidance
3 - adult supervision required
4 - adults only
1 - general

-ar 3
-in 0 or 1 allow search engines to index your clip;
0 - no
1 - yes
1 - yes

-in 0
-r 0 or 1 allow recording for RealPlayer Plus users;
0 - no
1 - yes
0 - no

-r 1
-w 0 or 1 emphasize audio or video (SureStream recording only);
0 - emphasize audio
1 - emphasize video
0 - audio

-w 1
-g 5 or 6 the version of RealPlayer the clip is compatible with (SureStream recording only); use one of the following numbers:
5 - RealPlayer 5.0 or later
6 - RealPlayer G2
6 - RealPlayer G2

-g 5
-sc 0 or 1 selects the network protocol for the server connection; use one of the following numbers:
0 - connect using UDP (recommended)
1 - connect using TCP
0 - UDP

-sc 1
-j <l>,<t>,<w>,<h> set cropping values where l=left, t=top, w=width, and h=height 0,0,0,0

-j 0,0,200,150
-td <directory> changes the temporary (scratch) directory used when creating RealMedia /tmp -td /var/tmp
-ow if specified, existing target files will be overwritten if they have the same file name
--help displays help information
--version displays the installed version of RealProducer Plus and the serial number

Video Codec Options
Syntax Description Default Value Example
-vb 0 or 1 variable bit rate encoding;
0 - no
1 - yes
0 - off

-vb 1
-vl <seconds> variable bit rate max latency; from 5 to 60 seconds 15 seconds

-vl 30
-lp 0 or 1 loss protection;
0 - no
1 - yes
0 - no

-lp 1
-kf <milliseconds> keyframe frequency; from 0-60000 milliseconds 10000 milliseconds

-kf 20000
-vc <video codec> overrides the default video codec; use one of the following numbers:
RV200 - RealVideo G2
RV201 - RealVideo G2 with SVT
RV300 - RealVideo 8
RV300 - RealVideo 8 -vc RV200

Examples

The following example records foo.wav into a RealMedia file for 28 and 56 Kbps audiences, audio set to voice only, file type set to SureStream, and "The Title" as the title of the clip. The output file defaults to foo.rm.


realproducer -i foo.wav -t 0,1 -a 0 -f 1 -b "The Title"

The next example records from a live video source to a RealServer with the same settings as above.


realproducer -l 3:1 -s myserver:4040/foo.rm -t 0,1 -a 0 -v 0 -f 1 -b "The Title"

Settings Configuration File

The Settings Configuration File option (-m) allows the user to specify a text file that contains the necessary target audience settings for the recording. Using a settings file allows you to save different settings that you use all the time, plus you can specify the exact codec used.

The parameters contained used for each target audience are as follows:

Settings File Parameters
Parameter Description
TARGET the target audience; see below for a list of values
TOTAL_BIT_RATE total bit rate for the target audience
AUDIO_CODEC the audio codec used for the target audience; see below for a list of values
VIDEO_CODEC the video codec used to create streaming video; see below for a list of values (defalut = RV300)
MAX_FRAME_RATE maximum frame rate, measured in frames per second (default = 15)

Warning
Parameters must be in upper case.

The settings file contains a line for each target audience that the user wishes to record for. A sample configuration settings file for a SureStream recording would be as follows:


TARGET=0,TOTAL_BIT_RATE=20,AUDIO_CODEC=sipr0,VIDEO_CODEC=RV300,MAX_FRAME_RATE=7.5

TARGET=2,TOTAL_BIT_RATE=45,AUDIO_CODEC=sipr1,VIDEO_CODEC=RV300,MAX_FRAME_RATE=10

RealProducer Plus then takes these values and creates a RealMedia stream for the target audience specified in each line.

Warning
Using a settings configuration file overrides the audio format switch (-a) and the video codec switch (-vc).

Target Audience Values

0 28 Kbps Modems
1 56 Kbps Modems
2 Single ISDN
3 Dual ISDN
4 DSL/Cable Modem
5 Corporate LAN
6 256K DSL/Cable Modem
7 384K DSL/Cable Modem
8 512K DSL/Cable Modem

Audio Codec IDs

List of audio codecs
Codec name Label Frequency response Description
sipr2 5 Kbps Voice 4 kHz For speech-based video over 28 Kbps and 56 Kbps modem connections. If better sound quality is required, select the 6.5 Kbps Voice codec.
sipr0 6.5 Kbps Voice 4 kHz For speech-based video over 28 Kbps and 56 Kbps modem connections.
sipr1 8.5 Kbps Voice 4 kHz For speech over 14 Kbps modem connections, or speech-based video over Single and Dual ISDN connections.
sipr3 16 Kbps Voice 8 kHz For speech over 28 Kbps and 56 Kbps modem connections, or speech-based video over Dual ISDN connections.
cook7 32 Kbps Voice 11 kHz For speech over 56 Kbps modem and Single ISDN connections, or for speech-based video over LAN/DSL/Cable Modem connections.
cook14 64 Kbps Voice 20 kHz For speech over Dual ISDN and LAN/DSL/Cable Modem connections.
cook8 6 Kbps Music 3 kHz For music-based video over 28 Kbps and 56Kbps modem connections. If better sound quality is required, select the 8 Kbps Music codec.
cook0 8 Kbps Music 4 kHz For music-based video over 28 Kbps and 56 Kbps modem connections.
cook1 11 Kbps Music 5.5 kHz For music over 14 Kbps modem connections, or music-based video over Single ISDN connections.
cook2 16 Kbps Music 8 kHz For music over 28 Kbps modem connections, or music-based video over Dual ISDN connections.
cook3 20 Kbps Music 10 kHz For music over 28 Kbps modem connections, or music-based video over Dual ISDN connections.
cook15 20 Kbps Music - High Response 20 kHz For high response music over 28 Kbps modem connections, or music-based video over Dual ISDN connections.
cook4 32 Kbps Music 16 kHz For music over 56 Kbps modem connections, or music-based video over LAN/DSL/Cable Modem connections.
cook16 32 Kbps Music - High Response 20 kHz For high response music over 56 Kbps modem connections, or music-based video over LAN/DSL/Cable Modem connections.
cook5 44 Kbps Music 20 kHz For music over Single ISDN connections.
cook6 64 Kbps Music 20 kHz For music over Dual ISDN and LAN/DSL/Cable Modem connections.
cook17 16 Kbps Stereo Music 4.3 kHz RealAudio 8 : For stereo music over 28 Kbps modem connections, or music-based video over Dual ISDN connections. Compatible with RealPlayer 8.0 and later. Previous versions of the RealPlayer will give the user the choice of updating in order to play RealAudio 8 streams.
cook9 20 Kbps Stereo Music 5 kHz For stereo music over 56 Kbps modem connections, or music-based video over LAN/DSL/Cable Modem connections.
cook18 20 Kbps Stereo Music 8.6 kHz RealAudio 8 : For stereo music over 28 Kbps modem connections, or music-based video over Dual ISDN connections.
cook19 20 Kbps Stereo Music High 9.9 kHz RealAudio 8 High Response : For stereo music over 28 Kbps modem connections, or music-based video over Dual ISDN connections.
cook10 32 Kbps Stereo Music 8 kHz For stereo music over 56 Kbps modem connections, or music-based video over LAN/DSL/Cable Modem connections. For use with RealPlayer G2 or greater.
cook20 32 Kbps Stereo Music 13.8 kHz RealAudio 8 : For stereo music over 56 Kbps modem connections, or music-based video over LAN/DSL/Cable Modem connections.
cook21 32 Kbps Stereo Music High 13.8 kHz RealAudio 8 High Response : For stereo music over 56 Kbps modem connections, or music-based video over LAN/DSL/Cable Modem connections.
cook11 44 Kbps Stereo Music 11 kHz For stereo music over Single ISDNconnections.
cook22 44 Kbps Stereo Music 13.8 kHz RealAudio 8 : For stereo music over Single ISDN connections.
cook23 44 Kbps Stereo Music High 16 kHz RealAudio 8 High Response : For stereo music over Single ISDN connections.
cook12 64 Kbps Stereo Music 16 kHz For stereo music over Dual ISDN and LAN/DSL/Cable Modem connections.
cook24 64 Kbps Stereo Music 16 kHz RealAudio 8 : For stereo music over Dual ISDN and LAN/DSL/Cable Modem connections.
atrc0 66 Kbps Stereo Music 12.4 kHz RealAudio 8 (ATRAC3) : For stereo music over Dual ISDN and LAN/DSL/Cable Modem connections.
atrc1 94 Kbps Stereo Music 15.1 kHz RealAudio 8 (ATRAC3) : For stereo music over Dual ISDN and LAN/DSL/Cable Modem connections.
cook13 96 Kbps Stereo Music 20 kHz RealAudio 8 : For stereo music over Dual ISDN and LAN/DSL/Cable Modem connections.
cook25 96 Kbps Stereo Music 16 kHz RealAudio 8 : For stereo music over Dual ISDN and LAN/DSL/Cable Modem connections.
atrc2 105 Kbps Stereo Music 13.7 kHz RealAudio 8 (ATRAC3) : For stereo music over Dual ISDN and LAN/DSL/Cable Modem connections.
atrc3 132 Kbps Stereo Music 16.5 kHz RealAudio 8 (ATRAC3) : For high-quality stereo music over LAN/DSL/Cable Modem connections.
atrc4 146 Kbps Stereo Music 16.5 kHz RealAudio 8 (ATRAC3) : For high-quality stereo music over LAN/DSL/Cable Modem connections.
atrc5 176 Kbps Stereo Music 19.2 kHz RealAudio 8 (ATRAC3) : For archive quality stereo music.
atrc6 264 Kbps Stereo Music 22 kHz RealAudio 8 (ATRAC3) : For archive quality stereo music.
atrc7 352 Kbps Stereo Music 22 kHz RealAudio 8 (ATRAC3) : For archive quality stereo music.

Video Codec IDs

List of video codecs
Codec name Description
RV200 RealVideo codec compatible with older versions of RealPlayer.
RV201 RealVideo codec with SVT (Scalable Video Technology).
RV300 RealVideo 8.0 codec, compatible with RealPlayer versions 8.0 and above.


Copyright © 2000 RealNetworks
For information on RealNetworks' technical support, click here.
This file last updated on 11/10/00 at 17:23:20.
previous next