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:
- Open a command line window.
- Change the directory to the main RealProducer Plus directory.
- 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.
|
- 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 1999"
|
| -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> |
keywords 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
|
| -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
|
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
| sipr0 |
6.5 Kbps Voice |
| sipr1 |
8.5 Kbps Voice |
| sipr2 |
5 Kbps Voice |
| sipr3 |
16 Kbps Voice |
| cook7 |
32 Kbps Voice |
| cook14 |
64 Kbps Voice |
| cook8 |
6 Kbps Music |
| cook0 |
8 Kbps Music |
| cook1 |
11 Kbps Music |
| cook2 |
16 Kbps Music |
| cook3 |
20 Kbps Music |
| cook15 |
20 Kbps Music - High Response |
| cook4 |
32 Kbps Music |
| cook16 |
32 Kbps Music - High Response |
| cook5 |
44 Kbps Music |
| cook6 |
64 Kbps Music |
| cook9 |
20 Kbps Stereo Music |
| cook10 |
32 Kbps Stereo Music |
| cook11 |
44 Kbps Stereo Music |
| cook12 |
64 Kbps Stereo Music |
| cook13 |
96 Kbps Stereo Music |
Video Codec IDs
| RV200 |
RealVideo codec compatible with older versions of RealPlayer |
| RV201 |
new 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 06/16/00 at 12:50:23.