imported>WaybackImport: Imported from Wayback via edit

2020-08-12T15:34:43Z

Imported from Wayback via edit

New page

== RDImport is a great tool to import large numbers of mp3s or wav into your music database. ==

To find out how to use rdimport functions type rdimport --help

----

rdimport [options] <group> <filespec> [,<filespec>]*

Import one or more files into the specified group in the library. By
default, a new cart will be created for each file imported. A <filespec> of
'-' will cause RDImport to read the list of filespecs from standard input.

The following options are available:

--verbose
Print progress messages during processing.

--log-mode
Prepend date/time information to each line of printed status (implies
the '--verbose' option).

--normalization-level=<level>
Specify the level to use for normalizing the audio, in dBFS.
Specifying '0' will turn off normalization.
On Rivendell meters, 0dB=-16dBFS

--autotrim-level=<level>
Specify the threshold level to use for autotrimming the audio, in
dBFS. Specifying '0' will turn off autotrimming.

--single-cart
If more than one file is imported, place them within multiple cuts
within a single cart, rather than creating separate carts for each
file.

--segue-level=<level>
Specify the threshold level to use for setting the segue markers,
in dBFS.

--segue-length=<length>
Length of the added segue in msecs.

--to-cart=<cartnum>
Specify the cart to import the audio into, rather than using the next
available cart number for the group. If the cart does not exist, it will
be created. Each file will be imported into a separate new cut within the
cart. Use of this option implies the '--single-cart' option as well,
and is mutually exclusive with the '--use-cartchunk-cutid' option.

--use-cartchunk-cutid
Import the audio into the cart specified by the CartChunk CutID parameter
associated with the file. If the cart does not exist, it will be
created. Use of this option is mutually exclusive with the '--to-cart'
option.

--title-from-cartchunk-cutid
Set the cart title from CartChunk CutID.

--delete-source
Delete each source file after successful import. Use with caution!

--delete-cuts
Delete all cuts within the destination cart before importing. Use
with caution!

--drop-box
Operate in DropBox mode. RDImport will run continuously, periodically
scanning for the specified files, importing and then deleting them when
found. WARNING: use of this option also implies the '--delete-source'
option!

--metadata-pattern=<pattern>
Attempt to read metadata parameters from the source filename, using
the pattern <pattern>. Patterns consist of a sequence of macros and
regular characters to indicate boundaries between metadata fields.
The available macros are:

%a - Artist
%b - Record Label
%c - Client
%e - Agency
%g - Rivendell Group
%i - Cut Description
%l - Album
%m - Composer
%n - Rivendell Cart Number
%o - Cut Outcue
%p - Publisher
%r - Conductor
%s - Song ID
%t - Title
%u - User Defined
%y - Year
%% - A literal '%'

Detection of either the Rivendell Group [%g] or Rivendell Cart [%n]
will cause RDImport to attempt to import the file to the specified Group
and/or Cart, overriding whatever values were specified elsewhere on the
command line.

Boundaries between metadata fields are indicated by placing regular
characters between macros. For example, the pattern '%t_%a_%g_%n.',
when processing a filename of 'My Song_My Artist_TEMP_123456.mp3',
would extract 'My Song' as the title and 'My Artist' as the artist,
while importing it into cart 123456 in the TEMP group.

--fix-broken-formats
Attempt to work around malformed audio input data.

== Notes ==
It may be necessary to enclose individual <filespec> clauses in quotes in order to protect wildcard characters from expansion by the shell. A typical indicator that this is necessary is the failure of RDImport to process newly added files when running in DropBox mode.

----
'''How I used rdimport'''

So this is how I added a whole lot of songs to my RD database...

<pre>rdimport --verbose --segue-level=-10 Examplegroupname *.mp3 2> errorlog.txt</pre>

This imports everything with an MP3 file extension in a particular directory to the RD database, and places a SEQUE LEVEL fade point at the end of the track at such a point where the volume drops to -10dB. A new CART number is created for each file. It also creates an error log. If the error log already exists put 2>> errorlog.txt to add to the bottom of an existing error log.

The only songs that don't get converted with more than one DOT or comma in the file name.
eg Artist Name - Song Name..mp3

or Artist Name - Song Name, Middle Name.mp3

Another thing you can do is make all the tracks CUTs inside the one cart.

<pre>rdimport --verbose --segue-level=-10 --single-cart Examplegroupname *.mp3 2> errorlog.txt</pre>

or if the CART already exists you can add CUTs to it.

<pre>rdimport --verbose --segue-level=-10 --to-cart=400 Examplegroupname *.mp3 2> errorlog.txt</pre>

Other things to consider with Linux and Unix based systems is all file names directory paths are case sensitive. eg Song Name.mp3 is different from song name.mp3
And when converting files using RDIMPORT... the group name is case sensitive.

== Wildcards ==
'''Q:''' I set up the metadata option as: --metadata-pattern=SPN_%l_[0-9]*_[0-9]*_%t\.mp3

'''A:''' Ah, you're using regexes. Unfortunately, RDImport doesn't have the smarts to
deal with that -- just '*' and '?' wildcards. Now that you bring it up, it
isn't a bad idea though...
Frederick F. Gleason, Jr. - Chief Developer - Paravel Systems

Using rdimport to import mp3 files - Revision history

imported>WaybackImport: Imported from Wayback via edit