<?xml version="1.0" encoding="ISO-8859-1"?>
<refentry id="stdin" xmlns="http://docbook.org/ns/docbook" version="5.0">
  <!--
      Header
  -->
  <refmeta>
    <refentrytitle>rdmarkerset</refentrytitle>
    <manvolnum>8</manvolnum>
    <refmiscinfo class='source'>June 2016</refmiscinfo>
    <refmiscinfo class='manual'>Linux Audio Manual</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>rdmarkerset</refname>
    <refpurpose>Tool for mass altering Rivendell audio cut markers</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>rdmarkerset</command>
      <arg choice='opt'><replaceable>OPTIONS</replaceable></arg>
      <sbr/>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1 id='description'><title>Description</title>
  <para>
    <command>rdmarkerset</command><manvolnum>8</manvolnum> is a command-line
    tool for setting or altering audio cut markers in the Rivendell Radio
    Automation System.
  </para>
  </refsect1>

  <refsect1 id='options'><title>Options</title>
  <variablelist remap='TP'>
    <varlistentry>
      <term>
	<option>--all-groups</option>
      </term>
      <listitem>
	<para>
	  Apply marker changes to ALL audio cuts in the Library.
	  Use of this option is mutually exclusive with the
	  <userinput>--group</userinput> option, below.  Use with caution!
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--auto-segue=</option><replaceable>level</replaceable>
      </term>
      <listitem>
	<para>
	  Set the Segue Start marker on the specified cuts to
	  <replaceable>level</replaceable> dBFS and the Segue End marker
	  to the position of the End marker.  Specifying a
	  <userinput>0</userinput> for <replaceable>level</replaceable>
	  will remove the segue markers. Default action is to leave the
	  segue markers unaltered.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--auto-trim=</option><replaceable>level</replaceable>
      </term>
      <listitem>
	<para>
	  Auto-trim the specified cuts to <replaceable>level</replaceable>
	  dBFS.  Specifying a <userinput>0</userinput> for
	  <replaceable>level</replaceable> will remove auto-trim --i.e.
	  move the Start and End markers to the extreme start and end of
	  the audio data.  Default action is to leave the Start and End
	  markers unaltered.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--group=</option><replaceable>group</replaceable>
      </term>
      <listitem>
	<para>
	  Apply marker changes to the audio cuts belonging to
	  <replaceable>group</replaceable>.  This option may be given
	  multiple times.  Use of this option is mutually exclusive with
	  the <userinput>--all-groups</userinput> option, above.
	</para>
      </listitem>
    </varlistentry>

    <varlistentry>
      <term>
	<option>--verbose</option>
      </term>
      <listitem>
	<para>
	  Print messages to STDOUT describing progress.
	</para>
      </listitem>
    </varlistentry>

  </variablelist>

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

</refentry>

