<?xml version="1.0" encoding="ISO-8859-1"?>
<refentry id="stdin" xmlns="http://docbook.org/ns/docbook" version="5.0">
  <!--
      Header
  -->
  <refmeta>
    <refentrytitle>rdimport</refentrytitle>
    <manvolnum>1</manvolnum>
    <refmiscinfo class='source'>October 2020</refmiscinfo>
    <refmiscinfo class='manual'>Linux Audio Manual</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>rdimport</refname>
    <refpurpose>
    Audio importation tool for the Rivendell Radio Automation System
    </refpurpose>
  </refnamediv>
  <info>
    <author>
      <personname>
	<firstname>Fred</firstname>
	<surname>Gleason</surname>
	<email>fredg@paravelsystems.com</email>
      </personname>
      <contrib>Application Author</contrib>
    </author>
  </info>

  <!--
      Body
  -->
  <refsynopsisdiv id='synopsis'>
    <cmdsynopsis>
      <command>rdimport</command>
      <arg choice='opt'><replaceable>OPTIONS</replaceable></arg>
      <arg choice='req'><replaceable>group-name</replaceable></arg>
      <arg choice='req'><replaceable>filespec</replaceable></arg>
      <sbr/>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id='description'><title>Description</title>
  <para>
    <command>rdimport</command><manvolnum>1</manvolnum> is a command-line tool
    for importing one or more audio files into the Rivendell Radio
    Automation System. By default, a new cart will be created for each file
    imported, although this behavior can be modified by use of the
    appropriate options (see the <option>--single-cart</option>
    and <option>--to-cart</option> options, below).  A
    <replaceable>filespec</replaceable> of <userinput>-</userinput> will
    cause the list of filespecs to be read from standard input.
  </para>
  </refsect1>

  <refsect1 id='options'><title>Options</title>
  <variablelist remap='TP'>
    <varlistentry>
      <term>
	<option>--add-scheduler-code=</option><replaceable>str</replaceable>
      </term>
      <listitem>
	<para>
	  Add Scheduler Code <replaceable>str</replaceable> to the target
	  cart. The specified code must exist in RDAdmin->SchedulerCodes.
	  This option may be specified multiple times.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--autotrim-level=</option><replaceable>level</replaceable>
      </term>
      <listitem>
	<para>
	  Specify the threshold level to use for autotrimming the audio,
	  in dBFS. Specifying <userinput>0</userinput> will turn off
	  autotrimming.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--by-isci</option>[=<replaceable>service-name</replaceable>]
      </term>
      <listitem>
	<para>
          Determine the target cart number by looking it up in the ISCI
          cross-reference table, using the ISCI code provided by the
          <option>--set-string-isci</option> or
          <option>--metadata-pattern</option> options. If
          <replaceable>service-name</replaceable> is given, prepend the
          Program Code for the specified service followed by an underscore
          to the ISCI code when doing the cart number lookup in the ISCI
          cross-reference table. Useful for importing sets of copy-split
          audio.
	</para>
	<para>
          This option is mutually exclusive with the 
          <option>--to-cart</option> option.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--cart-number-offset=</option><replaceable>offset</replaceable>
      </term>
      <listitem>
	<para>
	  Add <replaceable>offset</replaceable> to the cart number as
	  determined from the metadata pattern or
	  <option>--use-cartchunk-cutid</option>.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--clear-datetimes</option>
      </term>
      <listitem>
	<para>
	  Do not set the cut start and end datetimes, even if such are
	  found in the file's import metadata.  Mutually exclusive with the
	  <option>--set-datetimes</option> option.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--clear-daypart-times</option>
      </term>
      <listitem>
	<para>
	  Do not set the cut start and end daypart times, even if such are
	  found in the file's import metadata.  Mutually exclusive with the
	  <option>--set-daypart-times</option> option.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--create-enddate-offset=</option><replaceable>days</replaceable>
      </term>
      <listitem>
	<para>
	  If the imported file does not reference an end date, create with
	  end date offset by <replaceable>days</replaceable> days relative
	  to the current date. Cannot be less than the value the value for
	  <option>--create-startdate-offset</option> (default = 
	  <userinput>0</userinput>).
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--create-startdate-offset=</option><replaceable>days</replaceable>
      </term>
      <listitem>
	<para>
	  If the imported file does not reference an start date, create with
	  start date offset by <replaceable>days</replaceable> days relative
	  to the current date. Cannot be greater than the value the value for
	  <option>--create-enddate-offset</option> (default = 
	  <userinput>0</userinput>).
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--delete-cuts</option>
      </term>
      <listitem>
	<para>
	  Delete all cuts within the destination cart before importing.
	  Use with caution!
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--delete-source</option>
      </term>
      <listitem>
	<para>
	  Delete each source file after successful import.  Use with caution!
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--drop-box</option>
      </term>
      <listitem>
	<para>
	  Operate in DropBox mode, causing
	  <command>rdimport</command><manvolnum>1</manvolnum> to run
	  continuously, periodically scanning for files  matching the
	  specified <replaceable>filespec</replaceable>, importing and then
	  deleting them when found.  WARNING: use of this option also implies
	  the <option>--delete-source</option> option!
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--dump-isci-xref</option>
      </term>
      <listitem>
	<para>
          Print a copy of the current ISCI cross-reference table and then
          exit. Useless except for debugging.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--enddate-offset=</option><replaceable>days</replaceable>
      </term>
      <listitem>
	<para>
	  If the imported file references an end date, offset the value by
	  <replaceable>days</replaceable> days.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--fix-broken-formats</option>
      </term>
      <listitem>
	<para>
	  Attempt to work around malformed audio input data.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--help</option>
      </term>
      <listitem>
	<para>
	  Print a short usage message and exit.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--log-filename=</option><replaceable>filename</replaceable>
      </term>
      <listitem>
	<para>
	  The <replaceable>filename</replaceable> to write logs to.
	  This option is mutually exclusive with the
	  <option>--log-syslog</option> option.
	</para>
	<para>
	  Rivendell &quot;Filepath&quot; wildcards can be used in
	  <replaceable>filename</replaceable>. See the
	  <command>rivendell-wildcards</command><manvolnum>7</manvolnum>
	  man page for details.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--log-syslog</option>
      </term>
      <listitem>
	<para>
	  Writes the logs to <command>syslog</command><manvolnum>3</manvolnum>.
	  Overrides the <userinput>[Logs]</userinput> section of
	  <command>rd.conf</command><manvolnum>5</manvolnum>.
	  This option is mutually exclusive with the <option>--log-directory</option>
	  and <option>--log-filename</option> options.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--mail-per-file</option>
      </term>
      <listitem>
	<para>
	  Send an e-mail message for each file processed, rather than
	  a single message per run summarizing all actions taken. Implies
	  the <command>--send-mail</command> switch.
	</para>
	<para>
	  See the <command>--send-mail</command> switch (below) for more
	  details about generating e-mailed reports from
	  <command>rdimport</command><manvolnum>1</manvolnum>.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--metadata-pattern=</option><replaceable>pattern</replaceable>
      </term>
      <listitem>
	<para>
	  Attempt to read metadata parameters from the source filename,
	  using the pattern <replaceable>pattern</replaceable>.  Patterns
	  consist of a sequence of wildcards and regular characters to
	  indicate boundaries between metadata fields. This option is
	  mutually exclusive with the <option>--xml</option> option.
	</para>
	<para>
	  The available wildcards are:
	</para>
	<variablelist>
	  <varlistentry>
	    <term><userinput>%a</userinput></term>
	    <listitem>
	      <para>Artist</para>
	    </listitem>
	  </varlistentry>
	  <varlistentry>
	    <term><userinput>%b</userinput></term>
	    <listitem>
	      <para>Record Label</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%c</userinput></term>
	    <listitem>
	      <para>Client</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%e</userinput></term>
	    <listitem>
	      <para>Agency</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%g</userinput></term>
	    <listitem>
	      <para>
		Rivendell group name (overrides the 
		<replaceable>group-name</replaceable> parameter)
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%i</userinput></term>
	    <listitem>
	      <para>Cut Description</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%k</userinput></term>
	    <listitem>
	      <para>Time component of the cut start date/time, in
	      format <userinput>HH:MM:SS</userinput></para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%K</userinput></term>
	    <listitem>
	      <para>Time component of the cut end date/time, in
	      format <userinput>HH:MM:SS</userinput></para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%l</userinput></term>
	    <listitem>
	      <para>Album</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%m</userinput></term>
	    <listitem>
	      <para>Composer</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%n</userinput></term>
	    <listitem>
	      <para>Cart Number</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%o</userinput></term>
	    <listitem>
	      <para>Outcue</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%p</userinput></term>
	    <listitem>
	      <para>Publisher</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%q</userinput></term>
	    <listitem>
	      <para>
		Date component of the cut start date/time, in
		format <userinput>YYYY-MM-DD</userinput>. If the
		<userinput>%Q</userinput> wildcard has not also been provided,
		the end date will be assumed to be the same as the start date.
		If the <userinput>%k</userinput> wildcard has not been
		provided, a start time of
		<userinput>00:00:00</userinput> will
		be assumed, while if the <userinput>%K</userinput> wildcard
		has not	been provided, an end time of
		<userinput>23:59:59</userinput> will be assumed.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%Q</userinput></term>
	    <listitem>
	      <para>Date component of the cut end date/time, in
	      format <userinput>YYYY-MM-DD</userinput>.
	      If the <userinput>%K</userinput> wildcard
	      has not been provided, an end time of
	      <userinput>23:59:59</userinput> will be assumed.
	      </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%r</userinput></term>
	    <listitem>
	      <para>Conductor</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%s</userinput></term>
	    <listitem>
	      <para>Song ID</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%t</userinput></term>
	    <listitem>
	      <para>Title</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%u</userinput></term>
	    <listitem>
	      <para>User Defined</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%wc</userinput></term>
	    <listitem>
	      <para>Industry Standard Commercial Identification [ISCI] Code</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%wi</userinput></term>
	    <listitem>
	      <para>International Standard Recording Code [ISRC]</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%wm</userinput></term>
	    <listitem>
	      <para>MusicBrainz Recording ID</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%wr</userinput></term>
	    <listitem>
	      <para>MusicBrainz Release ID</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%y</userinput></term>
	    <listitem>
	      <para>Release Year</para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><userinput>%%</userinput></term>
	    <listitem>
	      <para>A literal '%'</para>
	    </listitem>
	  </varlistentry>

	</variablelist>
	<para>
	  Detection of either the Rivendell Group [<userinput>%g</userinput>] or
	  Rivendell Cart [<userinput>%n</userinput>] will cause
	  <command>rdimport</command><manvolnum>1</manvolnum> to  attempt  to
	  import the file to the specified Group and/or Cart, overriding
	  whatever values were specified on the command line.
	  If the <option>--set-user-defined</option> option has been used,
	  then the  value  specified  there will be used instead of
	  <userinput>%u</userinput>.
	</para>
	<para>
	  Boundaries between metadata fields are indicated by placing regular
	  characters between macros.  For example, the pattern
	  <userinput>%t_%a_%g_%n.</userinput>, 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.
    </para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--normalization-level=</option><replaceable>level</replaceable>
      </term>
      <listitem>
	<para>
	  Specify the <replaceable>level</replaceable> to use for peak
	  normalizing the audio, in dBFS.  Specifying <userinput>0</userinput>
	  will turn  off normalization.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--output-pattern=</option><replaceable>pattern</replaceable>
      </term>
      <listitem>
	<para>
	  Specify a <replaceable>pattern</replaceable> string
	  (which may include metadata wildcards), which will cause
	  <command>rdimport</command><manvolnum>1</manvolnum> to print
	  this string to standard output once for each file successfully
	  imported, with the wildcards appropriately resolved.
	</para>
	<para>
	  See the <option>--metadata-pattern</option> section (above) for
	  the list of supported wildcards.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--segue-length=</option><replaceable>length</replaceable>
      </term>
      <listitem>
	<para>
	  Length of the added segue in <replaceable>length</replaceable>
	  msecs. See <option>--segue-level</option>, below.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--segue-level=</option><replaceable>level</replaceable>
      </term>
      <listitem>
	<para>
	  Specify the threshold <replaceable>level</replaceable> to use for
	  setting the segue start marker, in dBFS, as measured after any
          specified normalization has been applied.  Default action is not
	  to create segue markers.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--send-mail</option>
      </term>
      <listitem>
	<para>
	  Send e-mail to the address(es) specified in the destination group's
	  <computeroutput>Notification E-Mail Addresses</computeroutput>
	  setting in <command>rdadmin</command><manvolnum>1</manvolnum>
	  summarizing the action(s) performed during the run.
	  Each invocation of
	  <command>rdimport</command><manvolnum>1</manvolnum> will
	  potentially generate
	  one message for all successful imports and another for all failed
	  imports (but see the <option>--mail-per-file</option> switch
	  (above) for a way to modify this behavior).
	</para>
	<para>
	  NOTE: Rivendell uses the system's
	  <command>sendmail</command><manvolnum>1</manvolnum> interface when
	  originating e-mail. For many modern e-mail setups, additional site-
	  and distro-specific configuration will likely be necessary beyond
	  what can be covered here.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--set-datetimes=</option><replaceable>start-datetime</replaceable>,<replaceable>end-datetime</replaceable>
      </term>
      <listitem>
	<para>
	  Set the cut start and end datetimes, in the format YYYYMMDD-HHMMSS.
	  Mutually exclusive with <option>--clear-datetimes</option>.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--set-daypart-times=</option><replaceable>start-time</replaceable>,<replaceable>end-time</replaceable>
      </term>
      <listitem>
	<para>
	  Set the cut start and end datetimes, in the format HHMMSS.
	  Mutually exclusive with <option>--clear-daypart-times</option>.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--set-marker-end-<replaceable>marker</replaceable>=</option><replaceable>offset</replaceable>
      </term>
      <listitem>
	<para>
	  Set the <replaceable>marker</replaceable> end marker to a given
	  offset value, with <replaceable>offset</replaceable> specified in
	  milliseconds.
          If positive, it is taken to indicate a marker position relative
	  to the absolute beginning of the audio cut, while if negative,
	  it is taken to indicate a marker position relative to the absolute
          end of the audio cut.
	</para>
	<para>
	  The following <replaceable>marker</replaceable> values are recognized:
	  <variablelist>
	    <varlistentry>
	      <term><userinput>cut</userinput></term>
	      <listitem>
		<para>The Cut markers</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>hook</userinput></term>
	      <listitem>
		<para>The Hook markers</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>segue</userinput></term>
	      <listitem>
		<para>The Segue markers</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>talk</userinput></term>
	      <listitem>
		<para>The Talk markers</para>
	      </listitem>
	    </varlistentry>

	  </variablelist>
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--set-marker-fadedown=</option><replaceable>offset</replaceable>
      </term>
      <listitem>
	<para>
	  Set the FadeDown marker to <replaceable>offset</replaceable>.
	  See the discussion of the
	  <option>--set-marker-end-<replaceable>marker</replaceable></option>
	  option above for a description of the
	  <replaceable>offset</replaceable> parameter.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--set-marker-fadeup=</option><replaceable>offset</replaceable>
      </term>
      <listitem>
	<para>
	  Set the FadeUp marker to <replaceable>offset</replaceable>.
	  See the discussion of the
	  <option>--set-marker-end-<replaceable>marker</replaceable></option>
	  option above for a description of the
	  <replaceable>offset</replaceable> parameter.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--set-marker-start-<replaceable>marker</replaceable>=</option><replaceable>offset</replaceable>
      </term>
      <listitem>
	<para>
	  Set the <replaceable>marker</replaceable> start marker to a given
	  offset value, with <replaceable>offset</replaceable> specified in
	  milliseconds. See the discussion of the
	  <option>--set-marker-end-<replaceable>marker</replaceable></option>
          option above for a description of the
	  <replaceable>marker</replaceable> and
	  <replaceable>offset</replaceable> parameters.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--set-string-<replaceable>field</replaceable>=<replaceable>string</replaceable></option>
      </term>
      <listitem>
	<para>
	  Set the cart label field <replaceable>field</replaceable> to
	  <replaceable>string</replaceable>. This will override any other
	  values --e.g.  from <option>--metadata-pattern</option>.
	</para>
	<para>
	  Values recognized for <replaceable>field</replaceable> are:
	  <variablelist>
	    <varlistentry>
	      <term><userinput>agency</userinput></term>
	      <listitem>
		<para>Agency Name</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>album</userinput></term>
	      <listitem>
		<para>Album Name</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>artist</userinput></term>
	      <listitem>
		<para>Artist Name</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>bpm</userinput></term>
	      <listitem>
		<para>Beats per Minute (integer numeric)</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>client</userinput></term>
	      <listitem>
		<para>Client Name</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>composer</userinput></term>
	      <listitem>
		<para>Composer Name</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>conductor</userinput></term>
	      <listitem>
		<para>Conductor Name</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>description</userinput></term>
	      <listitem>
		<para>Cut Description</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>isci</userinput></term>
	      <listitem>
		<para>Industry Standard Commercial Identification [ISCI] Code</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>isrc</userinput></term>
	      <listitem>
		<para>International Standard Recording Code [ISRC]</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>label</userinput></term>
	      <listitem>
		<para>Record Label Name (rights holder)</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>outcue</userinput></term>
	      <listitem>
		<para>Cut Outcue</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>publisher</userinput></term>
	      <listitem>
		<para>Music Publisher (rights holder)</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>recording-mbid</userinput></term>
	      <listitem>
		<para>MusicBrainz Recording ID</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>release-mbid</userinput></term>
	      <listitem>
		<para>MusicBrainz Release ID</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>song-id</userinput></term>
	      <listitem>
		<para>Song ID</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>title</userinput></term>
	      <listitem>
		<para>Title</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>user-defined</userinput></term>
	      <listitem>
		<para>Miscelaneous Information</para>
	      </listitem>
	    </varlistentry>

	    <varlistentry>
	      <term><userinput>year</userinput></term>
	      <listitem>
		<para>Year Released (four digit numeric)</para>
	      </listitem>
	    </varlistentry>

	  </variablelist>
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--set-user-defined=</option><replaceable>string</replaceable>
      </term>
      <listitem>
	<para>
	  Deprecated. Use <option>--set-string-user-defined</option> instead.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--single-cart</option>
      </term>
      <listitem>
	<para>
	  If more than one file is imported, place them within multiple cuts
	  within a single cart, rather than creating separate carts for each
	  file.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--startdate-offset=</option><replaceable>days</replaceable>
      </term>
      <listitem>
	<para>
	  If the imported file references a start date, add
	  <replaceable>days</replaceable> days to it.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--title-from-cartchunk-cutid</option>
      </term>
      <listitem>
	<para>
	  Set the cart title from CartChunk CutID.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--ticket=</option><replaceable>ticket-hash</replaceable>:<replaceable>ipv4-address</replaceable>
      </term>
      <listitem>
	<para>
	  Run <command>rdimport</command><manvolnum>1</manvolnum> as the
	  Rivendell user specified by <replaceable>ticket</replaceable>
	  rather than as the currently &quot;logged in&quot; user.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--to-cart=</option><replaceable>cartnum</replaceable>
      </term>
      <listitem>
	<para>
	  Import into cart <replaceable>cartnum</replaceable>, 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 <option>--single-cart</option> and is mutually exclusive
	  with <option>--use-cartchunk-cutid</option>.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--to-mono</option>
      </term>
      <listitem>
	<para>
	  Import the file as a monaural cut. If the file is stereo, both
	  left and right channels will be mixed together.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--use-cartchunk-cutid</option>
      </term>
      <listitem>
	<para>
	  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 <option>--to-cart</option>.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--verbose</option>
      </term>
      <listitem>
	<para>
	  Print progress messages during processing.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--version</option>
      </term>
      <listitem>
	<para>
	  Output version information and exit.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--xml</option>
      </term>
      <listitem>
	<para>
	  Attempt to read file metadata in RDXML format from the file
	  <userinput><replaceable>basename</replaceable>.xml</userinput>.
	  This option is mututally exclusive with the
	  <option>--metadata-pattern</option> option.
	</para>
      </listitem>
    </varlistentry>

  </variablelist>
