mirror of
https://github.com/ElvishArtisan/rivendell.git
synced 2025-05-20 06:58:01 +02:00
b7f0949049
* Added an 'Evergreen Cuts' section to the 'RDLibrary' chapter of the Operations Guide. * Documented the 'Source' and 'Ingest' fields for Cuts in the 'RDLibrary' chapter of the Operations Guide. Signed-off-by: Fred Gleason <fredg@paravelsystems.com>
1134 lines
42 KiB
XML
1134 lines
42 KiB
XML
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="chapter.rdlibrary">
|
||
<title>Content Management with RDLibrary</title>
|
||
<sect1 xml:id="sect.rdlibrary.the_rivendell_library_structure_and_rdlibrary">
|
||
<title>The Rivendell Library Structure and RDLibrary</title>
|
||
<sect2 xml:id="sect2_rdlibrary_carts">
|
||
<title>Carts</title>
|
||
<para>
|
||
The Rivendell Library consists of a set of objects called
|
||
<emphasis>carts</emphasis> (short for "cartridge", a nod to the days
|
||
when audio material for radio broadcast was commonly loaded to and
|
||
played from physical magnetic tape cartridges).
|
||
A Rivendell cart is a data container that holds either one or more
|
||
pieces of audio (called an <emphasis>audio cart</emphasis>), or macro
|
||
commands to the system
|
||
(called a <emphasis>macro cart</emphasis>). Carts are the
|
||
fundamental schedule
|
||
building block in Rivendell, in that they are the smallest object or
|
||
'atom' that the outside world (like a traffic or music scheduler)
|
||
can see.
|
||
</para>
|
||
<para>
|
||
RDLibrary, upon startup, will show the current list of all carts
|
||
on the system (see below).
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.rdlibrary_screenshot.png" width="154mm" depth="97mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>RDLibrary Main Window</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
A number of important attributes of carts can be seen from this
|
||
illustration. First is the cart's number. Each cart in the Library
|
||
gets assigned a unique number when it is created. This number can
|
||
range between 1 and 999999, and is the primary 'handle' by which
|
||
both Rivendell and external systems (like traffic or music schedulers)
|
||
refer to the cart. Very often, sites have specific rules concerning
|
||
which types of audio (commercials, promos, music, etc) and macros get
|
||
assigned which numbers. We'll cover this area in some detail when
|
||
we discuss groups.
|
||
</para>
|
||
<note>
|
||
Cart numbers in Rivendell are commonly displayed so that they
|
||
always have six digits, even if that means adding leading zeros
|
||
to the numbers --e.g. cart '123' will be displayed as '000123'.
|
||
This convention is used as a visual reminder that the value in
|
||
question is a Rivendell cart number, but it is perfectly valid to use
|
||
numbers without the leading zeros when inputting cart numbers into
|
||
Rivendell.
|
||
</note>
|
||
<para>
|
||
Immediately to the left of the cart number is an icon indicating
|
||
the type of cart. Just to the right of the cart number is the
|
||
average length of the cart. Except in the case of where
|
||
timescaling is in use (in which case it will be indicated in
|
||
blue numerals), this value is calculated automatically by the system.
|
||
</para>
|
||
<para>
|
||
Next comes various columns showing information from the cart
|
||
label – Title, Artist, Client and Agency data, etc. This
|
||
information can be edited by opening RDLibrary's Edit Cart dialog,
|
||
either by double-clicking on the desired cart
|
||
entry in the list, or by touching the desired cart entry and then
|
||
touching the Edit button. In either case, you should get a dialog
|
||
similar to that shown in the illustration.
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.edit_cart_dialog.png" width="114mm" depth="138mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Edit Cart Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
Near the center of the dialog will be a dropdown box labeled
|
||
<computeroutput>Schedule Cuts</computeroutput>. When set to
|
||
<computeroutput>By Weight</computeroutput> (the default), this will
|
||
allow cut rotation to be managed by means of daypart settings (see
|
||
<xref linkend="sect.rdlibrary.cut_dayparting"/>). When set to
|
||
<computeroutput>By Specified Order</computeroutput>, the precise
|
||
rotation of the cuts within the cart can be set manually.
|
||
</para>
|
||
<para>
|
||
This is how an audio cart looks when loaded into the Edit Cart dialog.
|
||
The upper half of the dialog is the cart label data. The meaning
|
||
of most of these fields should be fairly self-evident, but a few
|
||
call for special comment:
|
||
</para>
|
||
<para>
|
||
<variablelist>
|
||
<varlistentry>
|
||
<term>Enforce Length</term>
|
||
<listitem>
|
||
<para>
|
||
When checked, this indicates that timescaling should be
|
||
applied to this cart when it is played in RDAirPlay,
|
||
meaning that the cart will air at the length indicated by
|
||
the Forced Length field, rather than the native length of
|
||
the audio. Care is needed when implementing timescaling
|
||
within a facility, as there are limits to how much the
|
||
length can be altered, while only certain types of audio
|
||
adapters support it at all.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>Group</term>
|
||
<listitem>
|
||
<para>
|
||
This is a pull down menu by which the group ownership for
|
||
the cart can be set. Every cart in Rivendell belongs to
|
||
precisely one group. The system administrator configures
|
||
the list of available groups for each user in RDAdmin, and
|
||
may also define limits to which cart numbers are allowed
|
||
to belong to particular groups.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>Usage</term>
|
||
<listitem>
|
||
<para>
|
||
This defines the use to which the material is put. It
|
||
is included in records generated by the ASCAP/BMI Electronic
|
||
Music Report.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>User Defined</term>
|
||
<listitem>
|
||
<para>
|
||
As the name implies, this field has no dedicated meaning
|
||
to Rivendell itself, but is provided for each site to use
|
||
as is seen fit.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</para>
|
||
<para>
|
||
The example in the illustration above shows an audio cart. As such,
|
||
the bottom half of the dialog displays the lists of cuts contained
|
||
within the cart.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.cuts">
|
||
<title>Cuts</title>
|
||
<para>
|
||
Each audio cart can contain one or more <emphasis>cuts</emphasis>.
|
||
A Rivendell cut is
|
||
an actual piece of audio, somewhat analogous to a 'track' on a CD.
|
||
Up to 999 such cuts can exist within a single cart. Each line in
|
||
the cut list contains information about the cut, including:
|
||
</para>
|
||
<variablelist>
|
||
<varlistentry>
|
||
<term><computeroutput>Wt</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The <emphasis>weighting</emphasis> value for the cut. see
|
||
<xref linkend="sect.rdlibrary.cut_dayparting"/> for discussion.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Order</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The <emphasis>order</emphasis> value for the cut. see
|
||
<xref linkend="sect.rdlibrary.cut_dayparting"/> for discussion.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Description</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
An arbitrary string, assignable by the user as an aid in keeping
|
||
track of the content, it is roughly analogous to the 'Title'
|
||
field in the cart label.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Length</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The actual, measured play out length of the cut audio.
|
||
This field is calculated automatically by the system.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Last Played</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
he last date and time that the cut was aired by one of the
|
||
on-air modules. Useful for keeping track of stale inventory.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput># of Plays</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The total number of times the cut has been aired by the
|
||
one of the on-air modules.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Source</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The Rivendell user and host names from which the audio content
|
||
originated.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Ingest</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The name of the host and the date/time at which the audio content
|
||
was ingested.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Origin</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The name of the host upon which the audio in the cut was last
|
||
recorded, along with the date and time.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Outcue</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
A user settable field. This line shows up in the RDAirPlay
|
||
log display when the cut is played.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Start Date</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The effective start date/time of the cut.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>End Date</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The effective end date/time of the cut.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Start Daypart</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The start time of the cut's daypart.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>End Daypart</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The start time of the cut's daypart.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>Name</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The internal CUTNAME of the cut as used in Rivendell's
|
||
database.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term><computeroutput>SHA1</computeroutput></term>
|
||
<listitem>
|
||
<para>
|
||
The SHA-1 hash value of the cut's file in Rivendell's audio
|
||
store.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
<sect3 xml:id="sect.rdlibrary.multiple_cuts_in_a_cart">
|
||
<title>Multiple Cuts in a Cart</title>
|
||
<para>
|
||
What happens when more than one cut is placed into a cart? The
|
||
default answer, in a word, is <emphasis>rotation</emphasis>.
|
||
Rotation is the ability to
|
||
schedule a single cart in a log, but to have that cart play out
|
||
different material at different times. This capability has
|
||
myriad uses. One of the simplest, common in commercial radio
|
||
facilities, is to allow multiple versions of a spot to be placed
|
||
into the system, while still allowing the traffic department to
|
||
have to track and schedule only one cart number. A more
|
||
sophisticated use involves use of the cut's
|
||
<emphasis>dayparting</emphasis> settings,
|
||
forcing different cuts to play based upon certain date/time
|
||
criteria, such as day of the week or time of day. Cut dayparting
|
||
is a very powerful feature in Rivendell, and is something we
|
||
will discuss shortly.
|
||
</para>
|
||
<para>
|
||
To edit the properties of a cut, either double-click its entry
|
||
in the cut list, or touch it once to highlight and then touch
|
||
the <computeroutput>Cut Info/Record</computeroutput> button.
|
||
The Record Dialog will now open up.
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.edit_cut_info_dialog.png" width="67mm" depth="124mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Record Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
Roughly the upper third of the dialog is for editing the various
|
||
cut parameters, the middle section is for configuring the cut's
|
||
daypart settings, and the bottom third is a record machine that
|
||
can be used both to record new audio into the system and to
|
||
audition any recording already made.
|
||
</para>
|
||
</sect3>
|
||
<sect3 xml:id="sect.rdlibrary.cut_dayparting">
|
||
<title>Cut Dayparting</title>
|
||
<para>
|
||
For carts for which <computeroutput>Schedule Cuts</computeroutput>
|
||
is set to <computeroutput>By Weight</computeroutput>, each cut in
|
||
can be dayparted on the basis of these parameters:
|
||
</para>
|
||
<para>
|
||
<itemizedlist>
|
||
<listitem>
|
||
Weight
|
||
</listitem>
|
||
<listitem>
|
||
Absolute Start and End Date-Time
|
||
</listitem>
|
||
<listitem>
|
||
Relative Start and End Time
|
||
</listitem>
|
||
<listitem>
|
||
Day of the Week
|
||
</listitem>
|
||
</itemizedlist>
|
||
</para>
|
||
<para>
|
||
While not strictly a dayparting parameter, the
|
||
<computeroutput>Weight</computeroutput> setting of a cut can
|
||
strongly influence
|
||
the order (and hence placement) of when a particular cut will play.
|
||
The weight value of each cut in a cart consistutes the numerator
|
||
of a fraction, the denominator of which is the sum of the weight
|
||
values of every cut in the cart. Rivendell's cut selection
|
||
algorithm will seek to play each cut in like proportion. If it is
|
||
important in some cases to be able to specify the precise order
|
||
of each cut play-out, consider changing the
|
||
<computeroutput>Schedule Cuts</computeroutput> dropdown to
|
||
<computeroutput>By Specified Order</computeroutput>.
|
||
</para>
|
||
<para>
|
||
By default, each newly created cut in a
|
||
<computeroutput>By Weight</computeroutput> cart starts out with
|
||
dayparting
|
||
disabled, meaning that it will be 'eligible to play' at all times.
|
||
By clicking the <computeroutput>Enabled</computeroutput> radio
|
||
button in the <computeroutput>Air Date/Time</computeroutput> box, an
|
||
absolute start and end date for the cut can be entered, meaning
|
||
that the cut will be prevented from airing in the on-air modules
|
||
at any time outside the range of those date-times. Likewise, by
|
||
selecting the <computeroutput>Enabled</computeroutput> radio button
|
||
in the <computeroutput>Daypart</computeroutput> box, start and end
|
||
times (relative to the day the cut is to air) can be entered.
|
||
Cuts designated in this way will be allowed to air only within
|
||
the specified range of times. Finally, by ticking or clearing
|
||
the appropriate boxes in the
|
||
<computeroutput>Day of the Week</computeroutput> box, a cut can be
|
||
constrained to air only on certain days of the week.
|
||
</para>
|
||
<para>
|
||
All of the dayparting parameters can be used either singly or in
|
||
combination with each other. When combined, the resulting
|
||
'eligibility' is calculated as the logical AND of the applied
|
||
dayparting limits. For example, a cut with the 'Monday' box
|
||
cleared will refuse to air on Mondays, regardless of whether
|
||
any of the other daypart rules match.
|
||
</para>
|
||
<para>
|
||
It's important to remember that dayparting rules affect audio
|
||
play out only within the on-air modules. You will still be
|
||
able to audition and play the audio without limitation in the
|
||
other Rivendell modules.
|
||
</para>
|
||
<sect4 xml:id="sect.rdlibrary.cut_dayparting.evergreen_cuts">
|
||
<title>Evergreen Cuts</title>
|
||
<para>
|
||
By ticking the <computeroutput>Cut is EVERGREEN</computeroutput>
|
||
box, the cut is played into evergreen mode; wherein the normal
|
||
dayparting rules are bypassed. Instead, such a cut will play if.
|
||
and only if, <emphasis>no other</emphasis> cuts in the cart
|
||
are eligible to play, thus providing insurance in the event that
|
||
other cuts in the cart were not updated in a timely fashion.
|
||
</para>
|
||
</sect4>
|
||
</sect3>
|
||
<sect3 xml:id="sect.rdlibrary.cart_and_cut_color_coding">
|
||
<title>Cart and Cut Color Coding</title>
|
||
<para>
|
||
Each cart or cut in RDLibrary is assigned a color to indicate
|
||
it's 'playability' for air, as follows:
|
||
</para>
|
||
<para>
|
||
<variablelist>
|
||
<varlistentry>
|
||
<term>NO COLOR</term>
|
||
<listitem>
|
||
<para>
|
||
Event will play normally
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>CYAN</term>
|
||
<listitem>
|
||
<para>
|
||
Event will not play (cut datetime is in the future)
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>RED</term>
|
||
<listitem>
|
||
<para>
|
||
Event will not play (outside of dayparting limits or audio
|
||
is not available)
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>GREEN</term>
|
||
<listitem>
|
||
<para>
|
||
Event will play an Evergreen
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</para>
|
||
<caution>
|
||
It's important to remember that the color displayed for each
|
||
event indicates playability <emphasis>at the instant that the event
|
||
is being viewed</emphasis>.
|
||
</caution>
|
||
</sect3>
|
||
<sect3 xml:id="sect.rdlibrary.recording_and_auditioning_a_cut_in_the_record_dialog">
|
||
<title>Recording and Auditioning a Cut in the Record Dialog</title>
|
||
<para>
|
||
The lower third of the Record Dialog is used both to audition and
|
||
record audio. To audition the cut, simply press the play button
|
||
(the one with the triangular symbol). The button will
|
||
illuminate, audio will show on the bar meter and start playing
|
||
immediately. The audio will play to completion, unless either
|
||
the stop button (square symbol) is pressed, or the Record Dialog
|
||
is closed.
|
||
</para>
|
||
<para>
|
||
To record new material into a cut, first ensure that the
|
||
<computeroutput>Channels</computeroutput>
|
||
drop-down menu is set to record the appropriate number of channels,
|
||
then touch the <computeroutput>Record</computeroutput> button
|
||
(round symbol). If the cut contains
|
||
audio that was recorded previously, a warning box will pop up at
|
||
this point to inform you of this and to give you a chance to abort
|
||
the recording without erasing what was previously recorded. If
|
||
<computeroutput>Yes</computeroutput> is selected here, the
|
||
previous recording will be overwritten
|
||
and no longer accessible.
|
||
The <computeroutput>Record</computeroutput> button will now be
|
||
illuminated steadily, while the
|
||
<computeroutput>Play</computeroutput> button will be flashing,
|
||
indicating that the record machine is in 'ready' mode. The bar
|
||
meter will also be active to indicate input levels, and this is
|
||
the point where you want to verify that your levels are correct,
|
||
with peaks just into the yellow area being optimal. Nothing is
|
||
actually being recorded just yet.
|
||
</para>
|
||
<para>
|
||
We have two options for actually starting the record machine.
|
||
We can start it manually by pressing the
|
||
<computeroutput>Play</computeroutput> button, at which
|
||
point the machine will immediately begin recording, or we can set
|
||
the <computeroutput>Record Mode</computeroutput> drop-down menu
|
||
to the <computeroutput>VOX</computeroutput> (short for voice
|
||
activated) setting. When in <computeroutput>VOX</computeroutput>
|
||
mode, the record machine will
|
||
start automatically as soon as it senses the presence of audio
|
||
at the input.
|
||
</para>
|
||
<para>
|
||
Once started, recording will continue until either the
|
||
<computeroutput>Stop</computeroutput> button
|
||
is pushed, or the maximum allowed length for a manual recording
|
||
(set by the system administrator) has been reached. Once stopped,
|
||
if the <computeroutput>AutoTrim</computeroutput> drop-down menu
|
||
has been set to <computeroutput>On</computeroutput>, the Start and
|
||
End markers will be automatically set to the beginning and end of
|
||
detected audio within the cut. (We will discuss Markers in detail
|
||
when we get to the section on the Edit Markers dialog).
|
||
</para>
|
||
</sect3>
|
||
</sect2>
|
||
</sect1>
|
||
<sect1 xml:id="sect.rdlibrary.alternative_methods_of_audio_ingestion">
|
||
<title>Alternative Methods of Audio Ingestion</title>
|
||
<para>
|
||
In addition to manually recording material in realtime, RDLibrary
|
||
supports two alternative methods for audio ingestion:
|
||
</para>
|
||
<para>
|
||
<itemizedlist>
|
||
<listitem>
|
||
Importing from a File
|
||
</listitem>
|
||
<listitem>
|
||
Ripping from a CD
|
||
</listitem>
|
||
</itemizedlist>
|
||
</para>
|
||
<sect2 xml:id="sect2_rdlibrary_importing_audio_from_a_file">
|
||
<title>Importing Audio from a File</title>
|
||
<para>
|
||
To import audio from a file directly into a cut, we start by
|
||
opening the cut's parent cart in the Edit Cart Dialog. Next,
|
||
touch the cut's entry in the cut list and then touch the
|
||
<computeroutput>Import/Export</computeroutput> button to open the
|
||
Import/Export Audio Dialog.
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.import_export_dialog.png" width="84mm" depth="65mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Import/Export Audio Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
Select the file you wish to import, either by entering the path
|
||
and filename to it in the <computeroutput>Filename</computeroutput>
|
||
field or by clicking the <computeroutput>Select</computeroutput>
|
||
button to open a file browsing dialog. Rivendell is capable of
|
||
importing the following types of audio files:
|
||
</para>
|
||
<para>
|
||
<itemizedlist>
|
||
<listitem>
|
||
Microsoft WAV (*.wav) – PCM16, PCM24 and MPEG are supported
|
||
</listitem>
|
||
<listitem>
|
||
MPEG (*.mp1, *.mp2, *.mp3)
|
||
</listitem>
|
||
<listitem>
|
||
OggVorbis (*.ogg)
|
||
</listitem>
|
||
<listitem>
|
||
Free Lossless Audio Codec [FLAC] (*.flac)
|
||
</listitem>
|
||
</itemizedlist>
|
||
</para>
|
||
<para>
|
||
Next, set the <computeroutput>Channels</computeroutput> drop-down
|
||
menu to the appropriate number of
|
||
channels. You may also wish to adjust the
|
||
<computeroutput>Normalize</computeroutput> or
|
||
<computeroutput>Autotrim</computeroutput>
|
||
controls, although these will normally be set to reasonable default
|
||
values by the system administrator and should seldom have to be
|
||
altered. If <computeroutput>Normalize</computeroutput> is selected,
|
||
then the imported audio will
|
||
be peak normalized to the level indicated. The
|
||
<computeroutput>Autotrim</computeroutput> does the
|
||
same thing as in the Record Dialog (see section 2.0.1.2, 'Recording
|
||
and Auditioning a Cut in the Record Dialog' above for details).
|
||
</para>
|
||
<para>
|
||
Finally, touch the <computeroutput>Import</computeroutput> button.
|
||
A progress bar will indicate
|
||
percentage completion of the import, followed by a popup box to
|
||
announce completion. The Import Audio Dialog will automatically
|
||
close after acknowledging completion. The audio is now imported,
|
||
and can now be auditioned and otherwise processed in the usual way.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.importing_audio_from_a_cd_track">
|
||
<title>Ripping Audio from a CD Track</title>
|
||
<para>
|
||
To rip audio directly off of a CD into a cut, we again start by
|
||
opening the cut's parent cart in the Edit Cart Dialog. Next,
|
||
select the cut's by touching the cut's entry in the cut list,
|
||
and then touch the <computeroutput>Rip</computeroutput> button
|
||
to open the Rip CD Dialog.
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.cd_ripper_dialog.png" width="130mm" depth="116mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Rip CD Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
Load a CD into the CD drive. After a few seconds, list of tracks
|
||
should appear in the Tracks area. If the system administrator has
|
||
enabled it, the system will attempt to locate a record for the
|
||
disc at the MusicBranz.org music encyclopedia. If it finds a
|
||
record there, the disc title and track information will be populated
|
||
automatically.
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.cd_ripper_dialog_mb_success.png" width="130mm" depth="116mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>A typical MusicBrainz lookup</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<note>
|
||
It's possible that a disc will match more than one MusicBrainz record,
|
||
in which case the system will present a dialog asking you to select
|
||
the actual disc being used.
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.cd_ripper_dialog_mb_choose_disc.png" width="80mm" depth="30mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The MusicBrainz Multiple Matches Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
If this occurs, select one or more entries from the dropdown list
|
||
and then touch <computeroutput>OK</computeroutput>. If more than
|
||
one track is selected, the selected tracks will be seamlessly
|
||
concatenated together in the target cut.
|
||
</para>
|
||
</note>
|
||
<para>
|
||
Set the <computeroutput>Channels</computeroutput>,
|
||
<computeroutput>Normalize</computeroutput> and
|
||
<computeroutput>Autotrim</computeroutput> controls appropriately (see
|
||
<xref linkend="sect2_rdlibrary_importing_audio_from_a_file" />
|
||
for details on using the
|
||
<computeroutput>Normalize</computeroutput> and
|
||
<computeroutput>Autotrim</computeroutput>
|
||
controls). Next, touch the track you wish to rip and then press
|
||
the <computeroutput>Rip Track</computeroutput> button. The track will
|
||
now be ripped into the cut,
|
||
with a progress bar keeping you informed of progress. When the
|
||
rip is complete, a message box will pop up to inform you of this.
|
||
</para>
|
||
<para>
|
||
If MusicBrainz data was found for the CD, you can have that
|
||
information automatically be placed on the cart label
|
||
for the cart by ticking the
|
||
<computeroutput>Apply MusicBrainz Values to Cart</computeroutput>
|
||
box before closing the Dialog.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.ripping_multiple_cd_tracks_at_a_time">
|
||
<title>Ripping Multiple CD Tracks at a Time</title>
|
||
<para>
|
||
Sometimes, when transferring multiple audio tracks from CD,
|
||
it's more convenient to be able to set up the entire transfer at
|
||
once and then let the rip run in a 'batch' mode. RDLibrary is
|
||
capable of ripping audio in this manner as well. To do this, click
|
||
the <computeroutput>Rip CD</computeroutput> button near the bottom of
|
||
the main RDLibrary screen, bringing up the Rip Disk Dialog.
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.rip_disk_dialog.png" width="130mm" depth="138mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Rip Disk Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
This dialog is similar in many ways to the Rip CD Dialog described
|
||
above, except that each track or range of tracks can be assigned to
|
||
ripped to a different cut by double clicking on its listing or
|
||
selecting the desired tracks, touching the listing and then the
|
||
<computeroutput>Set Cart/Cut</computeroutput> button, bringing up
|
||
the Select Cart/Cut Dialog. It's also possible to create a new
|
||
cart automatically for each selected set of tracks by touching the
|
||
<computeroutput>Add Cart Per Track</computeroutput> or
|
||
<computeroutput>Add Single Cart</computeroutput> buttons.
|
||
</para>
|
||
<para>
|
||
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.set_cart_cut_dialog.png" width="143mm" depth="60mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Set Cart/Cut Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
Select the desired cut to rip to and then touch the
|
||
<computeroutput>OK</computeroutput> button, or create a new,
|
||
empty cart/cut by touching the
|
||
<computeroutput>Add New Cart</computeroutput> button.
|
||
The complete set of library filtering tools are
|
||
available to you here – see
|
||
<xref linkend="sect.rdlibrary.navigating_the_audio_library" />
|
||
for details on their function, just as in the main RDLibrary
|
||
screen.
|
||
</para>
|
||
<para>
|
||
Once all of the desired tracks have been assigned to cuts, be sure
|
||
that the <computeroutput>Normalize</computeroutput>,
|
||
<computeroutput>Autotrim</computeroutput>,
|
||
<computeroutput>Channels</computeroutput> and
|
||
<computeroutput>Apply FreeDB Values to Cart</computeroutput>
|
||
controls have been set as desired, then click the
|
||
<computeroutput>Rip Disk</computeroutput>
|
||
button. A set of progress bars will keep you informed of the
|
||
progress of each track, as well as overall progress. When, the
|
||
rip is finished, a message box will let you know.
|
||
</para>
|
||
</sect2>
|
||
</sect1>
|
||
<sect1 xml:id="sect.rdlibrary.macro_carts">
|
||
<title>Macro Carts</title>
|
||
<para>
|
||
A macro cart is a cart that contains one or more commands written in
|
||
Rivendell Macro Language (or 'RML' for short). The Edit Cart dialog
|
||
for a macro cart is similar in many ways to that for an audio cart
|
||
with the exception of the lower half, which contains a list of RML
|
||
commands to be executed rather than a list of cuts. (NOTE: for a
|
||
complete description of Rivendell Macro Language,
|
||
including a breakdown of available commands, see
|
||
<xref linkend="chapter.rml"/>).
|
||
</para>
|
||
<para>
|
||
To add a new line of RML, select the desired location in the list
|
||
and touch the <computeroutput>Add button</computeroutput>.
|
||
Similarly, a line can be deleted by
|
||
selecting it and then touching the
|
||
<computeroutput>Delete</computeroutput> button, or modified by
|
||
touching the <computeroutput>Edit</computeroutput> button. The RML
|
||
can be tested, either line-by-line
|
||
or as a whole by touching the <computeroutput>Run Line</computeroutput>
|
||
or <computeroutput>Run Cart</computeroutput> button
|
||
respectively. It is also possible to
|
||
<computeroutput>Copy</computeroutput> and
|
||
<computeroutput>Paste</computeroutput> individual
|
||
lines both within a given cart or between carts.
|
||
</para>
|
||
<para>
|
||
In addition to RML code, lines can also contain host variables
|
||
(see <xref linkend="sect.rdadmin.manage_hosts.configuring_host_variables" />)
|
||
and filepath wildcards
|
||
(see <xref linkend="appendix.filepath_wildcards" />).
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.edit_macro_cart_dialog.png" width="114mm" depth="138mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Edit Macro Cart Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
</sect1>
|
||
<sect1 xml:id="sect.rdlibrary.navigating_the_audio_library">
|
||
<title>Navigating the Audio Library</title>
|
||
<para>
|
||
The uppermost section of RDLibrary's main window contains tools
|
||
designed to allow for fast searching of the entire audio library,
|
||
making locating a particular piece of audio easy even in a library
|
||
containing thousands of carts. It's possible to control what carts
|
||
are listed, as well as how they are sorted.
|
||
</para>
|
||
<sect2 xml:id="sect.rdlibrary.changing_the_cart_sort_order">
|
||
<title>Changing the Cart Sort Order</title>
|
||
<para>
|
||
The order in which carts are displayed in the cart list can be
|
||
changed by simply clicking on the header of the column by which
|
||
you want them sorted by. By default, the carts are sorted by Cart
|
||
Number. To sort them alphabetically by Title instead, simply click
|
||
the <computeroutput>Title</computeroutput> header once.
|
||
To sort them by Title in reverse --i.e.
|
||
from 'Z' to 'A' – click the <computeroutput>Title</computeroutput>
|
||
header once again. Clicking the
|
||
<computeroutput>Title</computeroutput> header a third time restores
|
||
the sort to normal 'A' to 'Z' again. And so on for all of the columns
|
||
in the cart list – it's
|
||
possible to sort the Library by
|
||
<computeroutput>Artist</computeroutput>,
|
||
<computeroutput>Length</computeroutput>, or any other
|
||
parameter shown in the cart list.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.selecting_carts_by_the_filter_field">
|
||
<title>Selecting Carts by the Filter Field</title>
|
||
<para>
|
||
Often, one will want to find a cart or set of carts whose
|
||
label(s) contains a particular word or phrase. It's possible to
|
||
narrow the list of displayed carts to this set by simply entering
|
||
the desired word or phrase into the
|
||
<computeroutput>Filter</computeroutput> field at the top of the
|
||
main RDLibrary screen. The full list can be restored by clearing
|
||
the <computeroutput>Filter</computeroutput> field or by clicking
|
||
the Clear button.
|
||
</para>
|
||
<note>
|
||
For a detailed description of search filter syntax, including
|
||
examples, see <xref linkend="appendix.library_searches" />.
|
||
</note>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.selecting_carts_by_group">
|
||
<title>Selecting Carts by Group</title>
|
||
<para>
|
||
It's possible to limit the list of carts to only those in a
|
||
particular group by setting the <computeroutput>Group</computeroutput>
|
||
drop-down menu to the
|
||
desired group name.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.selecting_carts_by_type">
|
||
<title>Selecting Carts by Type</title>
|
||
<para>
|
||
You can tell RDLibrary what type of carts to list by checking the
|
||
<computeroutput>Show Audio Carts</computeroutput> and
|
||
<computeroutput>Show Macro Carts</computeroutput> boxes. Clearing
|
||
both boxes
|
||
obviously results in no carts at all being displayed.
|
||
</para>
|
||
<para>
|
||
It's also possible to combine all four of the above search and
|
||
sorting methods.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.selecting_and_opening_carts">
|
||
<title>Selecting and Opening Carts</title>
|
||
<para>
|
||
Once the desired cart has been located on the cart list, load it
|
||
into the Edit Cart Dialog by either double
|
||
clicking its list entry, or by touching its list entry and then
|
||
touching the <computeroutput>Edit</computeroutput> button.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.viewing_and_selecting_cuts">
|
||
<title>Viewing and Selecting Cuts</title>
|
||
<para>
|
||
If a cart contains more than one cut, you can view all the cuts
|
||
contained by the cart by clicking the
|
||
<computeroutput>+</computeroutput> icon. The cuts can be
|
||
hidden by clicking the <computeroutput>-</computeroutput>
|
||
icon.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.playing_carts_and_cuts">
|
||
<title>Playing Carts and Cuts</title>
|
||
<para>
|
||
A selected cart or cut can be played by either pressing the
|
||
play button (the one with the triangular symbol) or by
|
||
pressing the space bar. If a cart or cut is currently
|
||
playing, selecting another cart or cut with the mouse
|
||
or arrow keys will automatically play the newly selected
|
||
item. To stop a playing cart or cut, press the stop button
|
||
(square symbol) or press the space bar again.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.runnings_macros">
|
||
<title>Running Macros</title>
|
||
<para>
|
||
A selected macro can be run by pressing the
|
||
<computeroutput>Run Macro</computeroutput> button.
|
||
</para>
|
||
</sect2>
|
||
</sect1>
|
||
<sect1 xml:id="sect.rdlibrary.library_maintenance">
|
||
<title>Library Maintenance</title>
|
||
<sect2 xml:id="rdlibrary.editing_markers">
|
||
<title>Editing Markers</title>
|
||
<para>
|
||
Rivendell uses a system of cue points within audio cuts, referred
|
||
to as <emphasis>markers</emphasis>. Markers can be used to specify
|
||
a number of parameters for a piece of audio. They are set in the
|
||
Edit Markers Dialog. To access the Dialog, open an audio cart,
|
||
select the cut to open on the cut list and then touch the
|
||
<computeroutput>Edit Markers</computeroutput> button.
|
||
</para>
|
||
<para>
|
||
The Dialog is divided into three areas: the waveform area in the
|
||
upper half, consisting of the waveform display and
|
||
<computeroutput>Amplitude</computeroutput> and
|
||
<computeroutput>Time</computeroutput> buttons; the transport
|
||
controls area in the center, consisting
|
||
of <computeroutput>Start</computeroutput>,
|
||
<computeroutput>Pause</computeroutput>,
|
||
<computeroutput>Stop</computeroutput> and
|
||
<computeroutput>Loop</computeroutput> buttons along with an
|
||
audio meter and marker position readouts,
|
||
and the bottom section containing the usual
|
||
<computeroutput>OK</computeroutput> and
|
||
<computeroutput>Cancel</computeroutput> buttons.
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.edit_marker_dialog.png" width="150mm" depth="90mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Edit Marker Dialog</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
<para>
|
||
It's possible to 'zoom-in' on the waveform in various ways by
|
||
clicking the <computeroutput>Amplitude</computeroutput>
|
||
and <computeroutput>Time</computeroutput> buttons.
|
||
By default, the waveform
|
||
is displayed fully 'zoomed-out', thus showing the entire length of
|
||
the audio cut. The <computeroutput>GoTo</computeroutput> buttons
|
||
can be used to jump directly to
|
||
the current play out cursor position, start or end of the waveform.
|
||
</para>
|
||
<para>
|
||
Audio can be played one of two ways: either by clicking on the
|
||
waveform to indicate where play out should start and then clicking
|
||
the left-hand <computeroutput>Play</computeroutput> button,
|
||
causing play out to start from the
|
||
selected position, or by clicking the center
|
||
<computeroutput>Play</computeroutput> button, which
|
||
will cause play out to start from the currently selected start
|
||
marker.
|
||
Clicking the <computeroutput>Loop</computeroutput> button will
|
||
cause the audio to play out
|
||
continuously, looping from end back to start, until either the
|
||
<computeroutput>Stop</computeroutput>,
|
||
<computeroutput>Save</computeroutput> or
|
||
<computeroutput>Cancel</computeroutput> buttons are clicked.
|
||
</para>
|
||
<para>
|
||
All cuts have <computeroutput>Cut</computeroutput> markers, used
|
||
to indicate the absolute start and end of the cut when played on-air.
|
||
To adjust the position of the markers, position the mouse cursor
|
||
over one of the arrows on the marker, press and hold the left-hand
|
||
mouse button and drag it to the desired location. The marker's
|
||
arrows will become larger to indicate that the marker has been
|
||
selected.
|
||
</para>
|
||
<para>
|
||
Additional markers can be set as follows:
|
||
</para>
|
||
<variablelist>
|
||
<varlistentry>
|
||
<term>
|
||
<computeroutput>Fade Down</computeroutput>
|
||
</term>
|
||
<listitem>
|
||
<para>
|
||
Indicates the point in the cut play-out to begin a steady
|
||
fade down that will continue until the end
|
||
<computeroutput>Cut</computeroutput> marker.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>
|
||
<computeroutput>Fade Up</computeroutput>
|
||
</term>
|
||
<listitem>
|
||
<para>
|
||
Indicates the point in the cut play-out to end a steady
|
||
fade up that starts at the start
|
||
<computeroutput>Cut</computeroutput> marker.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>
|
||
<computeroutput>Hook</computeroutput>
|
||
</term>
|
||
<listitem>
|
||
<para>
|
||
Indicates the portion of the cut to be played by a
|
||
sound panel when in <computeroutput>Hook</computeroutput>
|
||
mode.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>
|
||
<computeroutput>Segue</computeroutput>
|
||
</term>
|
||
<listitem>
|
||
<para>
|
||
Indicates the portion of the cut to be
|
||
overlapped with audio from the following log
|
||
event when used with a <computeroutput>SEGUE</computeroutput>
|
||
transition in
|
||
<command>rdairplay</command><manvolnum>1</manvolnum>.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry>
|
||
<term>
|
||
<computeroutput>Talk</computeroutput>
|
||
</term>
|
||
<listitem>
|
||
<para>
|
||
Indicates the start and end points of the "Pie Widget"
|
||
talk timer when the cut is played in
|
||
<command>rdairplay</command><manvolnum>1</manvolnum>.
|
||
</para>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
<para>
|
||
To add a marker, position the mouse cursor on the waveform, press
|
||
the right-hand button and select the desired marker from the pop-up
|
||
menu. Once added, a marker can be repositioned in the usual way.
|
||
</para>
|
||
<para>
|
||
To delete a marker, position the mouse cursor on one of the marker's
|
||
arrows, press the right-hand button and select
|
||
<computeroutput>Delete Marker</computeroutput> from the pop-up menu.
|
||
</para>
|
||
<para>
|
||
<mediaobject>
|
||
<imageobject>
|
||
<imagedata align="center" fileref="rdlibrary.edit_marker_dialog.marker_menu.png" width="150mm" depth="90mm"/>
|
||
</imageobject>
|
||
<caption>
|
||
<para>The Marker Menu</para>
|
||
</caption>
|
||
</mediaobject>
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.copying_and_pasting_audio_from_cut_to_cut">
|
||
<title>Copying and Pasting Audio from Cut to Cut</title>
|
||
<para>
|
||
It's possible to make copies of an existing audio cut on the system
|
||
by opening up the cut's parent cart in the Edit Cart Dialog,
|
||
selecting it on the cut list and clicking the
|
||
<computeroutput>Copy</computeroutput> button. To
|
||
paste the copied audio, simply select the desired destination
|
||
cut (within the same cart or a different one) and press
|
||
<computeroutput>Paste</computeroutput>.
|
||
</para>
|
||
</sect2>
|
||
</sect1>
|
||
<sect1 xml:id="sect.rdlibrary.generating_library_reports">
|
||
<title>Generating Library Reports</title>
|
||
<para>
|
||
Various Library reports can be generated by touching the
|
||
<computeroutput>Reports</computeroutput>
|
||
button on the main RDLibrary screen and then selecting the desired
|
||
report and touching the <computeroutput>Generate</computeroutput>
|
||
button. The contents of the resulting report will be filtered
|
||
according to RDLibrary's the current search parameters.
|
||
</para>
|
||
<para>
|
||
The following reports are available:
|
||
</para>
|
||
<sect2 xml:id="sect.rdlibrary.the_cart_report">
|
||
<title>The Cart Report</title>
|
||
<para>
|
||
The cart report consists of a list of all selected carts on the
|
||
system, with their attributes.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.the_cut_report">
|
||
<title>The Cut Report</title>
|
||
<para>
|
||
The cut report consists of a list of all cuts contained by the
|
||
selected carts on the system, with their attributes.
|
||
</para>
|
||
</sect2>
|
||
<sect2 xml:id="sect.rdlibrary.the_cart_data_dump__csv_">
|
||
<title>The Cart Data Dump (CSV)</title>
|
||
<para>
|
||
The CSV cart data dump is a special type of report that
|
||
consists of CSV formatted data elements, one line per cut for the
|
||
selected
|
||
carts on the system. It is intended for use where a 'dump' of
|
||
available carts in the system is desired for import into an
|
||
external system (such as a music scheduling system).
|
||
</para>
|
||
</sect2>
|
||
</sect1>
|
||
</chapter>
|