Rivendell Operations GuideVersion 1.3.0-1by Fred Gleason
6.3.0 Adding an Event6.3.1 Moving an Event6.3.2 Deleting an Event6.3.3 Copying an EventSection 6.4 – The SoundPanel6.4.0 Panel Types6.4.1Programming a
waveform. This start location can be adjusted by dragging the topmost waveform to the left or right by means of the mouse or touchscreen. If the tra
8.1.3 Moving Between Track MarkersIt is possible to move directly to the next or previous voicetrack marker simply by touching the Next Track or Previ
state. It is also possible to undo a completed voicetrack by touching the Do Over button.Once completed, the segue overlaps into and out of a voicetr
button to open the Import/Export Audio dialog (see Illustration 5). (For more information on using the Import/Export Audio dialog, see Section 3.1.0
Chapter NineRivendell Macro Langauge
Section 9.0 OverviewRivendell Macro Language (or RML for short) is a set of commands implemented within Rivendell that can be used to program the syst
BINARY SERIAL OUT Code: BOSyntax: BO <port-num> <hex-code> <...>!Output a string of binary codes represented by <hex-code> &l
FIRE SALVOCode: FSSyntax:FS <matrix> <salvo-num>!Fire salvo number <salvo-num> on matrix <matrix>.GPI ENABLEMnemonic: GESyntax
Appendix A – The GNU General Public License, Version TwoAppendix B – The Creative Commons Non-Commercial ShareAlike License 2.5Change History
GPO SET (old format, deprecated)Code: GOSyntax: GO <matrix> <gpo-num> <state> <length>!Command GPO line <gpo-num> on m
Set the next event for RDAirPlay log machine <mach> to line <line>. Values for <mach> are: 1 = Main Log, 2 = Aux 1 Log, 3 = Aux 2
SERIAL OUT Code: SOSyntax: SO <port-num> <string>!Output <string> on serial port <port-num>!SERIAL RELOADCode: SYSyntax:SY &l
SET LABELCode: LBSyntax:LB <string>!Display <string> in the label area of RDAirPlay. SET MODECode: PMSyntax:PM <mode>!Set the RDAirP
START RECORD DECKMneumonic: RSSyntax:RS <deck-num> <cart-num> <cut-num> <max_len>!Start recording to cut <cut-num> of c
SWITCH ADD WITH GAINCode: SGSyntax:SG <matrix> <source> <dest> <gain>!Command switch matrix number <matrix> to add input
SWITCH TAKE Code: STSyntax:ST <matrix> <source> <dest>!Command switch matrix number <matrix> to take input number <source&g
Chapter TenInterfacing with the Linux Ecosystem: RMLSend and RDImport
Section 10.0 RMLSendRMLSend is a small utility that can be used to send RML commands to a local or remote Rivendell host. It can operate in two modes
Examples: rmlsend LL\ TestLog\! Send the RML command 'LL 1 TestLog!' to the local host. rmlsend --to-host=host.example.com --to-port=5858
--single-cart If more than one file is imported, place them within multiple cuts within a single cart, rather than creating separate carts fo
Boundaries between metadata fields are indicated by placing regular characters between macros. For example, the pattern '%t_%a_%g_%n.&a
Appendix AThe GNU General Public License, Version Two
GNU GENERAL PUBLIC LICENSEVersion 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-
effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not li
c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use
to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the prog
obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistri
Chapter OneSystem Overview
and of promoting the sharing and reuse of software generally.NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at y
Appendix BThe Creative Commons Attribution-Noncommercial-ShareAlike License 2.5
Document Change History2005-11-28 Fred Gleason <[email protected]> Initial document release, Chapters 1 -32006-09-27 Fred Gleason <fr
Section 1.0 Introducing RivendellRivendell is a digital audio content management and delivery system that is targeted for use in professional radio br
The operation of each of these modules is explained in detail in the chapters that follow. However, we first need to cover some basic concepts common
1.1.3 ServicesEvery facility at which Rivendell is deployed is presumed to have one or more ultimate destinations for which audio is intended. These
execution of all clients. More information can be found at the JACK web site, http://jackit.sourceforge.net/.1.2.1 Serial PortsCommonly known in the
Chapter TwoManaging the Current User with RDLogin
Section 2.0 RDLoginRivendell uses a sophisticated system of user privileges to keep track of which users have permission to perform what operations.
Chapter ThreeContent Management with RDLibrary
Section 3.0 The Rivendell Library Structure and RDLibrary3.0.0 CartsThe Rivendell Library consists of a set of objects called carts. A cart is a data
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 ca
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 timesc
word, is rotation. Rotation is the ability to schedule a single cart in a log, but to have that cart play out different material at different times.
a record machine that can be used both to record new audio into the system and to audition any recording already made.3.0.1.1 Cut DaypartingEach cut i
Rivendell Automation SystemSystem Operations Guideby Frederick F. Gleason, Jr.
3.0.1.3 Recording and Auditioning a Cut in the Record DialogThe lower third of the Record Dialog is used both to audition and record audio. To auditio
cart in the Edit Cart Dialog. Next, touch the cut's entry in the cut list and then touch the Import/Export button to open the Import/Export Audi
3.1.1 Ripping Audio from a CD TrackTo rip audio directly off of a CD into a cut, we again start by opening the cut's parent cart in the Edit Cart
If FreeDB data was found for the CD, you can have the FreeDB track, artist and album names be automatically placed on the cart label for the cart by c
the Audio Library' for details on their function, just as in the main RDLibrary screen.Illustration 8: The Select Cut DialogOnce all of the desir
Section 3.3 Navigating the Audio LibraryThe uppermost section of RDLibrary's main window contains tools designed to allow for fast searching of t
3.3.1 Selecting Carts by the Filter FieldVery 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 'zoom-in' on the waveform in various ways by clicking the Amplitude and Time buttons. By default, the waveform is dis
To set a marker, click on the corresponding marker button and then left-click on the waveform area to indicate where on the audio the marker should be
cut (within the same cart or a different one) and press Paste.Section 3.5 – Generating Library ReportsVarious Library reports can be generated by touc
Chapter FourAutomating Tasks with RDCatch
Section 4.0 Choosing the Correct Automation ToolRivendell includes two modules specially optimized for performing automatic operations: The RDCatch an
button, used to manually stop an event running in the deck. A description of the currently running event next appears (this area will be blank if no
4.1.1 The Filter AreaImmediately below the decks is the filter area, consisting of the Show Only Active Events, Show Only Today's Events and Show
forms: a hard time, which is simply an absolute time (in twenty-four hour 'military' format), a length (in HH:MM format, relative to an ear
Section 4.2 – Adding New EventsA new event can be added to the event list by simply clicking the Add button to bring up the Add Event Dialog (see Illu
Illustration 13: The Edit Recording Dialog4.3.2 The 'End Parameters' SectionThe end parameters of each recording are configured in the &apos
4.3.4 Selecting a Record SourceIf the selected record deck (chosen in the Location drop-down menu at the top of the dialog) as been configured to oper
Section 4.5 – Automating Uploads/DownloadsIt's possible to use RDCatch to automatically upload and download material from both local and Internet
of the Export Format control. This is used to set what file format should be used for the upload. Depending upon what software encoders have been in
WILDCARD MEANING%a Abbreviated Weekday Name (e.g. mon, tue)%A Full Weekday Name (e.g. monday, tuesday)%b Abbreviated Month Name (e.g. jan, feb)%B Full
Illustration 16: The Edit Upload DialogIllustration 17: The Edit Cart Event DialogSection 4.7 – Automating Switcher OperationsIt's possible to co
Illustration 18: The Edit Switcher Event Dialog
Chapter FiveGenerating and Maintaining Logs with RDLogEdit
Section 5.0 Logs and Log EventsA Rivendell log is a sequence of one or more events to be executed by the system, arranged in chronological order. (Th
Next comes a column showing the owning service. Each log is owned by exactly one service, which determines under what circumstances the log can be pl
5.0.2 Macro CartsA macro cart is a cart from the Library that contains one or more system commands that can be used to cause the system to take variou
5.0.4 Track MarkersA track marker is another meta event that is very similar in operation to note markers, with one key addition: track markers desig
Section 5.1 Event TransitionsEach event in a log has a transition type, shown in the “TRANS” column of the Edit Log dialog. The transition type deter
5.1.2 The SEGUE TransitionSEGUE transitions are similar to PLAY transitions, with one key difference: if the finishing event contains segue data (eit
5.2.2.1 Start ImmediatelyAs implied by the name, if the event is set to start immediately, it will be started as soon as the hard time is reached. An
field if the number is already known. The Title and Artist information will be automatically supplied by the system from the cart's label.5.3.2
to help identify the type of material.
Chapter SixRunning Logs with RDAirPlay
Section 6.0 OverviewRDAirPlay is the Rivendell module used to run logs generated by the RDLogEdit or RDLogManager (for an overview of Rivendell logs,
Table of ContentsChapter 1 -- System OverviewSection 1.0 – Introducing RivendellSection 1.1 – The Rivendell Security System1.1.0 Hosts1.1.1 Users1.1.2
The top area contains the following indicators:6.2.0 The Wall ClockIn the upper left-hand corner is wall clock indicator, which indicates the current
If the playout is such that the post point will be reached one second or more before its programmed time, then the counter will be in Early mode (see
counts to the start of the next transition or the absolute end of the event are both configurable in RDADmin. The color of the band that grows as the
messages can be made to appear here (by means of RML commands) to signal the operator concerning the state of the system or need to take some kind of
select the desired log from the list and then touch Load. The currently loaded log can also be saved by touching the Save or Save As buttons, or the
When running a log, it is often desirable to have the currently playing event always in sight. To do this, toggle the Scroll button on (blue backgrou
6.2.10.1 Adding an EventTo add an event, touch the ADD button to open the Select Cart dialog, pick the desired cart and then touch OK. To place the s
6.3.2 Copying an EventTo copy an event, touch the Copy button, then touch one of the violet COPY buttons in the button log widget, or select an event
the right of the arrow keys), consisting of the letter 'U' or 'S' followed by a number. An 'S' indicates that the panel
Chapter SevenGenerating Logs with RDLogManager
Section 3.4 – Library Maintenance3.4.0 Editing Markers3.4.1 Copying and Pasting Audio from Cut to CutSection 3.5 – Generating Library Reports3.5.0 The
Section 7.0 OverviewRDLogManager is a tool for generating Rivendell logs. It is different from RDLogEdit in that, instead of building logs line-by-li
To open a particular grid, select its service name and touch the Edit button (see Illustration 44).Illustration 43: The Log Grids DialogIllustration 4
Each grid has slots for every hour of every day of the broadcast week – 168 slots in all. By specifying a particular clock to go into each of these sl
The Edit Clock dialog consists of three main sections: a tabular list of events in chronological order, a graphical depiction of the clock in the tra
format, and a series of action buttons across the bottom.The clock's three-letter code is set by means of the Code: field in the upper right-hand
Available Services list and then touch the Add >> button. Likewise, to deselect a service, select its name in the Enabled Services list and the
The Edit Event dialog consists of two main parts: a Library cart picker widget on the left side, and an area showing the various event parameters on
log was generated.Next, the list of log events (if any) to be inserted before the data import should be placed in the PRE-IMPORT CARTS list. For audi
In all cases, a new log is initially generated by touching the Create New Log button. If the log for the selected date and service does not already e
5.0.5 Chain Events5.0.6 Import LinksSection 5.1 – Event Transitions5.1.1 The PLAY Transition5.1.2 The SEGUE Transition5.1.3 The STOP TransitionSection
parameters needed for data import is done in the RDAdmin module and is covered in the Rivendell Technical and Administration Guide).It is important to
Section 7.5 Generating ReportsA Rivendell report is a data output that details whether certain events aired as scheduled, and under what circumstances
desired service and then touching the Purge Data button in the Select Service dialog, opening up a calendar dialog (see Illustration 58). Each date t
Illustration 58: The Purge Calendar Dialog
Chapter EightVoiceTracking
Section 8.0 Voicetracking in RivendellVoicetracking is a capability wherein custom “one-off” content is created and inserted into logs, making it poss
8.0.2 VoiceTrack MarkersA voicetrack marker is a meta event that can be inserted into a log as a “placeholder” to others to indicate where a voicetrac
The upper three display waveform depictions while the fourth contains audition control buttons, an audio meter and various counters. Directly below t
Kommentare zu diesen Handbüchern