</refsect1>

<refsect1 id='exit_values'><title>Exit Values</title>
  <para>
    <segmentedlist>
      <?dbhtml list-presentation="tabular"?>
      <?dbfo   list-presentation="tabular"?>
      <segtitle></segtitle>
      <segtitle></segtitle>
      <seglistitem><seg>0</seg><seg>Normal exit</seg></seglistitem>
      <seglistitem><seg>2</seg><seg>Unable to open database</seg></seglistitem>
      <seglistitem><seg>4</seg><seg>Unknown/invalid command line option</seg></seglistitem>
      <seglistitem><seg>13</seg><seg>One or more audio imports failed</seg></seglistitem>
      <seglistitem><seg>14</seg><seg>Unknown dropbox ID</seg></seglistitem>
      <seglistitem><seg>15</seg><seg>No such group</seg></seglistitem>
      <seglistitem><seg>16</seg><seg>Invalid cart number</seg></seglistitem>
      <seglistitem><seg>17</seg><seg>No such scheduler code</seg></seglistitem>
    </segmentedlist>
  </para>
</refsect1>

<refsect1>
  <title>NOTES</title>
  <para>
    It may be necessary to enclose individual
    <replaceable>filespec</replaceable> 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
    <command>rdimport</command><manvolnum>1</manvolnum> to process newly
    added files when running in DropBox mode.
  </para>
</refsect1>

<refsect1>
  <title>BUGS</title>
  <para>
    It could be argued that RMS rather than peak normalization would be
    more appropriate for use with the <option>--normalization-level</option>
    option.
  </para>
</refsect1>

<refsect1 id='see_also'><title>See Also</title>
<para>
  <citerefentry>
    <refentrytitle>sendmail</refentrytitle><manvolnum>1</manvolnum>
  </citerefentry>
  <literal>,</literal>
  <citerefentry>
    <refentrytitle>rdexport</refentrytitle><manvolnum>1</manvolnum>
  </citerefentry>
  <literal>,</literal>
  <citerefentry>
    <refentrytitle>rdmarkerset</refentrytitle><manvolnum>8</manvolnum>
  </citerefentry>
</para>
</refsect1>

</refentry>

