NCH Software Home
Home | Support | Products

RecordPad Software Development Kit

RecordPad Software Development API

RecordPad can be controlled by other programs via command line tool. For example other software can start or stop recording or specified the output folder. This is useful for creating automation systems.

RecordPad [command][options]

Command:

-record [format] [format settings] Start recording. The output file will be put in the output folder as set in current settings. If "prompt for file name" option is enabled, it prompts for name before start recording; otherwise, it auto generate the file name based on the current settings.

Format Options:
wav: record in wav format
mp3: record in mp3 format

Format Settings Options:
If you don't specify the format settings, RecordPad will use the current format settings to record the file.

Wav file: -s sfreq -m nchans> -b<bitrate>
where:
-s <sfreq> sampling frequency of output file(kHz)
-m <nchans> number of channels
-b <bitrate> set the bitrate in kbs

Constant Bitrate Encoding (CBR) mp3 file: -cbr -b <bitrate>[-h] -m <mode> [-p]
where:
-b <bitrate>set the bitrate in kbs
-h higher quality, but a little slower
-m <mode> (s)tereo, (j)oint, (f)orce or (m)ono (default j)
-p error protection

Variable Bitrate Encoding (VBR) mp3 file: -vbr -b<minbitrate> -B <maxbitrate> -q <n> -m <mode>[-p]
where:
-b <minbitrate> specify minimum allowed bitrate
-B <maxbitrate> specify maximum allowed bitrate
-q <n> quality setting for VBR. default n=4, 0 = high quality, bigger files, 9 = smaller files
-m <mode> (s)tereo, (j)oint, (f)orce or (m)ono (default j)
-p error protection

-recordfile <filepath> [format settings]
Start recording to a specific file. Please refer to the above section on how to set format settings.

-pause
Pause recording.

-done
Finish recording the current file.

-restart
Restart recording.

-resume
Resume recording after it has been paused.

-outdir <dirpath>
Set the output folder to which RecordPad exports files.

-exit
Exit RecordPad.

-play <filename>
Play the specified file in the output folder. You only need to include the file name with the file extension. For example: MyFile01.wav

Options

-show
Show RecordPad when it is running. This is the default setting.

-hide
Hide RecordPad when it is running.

-exitifstop
Exit RecordPad if recording is stopped.

-ms <milliseconds>
Save the current recording file and exit RecordPad automatically after specified number of milliseconds.

-showbtn <button>
Show or hide the recording control buttons. The value of <button> can be one of the following: (r)ecord, (p)ause, restar(t), (s)top, showall, hideall.

Examples

recordpad -record -ms 5000
recordpad -record wav -s 44100 -m 1 -b 8
recordpad -record mp3 -cbr -b 128 -h -m s -p
recordpad -record mp3 -vbr -b 96 -B 128 -q 0 -m s -p
recordpad -recordfile "c:.mp3"-vbr -b 96 -B 128 -q 0 -m s -p
recordpad -outdir "c:files"
recordpad -play "myfile01.wav"
recordpad -record -showbtn showall
recordpad -showbtn r

Other Information

If you have problems writing your application, please go to www.nch.com.au/recordpad/support.html and use the form to contact us.

If you wish to distribute the RecordPad packaged with your software you should consider the very easy and affordable OEM license terms for distributing RecordPad. See http://www.nch.com.au/reseller for more information.

We also offer corporate software development services if you want us to do the development for you or if you need more substancial changes to the RecordPad . Costs start from around $US100 for a simple function but can increase to $10,000+ for development of a complete new release application. Please see www.nch.com.au/development for contact details to request a quote.

We can also rebrand RecordPad with your logo and details for a small fee (see http://www.nch.com.au/reseller for more information).

You can distribute the RecordPad install file with your software (but you may not under any circumstances distribute registration keys or seek to undermine the registration system). See the RecordPad license terms (on the Help file). Normally your customers would purchase the RecordPad directly from us. We also provide easy license terms if you do need to distribute registered versions of the RecordPad. Please see http://www.nch.com.au/reseller under the Software Blanket license heading.

More information

RecordPad Home Page
Frequently Asked Questions (Presales)
Technical Support Questions and Contacts
Discussion Forum

Top | Uninstall | Privacy | Legal & EULA | Contact Us | SiteMap | Home
© NCH Software