||
Welcome to SAM3 Technical Documentation. We hope you find answers to all your questions.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
SAM is short for Streaming Audio Manager and was developed specifically with the needs of Internet broadcasters in mind. It combines six years of research with cutting-edge technology to bring you the power, features, and reliability professional broadcasters require. SAM takes control of all aspects of your broadcast and makes you sound professional while saving you time and money. With the flexibility, compatibility, and strong support network, it is little wonder SAM is considered the best Internet broadcasting tool available today.
This help file contains many sections that will help you discover the full power of SAM technology. We would, however, like to point out that this is not the only place you can get help for SAM. There are many other resources:
The AudioRealm member section: http://www.audiorealm.com/members/
Spacial Audio Forums http://www.spacialaudio.com/forums/
The AudioRealm discussion list. To join simply send an email to the following address: general-subscribe@spacialaudio.com
Spacial Audio Knowledge Base / FAQ http://www.spacialaudio.com/knowledge/
And of course the Spacial Audio support page: http://www.spacialaudio.com/support/
Please make an effort to read the help documentation first before asking general questions. This help documentation covers SAM usage in depth and most questions can be answered herein.
external image images%5Cdot2.GIF
Note: The Quick Start guides are only meant to give you a quick overview of how to get certain tasks done. If you require more help after reading a Quick Start guide, please refer to the detail sections for more information.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Internet broadcasting is an exciting, cutting edge industry. SAM and AudioRealm services gives you the tools you need to make your broadcast dreams a reality. SAM can also make your present broadcast nightmares a thing of the past with one affordable solution. Let's get you streaming in 30 minutes or less....
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
The goal of this chapter is that any new user reading it can be up and streaming in less than 30 minutes.

This chapter is a quick start guide on how to setup a live Internet radio station using SAM Broadcaster and AudioRealm.com stream hosting services. We have offered advanced topics within the help file in the event you wish to obtain detailed information, but if you want to do it in 30 minutes it is best not to incorporate the advanced functions of SAM until you are up and running. Please refer to the rest of the help documentation and the website if you require further and/or advance help.


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Before we jump right in, let's discuss some basics regarding how internet radio works, the advantages of internet radio and what you will need to get started.


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
The Internet can transfer any type of data including text, video and audio.
Basically Internet radio is the transfer of audio data over the Internet to listeners spread across the world.
To make all of this happen 4 things are required; a) Source audio (Audio files or Live audio)
b) Audio encoder & streamer (SAM Broadcaster)
c) Streaming server (http://www.AudioRealm.com/stream)
d) Player (WinAmp, Windows Media Player)


The audio encoder takes the source audio and encodes the audio into a continuous stream of audio data. This single audio stream is sent to the streaming server. The streaming server then acts like a broadcasting antenna by sending the audio data to all the listeners.

For listeners to tune-in to the audio stream, they must have some kind of player installed that is able to receive the stream of audio data from the streaming server, and then play the audio data over the speakers. Since compressing audio data requires large amount of computing resources, the computer running SAM should be a dedicated server.

The audio data is usually compressed to make it easier and more cost effective to stream over the Internet. For this purpose many audio file formats have been developed that all vary in quality, compression rates and features. Some examples of popular audio formats: MP3, mp3PRO, Windows Media and Ogg.

This document will explain how you can use SAM Broadcaster as your audio encoder, streamer and use the stream hosting services of AudioRealm.com to start your own professional online radio station.

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
  • Start your own professional radio station for as little as $250, excluding hardware/operating costs such as a dedicated computers and ISP
  • Can be operated from home.
  • Many ways to generate revenue to fund your own station.
  • Reach an audience located across the world.
  • Start out small and grow as your station’s audience grows.
Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
First, you will need to decide which type of station you are going to run. Are you going to broadcast live content, pre recorded content, just playing audio source files or combination? Regardless of what you want to broadcast, SAM3 Broadcaster is the program that can handle it.

What do you need to set up an Internet radio station?
  • CD player
  • Ripper software (copies audio tracks from a CD onto a computer’s hard drive)
  • Minimum 48kbps Internet connection
  • Assorted recording and editing software (Optional)
  • Microphones (Optional)
  • Audio mixer (Optional)
  • Outboard audio gear (equalizer, compressor, etc.) (Optional)
  • Soundcard (Optional)
  • Dedicated computer with SAM Broadcaster software
  • AudioRealm Stream Hosting Server
Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
This portion of the documentation will go over the process of planning and setup of AudioRealm.com stream hosting.

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Planning for your stream hosting is a key element in the planning portion of your station. Depending on the station you will either need to start small and increase as the need arises or you will need to start large and scale down after you have a feel for how many listeners you should really expect. If you are an existing organization with a large contact list or a terrestrial station with means to advertise to the masses and you plan to announce to all of your potential listeners you will want to be able to handle the initial traffic.

AudioRealm.com stream hosting offers 20 listeners as the minimum amount to start and we offer up to 500 listeners per server, if you wish to have more please contact us we are able to accommodate.

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
  • Go to http://www.AudioRealm.com/stream
  • Select ‘Live Streaming’
  • Specify Server type ‘SHOUTcast’
  • Select the Maximum bitrate, this will determine the quality of your stream. Note: do not exceed your internet connection speed also allowing some room for emails and any other outgoing communications.
  • Select Maximum Concurrent listeners from the drop down box
  • Click Calculate
  • If the total monthly cost is within your budget click Continue
  • Member Details
    • If you are an existing member select ‘I’m already an AudioRealm member’ > >> > >> or
    • If you are not an existing member select ‘Sign me up (FREE)’
    • Enter a valid email address (notification of your server details and billing information will be sent to this email address)
    • Enter a username
    • Enter a password
    • Re-type your password
    • Read the Terms and Conditions and review the legal information (links are provided at the bottom of the page)
    • Check the box that indicates that you have read and understand the terms and conditions and that you have reviewed the legal information
  • Click Continue
  • Select your preferred payment method to make a payment right now.
  • SelectAutomated Monthly Payment’ this will ensure that your payment is made on time and that you will not have a lapse in service. > Note: any payment made by PayPal’s e-check, direct deposit, money order or check will take 4 days to process or until we receive and verify funds. A PayPal linked to your credit card is the fastest method and your account will be setup almost instantaneously upon completion of your order.
  • You will now be taken to the paypal.com site to complete your payment and setup a subscription for monthly payment > Note: If you do not currently have a PayPal account click on the ‘click here’ button next to the line that reads ‘If you do not currently have a PayPal account‘
    • Enter your PayPal login information
      • Enter username
      • Enter password
    • Click Continue
    • Confirm your payment by clicking ‘Pay’
    • You made a payment, now click ‘continue’ near the bottom of this page or you may exit this website at anytime by click ‘log out’ at the top of the page.
  • If you paid with a PayPal account linked to your credit card you should now be able access your stream hosting server by clicking here
  • Click Edit next to your new stream hosting account to obtain your encoder configuration information. Leave this window open or print the page, you will need information off it for your setup.
Related topics
*
Planning
*
General SAM setup
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
  • Download SAM Broadcaster > NOTE: If you are unsure which database is best for you, just download the one with FireBird database support
  • Select ‘Save this program to disk’ and click OK.
  • Browse to the location where you would like to save the file (i.e.; desktop)
  • Once the file has been downloaded Click Start/Run/Browse find Installation file samdb-fb.exe and click Open.
  • Click OK to execute installation file.
  • Click Yes, then click Next after reading the welcome message
  • Click Accept (to agree to the software terms and conditions), and then accept all defaults, clicking Next until you click Finish to close the installation program. (or click next to accept the default install path, Click Next to accept the installation options for SAM and the SAM Database i.e. MYSQL) > NOTE: if you have an existing database installed on your dedicated system, you may need to change the username and password for the database, otherwise leave as the defaults. > Once the installation has completed, you will be prompted to view the SAM readme file and start SAM, click Finish. > Note: it is suggested you read the readme file, but for now we can set that aside.
  • A Welcome! Window will appear that will prompt you to ‘add demo files’ and ‘add my audio files to the media library (Recommended) click Continue. Note: You may wish to uncheck the ‘add demo files’ option.
  • Select the location of your audio files and click OK.
  • SAM Broadcaster should now be running, if it is not you may execute SAM broadcaster by going to Start / Run / Programs / SAM / SAM Broadcaster.
  • Optional: Restart your computer.
Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Here is a quick overview on how to add files to SAM3, load them into the queue, and then play them.

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Go to the playlist window located on Desktop A far left half way down and select the category into which you want to add files. Categories are used to split files into manageable groups or lists.
For this example, we will create a completely new category.Right-click on the root Playlist category and from the popup menu choose New. Then type in the name of the new category - we'll call it QuickTracks.Press[Enter] to save the changes.
Now right-click on the QuickTracks category and from the popup menu select: Add->Add Directory.
The Choose directory dialog will display. Browse to the directory containing the music you want added to the category. Now click on OK and a status window will display the progress of the files being added to the media library.
Once completed, you should be able to see the list of tracks added to the category in the Tracks in selected category window.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
The next step is to load the files you want to play into the queue. The queue contains a list of files that will be played from top to bottom.
Inside the Tracks in selected category window double-click on a song and it will be added to the Queue. Repeat this process until you have a few songs in the Queue. Note: You can also drag & drop songs into the Queue.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
First make sure you have the Virtual DJ set to Auto DJ mode, this option is set by default. You can select the Virtual DJ mode by selecting the drop down arrow just left of the Desktop A button in the toolbar. By doing so the virtual DJ will automatically load the next song from the queue when required and crossfade to the next track.
Next, make sure both Deck A and Deck B are visible. You may reset the layout of the screen by selecting ‘layout’ from the menu bar, your resolution (i.e.; 800x600 or 1024x768), default.
Click on the Play button in the toolbar just below file in the menu bar to start audio playback in the next available deck.
external image images%5Cdot2.GIF
Note: The Virtual DJ cues up the next track as soon as the currently playing track reaches the end and then starts playback of the newly cued track (while crossfading).
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
  • You can quickly locate a song by clicking inside either the Queue or Playlist window and typing the name of the song you wish to find. This will instantly bring up a search window with matching results. Just double-click on the song to add it to the queue.
  • Drag & drop! In SAM3 you can drag track(s) from anywhere to almost anywhere. For example, you can drag a track from the search window onto the playlist, queue, or even directly onto the player decks. You can also drag from the search onto a category inside the Playlist window.
  • Learn the Shortcut keys - Like zippers, they make life so much easier.
  • More Dragging & Dropping - you can even drag & drop directly from Windows File Explorer!
  • Cool Trick: If a song is playing in a deck, hold down the [Shift] key while left-clicking on the Play, Pause, Stop or Next button. This will do a nice fade of the music to the specified state. ||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
You have set up a streaming server the next step is to create an encoder that can supply the streaming server with a source stream.
· Goto Desktop B in SAM3 Broadcaster
· In the Encoders window click on the ‘+’ button
· Select MP3 and mp3PRO and Click OK
· MP3 (PRO) Encoder & Streamer Configuration
o On the Converter tab
§ Set Quality to Medium
§ Under Format select the format that matches what you purchased at Audiorealm.com for stream hosting. See the Audiorealm.com stream hosting account panel for bitrate. Check Auto Start encoder after 5 Seconds NOTE: be sure that ‘Allow scripts in stream’ is unchecked.
o Server Details tab
§ Server type is SHOUTcast
§ Server Details (found on your Audiorealm.com stream hosting panel).
· Enter Host in Server IP field
· Enter Port in Server Port field
· Enter password in password field
§ Station Details
· Type in your Station Name
· Select the genre from the drop-down box or type in your own Note: you may type in more than one genre comma separated.
· Type in your website URL
· Enter AIM ID (optional)
· Enter ICQ # (optional)
· Enter IRC Channel (optional)
· Check ‘List on public station listing (recommended) Note: this will list your station at SHOUTcast.com
· Check ‘Enable title streaming’ and be sure that $combine$ is in the field below ‘Enable title streaming’ to display titles.

o Click OK

o Your Encoder should now say ‘encoded (#) and streamed (#).

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
The final step is to create a Statistics relay for the streaming server.
A statistic relay simply grabs the current status and viewer count from each server, reporting the details to SAM3. Without a statistic relay, SAM3 will not know where listeners can connect to listen to your music and it will also not accurately report the count of listeners connected to your stream.
Additionally, without valid statistic relays your station will not show up on AudioRealm.com. This means you will not get any extra exposure and you will miss extra listeners coming from the AudioRealm portal and partner sites. For more information on listing your station at AudioRealm.com click here .
· Goto Desktop B in SAM Broadcaster
· In the Statistic Relays window click on the ‘+’ button
· Select SHOUTcast Statistic Relay, click OK
· Enter SHOUTcast server details (found on your Audiorealm.com stream hosting panel).
o Enter Host in Host field
o Enter Port in port field
o Enter password in password field
· Click OK
· Statistic Relay should now say ‘Active (OK)’

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
1. New audio engine
  • Most of the work went into our new awesome sounding, low-latency audio engine. The new audio engine is capable of working with latency as low at 15ms! That is 15/1000 of a second, which basically means that any change you make to the audio will be heard instantly. For example, if you change the EQ you can hear the change INSTANTLY - just as you would if you were using a hardware EQ. This also means by setting your latency low enough, you will not longer hear any echo when you use the VoiceFX.
  • SAM3 features a high-quality built-in audio processor (AGC). This can hugely improve the quality of your audio. Learn more here.
  • “KernelStreaming" is now supported. This audio mode completely bypasses the Windows audio mixer - which results in better sounding audio at much lower latencies!
  • Improved WinAmp DSP plugin support - it is now even easier to use Winamp DSP plugins inside SAM. Learn more here.
  • This is some of the SAM2 problems the new audio engines fixes:
- The start of songs being cut off
- The end of songs being cut off
- Skips, audio blips and stuttering, especially when using the VoiceFX
- Inaccurate custom fade points
- High-latency audio

  • Crossfading - We spent many weeks researching the best crossfading techniques and we believe you will be pleased with the results. SAM3 will by default automatically detect the best point to start a crossfade and then apply one of the smooth fade curves for the best sounding fades on the planet! You also have the option to set the fade settings for each song to make sure the fading sounds exactly like you want.
  • Que Points - You can now set custom Fade in, Fade Out, Track start, Track end, Intro and Outro points, as well as up to 10 custom cue points. You can also completely customize fade and other settings for each track.
  • Stream Support - We improved MP3 audio streaming (playback) support, and also added Ogg streaming (playback) support. Windows Media audio streaming (playback) is of course also supported.
  • Two main decks, Two auxiliary players, 1 hidden auxiliary player, 1 SoundFX player and 1 VoiceFX input all mixed in real-time with extremely low latency into a final output channel.
  • A long requested feature is the ability to preview the audio on a separate channel before playing it live over the air. This is now possible by setting up a cue output device. We recommend using two soundcards, but you can also use the front and rear speakers on a single soundcard.
  • Pitch and Tempo Control - The Pitch and Tempo of each deck can now be controlled directly from the deck.
  • Volume Control - Apart from being able to decrease the volume, you can now also "pre-amp" or increase the volume on each Deck.
  • New advanced gap killer with more "real-world" silence detection techniques.
2. Improved Decoders
  • All audio file decoders have been written from the ground up to be faster and more efficient.
  • Better MP3 streaming (playback) support. SAM3 now displays full title streaming information for any MP3 streams being played. SAM3 can also stream MP3 files hosted on a remote server.
  • SAM3 introduces Ogg streaming (playback) support, with title streaming.
  • The Ogg tag handler can now fully read AND write Ogg tags.
  • The WAV file decoder can now properly handle compressed WAV files.
3. Rotation Logic
  • We've put in a lot of work to reduce the repeating of the same track, or similar named tracks and artists.
  • We also improved the "random" selection of songs. Thus the phenomenon where it sometimes seems like songs are selected in alphabetical order should occur less.
4. Request Handling
  • We have given you more power over request handling by allowing you to specifically specify when & how requests are inserted into rotation.
  • Requests can now use a DNS name to authorize remote request handlers.
  • Learn more here
5. Improved VoiceFX
  • VoiceFX can now be configured in 4 different modes to suit any need!
  • Low-latency audio engine removes the echo problem
  • Can process the sound of your voice to make it sound better.
  • Stutter problem has been fixed
6. Improved SoundFX
  • SoundFX pages now load a lot faster
  • Bigger buttons which counts down the time of the active SoundFX item being played.
7. Other improvements worth mentioning
  • Auxiliary players now include a "Loop" button - great for running a music bed while using the VoiceFX
  • Mass tagger now saves a error log file to help you track down songs with bad tags or songs SAM is unable to write to.
  • New SAM Reporter with better script error handling.
  • Updated HTML output template
  • Slightly improved PHP template. Also handles missing album cover pictures a lot better.
  • Can automatically detect the Beats Per Minute of a song.
  • Easier to navigate category tree layout.
  • New "Select directory" dialog that loads a LOT faster.
  • Code in both the Statistic relays & Encoders that helps prevent you from typing in the wrong information.
  • Can now organize the items in the event scheduler.
  • Slightly improved fade control
  • New master volume control window


  • New "Add Mic/Line-in" dialog inside the queue


  • Ability to enter station name and description for WM Encoder.
8. Multiple database support

  • SAM now supports 4 different databases: FireBird, MySQL, PostgreSQL and MS SQL.
  • Updated PHP web template that has proper database abstration to support the above 4 databases seemlessly.


Related topics


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Another big improvement in SAM3 is the way requests are handled. In the past you had two options - enable requests, or disable requests. When requests are enabled, requests can be inserted into the queue at any random time which in many cases can have an undesired effect on your rotation logic. A good example is when you have a 4 part show, and a request is suddenly inserted between part 3 and 4 of the show, breaking the flow of the show. The only way to avoid this was to completely disable requests for the duration of the show. Thus during this time none of the listeners could make any requests.

Another option was to set the request policy to "Leave requests in list" for the duration of the show, but this usually caused all the requests made during the show to be inserted back-to-back in the queue as soon as the policy is changed again to move requests to the queue. Even during just normal usage, requests can severely compromise a well thought out station programming rotation logic. To solve all of the above problems it is now possible to take complete control of when and how requests are inserted into the queue.

The first step is to enable requests, but set the policy to "Leave requests in list" and optionally also delay requests for xx minutes. Thus ALL requests made will stay in the request list - unless we specifically add requests as part of our rotation logic.

To do this you can use two methods:

1. Category based rotation
  • Under SAM->Config->Playlist rotation rules select the Clockwheel (Category rotation) logic module and hit the configure button.
  • Now modify your rotation clockwheel to insert requests at specified intervals.
  • Just hit the [+ Request] button to insert the appropriate clockwheel command.
2. PAL scripts
The other method is of course using PAL scripts.
Here is a simple example of a PAL script that will insert a request every 15 minutes, if a request is available.

{========================================} PAL.Loop := True; var Song : TSongInfo; Song := Req.QueueTop; if Song <> nilthenbegin writeln('Added request to queue:'); writeln(Song['filename']); Song.Free; {Dispose of the song object}end; PAL.WaitForTime('+00:15:00'); {========================================}


{========================================}
PAL.Loop := True;
var Song : TSongInfo;

Song := Req.QueueTop;
if Song <> nil then
begin
writeln('Added request to queue:');
writeln(Song['filename']);
Song.Free; {Dispose of the song object}
end;

PAL.WaitForTime('+00:15:00');
{========================================}

With this new process you can now accept requests from your listeners 24/7, but still have FULL control over the format of your station.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
SAM3 introduces a professional sound processor that can make your broadcast sound like any professional commercial station - just without the cost!

The AGC (as we collectively call all the sound processors) includes:
- Gated AGC (Gated Average Gain Control)
- Stereo expander
- Bass EQ
- 5 Band processor (Which includes Limiter, Compressor and Expander)
- Dual band processor
- Clipper

Traditionally, you had to pay thousands of dollars for sound processor hardware - but with SAM3 no more! All this is included right into the default SAM3 install at no additional cost.

Sound processing can make your station stand out above the crowd - if used correctly! Incorrectly using sound processing can harm your station just as much...

In this chapter our goal is to help you use the AGC processors to get the best sound for your station.

Lets start by briefly discussing each process:

1. Gated AGC
The Gated AGC is used to "roughly" normalize the volume level so that the audio has an approximated constant volume level. The Gated AGC should be used together with the 5-band or 2-band processor because the Gated AGC on its own aims to simply provide a better input audio stream to these more fine tuned n-band sound processors.



2. Stereo expander
The stereo expander can give more "dimension" to the audio, and can especially make voice sound better. Great for use with VoiceFX module.

3. Bass EQ
The Bass EQ is used to emphasize the bass sounds & beats.



4. 5-band processor
The 5-band processor splits the audio into 5 frequencies, applying a compressor, limiter and expander to each band.



5. Dual-band processor
The 2-band processor splits the audio into 2 frequencies, applying a compressor, limiter and expander to each band.



6. Clipper
The clipper ensures that the audio volume level does not exceed the maximum. Unlike "hard" clippers, this clipper ensures a smooth clip making sure we retain the very best audio quality.



Correctly using the AGC
SAM3 has a very advanced multi-channel audio pipeline which allows you to configure it to your exact needs. In order to process the sound of your station properly you need to understand where in the audio pipeline to active the AGC, and how this decision effects the overall sound of your station.

You basically have 3 options:
1. Enable the AGC on the final mixed audio only
2. Enable the AGC on each player/audio channel, but not on the final mixer.
3. Enable the AGC on each player/audio channel - as well as the final mixer.



1. Enable the AGC on the final mixed audio only
PROS:
- Uses less CPU, since the audio processing only happens at a single point.
- Easy to config

CONS:
- The same audio processing is applied to all channels.
- Any audio processing will NOT be heard over the Cue output channel, only the final "Air" output channel.
- Likely to mess up the fading & crossfading of tracks, since even the fade will be normalized.
- Likely to mess up the fade-out/fade-in of the voiceFX module especially when the destination of VoiceFX is set to the mixer. NOTE: Some people actually like this though, since it has the "cool" effect where the volume level of the music stays constant, but as soon as you start talking the music level drops instantly so your voice can be heard clearly.

2.Enable the AGC on each player/audio channel, but not on the final mixer.
(This is the recommended setup)
PROS:
- Have exact fine control over you each audio channel should sound. We recommend setting DeckA, DeckB, Aux1, Aux2 and Aux3 to ALL have the exact same configuration.
SoundFX and VoiceFX though generally needs a more fine-tuned configuration. SoundFX is usually louder, while voiceFX generally deals with vocals that require a very specific configuration. In fact, each DJ of the station will probably need his own custom preset.
- Does not effect the fade-in/fade-out of songs. In fact, since the volume is normalized before the fade is applied, even songs with an pre-existing fade follow the configured fade curve more closely - resulting in much better sounding fades.
- Does not effect the Fade-out/in of the VoiceFX module.
- The audio processing is also audible inside the Cue output.

CONS:
- During the crossfade, or with multiple tracks playing the audio processing can use a LOT of CPU. If you have a 2GHz or faster machine you should not experience any problems.
- Even if each channel is optimized, after all of them are mixed together. the sound will most likely not be "as" optimized. This really only applies during crossfading, since in most cases only a single audio channel will be active at any time - making this negative hardly worth mentioning.

3. Enable the AGC on each player/audio channel - as well as the final mixer.
The way to use this method is to apply some basic audio processing on each channel, but to do the final major processing on the mixer. For example, enable only the AGC on each channel to make sure the audio volume level for each channel is properly boosted to a uniform volume level - and then only to the finer processing on the mixer after all the channels have been mixed into one.


Configuration

=

======Refer to SoundSolution.pdf
There are minor changes in our version of the SoundSolution, so look out for those.

external image images%5Cdot2.GIF
Note: Beware of "over processing" the audio.
Turning on the AGC on each channel, and on the final mixer will probably sound worse - losing a lot of detail in the audio. Also, beware of using external DSP audio processing plug ins in conjunction with the built-in AGC. This might also cause a loss in audio detail.
Additional resources:
http://www.soundsolution.it/downloads/SoundSolution.pdf
http://www.soundsolution.it/content/view/19/35/
http://www.soundsolution.it/content/view/20/36/
http://www.soundsolution.it/content/view/24/38/
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Under the [Details] tab:

Play track [count] times and then [action] -This allows the track the be either Deleted from the Media library, or completely being deleted from the hard disk.
actions:
None - Play song only [xx] times.
Remove - Play song [xx] times, then delete from media library, i.e. delete from ALL categories
Erase - Play song [xx] times, remove from ALL categories, and also delete the physical file from the hard disk. Use with care!! Great for use with News and other "single play" files.

Also see the Categories under [Special->Play limit]

Under the [Reporting Fields] tab:

Can now specify different rights for the song
  • Royalty free. No royalty fee is payable on this music.
  • Download. Broadcaster may offer the track for downloading from a website or P2P sharing service.
  • On-demand. Broadcaster may use the song in an environment where listeners are able to listen to the track in an on-demand fashion. Steps should however be taken to avoid users being able to easily download or copy the track.
  • Broadcast. Broadcaster has the right to publically perform or broadcast the music.
Under the [Settings] tab:

Here you can set various custom settings for the track.
Cue points
Types of cue points.
Start: The point where playback will start from
End: The point where the track will end and be ejected. (Effectively the duration of the track)
Intro: The point where the first vocals start (and the DJ needs to shut up! ;)
Outro: The point where the vocals stop, and the DJ can open his mouth again...
Fade: The point where the fading out of the track should start.
XFade: The point where the next track will start playing.
Custom cue points: You can set up to 10 custom cue points to help seek to specified points in a file quickly.

Setting up a cue point:
  • Option 1: Double-click on the time window of the cue point to manually enter/change the time.
  • Option 2: Start playback in the player just above, and then click on the button containing the name of the cue point to set the time as the player reaches the correct point.
The [-] button clears the cue point, while the [>>] button will seek to the specified cue point.For custom cue points you must first select the index, then type in a short name/description of the point before setting up the cue point.

Beat-per-minute: Set the beats per minute of a track.
  • Method 1: Click the auto detect button to attempt to automatically detect the BPM value of the track.
  • Method 2: Click on the "Tab beats" button and then start the player. Now press on each beat until the "Tap on Beat" button goes away.
  • Method 3: Adjust the BPM manually by pressing the up/down arrows. The arrows on the left change the value by 1, while the ones on the right change the value only 0.1 for finer adjustment of the BPM value.
Metronome: To verify that your BPM value is 100% correct, follow these steps.
Start playback on the player and anticipate the next beat, trying to pause the player exactly on the beat. Now, while holding down [shift] click on the Metronome button to start the Metronome. Holding down shift will cause the player to resume playback the instant the button is pressed. If your BPM value is correct, you should hear the metronome sound exactly on the beat of the song.
If needed, adjust the BPM manually to better match the beat.

Notes: Make sure the Pitch and Tempo values of the player is set to zero, or else your beats will be configured incorrectly.

Other settings:
Gap killer - Specify whether the Gap killer should be applied to the track.
Gain - Apply pre-amp to the track, i.e. either increase or decrease the volume of the track. Great for making soundFX, advertisements and promos louder that normal tracks.

Applying settings:
  • The big [Apply] button will apply your settings to the player, so that when you start the player you can preview your custom settings.
  • The [Restore] button will restore the original player settings into the player.
  • The [Reset] button will restore the default player settings into the player.
Under the Fading Tab

Exact same details count as specified under the Config->Crossfading sections, except that you MUST check the "override" box next to each setting to override the default value for the track.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Audio mixer pipeline
  • Completely new audio pipeline
  • Can click on the [EQ], [AGC], [DSP] and [Output] buttons to configure
  • The VoiceFx destination gives you a nice view of how the different VoiceFX modes work.
  • The Cue output channel is represented on the audio pipeline. There is one important point about the Cue channel - the final audio processing right after the mixer is NOT applied to the cue channel. N ow the you can click on the [Air out] and [cue out] buttons to configure the output settings.
  • For the sake of visual clarity), [Cue out] button is hidden if cue output is not enabled.
  • Process Priority - sets the priority of the whole application. A setting of High is recommended if your output is set to very low latencies.
  • Note: All 3 Aux Players can be configured by selecting the correct Aux player number from the dropdown in the great Aux box. Aux3 is a hidden player, mostly used in the Song information editor->setting to play the track while editing the song settings.
  • Note: EQ, AGC, DSP and Output config will be explained in separate section.
Crossfading

The improved crossfading in SAM3 features auto-crossfade point detection, and various fade curves that can be set globally, or on a "per-track" basis.

  • Enable Fade in: Specifies if the track should contain a fade at the start of track.
  • Enable Fade out: Specified whether the track should contain a fade at the end of the track.
The following pertains to both Fade-in/out settings:
  • Curve: You can specify 3 types of fade curves
    • Default/S-Curve: The S-Curve provides a nice "COS" style curve that really sounds the best in most situations.
    • The S-Curve: Starts out slow, then accelerates quickly before slowing down again. This produces a nice sounding fade. The resulting shape of the curve looks like an S, thus the name S-Curve.
    • Exponential: This curve starts out slow, but increases exponentially to produce a very quick fade during the end of the fade.
    • Linear: The linear fade produces a constant rate of change in the volume during the fade. (Aka. the old SAM2 style fades) Sounds best in conjunction of tracks that already has a slow fade. (If you wish to force the track to fade out quicker)Sounds OK with most other tracks
  • Time: The duration of the fade.
Note: This setting has no effect on the Fade-Out during auto-detected crossfades.

  • Level: Specifies the start/end volume level of the fade. A value of 100% means the fade will start/end at the minimum volume.For example, during a fade-out this means the fade will go to zero volume (i.e. -100dB). During Fade-in this means the fade will start at zero volume. Anything other than 100% means the volume level will start/end a bit higher. For fade-outs it is sometimes best no to fully fade out the track, so that the vocals can be heard during the final milliseconds of the track. Same goes for the fade in, starting at a higher volume allows the audio to be instantly audible while we continue with the fade.
Crossfade settings: There are 3 crossfade modes...
  • Disable crossfading : No crossfade. The next track will start immediately after the current track has completely finished playing.
  • Default/Auto detect: Will automatically scan the song for a certain dB level, and when the song drops below that value towards the end of the track - the crossfade will be triggered.
  • Fixed point: You can specify how many seconds before the end of the track the next track will start playing.
Fixed crossfade point (Time): Works in conjunction with Fixed Point mode above; specifies how many seconds before the end of the track the next track will start playing.


Crossfade point detection: Works in conjunction with Default/Auto detect mode above.

Trigger at [xx] dB:This specifies the dB level the automatic crossfade point detection algorithm will look for. As soon as the song drops below this level, towards the end of the track, the next song will start playing. The current song will also be faded out according to the time left till the end of the song. (See below)


Min/Max fade time: These values specify the min/max values the fade-out duration can be. For example, say the crossfade point is detected 10 seconds before the end of the track, and the maximum fade-out is only 6 seconds - then the fade will be only 6 seconds, resulting in the song being stopped 4 seconds earlier. If the crossfade point is detected 1 second before the end of the track, and the minimum fade out is 3 seconds, the following will happen. The fade out will be started 3 seconds before the end of the track, but the crossfade will actually start 1.5 seconds before the end of the track (3sec/2)

All the above settings can of course be overridden for each and every track. [x] Do not crossfade or fade tracks [xx] seconds or less in duration . This will avoid crossfading or fading of very short tracks like advertisements, promos and sound effects. Fading media like this usually sounds very bad. Imagine applying a 3 second fade-out to a 4 second track!

Note: Any content marked as "Allow overlay", i.e. "overlays" will not be crossfaded.

Gap Killer

Gap killer settings are pretty much the same as in SAM2, although the backend code has been hugely improved.
New: Trigger end of song if more than [xx] seconds of silence - if either the beginning or middle of a song contains a period of "near" silence as specified in the dB values, the end of the song will be triggered. Great for getting rid of "hidden tracks".
Bad for songs recorded or encoded at very low volume levels, or tracks with long periods of very low volume audio since this will trigger the end of the song prematurely.

Playlist Rotation Rules
  • Added new "Do not repeat album rule"
  • Also, SAM does a MUCH better job of preventing the same songs from being repeated too often.
  • The resetting of the weight balance after adding songs is no longer that important, since SAM will now use an average balance for new songs making them "go more with the flow" of the current weighted balances. Resetting the weight balance is still recommended on a periodical fashion, but SAM should do much better for people who never does this. This of course only effects people relying on weighted rotation or LemmingRules, since weighted rotation is one of the logics used by LemmingLogic.
  • Also, under category based rotation there is the new [+ Requests] button.
  • See updated request handling for details
Request Policy
Two major changes:
  • IP address list can now also accept DNS entries like www.audiorealm.com, etc. (Do NOT put an HTTP: in front of name!)
  • "Leave request in list" is now a very good option, since you can now choose when to insert requests via the Clockwheel or PAL scripts.
  • See sam.requests.txt document for details
Registration Key
Now contains new 5x5 key structure. As always, you can copy & paste the complete key into the first edit box.

Important difference: The version of SAM available for download to the general public will NOT be unlockable. Users MUST download the FULL unlimited version from the secure client section . The key will work in the DEMO version, but still expire.

||

||
external image images%5Cdot2.GIF

external image images%5Cdot2.GIF

external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Deck A & B

  • Beat match button (=) will change the player's tempo so that it matches the Beats-per-minute of the other Deck. Both tracks must have a valid BPM value, or else the button has no effect.
  • The [EQ] button brings up the Audio settings dialog which includes sections to change the Equalizer, AGC, DSP plugins and Output settings of the audio pipeline for all channels/players.
  • The [CP] button allows you to quickly seek to specified Cue Points
  • Intro/Outro - this display will show you the time left during the Intro stage and Outro stage - ie. the time just before the Vocals start, and just before the vocals end. This must be manually configured in the Song information editor.


[V][P][T]
Volume/Pitch/Tempo

Volume - increase or decrease the volume.
>0dB means the volume is getting boosted/pre-amped
<0dB means the volume is getting decreased
Volume should be left at 0dB in most cases. We recommend you adjust the volume of your speakers, or the Master volume instead of messing with the volume of the players.

Pitch changes the frequency/sampling rate of the track to speed it up or slow it down.
Tempo changes the speed of the track without changing the Pitch of the sound.
Thus you can speed up the music without the "Smurf" effect, or slow down the track without the "Demon" effect.

[air][cue]
When the Air button is selected, the audio passing through the player will be heard over the main output device. When the Cue button is selected, the audio will be heard through the cue device, if configured. This allows you to preview tracks before you play it over the main output.
Important: When both buttons are down, the audio will be heard on both devices.
In SAM Broadcaster, only the [air] audio channel is encoded by the encoders.

Aux1/Aux2

Exactly the same as Deck A & B with exception:

  • Few buttons are missing ([=],[>|])
  • Extra button - [Loop]
When down, the loop function will repeat the track when it reaches its end. This is great for playing a "music bed" while you talk over the voiceFX.

Playlist
Playlist window now has a "side category" view, much like you will find in Explorer
Note the new category layout.

Queue

  • New Add->Mic/Line-in which brings up the "Soundcard recording configuration" dialog. This allows you to configure the exact way a "mic:" song should be recorded
  • [x] Automatically select mixer volume control, when checked will change the recording volume control to the specified control. This is useful to force the correct input - i.e. record from WAVE in one instance, and then from MIC in another.
VoiceFX
  • Huge improvement over old voiceFX.
  • [auto] - if enabled (green light is on), the music will automatically be faded out/in when talking button is pressed.
  • [V][S]
    • S = Speed, is actually exactly the same as tempo. Tempo changes the speed of the audio without effecting the audio. This is the only mode that will work with VoiceFX since unlike songs, VoiceFX data is in real-time.
    • V = Volume
  • In "Soundcard" mode, the volume control changes the actual volume of the PLAYBACK line. i.e. it changes the volume as you will hear it over your soundcard. To demonstrate this, open up your mixer control on the playback controls interface, and change the volume in SAM. Notice how the volume changes in the mixer control.
  • In "Record to pipeline" modes, this controls the volume of the VoiceFX channel. This has no effect on the actual recording control line's volume.

Configuration:
Recording Modes: These are best viewed under Config->Audio mixer pipeline.

1) None: When talk button is pressed, SAM will simply automatically fade out the music. (If auto fade is enabled). No other action is taken. Works great for those that have an external Mic routed through an external mixer.

2) Mixer (Record to pipeline): Audio data is recorded from the soundcard, and fed as input audio to the VoiceFX channel. This mode allows you to perform audio processing on the audio, exactly like for example Deck A.
This also means that you will be able to hear yourself speak - if your latency in both the output and recorder is low enough, the "echo" should be tolerable/instant.
Otherwise, see mode 4 below.


3) SoundCard: SAM will play back the audio over the soundcard. Although this has the "echo" effect as well, the "echo" is instant. This mode is usually used in conjunctions with the "red" button on the encoders. That way you always encode exactly what you hear.

4) Encoders: Exactly like mode 2, except that the audio is only mixed into the audio right before the encoders. This means that this mode skips the main Mixer and Output - which of course means that it totally bypasses the mixer EQ, AGC and DSP plugins and also the Output - thus no echo.

Things to keep in mind:
  • VU meters are only available for modes 2 and 4
  • In modes 2 and 4 you can specify the latency of the recorder. If you hear skipping in your voice, you might need to increase the latency of both your output and recorder. Also, in these modes the [Mixer] button allows you to quickly jump to your soundcard audio mixer recording setup - which needs to be configured properly before using VoiceFX.
  • In mode 3, SAM can automatically "mute" or "unmute" the correct output volume control on your mixer. On some cheaper soundcards this might cause ALL the output controls to be muted. Automated "mute" should be disabled on these kinds of soundcards.
  • Mode 4 is only available in SAM Broadcaster.
Notes on AGC use with VoiceFX: The AGC can have a huge influence on how good your VoiceFX sounds. This will be discussed more on the AGC configuration itself.

SoundFX
Faster loading SoundFx categories. Biggest change is 12 buttons (instead of 9) which counts down the audio when playing. Pressing a button while actively playing will stop.
Tip: Set volume to +2.8dB (Highest volume value) since SoundFx generally needs to be louder than the playing audio.
[air][cue], volume/pitch/tempo control

Volume
Adjust the volume of the Air and Cue output devices separately. You can also mute the device. Muting the Air device has not effect on the audio going to the encoders.



Fade control
Same as old "DJ Control". Slightly improved GUI.



Encoders
  • For MP3, the configuration of the scripting changed slightly
  • For WMA, you can now specify the station information. This will appear in the player when the stream is played. (Under the scripting tab)
PAL scripts
Improved PAL editor
See "Edit" commands now available



Event scheduler
  • Can now move events up/down to sort them.
  • New [Request] button in "Add files to queue" event.


Clock
3D pie chart has been replace by 2D pie, to better represent the "clockwheel"
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
This area of will explain, more in depth, some general uses and functions of SAM3.

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
This guide will give you a quick overview on how to add files to SAM, load them into the queue, and then play them.

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Open the Playlist window and select the category into which you want to add files. Categories are used to split files into manageable groups or lists. Read more here.
For this example, we will create a completely new category.Right-click on the root Playlist category and from the popup menu choose New. Then type in the name of the new category - we'll call it QuickTracks. Press [Enter] to save the changes.
Now right-click on the QuickTracks category and from the popup menu select: Add->Add Directory.
The Choose directory dialog will display. Browse to the directory containing the music you want added to the category. Now click on OK and a status window will display the progress of the files being added to the media library.
Once completed, you should be able to see the list of tracks added to the category in the Tracks in selected category window.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
The next step is to load the files you want to play into the **Queue**. The queue contains a list of files that will be played from top to bottom.
Inside the Tracks in selected category window double-click on a song and it will be added to the Queue. Repeat this process until you have a few songs in the Queue.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
First make sure you have the Virtual DJ set to Auto DJ mode. By doing so the virtual DJ will automatically load the next song from the queue when required and crossfade to the next track.
Next, make sure both Deck A and Deck B are visible.
Click on the Play button on Deck A to start audio playback. Note: The Virtual DJ cues up the next track as soon as the currently playing track reaches the end and then starts playback of the newly cued track (while crossfading).
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
You can quickly locate a song by clicking inside either the Queue or Playlist window and typing the name of the song you wish to find. This will instantly bring up a search window with matching results. Just double-click on the song to add it to the queue.
· Drag & drop! In SAM3 you can drag track(s) from anywhere to almost anywhere. For example, you can drag a track from the search window onto the playlist, queue, or even directly onto the player decks. You can also drag from the search onto a category inside the Playlist window.
· Learn the Shortcut keys - Like zippers, they make life so much easier...
· More Dragging & Dropping - you can even drag & drop directly from Windows File Explorer!
Cool Trick: If a song is playing in a deck, hold down the [Shift] key while left clicking on the Play, Pause, Stop or Next button. This will do a nice fade of the music to the specified state .
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Understanding playlist categories is crucial to effective use of SAM3. Categories will make managing and using your music easy and fast - but first you must fully understand their use. Please read the following guide carefully and make sure you understand the concepts discussed in each section before moving to the next.
external image images%5Cdot2.GIF
Note: When we type Special->Weighted rotation->Power hit we mean you need to locate the Special category, then find the child category Weighted rotation and then finally the Power hit category.

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
You can have just one big list in SAM. Just create a single category under SAM and dump all your files into it. But while you are at it, you might as well roll the rock in front of the cave door - dinosaurs might get in.
There is a reason we group things in life - so we have to think less (and do less)!
Not all songs are the same, nor do they have the same function. There are normal music tracks, but then there are Promos, Advertisements, Station ID's, News, Live shows, Interviews and so on.
We can go a step further to say that songs that seem to have the same function are in some ways not the same. Lets take some normal music files as an example. On a station we would think about them as all the songs the listeners really want to hear - so it seems like we can group them under the collective name of "Music listeners want to hear".
But, if we look closely, some music is more popular than others. Some songs are new; while others are so old that the copyright has expired! Suddenly, it seems we can create more "containers" - "Popular music", "New music", "Oldies".
Now let's take a look at just the "Popular music" container. We realize we can make even more containers such as "Popular music - Europe", and "Popular music - USA" because we realize musical tastes vary across the world.
We can probably keep on adding categories until the end of time - because for each "container" you will be able to find other "parameters" to split the category into even smaller "containers".
So it would seem that just the nature of music beckons for it to be sorted into logical groups or categories. "But sorting music into categories seems like a lot of work. I'm a certified lazy person - can SAM3 help?"
Yes - this is what makes SAM so powerful! SAM will automatically sort your music into categories - and for the few categories you have to sort manually, it is as simple as dragging & dropping files into the right category!
||
||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
- A category is a "container" that labels a collection of songs. Before anybody goes "Huh?", lets make the declaration simpler - because it's really a lot simpler than the former sounds.
- A category is a list of songs identified by a name.
Those of you that are used to applications like WinAmp can think of a category as an .m3u or .pls playlist file - but instead of keeping the list of songs in a file, it is kept in an internal database inside SAM3.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
The following is only a quick overview on how SAM3 uses categories.
As any professional station programmer will tell you - playing random songs will not satisfy a listener. A radio station needs a format - some template that guides how and when certain types of music must get played. A typical station must also play station ID's to let the listener know to which station they are listening, run promos to market upcoming events or shows, and then, of course, advertisements because stations can not survive on love forever.
So, a typical station format will look like this:
  1. Play a music file
  2. Play a music file
  3. Run station ID
  4. Run promo
  5. Play a music file
  6. Run Advertisement
  7. Run Advertisement
  8. Repeat above
Therefore, in steps 1, 2 and 5 we need to pull a song out of the "Music" category. Then for step 3 we need a "Station ID" category and for Step 4 a "Promo" category. Finally, we need an "Advertisement" category. As you can see from the description above, SAM needs to know how to choose songs from the media library to play. In other words, in what format should the music be played.

SAM Broadcaster can achieve this via different Playlist rotation logic modules and PAL scripting
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
In SAM all categegories are not just lists of songs. Some categories contain artificial intelligence that can help you save a lot of time if you know how to use this feature. All this will be explained below.
1. Types of categories
Let's get down & dirty with the technical stuff.
First, SAM has 4 major category types.
1.1 Parent categories
These are categories like the Playlist root category. They have no other function other than to serve as a root parent for other categories. In other words, their only function is as a "container" of "containers".
external image images%5Cdot2.GIF
Note: You can not create a parent category. (You can however create a normal category that contains other categories along with songs. We will discuss this later.)
Features
  • Does NOT contain songs
  • Can have zero or more child categories
  • Can NOT be deleted.
Examples: Playlist, Special, Content, Groups
Parent categories normally have one of the following icons:
external image images%5Cplaylist.gif
external image images%5Cstar.gif
external image images%5Cfolder_opne.gif

1.2 Normal categories
Normal categories are the workhorse of categories. These are the category types you will use most often.
Normal categories contains a list of songs and can even have other child categories containing more songs.
Features of Normal Categories
  • Contains a list of tracks
  • Can have zero or more child categories
  • The SAME track can be listed inside the category more than once
  • Can usually be sorted
Examples: Any category you create under the Playlist root category.
Normal categories have one of the following icons:
external image images%5Cfolder.gif

1.3 Auto-generated categories
Auto-generated categories are powerful categories that need no management on your part. They are automatically generated each time you view them!
The Content->Sound FX->Sound FX (All) category is an example. This auto-generated category contains a list of ALL songs that are marked as a Sound FX.

Features of Auto-Generated Categories
  • Contains a list of tracks automatically generated from data in the media library.
  • Can not contain child categories
  • The same track can NOT be listed more than once in the category
  • Is usually sorted by some field.
Example: Special->Weighted rotation->Power hit
Auto-generated categories have one of the following icons:
external image images%5Cgenerate.gif

1.4 Grouped categories
Grouped categories can be thought of as 2-level categories where level 1 is the attribute on which songs will be grouped and level 2 the actual songs in that group. (They are a special kind of auto-generated category.)
Grouped categories are best explained via an example:
Goto the Groups->By Artist category. ( NOT the By Artist (A-Z) category.)
This grouped category groups all the songs together with the SAME artist. Select an artist name on the left and a list of songs performed by that artist will instantly be displayed on the right.

Features of the Grouped Category
  • Contains a list of groups, and then a list of tracks inside each group.
  • The same track will not be listed more than once inside the same group
  • List is auto-generated from data inside the media library.
Grouped categories have one of the following icons:
external image images%5Cfolder.gif


Phew. That was a mouth full. Lets recap quickly.
Key points
  • 4 major categories: > 1) Parent > 2) Normal* > 3) Auto-generated > 4) Grouped > *The ONLY categories you can manually create yourself are the Normal categories.
Note: Make sure you understand everything up to this point before continuing. Things get interesting from this point forward.

2. Category attributes
Those of you who have been paying close attention might ask: "Ok, so we can split files into categories and SAM automatically generates some categories for us. Big deal. Many other applications can do the same..."
SAM brings to music management a concept that has revolutionized application development - the concept of Objects with inheritance. RAD (Rapid Application Development) would not be possible without inheritance.
SAM brings to the world of automation the concept of management via song attribute inheritance .
Without straying too far off topic let's quickly discuss the concept of Objects with inheritance.
Let's use a Transportation vehicle as an example. One general attribute of a Transportation vehicle is its use as a vehicle to take a person from point A to point B.
We basically have two types of Transportation vehicles
1. Motorized vehicles 2. Human powered vehicles
One general attribute of a motorized vehicle is it is powered by some kind of engine or motor.
One general attribute of a human powered vehicle is it requires the physical effort of a human to "make it go."
Ok, lets make it interesting. A car has 4 wheels, a (bi-)cycle 2.
So...to build a motorcar we know it's a: 1) Transportation vehicle (Transports a person from Point A to Point B) 2) Must be powered by an engine 3) Must have 4 wheels
Key point: The motorcar inherited attributes from both Transportation vehicle and Motorized vehicle.
And a Bicycle is a 1) Transportation vehicle (Transports a person from Point A to Point B) 2) Must be powered by a human 3) Must have 2 wheels
Key point: The bicycleinherited attributes from both Transportation vehicle and (bi-)cycle.
Conclusion: By placing an object in a certain group we automatically know what to expect of that object. We know a motorcar has 4 wheels and an engine, and we know if you get into a motorcar it will be able to take you from one place to another. We also know what NOT to expect from a motorcar. We know it can not have two wheels - if it did have two wheels then it would cease to be a motorcar, and become a motorcycle instead. It also can not be a motorcar and a motorcycle at the same time - it needs to be either one or the other. To add to the mix, think about the following: If we classify an object as a (bi-)cycle, we know it can take you from point A to point B and has 2 wheels. We, however, do not know if it requires human effort or if its powered by an engine. The fact is, we don't care! The only stipulation is the object must have 2 wheels and be able to transport a human - that's it. If an object has those two attributes we know its some kind of (bi)-cycle.

So how does this apply to SAM?

Each SAM category has zero, 1 or more attributes associated with it. A complete list will be made at the end of this section, but lets just go over a few examples to explain the concept.
Browse to the Content->Sound FX category. This category has a song type attribute of "X". Meaning ALL songs added to categories under this parent will be assigned a song type of "X".
Lets go over an example step by step.
1. Right-click on the Content->Sound FX category and select New. Type "ExampleFX" as your category name.
2. Add a song to the Queue. Now bring up the Song information editor for the song and take note of the Type field. (It should display "S" if it was a normal song type.) Close the Song information editor.
3. Now drag the song from the Queue to the ExampleFX category.
4. Again open the Song information editor for the song. Notice how the Type changed to "X"! Ok, now change the "X" back to "S" and click on OK to close the Song information editor.
5. Now click on Refresh inside the ExampleFX category. Notice that the song you just added to the category is suddenly gone!
Lets slowly recap what just happened
  1. When you created the ExampleFX category it inherited the attributes of the parent category. The parent category in this example had the attribute that "if you want to belong to this category your song type better be 'X' or you will not show up."
  2. When we dragged the song to the ExampleFX category three things happened: > 2.1 First, SAM checked that the song was already added the the media library. In this case it was. (If it wasn't, SAM would have automatically added the track to the media library.) > 2.2 Second, it checked that the song's type matched the category attribute (Song type ='X'). In this case it wasn't, so it changed the type to 'X'. > 2.3 Lastly it added the song to the ExampleFX category.
  3. When we changed the type of the song back to 'S' inside the song information editor we effectively made the song invalid to still be part of the ExampleFX category because only songs of type 'X' can be listed inside it. Thus, when we refreshed the list of songs the song was removed from the list.
Lets continue. Browse to the Content->Sound FX->Sound FX (All) category. This is an example of an Auto-generated category discussed earlier, but, as you might have guessed, with the additional property of having an attribute assigned that specifies "only list songs of type 'X'".
  1. Now drag the song from the Queue into the Sound FX (All) category.
Two things just happened
  1. SAM checked if the song was already in the media library
  2. Changed the song type to 'X'
That's it! Since the list is auto-generated from all songs in the media library there is no need to store any additional information. This category simply shows ALL songs in the media library that has the attribute that the song type is 'X'.

Lets take a look at a more complex category
Browse to the Special->Weighted rotation category. Under it you will find a list of categories called "Power hit", "Heavy rotation", etc.
A Weighted category has the following attributes
  1. The song must be of type 'S'
  2. To belong to a specific weighted category the song's weight must be in a specified range.
For example to belong to the Power hit category a song must be a) Of type 'S' b) Have a weight of 80 to 100
So dragging a song into the Power hit category will do the following
  1. Add the song to the media library if needed
  2. Change the song type to 'S'
  3. Change the weight to (Minimum weight+Maximum weight) / 2. (Which is 90 in this case since 80 + 100 =180 / 2= 90)
Next, let's look at a category with zero attributes. Any category created under the root Playlist category will have zero attributes.
Thus adding a song to such a category will result in the following
  1. Song is added to the media library if needed
  2. Song is added to the category list.
And that's it. Nothing more. Neither the song type nor the actual weight gets changed.

Quick overview
  1. Categories have certain attributes.
  2. A category will only list songs that matches all the attributes of the parent category.
  3. A category will change the attributes of any songs added to it in order to match the attributes of the parent category.
  4. Some categories have zero attributes and thus will list all songs added without changing any attributes of the song.
  5. If you create a new category it will also inherit all the attributes of the parent category.
3 Categories and their attributes
3.1 Normal categories (Attributes: NONE)
  • Playlist
3.2 Song type categories (Attributes: Song Type)
  • Content (Attribute: Song Type)
    • Music (Song type = 'S')
    • Sound FX (Song type = 'X')
    • Station IDs (Song type - 'I')
    • Jingles (Song type = 'J')
    • Promos (Song type = 'P')
    • Advertisements (Song type = 'A')
    • News (Song type = 'N')
    • Interviews (Song type = 'V')
    • Other (Song type = 'C')
3.3 Special categories (Attributes: Song Type, Weight range)
  • Special
    • Weighted Rotation* (Attribute: Song Type = 'S', Weight range)
      • Power hit (Weight = 80..100)
      • Heavy rotation (Weight = 60..79)
      • Medium rotation (Weight = 40..59)
      • Light rotation (Weight = 20..39)
      • Rare rotation (Weight = 10..19)
      • No rotation (Weight = 0..9)
    • Overlay (Attribute: Overlay = Yes/No)
    • Song rights (Atrribute: Song rights, i.e. Broadcast,On-demand,Download, Royalty free)
    • Play limit (Atrributes: Play limit, and action)
*ALL weighted categories have a song type of 'S'.
3.4 Grouped categories
Grouped categories are a special case. The attribute of grouped categories is the data field by which the song list is grouped along with the actual value inside the data fields.
Currently grouped categories do not support inheritance. In fact, you can't even drag a song into a grouped category.
Eventually, future inheritance for grouped categories might be supported.

4. Directories - a special kind of category
The last type of category type is the one built into your operating system. The one that nicely groups your files into logical groups: a Directory. (Windows often refers to a directory as a folder. )
Rotation logic can be applied directly to directories making them act as a kind of special case for categories.
5. Drag&Drop maintenance
Now that you know all about categories start putting that knowledge into good use. Plan how you want your music organized, what categories you need and how they will be used.
Once you have created all the required categories, management becomes a very simple process of dragging&dropping files into the right category.
6. Putting categories to work
So your music media library is now nicely sorted into categories. Easy, wasn't it?
Now lets put these to good use.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
This section contains important snippets of information in order to properly utilize SAM3.
· Keep your songs in a static location Before using SAM3; logically organize the complete music library on your hard disk. Use a directory structure like c:\music\"artist"\"album"\*.mp3. Once songs are added to the SAM2 media library, do not move the songs or SAM2 will have invalid songs and will not know where to find them.
· Any song that gets played is automatically added to the media libraryAny song that gets played on SAM2 gets automatically added to the media library. This includes songs directly added to the queue or songs inserted via a PAL script. These songs then show up under the Content->Music->Music (All) category.
· Deleting a song from a category doesnotdelete the song from the media library When removing/deleting a song from a specific category the song will STILL be in the media library. To completely remove a song, select the Remove from ALL command.
· Some changes are not instantly reflected on the SAM3 display For example, changing the artist name of a song inside the song information editor will apply the changes, but will not immediately be visible. Refresh the list of songs in order to make the changes visible. The general rule to live by - "When in doubt, hit refresh." SAM3 caches song information in order to speed up display and control, and changes to the song data will not be immediately updated inside the cached information.
· Save the song information directly in the file tag after major changes Each time, after making changes to the song information, click the Save tag button to store the information directly inside the song file. This can prevent a lot of headaches later down the road in case: a) Your media library database gets corrupted and you have to rebuild it b) You move your files and re-add them to SAM c) You want to use the same song on other stations d) You accidentally delete songs from the media library and need to re-add them.
· Keep your media library consistent In general, try not to move songs around on your hard drive and do not directly delete songs from your hard drive. So how do you move or delete a song? a) Moving a song Move the song to the new location. Search for the song inside SAM, then open up the Song information editor, and click on the browse button located next to the filename. Browse to the new location of the song. The filename will be updated to point to the new location and all song information and statistical information will still be intact. b) Deleting a song Deleting songs is a bit easier. Find the songs to delete using the song search, and then use the Delete physical file function to delete the song file(s) from the hard disk.



Tips:
  • If retaining the song information and song statistics are not important to you, simply move the songs to the desired new location and then write a short PAL script to rescan both the old directory and new directory. That way, the old invalid entries will be deleted from the media library and the new files will be added to the media library.
  • Another tip for moving files: Create a custom category called "Moved" and then drag your songs into the "Moved" category directly from explorer BEFORE you move the files. This will give a list of all songs moved and you can use the song information editor quickly to update the new location of each moved song without needing to go search for each one.
  • Same tips can be used for songs you want to delete. A PAL script that rescans the directories will detect deleted songs and remove them from the media library.
  • Also, dragging songs you want to delete into a custom "DeleteUs" category will provide you with a complete list of songs you need to delete. Then simply select all the songs in this list and use the Delete physical file command to delete them all in one shot.

Drag & Drop management Make sure you understand categories - drag & drop management can either be a helping friend or the ghost that keeps moving songs into strange places.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
This section will provide a step-by-step guide to initialize a category-based rotation logic script. This section is by no means a complete overview of category based rotation, but will give a good start in exploring the power of SAM's rotation logic.
external image images%5Cdot2.GIF
Note: Advanced users can achieve the same logic as described here using a PAL script.

Related topics

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
Lets first activate the SAM3 Category based rotation logic module.
Open up the SAM3 configuration and browse to SAM3->Config->Playlist rotation rules
Under Playlist logic modules select the Category Playlist rotation logic module and click on the Configure button.
This will bring up the Category rotation logic configuration dialog.
Ignore the values in the Adjust weight on events section for now and look at the Rotation clockwheel format section.
Once you have the Rotation clockwheel format window in front of you and can specify your own clockwheel format.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
A review of the buttons - from top to bottom:
  • + Category - Select a song from a category rule.
  • + Directory - Select a song from a directory rule.
  • + Request - Select a pending request to be moved to the queue.
  • + Comment - Add a comment or description to the clockwheel that helps you follow the logic or provides more information.
  • Clear - completely empties the clockwheel.
  • Load - Load a clockwheel format from a file.
  • Save - Save the current clockwheel format to a file.


Example clockwheel
[[code format="sourcecode"]]
Category based rotation - some more examples
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg
Category based rotation - Examples
Example 1: A very simple clockwheel
Click on the Clear button to start a new clockwheel; then click on the Category button.
This will bring up the Select category dialog. From the categories on the left choose the Tracks category.
On the right are various options:

Enforce playlist rotation rules
Specifies whether SAM will use the Playlist rotation logic rules when selecting a track out of this category.
Selection method specifies what logic to use when selecting a track. The Least recently played logic, for example, will select the song that hasn't played for the longest time. For a complete overview, please refer to the documentation Selection method .

For this example, check the Enforce playlist rotation rules checkbox and click the Lemming Rules selection method.
Now click on OK. The clockwheel format script should now look like this:
[[code format="sourcecode"]] Cat.QueueBottom('Tracks',smLemmingLogic, prEnforceRules); code
Now click on OK to save the current configuration.
SAM will now select a song out of the Tracks category EACH time SAM needs a song for rotation. SAM will ONLY select songs inside the Tracks category. If a song is not located inside the Tracks category, it will not be played.

Example 2: More advanced clockwheel
In this example, songs will be inserted from two categories, a station ID will run, and then a featured artist from files located inside a certain directory will be added to the queue.
Here is the final product:
[[code format="sourcecode"]] Cat.QueueBottom('Tracks',smLemmingLogic, prEnforceRules); Cat.QueueBottom('Music (All)',smWeighted, prEnforceRules); # Insert Station ID Cat.QueueBottom('Station IDs (All)',smWeighted, prNoRules); # Insert song from one of our featured artists SubDir.QueueBottom('C:\Music',smLRPA, prEnforceRules, NoScan); code
The first line is exactly the same as in Example 1.
The second line was created by clicking on the Category button and browsing to the Special>Content->Music->Music (All) category. The Weighted selection method was chosen and the Enforce rules checkbox checked.
For the third line, click on the Category button and browse for the Special->Sweepers->Stations IDs->Stations IDs (All) category. Do NOT check the Enforce rules checkbox since most stations only have a few station IDs that play often. Thus the Do not repeat song within [xx] minutes rule will almost never be able to select a valid station ID for play. Consequently, this command skips the playlist logic rules for station IDs and simply selects the one that has the best balance according to weighted rotation.
Then, on the next line, use a directory category to only select songs located inside a certain directory. To accomplish this, click on the Directory button and browse to the directory containing the music. (In this example, it was c:\music\ ). If the music is nicely sorted in subdirectories, and to have the logic also search the subdirectories for songs, check the Include subdirectories checkbox. Do not check the Rescan directory if there are a lot of files in the folder, as rescanning each time will waste considerable CPU power. Songs will have to either manually be added to the media library each time new files are added to the c:\music directory, or a PAL script will need to be created to automatically check for new files on a daily basis - or else the files will not be in the media library and SAM2 will not select them for rotation.

How SAM works with the clockwheel:
As SAM plays songs it will refer to the playlist rotation logic module each time it requires a song for rotation. The Category based rotation module decides which song to play according to a clockwheel format script.
The above script does the following:
First, select a song from the Tracks category, using Lemming Rules (which basically means random logic) and make sure the song selected obeys all playlist rotation rules.
Then select a song from all songs inside the media library (excluding Sound FX, stations ID, etc) using weighted rotation selection logic (song with higher weight will get played more often), once again obeying all playlist rotation rules when selecting the song.
The third song selected will be a station ID, selected from the list of ALL songs marked as a station ID. Once again, the weighted selection method is used, but we do not enforce the playlist rotation rules. (See notes below.)
Finally, select a song located inside the c:\music directory or a song located in one of the subdirectories located under c:\music. Use the Least recently played artist selection method logic since this will give us a nice rotation between artists. Playlist rules are enforced, but do not rescan since it might put our CPU under too much load with a large amount of songs under that directory.
external image images%5Cdot2.GIF
Notes
  • When a category selection method can not find a valid song that plays within the playlist rotation rules and Enforce rules is used, the specific selection will return an EMPTY result - meaning NO song will be inserted from that category and one from the NEXT category will be inserted instead.
  • A common mistake is to enforce rules on Station IDs, Sweepers, etc., causing them to be not valid under the rules and returning an empty result set. This in turn causes your clockwheel format to be "broken" - i.e., not playing songs in the correct "format"
  • Using rescan for small directories (Less than 1000 songs) will read the files inside the directory/subdirectories and also remove invalid files. This is very useful if you simply want to copy featured songs into a directory without needing to manually add them to the media library. Just be warned that for big directories running rescan in your playlist category script is NOT recommended. Rather, use a PAL script to rescan it daily or once every few hours.
external image images%5Cdot2.GIF
Note: This is a note or comment

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Properly using Categories for rotation
Categories will make life easier and can make the music format sound like a professional radio station - if used properly. First, before reading this section, read the Understanding playlist categories section to get a proper background on the subject.
This section only applies if SAM3 is using the Category based rotation logic module or using a PAL script that inserts songs for rotation using categories.
Refer to the following examples
Things to keep in mind while working with category based rotation logic:
  • Make sure there are enough songs in the category to rotate within the bounds of the playlist rotation rules, or else the category will be skipped. This is a common mistake with categories like Promos, Station IDs, Sweepers, etc. Always use the NoRules parameter for those categories.
  • When using directories as categories, remember that the songs must already be in the media library before they can be selected for rotation. The Rescan flag will, of course, scan the directory for new files and remove invalid files - but that can take a lot of time and CPU with large directories.
  • Category names are not case sensitive, but spelling must be exactly the same as the actual category as located in the Playlist. > - A PAL script will warn you inside the output window if it could not find the specified category. > - The Category based rotation module currently will not report any problems with the category name. It will simply skip that category script line. Therefore, it is very important to double-check the name of categories in your scripts.
  • Parent and Grouped categories are not valid names for category-based rotation! > Parent categories do not contain any songs, only other categories. They cannot be used for category-based rotation. In the future, the support for grouped categories for rotation logic may occur.
  • If a category is the parent of other categories, but also contains a list of songs - from where will the selection be made? > This is the main difference between categories and directories > > a) Using the Dir['c:\music\'].QueueBottom(...) command, songs will only be selected from the main root directory. No songs from any subdirectories will be included in the search. > > b) Using the SubDir['c:\music\'].QueueBottom(...) command, songs will be selected from the main root directory and songs from any subdirectories will also be included in the search. > c) Using the Cat['MyCategory'].QueueBottom(...) command, songs will only be selected from the 'parent' category. No songs from any child-categories will be included in the search. Thus, it works similar to (a).
Related sections

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Setting SAM to Broadcast over the Internet

  • Set up a streaming server (SHOUTcast, LIVE365, Icecast, Windows Media, etc.). > Note: If you need a streaming server, we recommend AudioRealm stream hosting .
  • Create an Encoder to stream to the server.
  • Create a relay for each streaming server to grab statistics from the servers. This will also cause your station to appear on AudioRealm.com and other station listing sites.
To broadcast over the Internet with SAM you need to do the following:

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Setup a streaming server
To make your stream available to listeners you need a streaming server. Setup and configuration of streaming servers are out of the scope of this guide - you should refer to the specific server documentation for setup details.
SAM3 supports almost all of the popular streaming servers available today. SAM3 thus gives you the power of choice, allowing you to stream to almost any type of server or even multiple types of servers all at the same time!

Note: If you need a streaming server, we recommend AudioRealm stream hosting

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Create an encoder to stream to the server
Once you have set up a streaming server, or purchased stream hosting from a provider, the next step is to create an encoder that can supply the streaming server with a source stream. A complete discussion about each encoder type can be found here.
external image images%5Cdot2.GIF
Note: Most streaming servers have the ability to relay a stream from another server. For example, a Live365 server can relay a stream directly from a Shoutcast server. Thus you only have to send one source stream to the Shoutcast server, which in turn streams a stream to the Livecast server, saving you bandwidth and CPU power since you only have to run a single encoder instance.
You can also stream at multiple bitrates. For example, you can stream at 24kbps WMA for modem users and 128kbps WMA for cable modem/DSL users. Note: You will need a server for each source stream. (In the case of Windows Media servers, the same server instance can handle multiple streams, but each stream has its own unique alias.)

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Create a relay for each server
The final step is to create a Statistics relay for each streaming server. Remember, this includes relay servers. A statistic relay simply grabs the current status and viewer count from each server, reporting the details to SAM. Without a statistic relay, SAM will not know where listeners can connect to listen to your music and it will also not accurately report the count of listeners connected to your stream.
Additionally, without valid statistic relays your station will not show up on AudioRealm.com. This means you will not get any extra exposure and you will miss extra listeners coming from the AudioRealm portal and partner sites.

A complete discussion about all available statistic relay types can be found here.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Getting your Website Ready

In today's world, a website can no longer be a static page of text. To compete in the broadcasting world, your website must be informative, interactive and easy to use.
Luckily, by using SAM, you already have the edge over many other stations. SAM3 features advanced HTML and PHP output capabilities, making it a breeze to have dynamic updated web pages - even if you do not know a thing about web scripting or HTML! Also, SAM3 templates include a Buy CD link, which can provide an additional revenue opportunity.
SAM3 ships with two example website templates:
  • The PHP web template, located inside ...\program files\spacial audio\SAMBC\samPHPweb, contains a basic example of how to write a website using the PHP scripting language. This template is intended for more advanced users, since learning PHP can take some time and effort. We do, however, highly recommend PHP websites since the power of PHP for website creation is unmatched.
  • The second web template is located in ...\program files\SpacialAudio\SAMBC\samHTMweb. This template uses the built in SAM HTML output language.
This is only a quick overview of what to do in order to get a website up and running. For complete, detailed instructions, please refer to the HTML output section and the HTML output reference guide .
Steps for preparing your website

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Steps for preparing your website
  • Get a good web-hosting provider.
  • Get FTP access to the website.
  • Configure HTML output as described in the Readme.txt file. Customize the web template to specific needs.
  • Make sure the request policy is properly configured to handle requests.
  • Associate pictures with songs and upload them.
  • Upload the complete HTML template to the website. (Including pictures and all subdirectories.)
  • Generate the playlist and upload it.
Your website should now be ready!

external image images%5CHeader.jpg

PAL Scripting - "Hello World" Example

This section gives a quick start in getting a PAL or Playlist Automation Language script working. PAL is a fully featured programming language embedded directly into SAM3 that allows control of almost every aspect of SAM and playlist rotation logic.
Step 1: In SAM3 go to the menu option Menu->Window->PAL scripts and activate the PAL script window.
Step 2: Click on the Add ("+") button. This will open the script options dialog.
Step 3: Next to the script source file, click on browse ("folder") button located to the right of the edit field. Enter the name of the script you want to load, or, if the script does not exist, the name of the script to create. For this example, it is "Guide.PAL". Click OK. (If prompted to create the file, select yes...)
Step 4: The Guide.PAL script entry will appear inside the PAL Scripts window. Double-click on the Guide.PAL entry to open up the PAL IDE.
Step 5: Inside the PAL IDE type the following text:
code
WriteLn('Hello world!'); codeStep 6: Click on the Run button (or press [F9] ).
The BLUE line shows which line is being executed, and the output is written on the right hand side of the PAL IDE. (It will show "Hello world!".) The status of the script in the status bar will also be displayed in the PAL IDE.
Congratulations! You have just entered the awesome world of radio automation scripting!

Some more examples:

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
The next example shows how to create a Category based rotation logic script, much like can be done using the Category based rotation logic module.
Assumptions for this example: a) All the popular music is in a category called "Hitz" b) The rest of the music is in a category called "Tracks" c) There are some station IDs inside the "Station IDs (All)" category.
As a program manager, you realized that your listeners like to hear two Hitz back-to-back and then play a tune from the Tracks, and then finally play a station ID so that they don't forget to what station they are listening.
Follow steps 1 to 4 from the “Hello World” and create a PAL script called "Example1.PAL"
Then, paste this text into it:
codecodecode{#0# Make the script restart once it reaches the end}codecode PAL.Loop := True; codecodecodecode{#1# Insert songs into the Queue from various categories}codecode CAT['Hitz'].QueueBottom(smLemmingLogic,EnforceRules); codecode CAT['Hitz'].QueueBottom(smLRP,EnforceRules); codecode CAT['Tracks'].QueueBottom(smLRPA,EnforceRules); codecode CAT['Station IDs (All)'].QueueBottom(smLRP,NoRules); codecodecodecode{#2# Lets wait a while until a few songs have playedcodecodeor else we will completely fill up the queue with songs!}codecoderepeatcodecode PAL.WaitForPlayCount(1); codecodeuntil Queue.Count < 3; code
external image images%5Cdot2.GIF
Notes:
· The PAL.Loop := True will make the script execute in a never-ending loop. To stop the script press [Ctrl]+[F2]
· At the end of the script, the PAL script waits for a song to play and then checks on how many songs are left in the queue. If there are two or less songs in the queue, it continues execution of the script (which will add more songs to the queue). If this wait were not in the PAL script, it would continue adding songs to the queue till the queue eventually filled with thousands of songs!
· Notice that for the Station IDs the NoRules flag was used. This is because the station IDs category is likely to only contain a few tracks that will get played often and thus not comply with the "Do not repeat same song within [xx] minutes" rule. In order to work correctly, the playlist rotation rules must be ignored.
||


external image images%5CHeader.jpg

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

external image images%5CHeader.jpg
||
Assumptions for this example: 1) All the advertisements are located in the "Advertisements (All)" category.
PAL Script:
code PAL.Loop := True; code code PAL.WaitForPlayCount(5); code code CAT['Advertisements (All)'].QueueTop(smLemmingLogic, NoRules); code code code
external image images%5Cdot2.GIF
Note:This script places an advertisement at the top of the queue after five songs play. SAM3 uses the normal playlist rotation logic to choose the five songs, but the PAL script forcefully adds an advertisement after every five songs that play.
||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
external image images%5Cdot2.GIF
Notes:
· The shows are loaded in reverse order (#4 first, then #3, #2 and then finally #1). This occurs because we are loading each show at the top of the Queue. For the first song to be at the top of the queue we need to load it last.
· This script will only execute the show if it’s Wednesday between 7:58:00pm and 7:58:30pm.
· The PAL.WaitForTime is needed so that the current time is later than the end_time variable. If the script were to continue without waiting it might occur that the show is executed twice (The script will restart and still be inside the 7:58pm and 7:58:30pm time window.).
Summary
This concludes a quick introduction to the exciting world of PAL scripting. Please refer to the PAL scripting reference guide for more detailed information about PAL scripting and make sure to visit the Spacial Audio Knowledge base for countless examples of PAL scripts being used by broadcasters.

Related sections


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

||
HTML output pages can be created in various ways inside SAM. This section walks through three quick examples showcasing each type.

external image images%5Cdot2.GIF
Note: This section does not cover websites generated exclusively via a webscripting language like PHP or ASP. This only concerns only HTML pages as parsed and generated via SAM.



1. Input source type: File

Create a file called input_file.txt and enter the following for its contents:
[[code format="sourcecode"]]
Now go to the HTML output configuration section and add a new HTML output file with input_file.txt as the input source with type File and output as output_file.txt



2. Input source type: HTTP

Inside the HTML output configuration add a new output page of type HTTP with input source: http://www.spacialaudio.com/help/input_http.php?artist=#artist#&title=#title#&mmss=#mmss#

(Line might wrap, it needs to be a single line though)

and output called output_http.txt

external image images%5Cdot2.GIF
Note: This page is generated on our webserver using song information SAM sends inside the GET URL parameters. The source for this PHP script is as follows:
[[code format="sourcecode"]] code




3. Input source type: PAL Script

Finally, create a file called input_pal.txt and use the following for its contents:
[[code format="sourcecode"]] <% Send('Currently playing:'); %> <%= cursong['artist'] %> - <%= cursong['title'] %> (<%= cursong['mmss'] %>) code




Next, inside the HTML output configuration , add a new output page of type PAL script with input file input_pal.txt and output output_pal.txt
external image images%5Cdot2.GIF
Note: Notice that this special kind of PAL script mixes normal HTML with PAL script commands. All PAL script commands need to be within <% %> brackets.

4. Generate the example pages

From the General menu command generate the HTML output page and look at the output files created.



The same page was just created in three different ways!


||

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

external image images%5CHeader.jpg

external image images%5CHeader.jpg

Interface Windows Overview

The SAM3 user interface was designed to be user friendly, clean & functional. Because SAM3 does so many things, it is impossible to keep all windows open since they will not fit onto a single screen. Thus, the user interface allows you to only open those windows you need.
The SAM3 user interface can be divided into 3 sections
  • Menu
  • Toolbar
  • "Desktop" - the place where all windows will be visible. > A "Desktop" is a space where windows are shown. You can configure up to 3 unique desktops (Desktop A,B,C). These allow you to quickly switch between different views. For example, on Desktop A you might place all windows related to DJ-ing like the Player Decks, Queue & Playlist. Then on Desktop B you can place all your streaming functions like the Statistic relays & Encoders.
  • The SAM3 Tray icon is located at the bottom right of your screen on the taskbar. You can use it to hide the SAM3 user interface or to open it. Try to Double-click on the tray icon. That will hide or show the user interface. Right-clicking on the tray icon will bring up a popup menu with a few more options.
For more details on each section please follow these links

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Song Information Editor

The Song information editor allows you to quickly view, edit and save details about a specific song.
external image images%5Cdot2.GIF
Note: You can open the Song information editor from almost any list of songs by selecting/focussing the song and pressing the shortcut key [Alt]+[3] . (Or right-click to bring up the popup menu.) To edit more than one song at once, select all the songs you wish to edit and then press the shortcut key [Alt]+[3]

Info Tab
  • Artist - The Artist or group that performs the song.
  • Title - The title or name of the song.
  • Album - The name of the album from which the song was taken.
  • Year - The year the album was released.
  • Genre - The genre of music the artist or song falls under. You can choose a pre-defined genre from the dropdown list or type in your own.
  • Label - The organization that markets the album or song.
  • Composer - the person, band or artist that composed the lyrics/music.
  • Website - URL to the band's official website.
  • Buy CD - URL to where the CD can be bought.
  • Track # - Track number, i.e., position of song on the album.
  • Type - The song type which can be any of the following values > (This value can effect the song's consideration for normal playlist rotation. In general, only songs of type "S" are considered for rotation, unless Category based rotation or PAL scripts are used.)
    1. S - Normal song
    2. I - Station ID
    3. P - Promo
    4. J - Jingle
    5. A - Advertisement
    6. N - Syndicated news
    7. V - Interviews
    8. X - Sound FX
    9. C - Unknown content
    10. ? - Unknown
  • Mood - Specify the mood of the track. This can help you identify the suitability of the track in certain situations.
  • Rating - rate the song. 1 is very bad and 9 is very good.
  • Weight - The weight of the song specifies how important it is. If weighted rotation logic is used, songs with a higher weight will play more often than songs with a lower weight.
  • Duration - Time of the song in mm:ss
  • Filename - The location and filename of the song. If the file is moved to another location, use the button next to the filename to specify the new location.
  • The Picture Upload button will FTP upload the current album picture to a remote website.
  • Clicking on the picture frame loads the picture from a file.
  • The Find at Amazon function is a powerfull search that allows you to quickly locate album cover pictures on Amazon.com and generate a Buy CD link directly to the CD. Additionally, if listeners use this link to buy a CD, you will receive a referral fee. (Provided, of course, you have supplied your Amazon associate ID.)
external image images%5Cdot2.GIF
Note: You can legally use the Amazon pictures provided that you also display these pictures on your website in order to sell the CD's.

  • The Save tag button will save all the song information inside the audio file itself. This is highly recommended once you have made all the required changes. If the Save tag option is disabled, read the section at the very bottom of this page.
  • The Load tag button will load all the information saved inside the audio tag into the database fields.
Picture Tab
  • Load button allows you to load a picture from file.
  • Clear button will remove the picture.
  • Find at Amazon function allows you to quickly locate album cover pictures.
  • FTP upload picture will upload the picture to your remote website.
Lyrics Tab - Enter the lyrics for the song.
Comments tab - here you can enter comments, artist information, bio's, events, gigs or any other general information you want to store or display on the website.
Details Tab
  • Song ID - the ID of the song as stored in the SAM database.
  • Duration in mm:ss.
  • The Date added is the date on which the song was added to the media library for the first time.
  • The Last played date shows the date the last time the song has played.
  • Play count - this counts how many times the song has played.
  • Request count - how many times has this song been requested in the past.
  • Weight - current weight setting.
  • Balance - The lower the balance, the more likely a song is to play if weighted rotation is used.
  • Status - The current song status which can be any of the following values:
    • 0 - Song is online and ready for play
    • 1 - Disk/CD not in drive, so file is not available for play
    • 2 - Unkown status (Netowork source / URL, so status of song unknown)
    • 3 - Song is currently in recycle bin
    • 4 - Song was banned
    • 5 - SAM3 failed to play the song
    • 6 - Deleted (Physical song was deleted or moved)
  • Filename - current full path & filename of song.
  • Special Settings -

Play track [count] times and then [action]
This allows the track the be either Deleted from the Media library, or completely being deleted from the harddisk. > >>
Actions:
None - Play song only [xx] times.
Remove - Play song [xx] times, then delete from media library, i.e. delete from ALL categories
Erase - Play song [xx] times, remove from ALL categories, and also delete the physical file from the harddisk. Use with care!! Great for use with News and other "single play" files.

Also see the Categories under
[Special->Play limit]
==
Reporting Fields Tab==Depending on your country, you might be required to report details on the songs you play on your station to certain organizations. Luckily, SAM3 makes this job very easy for you. Just make sure you complete the details for each song to the best of your abilities and SAM3 will keep a complete history log. Fields are the same as under the Info tab above except as noted below:
P-line is the current copyright holder. Usually the P-line code is the text that follows a (P) "P inside a circle".
ISRC - Internatiol Standard Recording Code.
Catalog# - The catalog number (Each label usually has its own system of cataloging music).
UPC - Universal Price Code.
Rights - Can now specify different rights for the song
*
Royalty free - No royalty fee is payable on this music.
*
Download - Broadcaster may offer the track for downloading from a website or P2P sharing service.
*
On-demand - Broadcaster may use the song in an environment where listeners are able to listen to the track in an on-demand fashion. Steps should however be taken to avoid users being able to easily download or copy the track.
*
Broadcast - Broadcaster has the right to publically perform or broadcast the music.
Settings Tab**
The settings tab allows you to set custom crossfading options, specify the Beats-per-minute, cue, intro and other song properties useful for live mixing.
  • First, on the top-left corner you will notice the dulpilcate layout of Deck A and DeckB with Pause and Stop buttons are used to pause/stop playback of the song. To the right of these buttons are the normal Tot, Intro, Cur, Rem labels which indicate Total duration, Time till intro ends, Current payback time and Remaining playback time respectively.
  • Next you will find the (V) Volume, (P) Pitch and (T) Tone slider
*
Cue points


Standard Cue Points:

*
Start -The point where playback will start from
*
End - The point where the track will end and be ejected; effectively the duration of the track.
*
Intro -The point where the first vocals start (and the DJ needs to shut up! ;)
*
Outro -The point where the vocals stop, and the DJ can open his mouth again...
*
Fade - The point where the fading out of the track should start.
*
XFade -** The point where the next track will start playing.
    • Custom Cue Points: You can set up to 10 custom cue points to help seek to specified points in a file quickly.
Setting up a cue point:

Option 1: Double-click on the time window of the cue point to manually enter/change the time.

Option 2: Start playback in the player just above, and then click on the button containing the name of the cue point to set the time as the player reaches the correct point.

The [-] button clears the cue point, while the [>>] button will seek to the specified cue point. For custom cue points you must first select the index, then type in a short name/description of the point before setting up the cue point.



  • Beat-per-minute - Set the beats per minute of a track.
    • Method 1: Click the auto detect button to attempt to automatically detect the BPM value of the track.
    • Method 2: Click on the "Tab beats" button and then start the player. Now press on each beat until the "Tap on Beat" button goes away.
    • Method 3: Adjust the BPM manually by pressing the up/down arrows. The arrows on the left change the value by 1, while the ones on the right change the value only 0.1 for finer adjustment of the BPM value


  • Metronome: To verify that your BPM value is 100% correct, follow these steps:
    • Start playback on the player and anticipate the next beat, trying to pause the player exactly on the beat.
    • Now, while holding down [shift] click on the Metronome button to start the Metronome. Holding down shift will cause the player to resume playback the instant the button is pressed.
    • If your BPM value is correct, you should hear the metronome sound exactly on the beat of the song. If needed, adjust the BPM manually to better match the beat.
Notes: Make sure the Pitch and Tempo values of the player is set to zero, or else your beats will be configured incorrectly.

  • Other settings:
Gap killer - Specify whether the Gap killer should be applied to the track.

Gain - Apply pre-amp to the track, i.e. either increase or decrease the volume of the track. Great for making soundFX, advertisements and promos louder that normal tracks.

  • Applying settings
    • The big [Apply] button will apply your settings to the player, so that when you start the player you can preview your custom settings.
    • The [Restore] button will restore the original player settings into the player.
    • The [Reset] button will restore the default player settings into the playerApply, Reset and Restore.


Fading Tabs

You can apply custom crossfade settings to each song to ensure the very best fade possible between tracks.

  • Enable fading - if not checked the song will not be faded at all.
  • Allow cross-fading - if checked, the next song will be crossfaded with this song
  • Override Fade in - Override the fade settings provided in the config section > Time - the duration of the fade-in > Level - at what volume level should the fade start
  • Override Fade out - Override the fade settings provided in the config section > Time - the duration of the fade-out > Level - at what volume level should the fade start
Note: You MUST check the "override" box next to each setting to override the default value for the track.



Related sections

  • All pictures are saved inside the specified Local picture directory that can be configured here.
  • In order to FTP upload pictures you first need to set up your FTP details.
  • The song information editor can be opened from almost all song lists, like for example the Queue, Playlist and song Search dialog.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Song Search Dialog

The Song search dialog is simply the quickest way to located any song - even if your media library contains thousands of files.
On most track lists, you can simply start typing your search and the search window will load and instantly display matches while you are typing. Continue typing to narrow down your search until the song you desire appears.
Once you have found the song or songs you can:
  • Add the songs to the bottom or top of the Queue by using the shortcut keys [Enter] and [Ctrl] + [Enter] (Remember to select the songs first!). You can also drag the songs into the Queue
  • Add songs to a Playlist category by dragging the songs into the category.
  • Edit the song information via the Song information editor .
  • Or completely Remove the song from the media library.
Search options
  • Search string is the data that is matched to the data of the songs. > SAM uses complete phrase matching. For example, if you type "nothing matters", and the track is named "nothing else matters", the search will not find a match.
  • If Search on keystroke is checked SAM3 will search during data entry.
  • If Substring search is checked SAM3 will search for a match inside the string, i.e., the search "ground" will match "My ground", "Ground rules", and "Stood my ground forever."
  • If the Limit search to 100 results is checked the search is limited to 100 songs.
Search for matching specifies which fields will be searched for a match
  • Artist
  • Title
  • Album
  • Filename (This includes the full directory path and the filename)

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Menu

The Menu is located at the top of SAM3 and works like any other standard menu. Please read more about the function of each menu command in the following sections.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
File
Config - open up the configuration section.
Save configuration - Forces SAM to save its current configuration to file. This is very helpful if you made a lot of changes and want to make sure SAM3 saves them in case the computer crashes or freezes before SAM3 is able to save the current configuration on exit.
Hide - Hides the SAM3 user interface. You can show the interface again by Double-clicking on the SAM3 tray icon.

Exit - Closes SAM3

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Player
Play - Starts playing a song in the first empty deck if all decks are empty, or if a deck is paused, starts playing the deck. If a deck is already playing, the Play button will restart the song.
Pause - This button pauses the first currently playing deck it finds. If both decks are playing, you will need to press this button twice to pause both decks. Pressing pause again will start play again.
Stop will stop any currently playing deck. It will stop both decks if both are playing.
Next - This button will load the next song into a deck, if needed, and start play.
Fade to Next - This button will jump to the last 2 seconds of the present song fade and play next song in the queue.
DJ Mode> The Virtual DJ has 3 operating modes. Auto DJ, Play only queue, Manual DJ. Turning Auto recovery on will cause SAM to automatically load and play a song if SAM3 is paused or stopped for some reason.
Mute Studio This instantly mutes SAM3 operator's desktop

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
General
HTML output> Generate will generate all HTML output pages as specified in the configuration. Generate playlist will generate the complete HTML playlist as specified in the configuration. This should only be done once after new songs have been added to the playlist. Upload all pictures will add ALL the files found inside your local picture directory into the FTP queue for uploading.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Window Pull Down
The Window menu gives you quick access to show or hide a window. All windows with a checkmark are currently visible. Clicking on a visible window item will hide the window, while clicking on a unchecked window item will show the window on the current desktop.

Commands
  • Close all - will hide all the windows on the current desktop.
  • Restore - will show all the windows again that was previously hidden with the Close all command.
  • Desktop > - Desktop A will load the first desktop. > - Desktop B will load the second desktop. > - Desktop C will load the third desktop.
Next follows the list of all available Windows (Devided into 3 logical sections)
DJ Tool windows
  1. Deck A & Deck B
  2. Playlist
  3. Queue
  4. History
  5. Request
  6. Fade Control
  7. Sound FX
  8. Voice FX
  9. Clock
Broadcasting windows
  1. Encoders
  2. Statistic relays
  3. Statistic relays graph
  4. FTP Log
  5. PCI Max Ultra
General windows
  1. Event log
  2. PAL Scripts

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Player Decks (A & B)
Decks A & B are the main audio player decks. Having more than one player allows for many advanced functions (such as crossfading and cueing up the next song).
Player display
  1. Song Artist - Title information.
  2. Album cover display. Clicking on the Album cover will bring up the Song information editor.
  3. Cur - Displays the current playing time of the song.
  4. Tot - Displays the total duration of the song.
  5. Rem - Displays the remaining playing time of the song.
  6. Intro/Outro - the time remaining till the vocals of the song starts, or the time left till the vocals end and the DJ can start talking again. (Specified in Song information editor )
  7. kbps - Displays how many kilobits per second the encoded song is. > (Note 1byte = 8bits)
  8. kHz - Displays the sampling rate of the song.
  9. Stereo / Mono displays how many channels the audio contains.
  10. BPM - Indicated the Beats-per-minute of the song. (Specified in Song information editor )
  11. Control slider, that controls the Volume, Pitch and Tempo. Select which one to control by clicking on the [V], [P] and [T] buttons.
  12. When the [Air] button is down, the audio will be heard over the main output device. > When the [Cue] button is down, the audio will be heard over the cue output device, if enabled.
  13. VU Meter shows the current peak levels of the audio.
  14. Play/Pause button
  15. Stop button
  16. Next button
  17. Cue points
  18. Eject button
  19. Fade out button
  20. EQ button (Brings up Audio settings dialog)
  21. Beat match button ([=])
  22. Track position slider
Player usage
Loading a song into a player deck

*

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Aux 1 & 2
Exactly the same as Deck A & B with exception:
  • Few buttons are missing (Beat match [=], Next[>|])
  • Extra button - [Loop]
When down, the loop function will repeat the track when it reaches its end. This is great for playing a music bed while you talk over the voiceFX.

Note: Tracks played in the Aux players will not be logged in the history window.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Playlist
The Playlist provides an easy to use interface to categorize, manage and find your music. Understanding the power of SAM3 categories is crucial for the proper use of SAM3.
Note the new category layout.
Categories are incredibly important. Therefore, if you have not read and understood playlist categories, please do so before continuing:
Playlist display
  1. [^] Categories
  2. Categories window
  3. Category tracks window
  4. Add files
  5. Remove files
  6. Search
  7. Refresh
  8. Status bar
Playlist control
You can click on the [^] button right next to the Categories text to hide or show the category window. (You can also double-click on the Categories text.)
The Categories window contains a "tree view" of all available categories. You can click on any node in the tree to open up the node and display its contents inside the Category tracks window.
You can create a new Category by right-clicking on a Category parent and choosing New from the popup menu. Then enter the new category name and press [Enter] to save the changes. The Category name MUST be unique or else the changes to the name will not be applied.
You can delete a category by right-clicking on the category and choosing the Delete option from the popup menu. Warning: This will delete the complete category a long with any child-categories beneath it!
You can rename any category by choosing the Rename option from the popup menu.
The Add command from the popup menu allows you to:
  • Add files
  • Add directory
  • Add URL
  • Add Playlist
Other popup menu commands:
  • Search will bring up the search dialog in order to instantly locate songs.
  • Refresh list will reload the track information from the database.
Also note: You can drag categories around to change their location or to make them a child node of another category.

Shortcut keys
Shortcut
Action

[Ins]
Add a new category

[Del]
Delete selected category

[Ctrl] + [F]
Open Song search dialog

Begin typing
Open Song search dialog

[F10]
Refresh information
Depending on the currently selected category the Category tracks window will display either:
  1. Normal categories > A list of all tracks / songs in the category. > Example : Tracks category.
  2. Parent categories > A list of all child categories under the current category. > (If the category is a parent root node category.) > Example : Playlist category.
  3. Grouped categories > A list of category groups on the left with a list of tracks inside the group to the right. > Example : Groups->By Artist
1. Normal categories
Most categories are normal. They contain a list of songs. If some options are disabled for a particular category, those operations are not valid for the current, selected category.
Adding songs to the category - You can drag a track or tracks from almost ANY song list onto the tracks window and the songs will be added to the category. - You can even drag files directly from Windows File Explorer. - The green Plus ("+") button will allow you to Add files to the category. Clicking directly on the Plus button will load the File Open dialog box. Clicking on the down arrow will allow you to: - Add Files - Add a whole Directory - Add an URL or - Add a Playlist to the current category.

Removing songs from a category
The red Minus ("-") button allows you to Remove the selected track(s) from the category. The dropdown menu from the Minus button allows you to: - Remove - Remove the selected tracks from the category. - Crop - will remove ALL tracks from the category EXCEPT those currently selected. - Clear - will remove all tracks from the category. - Remove from all - will completely remove the selected tracks from the Media Library. (The song is completely taken out of the database) - Delete physical file - will delete tha actual source audio file. Use with care!
  • The Search button will open the Song search dialog which allows you to quickly locate songs.
  • The Refresh button will reload the information from the database to make sure the very latest information is being displayed.
  • Right-click on the tracks window to get a list of more operations > (We will only discuss the operations not dicussed above.) > - Queue bottom - will add the selected tracks to the bottom of the queue. > - Queue top - will add the selected tracks to the top of the queue. > - Sort - allows you to sort the list according to a specific field, or the Shuffle command will randomize the list. > - Select all - will select all the tracks in the category. > - Invert selection - will unselect the currently selected songs and then select the currently unselected songs. > - Song Info - will open the Song information editor .
Shortcut keys
Shortcut
Action

[Enter]
Add selected songs to bottom of queue list

[Ctrl] + [Enter]
Add selected songs to top of queue list

[Ctrl] + [O]
Add files

[Ctrl] + [D]
Add directory

[Ctrl] + [U]
Add URL

[Ctrl] + [L]
Add Playlist

[Del]
Remove selected song(s)

[Shift] + [Del]
Crop

[Ctrl] + [Del]
Clear category

[Ctrl] + [F]
Song search dialog

Just start typing your search
Song search dialog

[Ctrl] + [R]
Shuffle

[F10]
Refresh

[Ctrl] + [A]
Select all

[Ctrl] + [I]
Invert selection

[Alt] + [3]
Song information editor
2. Parent categories
Some categories have no other purpose than existing as the parent node in a tree for more categories. Such categories will simply display the list of child categories in the tracks window. You can then double-click on a category to open it.

3. Grouped categories
Grouped categories groups tracks together by a certain common value. For example, the Grouped category called By genre groups tracks together with the same genre. Clicking on a genre in the list on the left loads all the tracks available in that genre in the list on the right.
external image images%5Cdot2.GIF
Note: Many of the operations discussed in (1) Normal categories will not work in this section since these lists are an example of Generated categories.

Related sections

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Queue
The Queue list contains the list of songs scheduled for play in the order listed. The songs play from top to bottom, and a song is removed from the queue as soon as it is loaded inside a player deck. The Queue allows a DJ to make a list of songs well in advance - no more searching for the next song at the last second! New to the Queue with SAM3:

  • New Add->Mic/Line-in which brings up the "Soundcard recording configuration" dialog. This allows you to configure the exact way a "mic://" song should be recorded
  • [x] Automatically select mixer volume control, when checked will change the recording volume control to the specified control. This is useful to force the correct input - i.e. record from WAVE in one instance, and then from MIC in another.
Queue display
  1. Add files
  2. Remove files
  3. Song Search
  4. Save queue to playlist file
  5. Refresh list
  6. Put another song in the queue
  7. Play next song in queue
  8. ETA - Estimated time of arrival (play)
  9. Artist-Title
  10. Duration (total play time) of the song
  11. The status bar displays the number of songs inside the queue and the total duration of songs inside of the queue (Total playtime of the queue).
Queue Toolbar buttons
Adding songs to the Queue - You can drag song(s) from any song list into the queue. - You can drag song(s) directly from Windows File Explorer into the queue. - You can do a song search by simply typing inside the queue window, then adding the song(s) to the queue.
The black down arrow beside the green plus ("+") button brings up a dropdown menu that allows you to - Add files - Add a whole directory - Add an URL - Add a playlist Clicking on the green plus itself will perform the add files action. Removing songs from the Queue The black down arrow beside the red minus ("-") button brings up a dropdown menu that allows you to - Remove the selected song(s) from the queue - Crop the song(s) (This will remove all songs EXCEPT those selected.) - Clear the queue (This will remove ALL songs from the queue.) - Remove duplicates will remove any files listed more than once in the queue, so that only a single entry remains. Clicking on the red minus button itself will perform the Remove action. The Search button allows you to quickly find songs to add to the queue.
The Save button allows you to save the queue to a playlist file. (*.m3u)
The Refresh button will refresh the list of songs in the queue. This is useful if you changed the song information (i.e., edited the Artist name for example) from the Song Information editor.

Put another song in the queue button will select another song according to the playlist rotation logic and put it at the bottom of the queue.
If you right-click on the queue with your mouse a popup menu will appear with many options.

Shortcut keys
Shortcut
Action

[Enter] or Double-click
Play next

[Ctrl] + [N]
Choose next

[Ctrl] + [O]
Add files

[Ctrl] + [D]
Add directory

[Ctrl] + [U]
Add URL

[Ctrl] + [L]
Add Playlist

[Ctrl] + [M]
mic:// configuration dialog

[Del]
Remove selected song(s)

[Shift] + [Del]
Crop

[Ctrl] + [Del]
Clear Queue

[Ctrl] + [S]
Save queue to file

[Ctrl] + [F]
Song search

Begin Typing
Song search

[Ctrl] + [R]
Shuffle

[F10]
Refresh

[Ctrl] + [A]
Select all

[Ctrl] + [I]
Invert selection

[Alt] + [3]
Song information editor


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
History
The history window displays the last 200 songs played by SAM3. It allows you to easily view the history and avoid playing recently played songs. You can also drag a song from within the history list to most other lists, including the queue, a playlist category, or even directly onto a player deck.
Right-click on the window for a popup menu with more options.

Shortcut keys
Shortcut
Action

[Enter]
Add selected song(s) to bottom of queue

[Ctrl] + [Enter]
Add selected song(s) to top of queue

[Ctrl] + [F]
Open Song search dialog

Begin typing
Open Song search dialog

[Alt] + [3]
Open Song information dialog

[F10]
Refresh list of songs


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Requests
The request window shows all pending requests that is waiting to be added to the queue (Either automatically, or manually)

Request display
  1. Refresh button will refresh the list of requests.
  2. Clear button will clear the list of requests (effectively ignoring those requests).
  3. ETA is the estimated time the request will be added to the queue.
  4. Artist - Title information.
  5. Duration or total play time of the requested song.
  6. The status bar displays the number of songs inside the request window and the total duration of the songs. (The total playtime of the request list.)
Request control
The Refresh button will reload the list of requests.
The Clear button will ignore (remove) all the requests in the request window.
Right-clicking on the request list it will bring up a popup menu with many more actions.

Shortcut keys
Shortcut
Action

[Enter]
Add selected request(s) to bottom of queue

[Ctrl] + [Enter]
Add selected request(s) to top of queue

[Del]
Ignore (remove) selected request(s)

[Ctrl] + [Del]
Ignore all requests (Clear)

[F10]
Refresh information

[Alt] + [3]
Song information editor


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Voice FX
The Voice FX window provides an easy way for DJs to fade the currently playing broadcast sound and talk over it.

Voice FX display
  1. Config button
  2. EQ button (Brings up Audio settings dialog)
  3. Mic off/on button
  4. Press to talk button
  5. Lock talk button
  6. Music volume slider
  7. [Auto] fade music switch
  8. Mic volume/speed slider
  9. VU meter

Some more information:
  • [auto] button - if enabled (green light is on), the music will automatically be faded out/in when Press to talk button is pressed.
  • [V][S]
    • S = Speed, is actually exactly the same as tempo. Tempo changes the speed of the audio without effecting the audio. This is the only mode that will work with VoiceFX since unlike songs, VoiceFX data is in real-time.
    • V = Volume
  • In "Soundcard" mode, the volume control changes the actual volume of the PLAYBACK line. i.e. it changes the volume as you will hear it over your soundcard. To demonstrate this, open up your mixer control on the playback controls interface, and change the volume in SAM. Notice how the volume changes in the mixer control.
  • In "Record to pipeline" modes, this controls the volume of the VoiceFX channel. This has no effect on the actual recording control line's volume.

Configuration:
Recording Modes: These are best viewed under Config->Audio mixer pipeline.

1) None: When talk button is pressed, SAM will simply automatically fade out the music. (If auto fade is enabled). No other action is taken.


2) Mixer (Record to pipeline): Audio data is recorded from the soundcard, and fed as input audio to the voiceFx channel. This mode allows you to perform audio processing on the audio, exactly like for example Deck A.
This also means that you will be able to hear yourself speak - if your latency in both the output and recorder is low enough, the "echo" should be tolerable/instant.
Otherwise, see mode 4 below.

3)SoundCard: SAM will play back the audio over the soundcard. Although this has the "echo" effect as well, the "echo" is instant. This mode is usually used in conjunctions with the "red" button on the encoders. That way you always encode exactly what you hear.

4) Encoders: Exactly like mode 2, except that the audio is only mixed into the audio right before the encoders. This means that this mode skips the main Mixer and Output - which of course means that it totally bypasses the mixer EQ, AGC and DSP plugins and also the Output - thus no echo.

Things to keep in mind:
  • VU meters are only available for modes 2 and 4
  • In modes 2 and 4 you can specify the latency of the recorder. If you hear skipping in your voice, you might need to increase the latency of both your output and recorder. Also, in these modes the [Mixer] button allows you to quickly jump to your soundcard audio mixer recording setup - which needs to be configured properly before using VoiceFX.
  • In mode 3, SAM can automatically "mute" or "unmute" the correct output volume control on your mixer. On some cheaper soundcards this might cause ALL the output controls to be muted. Automated "mute" should be disabled on these kinds of soundcards.
  • Mode 4 is only available in SAM Broadcaster.
Notes on AGC use with VoiceFX: The AGC can have a huge influence on how good your VoiceFX sounds. This will be discussed more on the AGC configuration itself.


The Microphone volume slider adjusts the volume of the microphone.
IMPORTANT: This slider does not change the actual volume of the microphone in your sound mixer/soundcard. Make sure you set your microphone volume of your soundcard to the desired level before using Voice FX. Also, Voice FX takes the audio input from the currently selected recording device line input. Thus, make sure you have the correct line input selected for your purposes.

The Music volume slider fades the volume of the music when the Talk button is pressed. Set it low enough so that your voice can easily be heard above the audio.
The Fade Time sliders specify how long it will take for the sound to fade when the Talk button is pressed and how long it takes for the sound to fade-in after it is released.

Using Voice FX After configuration, follow these steps to use Voice FX :
Step 1: Turn the microphone on by pressing the Microphone power button. The green LED light on the button will turn on. You will also notice that the Press to Talk and Lock talk buttons are no longer disabled.
Step 2: Press the Press to Talk button. The sound will fade. You are now ready to start talking into the microphone. You should see the VU Meter display the sound levels of the recorded sound. If not, please refer to the troubleshooting section.
external image images%5Cdot2.GIF
Note:
VU meter is not supported in all modes
Step 3: Release the Press to Talk button. Notice how the music fades back to its normal volume level.
Step 4: Turn the microphone off again by pressing the Microphone power button. The green LED light on the button should indicate it is off and the talk buttons will become disabled.
At steps two and three you can alternatively press the the Lock talk button. This will lock the Press To Talk button in the talk position until you click it again, freeing your mouse for other tasks.
external image images%5Cdot2.GIF
Note: While the Lock talk button is activated you can, at any time, press the Press to Talk button, and once you release it the button it will unlock the Lock talk button.
We recommend turning the microphone off after each talk session to a) avoid wasting the processing power of your computer, and b) to avoid accidently pressing the Talk button causing the music to fade and only static being played. This will also help you avoid the embarrassment of leaving the lock button on and saying something over the air that you did not want everybody to hear.

Shortcut keys
Shortcut
Action

[F11]
Press to talk button. Turns on Mic power if needed


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Volume
The volume window allows you to control the master output volume of both the main air output device, and the cue output device.
You can also mute the any of the two output devices. This is great for when you quickly want to silence the studio speakers while you talk over the mic, or make SAM silent while you work on something else.

Note: This does not have any effect on the volume of the encoded stream.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Sound FX
The Sound FX window allows you to instantly play various sound effects or jingles over the current broadcast.

Sound FX display
  1. Sound FX category list dropdown
  2. Previous page
  3. Current Page counter
  4. Next page
  5. Effect buttons 1 through 12
  6. Emergency stop button
  7. Volume slider
Sound FX control
The first step to complete before using Sound FX is to load the sound effect tracks. To do this, open the Playlist window and browse to: Content -> Sound FX category.
You can create your own custom categories under this parent category or simply add your effects to the already existing category called Sound FX (All)
Once done, return to the Sound FX window and click the Category dropdown to select the sound effects category you want loaded inside the window.
You should see the effect buttons 1 to 12 become active as the effects load into them.
You can instantly play an effect by pressing the appropriate button as well as pressing the button again will actively stop the FX.
Most effects are short and should play to the end, but if you for some reason instantly want to stop an effect, press the stop button.
The volume slider allows you to set the volume at which effects are played. Make sure the volume is loud enough that effects can clearly be heard above the currently playing sound.
Tip: Set Volume to +2.8dB, the highest volume value, since SoundFX generally needs to be louder than the playing audio.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Fade Control (aka DJ Control)
The Fade control is used to manually crossfade between songs and also perform professional beat matching of tracks.

Fade Control display
  1. Manual crossfade
  2. Manual fade
  3. Manual tempo adjust
  4. Smooth Beat Fade
  5. Beat Fade
Fade Control
Manual crossfade
This slider bar allows you to manually crossfade between songs by dragging the slider-tab left or right.
Firstly notice that as soon as you click on the tab a new song will be loaded into the empty deck (If one deck happens to be empty).
Dragging it left will a) Decrease the volume on the actively playing deck (Fade out) b) Start the idle deck playing c) Increase the volume of the idle deck (Fade in)
Dragging it right will a) Decrease the volume on the actively playing deck (Fade out) b) Start the idle deck playing c) Set the volume of the idle deck to full volume (NO Fade)
Finally notice that the previously active player will be ejected as soon as you release the mouse button.
Manual Fade
This fade acts more like the traditional fading found in many hardware mixers.
This fader will not load any tracks into empty decks, start playback or eject the last playing track.
Dragging the slider-tab left will cause the volume on Deck B to decrease.
Dragging the slider-tab right will cause the volume on Deck A to decrease.
The way this fade is supposed to be used is as follows:
  1. Lets assume Deck A is actively playing a track.
  2. Drag the slider all the way to the left to make the volume on Deck B silent.
  3. Load a track into Deck B and click on the play button to start playback.
  4. Finally drag the slider slowly all the way to the right. This will firstly fade-in Deck B and then finally fade out Deck A.
You can click on the center button to normalize the volume on both Decks.
Tempo adjust (Pitch control)
For beat matching SAM2 adjusts the tempo of the song instead of the actual pitch. The reason is that adjusting the tempo will not make your vocals sound like the smurfs.
To adjust the tempo for a deck, simply drag the slider - or use the buttons to increase/decrease the tempo.
You can click on the center button to normalize the tempo.
Beat matching
Note: For beat matching to work you need to set the Beats-per-minute for both tracks in the Song information editor.
Smooth beat fade
This tool is used to make the beats of two songs match by "crossfading" their beats to a central matching beat. This provides for the smoothest sounding beat matching around. For the best effect you need to combine both the Smooth beat fade with a Manual fade
Usage
  1. Load a track into the idle deck.
  2. Drag the Manual fade slider all the way to the direction required for the idle deck to be silent.
  3. Drag the Smooth beat fade slider all the way to the right...slowly. By doing it slowly your listeners will probably not even notice the tempo of the song changing.
  4. Now start playback of the idle track and drag the Manual fade slider so that the new track starts fading in and the ending track starts fading out. The two tracks should at this point have the same beat.
  5. Once the ending track reaches silence, eject this track.
  6. Start dragging the slider all the way to the left again...slowly. This will normalize the tempo of the new track.
Beat fade
Traditional beat matching method.
If the slider is in the center, both decks have normal beats.
If at the slider is dragged to the left, Deck B will slowly start matching the beat of Deck A.
If at the slider is dragged to the right, Deck A will slowly start matching the beat of Deck B.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Encoder
SAM3 contains various built-in Encoders that translate the raw PCM sound samples into an MP3 and/or Windows Media (and other formats) that can be streamed over the internet to multiple listeners.
SAM3's encoders are by far the most advanced available today. They feature the ability to encode and stream at multiple bitrates and in multiple formats!

Encoders display
  1. Dropdown menu
  2. Add new Encoder
  3. Configure selected encoder
  4. Remove selected encoder
  5. Start selected encoder
  6. Stop selected encoder
  7. The Blue button will make the encoders encode the sound directly from the SAM2 audio pipeline.
  8. The Red button will make the encoders encode the sound from the soundcard.
  9. Hide / Show scripting interface
  10. VU Meter
  11. Scripting interface (Press the button described in (9) to make it visible.)


Encoders control
The Dropdown menu gives almost the same options as the commands below.
The following are only the last few commands: (You can also right-click on an encoder to bring up a popup menu with the same commands.)
The Start all command will start ALL the encoders while the Stop all will stop all the encoders.
The Select source command allows you to select the encoders source: directly from the audio pipeline or from the soundcard. If you have multiple soundcards, this menu option will list all available recording devices: you can select the correct one.
The Add new encoder ("+") button will bring up the Encoder plugin list . Select the type of encoder to use and click on OK to configure the new encoder.
The Configure ("Tools") button will allow you to change the configuration of the selected Encoder.
The Remove button will remove the selected encoder.
The Start button will start the currently selected encoder. (Encoder will start encoding the audio data and streaming it over the internet.)
The Stop button will stop the selected encoder.
The Blue ("dot") button will use the Audio Pipeline as the direct source for the audio samples that will be encoded.
The Red ("dot") button will grab the audio data from the soundcard (whatever is being played over the soundcard will be encoded. This requires configuration of the soundcard mixer to work correctly!).
The Scripting interface button will hide or show the scripting section of the Encoders window.
external image images%5Cdot2.GIF
Note: Scripting only works in Windows Media Player. Scripting for MP3 is also supported, but requires the embedded MP3 player.
On the scripting interface the Script type command specifies what kind of script data is going to be used. Only the CAPTION type is listed here:

The CAPTION allows you to display custom text inside the Windows Media Player of your listeners. (They will need to enable captioning inside their players to make this work.) Simply enter your text inside the Script data textbox (and make sure the Script type is CAPTION of course) and then click on the Send button. The caption text you entered should display inside the listener player as soon as it reaches that section of the song. Also note that the SAM Windows Media Encoder will send the currently playing song information to the captioning area of the player automatically on each song change.

The VU Meter shows you the audio levels in decibels (dB) being encoded.

Shortcut keys
Shortcut
Action

[Ins]
Add enw encoder

[Enter]
Config selected encoder

[Del]
Remove selected encoder

[F9]
Start selected encoder

[F10]
Stop selected encoder

[Ctrl]+[F9]
Start all encoders

[F10]
Stop all encoders


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Encoder Plugins
Clicking on the Add new encoder button launches the Encoder plugin list of all available encoder plugins.
Select the plugin to use by clicking on the radio button next the the plugin name. If you focus on a plugin by clicking on it, you will be able to read more information about the plugin in the area below the list.
Once you have selected the encoder plugin to use, click on the OK button in order to bring up the configuration for that encoder.

Default installed encoder plugins

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
WMA
Windows Media Streaming technology was developed by Microsoft and provides a complete end-to-end solution for almost all streaming media needs.
SAM3 has extensive support for Windows Media technology (both decoding, encoding, and "Tagging" and scripting).
Windows Media sounds a lot better than any MP3 stream at lower bitrates. Consequently, most stations use WMA for low bitrate streams. mp3PRO streams on the other hand sound the very best.

WMA Encoder & Streamer options
Under the Profile tab
  • Choose profile - Windows Media comes with a good selection of predefined profiles to use. Select the profile that best fits your streaming needs.
  • Description - Once you click on a profile you can get an extended description in the window below.
Multi-bitrate vs Single bitrate
  • Multi-bitrate only works on Windows Media Player 9 or later and can only be streamed from Windows Media Services 9 or later.
Under the Stream options tab
  • When Auto start encoder is checked, the encoder will automatically be started after [xx] seconds of the application start.
  • Enable Use pull distribution to activate the pull method of streaming. This is where the Windows Media Server connects to your encoder plugin on the specified Port . Only Max clients can connect directly to your plugin. >
    external image images%5Cdot2.GIF
    Note: Unlike MP3 where the Encoder connects to the server, the WMA SERVER connects to the encoder.
  • Enable Push distribution to active the push streaming method. This method only works with Windows Media services running on the Windows 2003 Server / .NET server operating system. > Media server host / IP is the IP address or DNS name of the remote Windows Media Server. > Publishing point is the mountpoint or connection point on the windows media server. > Template publishing point is optional. If the publishing point needs to be created, it will be created using the same settings as available in the Template publishing point. > If Automatically destroy publishing point after disconnect is enabled, the publishing point will be removed once disconnected. > Authentication may or may not be required to connect to the media server.
  • Scripting > > Allow scripts in stream specifies whether scripting will be enabled in this encoder. > > If Allow automatic captioning is checked, the encoder will automatically send information to the captioning area of the Windows Media Player, allowing the listeners to instantly see the latest song information. The edit box just below that allows you to specify how this information will look inside the player. > Valid tags are: > $artist$, $title$, $album$, $duration$, $mmss$, $albumyear$, $genre$, $buycd$, $website$, $comment$, $filename$ > Replacing $ with # will URL encode the tag. > > If Allow automatic data streaming is checked, the encoder will automatically send extended information of the currently playing song to the Windows Media Player. This allows things like the AR Choice player to show the currently playing album cover, artist, title and album information the instant the song changes. Once again, the edit box just below that allows you to specify exactly what data gets sent over the stream. > Valid tags are: > $artist$, $title$, $album$, $duration$, $mmss$, $albumyear$, $genre$, $buycd$, $website$, $comment$, $filename$ > Replacing $ with # will URL encode the tag. > Buffer window specifies the time it can take for the script event to buffer. > Bandwidth is the total amount of bandwidth to reserve for the sending of the script data.
Under the Stream archive tab
You can also save the data being encoded to a file. That way, you can have an archive of live audio streams and even offer these archives via on-demand streaming later on.
Warning: Archive files can become quite big if you stream for long sessions. Make sure you have more than enough disk space before you start encoding sessions.

Stream archive options
  • Check the Save stream to file checkbox to make the rest of the options visible.
  • Filename is the filename to which the stream will be saved.
  • File split options > - New file for each session will append a date and incremental number to the Filename so that the filename is unique for each encoding session. > - Overwrite file for each session uses the exact filename as specified, which means that the last archive will be overwritten each time a new encoding session is started!

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Legacy MP3 (CODEC)
The MP3 (Codec) plugin uses an installed MP3 ACM CODEC to compress the audio into an MP3 stream that can be broadcast over the internet.
external image images%5Cdot2.GIF
Note: SAM3 is distributed with the Windows Media Format redistributable file that installs an MP3 Codec on your system. There are many other MP3 codecs available for download or purchase.

external image images%5Cdot2.GIF
Important:
Some codecs cause serious problems due to incorrect or incompatible implementations.
  1. If you have a Creative Soundcard installed please read this article .
  2. If you want to run multiple CODEC streams please read this article.
  3. If you are using Windows XP please read this article .
Under the Converter tab
Converter options
  • Click on the Choose format button launch a list of all supported MP3 formats for the currently installed ACM CODEC. > Select one from the list and click on OK. The details of the format will be displayed just below the Choose format button.
General options
  • If Auto start encoder is checked, the encoder will automatically be started after [xx] seconds of the application start.
  • If Auto reconnect is checked, the encoder will automatically try to reconnect to the streaming server if it gets disconnected. (After waiting the specified [xx] seconds .)
  • Allow scripts in stream specifies whether scripting should be enabled for this encoder.
Scripting
  • Allow automatic data streaming will embed song information directly into the MP3 stream. > The edit box below allows you to specify exactly what data is being inserted into the stream. >
    external image images%5Cdot2.GIF
    Note: This option is only for advanced users and future technology implementation support. Please note that with most current MP3 players the audio might contain a blip or pop at the exact point where the data streaming is inserted, so we do not recommend enabling data streaming if you are not using it for any specific purpose.
Under the Server details tab you will find the streaming server options discussed here.
Under the Stream archive tab you will find the Stream Archiving options.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
MP3 and mp3PRO
The MP3 and mp3PRO plugin uses a fully licensed mp3PRO encoder bundled with SAM3 to compress the audio into an MP3 stream that can be broadcast over the internet.
mp3PRO uses SBR technology to reduce the size of the stream even more! Requires a special mp3PRO decoder to hear the enhanced audio. Read more about the mp3PRO technology .

Under the Converter tab
Output format settings
  • Quality > Fast - Uses less CPU with a slight decrease in quality. > Medium - Good average between CPU & Quality > High - Produces the best quality output, but uses slightly more CPU
  • Format > IMPORTANT: You can select both plain MP3 and mp3PRO formats from this SAME format dropdown box. > Plain MP3 formats are listed first and mp3PRO formats are listed last. > > MP3 Plain stereo modes > > Mono - Single mono channel > > Dual Mono - In this mode, both channels are independently coded; no profit is taken of a potentially existing correlation between both channels. This mode is best suited for signals where the channels are independent (e.g. a bilingual source: English left, French right). > > Stereo - This mode is similar to the dual channel mode in that still no profit is taken from correlation between channels; the encoder may, however, take bits from a channel that is easy to encode to use them for a hard-to-encode channel. > > > mp3PRO stereo modes > > Mono - Single mono channel > > Dual Mono - In this mode, both channels are independently coded; no profit is taken of a potentially existing correlation between both channels. This mode is best suited for signals where the channels are independent (e.g. a bilingual source: English left, French right). > > Stereo - This mode is similar to the dual channel mode in that still no profit is taken from correlation between channels; the encoder may, however, take bits from a channel that is easy to encode to use them for a hard-to-encode channel. > > LC Stereo - The mp3PRO format adds the so called Low-Complexity Stereo technique to the plain mp3 format: mono mp3 bitstreams can be enhanced not only by applying the usual PRO enhancement for higher audio bandwidth, making a monoaural mp3PRO bitstream, but also by LC stereo to make it a stereo channel mp3PRO bitstream. This feature is designed to allow stereo coding even at extremely low bitrates. A plain mp3 decoder however would play LC stereo enhanced mp3PRO bitstreams as mono.
General options
  • If Auto start encoder is checked, the encoder will automatically be started after [xx] seconds of the application start.
  • If Auto reconnect is checked, the encoder will automatically try to reconnect to the streaming server if it gets disconnected. (After waiting the specified [xx] seconds.)
  • Allow scripts in stream specifies whether scripting should be enabled for this encoder.
Scripting
  • Allow automatic data streaming will embed song information directly into the MP3 stream. > The edit box below allows you to specify exactly what data is being inserted into the stream. >
    external image images%5Cdot2.GIF
    Note: This option is only for advanced users and future technology implementation support. Please note that with most current MP3 players the audio might contain a blip or pop at the exact point where the data streaming is inserted, so we do not recommend enabling data streaming if you are not using it for any specific purpose.
Under the Server details tab you will find the streaming server options discussed here .
Under the Stream archive tab you will find the Stream Archiving options .

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Ogg / Vorbis
  • The Ogg tag handler can now fully read AND write Ogg tags. >
The Ogg (Vorbis) plugin uses the open source Ogg CODEC to compress the audio into an Ogg stream that can be broadcast over the internet. SAM3 introduces Ogg streaming (playback) support, with title streaming. The Ogg tag handler can now fully read AND write Ogg tags. >
Under the Converter tab
Converter options

    • Channels - Mono or Stereo
    • SampleRate - The audio frequency
    • Quality management mode > >> Drag the slider to adjust the quality of the audio. Please note that the average bitrate is only an estimation and is rarely very accurate.
    • Bitrate management mode (Not recommended) > >> Allows you to set exact bitrate requirements for your stream. > >> ABR - Average Bitrate mode > >> CBR - Constant Bitrate mode
General options

    • If Auto start encoder is checked, the encoder will automatically be started after [xx] seconds of the application start.
    • If Auto reconnect is checked, the encoder will automatically try to reconnect to the streaming server if it gets disconnected. (After waiting the specified [xx] seconds .)
Under the Server details tab you will find the streaming server options discussed here. > (Only the IceCast2 server is available)
Under the Stream archive tab you will find the Stream Archiving options.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Stream Archive options
The Encoder allows saving the stream to a file. There are many reasons why you might want to save the stream:
  • So that you can have an archive of live shows.
  • So that you can make the files available later via on-demand streaming.
  • Or so that you can let listeners download the shows.
Check the Save stream to file checkbox to make the rest of the options visible.
Filename is the path and filename to use as the name for the archive file.
File split options
  • New file for each session - New file for each session will append a date and incremental number to the Filename so that the filename is unique for each encoding session.
  • Overwrite file for each session uses the exact filename as specified, which means that the last archive will be overwritten each time a new encoding session is started!
  • Resume with same file for each session will append the stream data to the current file. That way you only get one BIG archive file.
  • New file every [xx] minutes will archive to a new filename every [xx] minutes, splitting the archive into equal segments.
  • New file every [xx] MB will create a new archive file after the current file reaches [xx] MB (megabyte).
external image images%5Cdot2.GIF
Note: Archive files can eventually take up a lot of disk space - so make sure you have enough space on your hard disk for the next encoding session before you start the encoder!

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Legacy MP3 CODEC vs MP3/mp3PRO version
Advantages of CODEC version
  • Sounds better at lower bitrates (< 64kbs) than plain mp3PRO encoder doing plain MP3 > (mp3PRO streams sounds the very best at lower bitrates!)
  • You can install the best CODEC MP3 encoder you like
Advantages of MP3/mp3PRO version
  • Can run multiple encoding streams.
  • Sounds great at higher bitrates. mp3PRO sounds the BEST of all formats at anything below 64kbps.
  • A lot more options for stereo/mono/LC stereo encoding.
But why choose when you can mix & match?
Remember, you don't have to choose between the two. You can run a normal MP3 stream and then also a mp3PRO stream...

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
MP3 Streaming Servers
Streaming servers will deliver the encoded (compressed) MP3 stream to the listeners.
Select the Server type to bring up the options for that specific server.

The following servers are currently supported:
Note: We highly recommend AudioRealm stream hosting for all your stream hosting needs.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
SHOUTcast
ShoutCast is an popular MP3 streaming server developed by the makers of Winamp.

Server details
  • Server IP - is the IP address or DNS name of the machine where the server is located.
  • Server Port - The port as specified in your Shoutcast server configuration (usually 8000).
  • Password - The encoder password as specified inside your Shoutcast server configuration file.
Station details
These are the details that will be visible to your users and that will show up on Shoutcast.com
  • Station name- Your station name followed by a short description of your station.
  • Genre - the genre of music that you play. If you want to enter more than 1 genre, simply type them into the genre field and separate them via a comma.Example: Rock, Alternative, Various
  • Website URL - The URL to your website.
  • AIM - your AOL Instant Messenger username/handle.
  • ICQ number
  • IRC channel of your website (not really used anymore).
  • If the List on public station listing is checked your station will be listed on Shoutcast.com and visitors will be able to tune into your stream.
  • If Enable title streaming is checked the information of the song will be sent to the server so that the information can be displayed on the listeners' player. > The format of the title is specified just below in the edit box using template tags. > Valid tags are: > $artist$, $title$, $album$, $duration$, $mmss$, $albumyear$, $genre$, $buycd$, $website$, $comment$, $filename$

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Live365
Live365 offers low cost stream hosting for small to medium broadcasters. VisitLive365's website for more details.

Live365 member details
  • Username - Your Live365 account username.
  • Password - Your Live365 account password.
Station details
  • Station name- Your station name followed by a short description of your station.
  • Genre - the genre of music that you play. If you want to enter more than 1 genre, simply type them into the genre field and seperate them via a comma. Example: Rock, Alternative, Various
  • Website URL - The URL to your website.
  • If the List on public station listing is checked your station will be viewable to the public.
  • Post song data directly to Live365 will update your song information directly to the Live365 servers. (This is the recommended method.)
  • User normal title streaming will use normal Shoutcast style title streaming.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, Lseparate 04
||


external image images%5CHeader.jpg
Icecast (v.1 & v.2)
Icecast is an open source MP3 server. You can read more about Icecast on the Icecast website.

Icecast server options
First, select the server version.
Icecast 1 Server details
  • Server IP - is the IP address or DNS name of the machine where the server is located.
  • Server Port - The port as specified in your Icecast server configuration (usually 8000).
  • Password - The encoder password as specified inside your Icecast server configuration file. (Please note that you must use the Encoder password since Icecast has different passwords for the Administrator, Encoder and Operator. )
  • Mount - The alias name of your stream. Icecast has the ability to serve multiple streams from different encoder sources from the same port. The Mount field is used to enable listeners to connect to the correct stream.
  • Dump stream to file - If you enter a filename into this box the stream will be archived to file on server side. >
    external image images%5Cdot2.GIF
    Note: You can also archive the stream on encoder side via the Archive options.
Icecast 2 Server details
All options for Icecast2 are exactly the same as for Icecast1, with the only exception being the Dump stream to file option which is not supported on Icecast2. If you enter a filename into this box the stream will be archived to file on server side.

Station details
  • Station name - Your station name.
  • Station description - Short description of your station.
  • Genre - the genre of music that you play. If you want to enter more than 1 genre, simply type them into the genre field and separate them via a comma.Example: Rock, Alternative, Various
  • Website URL - The URL to your website.
  • If the List on public station listing is checked your station will be listen on Icecast.org and visitors will be able to tune into your stream.
  • If Enable title streaming is checked the Artist - Title information of the song will be sent to the server so that the information can be displayed on the listeners' player.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Static Relays
The Statistic relays window provides a quick overview of the status of all inserted streaming servers and an interface to add, modify or remove streaming servers/relays.
external image images%5Cdot2.GIF
Note: In this section, a relay server and a streaming server are exactly the same and used interchangeably.

Statistic relays display
  1. Dropdown menu
  2. Add new relay
  3. Configure currently selected relay
  4. Delete selected relay
  5. Force update
  6. View in graph, color-code
  7. Relay number
  8. Current viewers/Max viewers
  9. Peak viewers since SAM started
  10. File format
  11. Streaming bitrate
  12. Server type
  13. Status
  14. Details
Statistic relays control
The Dropdown menu provides the same options available from the rest of the toolbar buttons.
The Plus ("+") button will add a new relay. Pressing the button will launch the relay plugin selection window, and you can follow the process as described here .
The Configure button will present the details of the currently selected relay.
The Minus ("-") button will delete the selected relay from the list.
The Force update button will force all relays to update their status. Note: The update might not be instant and can take a few seconds to complete (especially if you have a lot of relays).
The Checkbox specifies if the relay will be shown inside the Statistic relays graph.

Shortcut keys
Shortcut
Action

[Ins]
New relay

[Del]
Delete relay

[Enter] or double-click
Configure selected relay

[F10]
Force update


||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Relay Plugins
Relay plugins are used to retrieve statistical information from a streaming server.

The following plugins are installed by default

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Windows Media (WMA) Relay
Currently, SAM3 can not grab statistics directly from a Windows Media server. But, with the use of MediaPoint Manager, SAM3 can report current viewer statistics.
external image images%5Cdot2.GIF
Note: If your stream hosting provider does not support MPM (MediaPoint Manager), please contact us and we will talk to them about MPM-enabling your stream. A mini-MPM version of MPM is also under development and should be available shortly.
We highly recommend AudioRealm stream hosting for all your stream hosting needs.
Feel free to contact Spacial Audio if you have any questions concerning Windows Media streaming or MediaPoint Manager.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||



external image images%5CHeader.jpg
MediaPoint Manager Relay
MediaPoint Mananger (or MPM for short) is a reporting tool written by Spacial Audio that runs on a Windows Media streaming server and is able to report statistics directly to SAM3 about your Windows Media streams.
You can read more about MediaPoint Manager on the MPM website .
Many stream host providers already have MPM support. Please contact us if your stream hosting provider does not have MPM support.
We highly recommend AudioRealm stream hosting for all your stream hosting needs.

MediaPoint manager information
  • Host - The server MediaPoint Manager is running on.
  • MPM Port - The port the MPM Service is running on. This is usually 8008. >
    external image images%5Cdot2.GIF
    Note: This is NOT the same port as the port that your encoder uses.
Stream information
  • Username - your MPM client username.
  • Password - your MPM client password. > (Your stream host provider should have given you an username/password for MPM when you signed up.)
  • Alias - click on the dropdown to get a list of live aliases assigned to your username. Select the correct one from the list.
  • Bitrate - please enter the bitrate of your Windows Media Stream since this can currently not be automatically detected by MPM.
  • Color on graph - the color to use when drawing this relay's graph on the Statistic relays graph .
  • Private statistic relay - when checked, this relay will NOT show up on the AudioRealm.com station listing, but you will still be able to view the statistics for this relay in the local SAM3.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
SHOUTcast Relay
ShoutCAST is an MP3 streaming technology developed by AOL's Nullsoft. Its a simple, free MP3 streaming solution.
Please visit the SHOUTCast website for more information.
IMPORTANT: This page covers the setup instructions for TWO types of Shoutcast relays. Please read both cases to see which type fits your needs.

[Type 1] Shoutcast statistic relay
This relay is meant to be used with Shoutcast v1.8.9 or later. If your version of Shoutcast is older than v1.8.9 we STRONGLY suggest upgrading to the latest version of Shoutcast. If upgrading is not an option you can still use the Type 2 relay.
Shoutcast server details
  • Host is the DNS name or the IP address of the machine where the Shoutcast Server is located.
external image images%5Cdot2.GIF
Note: Do NOT use a local IP address or network address. Use the internet IP address or DNS name that can be accessed by users outside your network.

  • Port - the port as specified inside your Shoutcast server configuration file.
  • Password - the encoder password as specified inside your Shoutcast server configuration file.
  • Color on graph - the color to use when drawing this relay's graph on the Statistic relays graph .
  • Private statistic relay - when checked, this relay will NOT show up on the AudioRealm.com station listing, but you will still be able to view the statistics for this relay locally in SAM3.
[Type 2] OLD Shoutcast statistic relay
This relay is meant to be used with Shoutcast server versions OLDER than v1.8.9. If your version of Shoutcast is older than v1.8.9 we STRONGLY suggest upgrading to the latest version of Shoutcast. Only if upgrading is not an option should you use this relay type.
external image images%5Cdot2.GIF
Note: This relay type will be depreciated in the near future.

Shoutcast server details
  • Host is the DNS name or the IP address of the machine where the Shoutcast Server is located.
external image images%5Cdot2.GIF
Note: Do NOT use a local IP address or network address. Use the internet IP address or DNS name that can be accessed by users outside your network.

  • Port - the port as specified inside your Shoutcast server configuration file.
  • Color on graph - the color to use when drawing this relay's graph on the Statistic relays graph .
  • Private statistic relay - when checked, this relay will NOT show up on the AudioRealm.com station listing, but you will still be able to view the statistics for this relay in SAM3.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
LIVE365 Relay
TheLive365 statistic relay will report the current viewer count from your Live365 server.
About Live365
Live365 is a broadcast service almost as old as AudioRealm.com. It provides very cheap stream hosting for small to medium size broadcasters. Visit the Live365 website for more information.
Live365 member info
  • Username - your Live365 username.
  • Password - you Live365 password.
  • Bitrate - currently SAM3 can not automatically detect the bitrate of a Live365 server. You must manually specify the correct bitrate.
  • Color on graph - the color to use when drawing this relay's graph on the Statistic relays graph .
  • Private statistic relay - when checked, this relay will NOT show up on the AudioRealm.com station listing, but you will still be able to view the statistics for this relay locally on SAM3.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Icecast Relay
IceCast is another MP3 streaming technology based on the original Shoutcast technology. Icecast is 100% open source. Currently, there are two versions of Icecast available: Icecast1 and the latest release Icecast2.
More information about the IceCast technology can be found on the Icecast and Vorbis website. This section describes the configuration of both of these servers.
[1] Icecast statistic relays
This option should be selected if you are running an Icecast v1 server.

IceCast server details
  • Host is the DNS name or the IP address of the machine where the Icecast Server is located.
external image images%5Cdot2.GIF
Note: Do NOT use a local IP address or network address. Use the internet IP address or DNS name that can be accessed by users outside your network.

  • Port - the port as specified inside your Icecast server configuration file.
  • Password - the Admin password as specified inside your Icecast server configuration file. >
    external image images%5Cdot2.GIF
    Note: Icecast has 3 levels of passwords. In this case, you will need to use the Admin password (admin_password) in order to connect to the Icecast server.
  • Alias - the Alias your encoder will be connecting on. If your encoder is already connected, you may click on the dropdown box to show a list of already connected aliases. Select the one to point your encoder.
  • Color on graph - the color to use when drawing this relay's graph on the Statistic relays graph .
  • Private statistic relay - when checked, this relay will NOT show up on the AudioRealm.com station listing, but you will still be able to view the statistics for this relay in SAM3.
[2] Icecast2 statistic relay
This option should be selected of you are running an Icecast2 server.

IceCast2 server details
  • Host is the DNS name or the IP address of the machine where the Icecast2 Server is located.
external image images%5Cdot2.GIF
Note: Do NOT use a local IP address or network address. Use the internet IP address or DNS name that can be accessed by users outside your network.

  • Port - the port as specified inside your Icecast2 server configuration.
  • Alias - the Alias your encoder will be connecting on. If your encoder is already connected, you may click on the dropdown box to show a list of already connected aliases. Select the one to point your encoder.
  • Bitrate - Currently, the stream bitrate can not be detected automatically for Icecast2 servers. Please enter the correct bitrate manually.
  • Color on graph - the color to use when drawing this relay's graph on the Statistic relays graph
  • Private statistic relay - when checked, this relay will NOT show up on the AudioRealm.com station listing, but you will still be able to view the statistics for this relay in SAM3.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
P2P Streamer Relay
Streamer is an MP3 streaming technology that uses Peer-to-peer distribution.
Please visit the website for more information.
P2P Streamer
  • Host is the DNS name or the IP address of the machine where the Streamer is located.
external image images%5Cdot2.GIF
Note: Do NOT use a local IP address or network address. Use the internet IP address or DNS name that can be accessed by users outside your network.

  • Port - the port as specified inside your Streamer configuration.
  • Password - the encoder password as specified inside your Streamer configuration.
  • Color on graph - the color to use when drawing this relay's graph on the Statistic relays graph .
  • Private statistic relay - when checked, this relay will NOT show up on the AudioRealm.com station listing, but you will still be able to view the statistics for this relay locally in SAM3.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
VTrails Relay
VTrails is an advanced Peer-2-Peer streaming technology that shares the bandwidth of your viewers in order to reach a bigger audience without spending more on bandwidth.
Currently, support for Vtrails has been depreciated.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Static Relays Graphs
The Statistic relays graph window provides a nice graphical overview of listeners over the last hour. You can view the overall listenership plus each individual relay. (Each relay can be color-coded for easy identification.)

Statistic relays graph display
  1. The vertical axis displays the number of viewers (listeners).
  2. The horizontal axis displays the time.
  3. The navy colored line is the overall stats of all the relays combined. This line will turn red if no relays are active.
  4. Each relay is color-coded. The color can be specified within the Statistic relays window.
Statistic relays graph control
Hold down [Shift] and then hold down the left mouse button whiledragging the mouse. This will create a zoom box that allows you to zoom into a section of the graph.
Holding down [Shift] and make a single left click with the mouse to restore the view.
Holding down [Ctrl] and the left mouse button while dragging the mouse to pan the graph view.

external image images%5Cdot2.GIF
Note: You can get more graphs inside the AudioRealm member section. There is a full 24-hour graph and a daily summary graph.
external image images%5Cdot2.GIF
Note: The graph will return to the default state as soon as the graph updates.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
FTP Log
The FTP log window type displays information about current FTP uploads. Most FTP uploads are HTML output files that need to be uploaded to the station website. This window tracks the upload progress and is used to debug possible errors.
FTP log display
  1. FTP log dispays the interaction of SAM3 with the FTP server. If the FTP upload fails the cause can usually be determined by reviewing the FTP log.
  2. FTP Queue displays the list of files that must be uploaded.
  3. Clear queue button will remove all queued items from the FTP queue.
Related sections

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
PAL Scripts
Please see PAL Script Options for more information.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
PCI Max Ultra
The PCI Max Ultra window provides a control interface to your PCI Max Ultra FM broadcasting hardware. PCI Max is a range of computer cards and hardware that can turn your computer in a full terrestrial station! If you want more information about this hardware, please visit our hardware section on our website.

PCI Max Ultra display
  1. Power
  2. Stereo
  3. Power options
  4. Fm band display
  5. Frequency control
  6. Fast tune knob
PCI Max Ultra control
The Power button will activate or disable the card.
The Stereo button decides if the audio will be broadcasted in 1 (mono) or 2 (stereo) channels.
The Fast tune knob allows you to quickly switch to a frequency, while the frequency control interface gives you finer control over the tuning.
Power options
  • Turn power on at start will activate the hardware as soon as SAM3 is started.
  • Turn power off at exit will turn the hardware off as SAM3 is being closed.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Event Scheduler

Now you can schedule clockwheel format changes, PAL scripts, Encoder Start/Stop and other events more easily with a user friendly Event scheduler tool.


Event Scheduler Display
  1. Add New Event - To add a new scheduled event simply click on the big green plus sign (+) and choose the type of event you wish to add.
Schedule Event Display
1. Event Action Tab - choose which type of event you would like to run.


Types of Events include:
Load New Clockwheel - load clockwheel at set time(s)
Add Files to Queue - Add Category, Directory, files, playlists, urls to queue at scheduled time(s).
Execute PAL Script - will launch a pal script at set time(s).
Start/Stop Encoders - starts and stops encoders at set time(s)
Download Content - coming soon

2. Schedule Times Tab - Schedule the event
The next step is to schedule a time or reoccuring times to run the event.
Note: You may specify multiple times and days within an event (i.e.; Mon - Fri 8am, 9am, 10am, 11am, 12pm and Saturday 8am, 10am, 11am)

external image images%5Cdot2.GIF
Note: There is no Stop command for a CWF (Clockwheel script that is). A clockwheel wil coninue to run until another is run. So set another clockwheel to run your regular rotation 6 minutes after your re-broadcast.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Event Log
The Event log displays the last 200 important events that occured inside SAM3. Check the event log occasionally for errors, warnings and exception errors (they should stand out since they are color coded). When something unexpected happens inside SAM3, check the event log to see if it was caused by some kind of error.
Event log display
  1. Time event occured.
  2. Category will display the location or module the event occured in.
  3. Type is the event class, i.e.: > - Notice: General information > - Warning: A non fatal error > - Error: An error occured. > - Exception: A serious error occured. Exception errors should always be reported to the SAM2 bug reporting system.
  4. The Message will give you more detailed information about the event.
external image images%5Cdot2.GIF
Note: The event log is also logged to file. If SAM3 happens to crash or if you want to review the events at a later stage you can use the EventLog.log log file located in the SAM3 directory and view the events.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Clock
The current time is very important to a professional DJ, especially if you are a radio DJ.
The clock allows you with a big analog clock display, as well as a digital clock display - so you can always know the exact time without having to look anywhere else.
The pie chart also quickly shows you in which quarter of the hour the current time is.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Layout
New closes all current windows and creates an empty layout plan. Use this if you want to create a new layout from scratch.
Load> - Load default loads the last layout used when SAM3 exited. - Load loads a layout from a file.
Save - Save as default saves the current layout as the default layout. - Save allows you to save the current layout to a specified file.
Note: SAM3 comes with various example layouts designed to work best with various screen sizes. Load these layouts by simply selecting one of these menu options in the preferred screen size.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Tools
Various helper tools built into SAM3.

  • Reports - SAM3 Report generator
  • Maintenance
    1. Reset weight balance - Run this each time after you added songs to your library if you use weighted rotation, otherwise newer songs might play very often since they have a very low balance.
    2. Verify songs scans through all the songs in the media library database and then deletes all entries where the physical file no longer exists.
    3. Clear history will completely empty the history table. Most broadcasters need this data for reporting purposes (Used for royalties or station statistics). So be very careful with this command. We recommend doing a backup of your data before you run this command.
  • Mass tagger - Load or Save all the tags for your songs with a single button click.
  • Backup*
    1. Backup - backup the complete SAM3 database.
    2. Restore - restores the complete SAM3 database.
*Note: Backup/Restore is not available for all supported database types. Currently only FireBird and MySQL is supported.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg
Help
Help options
  • Help - Will open this document.
  • HTML output reference - The HTML Output tag reference/guide.
  • PAL scripting reference - The PAL (Playlist Automation Language) scripting reference/guide.
  • Visit website - opens the SpacialAudio website inside the default browser
  • About - Shows the About window.


external image images%5Cdot2.GIF
Note: Please visit the Spacial Audio Support page if you require additional help.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Toolbars

The toolbar is located just under the Menu and allows quick access to certain functions of SAM3. The buttons on the toolbar are (from left to right):
  1. Play - Start playing a song in the first empty deck if all decks are empty, or if a deck is paused start playing the deck. If a deck is already playing the Play button will restart the song.
  2. Pause - This button will pause the first currently playing deck it finds. If both decks are playing you will need to press this button twice to pause both decks. Pressing pause again will start play again.
  3. Stop will stop any currently playing deck. (Will stop both decks if both are playing.)
  4. Next - This button will load the next song into a deck (if needed) and start play. > Tip: Try holding down [Shift] while you click on this button.
  5. Mute - Mute button will silence the audio over the speakers, but do not effect the audio going through the audio pipeline. > In other words the encoders will still properly encode the audio and your listeners will still hear audio.
  6. The Virtual DJ has 3 operating modes. Auto DJ, Play queue, Manual DJ. Clicking on the button will switch the Virtual DJ mode between Auto DJ and Manual mode. Clicking on the dropdown arrow of the button will bring up a dropdown menu which will allow you to switch to a specified virtual DJ mode. It also allows you to turn Auto recovery off or on .
  7. Next are the three Desktop buttons. Clicking on these buttons will instantly load a brand new set of windows inside the SAM3 Desktop . This handy feature allows many windows to be open without cluttering up your working space.
  8. The Config button will bring up the Configuration screen.
  9. The Hide button will minimize SAM3 to the tray icon area (the area located to the bottom right of your screen). You can either Double-click on the SAM3 icon in the tray to show SAM again, or Right-click on the icon to bring up a popup menu.
  10. Next is the ? button. This button brings up this help documentation.
  11. The mini-clock displays the current system time.
  12. Finally you will find the Viewer statistic panel. It reports in real-time how many viewers are connected to your station and your highest/peak count since SAM3 started.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Audio settings

The Audio settings dialog allows you to quickly adjust the settings of all audio channels and output devices from a single location.
There are two ways to bring up the Audio settings dialog.
The first method is to click on any of the buttons in the Audio mixer pipeline
The second method is to click on the [EQ] button on any of the players, SoundFX or VoiceFX windows.
external image images%5Cdot2.GIF
Note: When invoked from the players, you can actually adjust the audio settings and STILL control the players and user interface as well. So this is a great way to adjust the settings while still having control over SAM. When invoked from the Audio mixer pipeline, the dialog and showed as "modal" and you must click on the OK button before you can access anything on SAM again.

The Audio settings dialog allows you to configure the audio settings for Deck A, Deck B, Aux players 1, 2 and 3, Sound FX, Voice FX, the final mixer channel and the selected output devices. Note: Aux player 3 is a hidden player, mostly used in the Song information editor.

Audio settings

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Equalizer

An Equalizer allows you to adjust the volume level for different frequency bands, giving you fine control over the final sound output. This allows you to emphasize bass, trebble or vocals.
SAM3 contains a 10-band equalizer for each audio channel, as well as the final mixer channel.
You can Load predetermined EQ settings, or save your own custom EQ settings.
The EQ settings will only be used on the audio channel if the Enabled button is checked.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

AGC - Active Gain Control

SAM3 introduces a professional sound processor that can make your broadcast sound like any professional commercial station - just without the cost!

The AGC (as we collectively call all the sound processors) includes:
- Gated AGC (Gated Average Gain Control)
- Stereo expander
- Bass EQ
- 5 Band processor (Which includes Limiter, Compressor and Expander)
- Dual band processor
- Clipper


Traditionally, you had to pay thousands of dollars for sound processor hardware - but with SAM3 no more! All this is included right into the default SAM3 install at no additional cost.

Sound processing can make your station stand out above the crowd - if used correctly! Incorrectly using sound processing can harm your station just as much...

In this chapter our goal is to help you use the AGC processors to get the best sound for your station.

Lets start by briefly discussing each process:

1. Gated AGC
The Gated AGC is used to "roughly" normalize the volume level so that the audio has an approximated constant volume level. The Gated AGC should be used together with the 5-band or 2-band processor because the Gated AGC on its own aims to simply provide a better input audio stream to these more fine tuned n-band sound processors.

2. Stereo expander
The stereo expander can give more "dimension" to the audio, and can especially make voice sound better. Great for use with VoiceFX module.

3. Bass EQ
The Bass EQ is used to emphasize the bass sounds & beats.

4. 5-band processor
The 5-band processor splits the audio into 5 frequencies, applying a compressor, limiter and expander to each band.

5. Dual-band processor
The 2-band processor splits the audio into 2 frequencies, applying a compressor, limiter and expander to each band.

6. Clipper
The clipper ensures that the audio volume level does not exceed the maximum. Unlike "hard" clippers, this clipper ensures a smooth clip making sure we retain the very best audio quality.

Correctly using the AGC
SAM3 has a very advanced multi-channel audio pipeline which allows you to configure it to your exact needs. In order to process the sound of your station properly you need to understand where in the audio pipeline to active the AGC, and how this decision effects the overall sound of your station.

You basically have 3 options:
1. Enable the AGC on the final mixed audio only
2. Enable the AGC on each player/audio channel, but not on the final mixer.
3. Enable the AGC on each player/audio channel - as well as the final mixer.

1. Enable the AGC on the final mixed audio only
PROS:
- Uses less CPU, since the audio processing only happens at a single point.
- Easy to config

CONS:
- The same audio processing is applied to all channels.
- Any audio processing will NOT be heard over the Cue output channel, only the final "Air" output channel.
- Likely to mess up the fading & crossfading of tracks, since even the fade will be normalized.
- Likely to mess up the fade-out/fade-in of the voiceFX module especially when the destination of VoiceFX is set to the mixer. NOTE: Some people actually like this though, since it has the "cool" effect where the volume level of the music stays constant, but as soon as you start talking the music level drops instantly so your voice can be heard clearly.

2. Enable the AGC on each player/audio channel, but not on the final mixer.
(This is the recommended setup)
PROS:
- Have exact fine control over you each audio channel should sound. We recommend setting DeckA, DeckB, Aux1, Aux2 and Aux3 to ALL have the exact same configuration.
SoundFX and VoiceFX though generally needs a more fine-tuned configuration. SoundFX is usually louder, while voiceFX generally deals with vocals that require a very specific configuration. In fact, each DJ of the station will probably need his own custom preset.
- Does not effect the fade-in/fade-out of songs. In fact, since the volume is normalized before the fade is applied, even songs with an pre-existing fade follow the configured fade curve more closely - resulting in much better sounding fades.
- Does not effect the Fade-out/in of the VoiceFX module.
- The audio processing is also audible inside the Cue output.

CONS:
- During the crossfade, or with multiple tracks playing the audio processing can use a LOT of CPU. If you have a 2GHz or faster machine you should not experience any problems.
- Even if each channel is optimized, after all of them are mixed together. the sound will most likely not be "as" optimized. This really only applies during crossfading, since in most cases only a single audio channel will be active at any time - making this negative hardly worth mentioning.

3. Enable the AGC on each player/audio channel - as well as the final mixer.
The way to use this method is to apply some basic audio processing on each channel, but to do the final major processing on the mixer. For example, enable only the AGC on each channel to make sure the audio volume level for each channel is properly boosted to a uniform volume level - and then only to the finer processing on the mixer after all the channels have been mixed into one.

Configuration
Please refer to SoundSolution.pdf
There are minor changes in our version of the SoundSolution, so look out for those.

external image images%5Cdot2.GIF
Note: Beware of "over processing" the audio.
Turning on the AGC on each channel, and on the final mixer will probably sound worse - losing a lot of detail in the audio. Also, beware of using external DSP audio processing plug ins in conjunction with the built-in AGC. This might also cause a loss in audio detail.
Additional resources:
http://www.soundsolution.it/downloads/SoundSolution.pdf
http://www.soundsolution.it/content/view/19/35/
http://www.soundsolution.it/content/view/20/36/
http://www.soundsolution.it/content/view/24/38/

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

DSP

DSP is short for Digital Sound Processing. DSP plugins can modify the audio and common DSP plugins are limiters, plugins that add reverb and volume normalization plugins to name just a few.
SAM3 has full support for Winamp DSP plugins and makes it easy to use DSP plugins inside SAM3.
external image images%5Cdot2.GIF
Note:Before we continue, we highly recommend you read this .

On the DSP window display will be a list of available DSP plugins. SAM3 will automatically search both the ./SAM/plugins directory, as well as the ./Winamp/plugins directory for DSP plugins.

To enable a DSP plugin, simply click the checkbox next to the DSP plugin.
To configure a DSP plugin, make sure that it is selected and then click on the Configure plugin button.
The Refresh list button allows you to reload the list of available plugins without having to restart SAM. (i.e. if you installed a DSP plugin while SAM3 is running, you will need to click on the Refresh list button in order to make the new DSP plugin show up in the list of available DSP plugins)

DSP plugins process the audio pasing through the audio channel in the order they are listed in the window. You may change the order of the plugins with the green up/down arrows on the right.

Important note: Not ALL DSP plugins will work correctly inside SAM. Please read this to help you avoid any possible issues.

Where to find more DSP plugins?
The best place to find DSP plugins are from the Winamp website

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Output

Correct output settings is vital to good SAM performance. SAM features a low-latency audio engine that can handle latencies of as low as 15ms. This however will not work without problems on slow machines or sub-standard soundcards. If you experience skips or blips in the audio, you might need to set the output to have a higher latency. Even slow computers should be able to perform well with a latency of 100ms. A setting of around 25ms is recommended for fast computers with a good soundcard.

Air output settings
Configure the main output device.
  • Output driver - Specify which device driver to use for the audio output. > a) Silent output: This output driver requires no soundcard. Thus it is ideal for use on a machine which does not contain any soundcards, or if you never wish to listen to the audio of your station directly. > b) DirectSound output: Uses the standard DirectX drivers for audio output. This driver is compatible with most machines and performs vary well in most conditions. > c) Kernel Streaming Output: This driver is a very advanced driver that totally bypasses the Windows audio layer by talking directly with the soundcard. This results in superior audio quality (the Windows mixer is known for not mixing audio perfectly) and much lower reliable latency. > This mode however might not work on all soundcards.
  • Output device - If you have multiple soundcards you should see multiple devices listed. Select the physical audio device to use for the main output.
Cue output settings
The cue output is used to preview tracks or work on tracks on a seperate output device. This allows you to cue up music and peview music, before actually playing it over the main output device.
There are different cue output modes:
  • Disable cue output - No cue output mode is specified and thus there will be no cue output device or active cue channel.
  • Right channel - the main Air output audio will be played over the left speaker, and the Cue output audio will be played over the right speaker. (Note: This means that both channels will be converted to Mono)
  • Rear channels - the main Air output audio will be played over the front speakers, and the Cue output over the rear speakers. > Note: This requires a soundcard that supports at least 5.1 output. This mode might not work with the DirectSound driver on some machines, but should work fine with the Kernel Streaming driver.
  • Seperate sound device (Recommended) > Using a second soundcard for the Cue output is the very best way to preview tracks. These days all motherboards already contain a good on-board soundcard. So if you purchase a professional soundcard for your main air output, you automatically have a soundcard to use for your cue output! > > Cue output driver - the output device driver to use. See Air output for detailed explanation. > Cue device specifies the soundcard to use for the Cue output.
Buffer settings
  • Packets specifies the number of audio buffers the output driver can cache to ensure uninterrupted audio.
  • Packet time specifies the duration of audio data each audio packet (buffer) can hold.
  • Maximum latency is the total latency you can expect in the audio pipeline. A low latency is desired, but setting the latency too low on some systems can result in audio problems.
Force mono output - when selected, all stereo output will be downmixed into mono output. This is useful for playing audio in a huge location where stereo audio would cause the audio waves to interfere with each other due to the speed the audio travels, or locations where stereo output is simply not viable.

Once you have made the desired changes, you can click on the Apply button to immediately use the new audio settings. You might hear a short skip/blip in the audio as the driver is reloaded.

Troubleshooting
If you experience skips, blips or other audio anomalies there are a few things you can do to help rectify the problems.
Firstly, make sure you have a good quality soundcard and have upgraded the soundcard driver to the very latest one. Many problems have been solved by simply upgrading the soundcard driver.
The second thing you can try is to upgrade to the latest version of DirectX. DirectX v9 was the latest version at the time of the writing of this help manual. Make sure you upgrade to DirectX v9 or later for best possible performance.
If all else fails, it might be that you either have a sub-standard soundcard, or your audio latancy is set too low. Try increasing the latency to 100ms or even 200ms. If you still hear audio problems at 200ms latency, then it might be time to invest in a better soundcard.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

SAM3 Configuration

The SAM configuration section allows you to customize SAM to your specific needs. You should read through each section at least once to familiarize yourself with SAM's setup options.

Configuration sections

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Member Details

In this section, supply your AudioRealm member details. This allows you to use many of the free services AudioRealm offers, such as: - Listing your station on the AudioRealm station list and partner sites - Getting free content (Music, interviews, news, etc.) - Making revenue (advertising, promotions, etc.) - and much more!
So if you are not an AudioRealm member yet - click here to sign up now!

AudioRealm Member login details
  • Username - Your AudioRealm member username
  • Password - Your AudioRealm member password
Related sections
  • Station details > You must have valid AudioRealm member login in order to complete the station details section.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Station Details

In this section, supply the details specific to your station.
Before you can complete the section, you must make sure that you have done three things:
  1. Supplied the correct information inside the Member details section.
  2. Connected to the internet.
  3. Created a station inside your AudioRealm member account.
How to create a station inside your AudioRealm member account
  1. Go to the AudioRealm member section (http://www.audiorealm.com/members/ )
  2. Log in
  3. Click on Admin Stations
  4. Click on Create a new station
  5. Now enter the short version of your station name. This name can only be 10 characters long. Read the instructions on the website for more information. After you entering your name click on the Continue >> button to move to the next page.
  6. If no error was found with your station name, your station will be created. You are now ready to complete the station information inside SAM.
Station details Only the Short name and Name fields are required . We recommend completing all the fields.
  • Short name - This is the short name of the station as created in step five above. Click on the dropdown arrow and wait a second or two for SAM3 to query the AudioRealm database for all registered stations. Once it completes, it will show you a list of stations that you have registered - choose the correct one. > Note: If you get an error message, double-check your Member details to make sure they are correct. Also, make sure you are connected to the internet.
  • Name - Full name of your station.
  • Description - of your station. Short and to the point descriptions are the most effective.
  • Website - the website address of your station. > Important: Make sure to include http: in front of your website address!
  • Genre 1 - The main genre describing the station.
  • Genre 2 - Secondary genre describing the station.
  • Genre 3 - Inside genre 3 you can manually enter genre information (Up to 15 characters) or select one from the dropdown list.
  • Email - Your station contact email address. > Important: This information will be publically displayed. Leave this field empty if you do not wish the general public to view your email address.
  • AIM - Your AOL Instant Messenger username. > Important: This information will be publically displayed. Leave this field empty if you do not wish the general public to view your AIM details.
  • ICQ # - Your ICQ number. > Important: This information will be publically displayed. Leave this field empty if you do not wish the general public to view your ICQ number.
  • Show details on AudioRealm.com - If checked, your station will be shown on the AudioRealm station list, but only// if you have at least one active relay. (There is no sense showing a station into which no listener can connect.) By checking this option, you give express permission to AudioRealm.com to list your station on partner sites and players for even more exposure.
external image images%5Cdot2.GIF
Note: Please refer to the troubleshooting section if you are having trouble getting listed on AudioRealm.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Statistic Relays

This section describes how to configure relays.

Click on the Plus ("+") button to add a new relay. This will bring up the Relay plugin select interface. Detailed information on each type of plugin can be found here .
Click on the Configure button to change the details of the currently selected relay.
Click on the Minus ("-") button to remove the currently selected relay.

Note: Relays must be configured in order to be listed on AudioRealm.com. You must configure a relay for each server streaming your content.
Related sections

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Audio mixer pipeline

The Audio Mixer Pipeline section allows control over the
Read->Decode->EQ->AGC->DSP->Mix=>[EQ]->[AGC]->[DSP]->[Output]->Encode process for EACH audio player (Referred to as an audio channel).
Control over each channel of audio allows for flexible audio processing. For example, a vocoder DSP plugin on the Voice FX player channel can make your voice sound like a robot. And, since it will only effect the Voice FX player, the other audio channels will sound normal. Additionally, the option to run compressor/limiters on Deck A & B players before crossfading happens. In that way, the DSP processing will not interfere with the crossfade effect.
Take a close look at the audio pipeline and take a moment to understand how all the audio channels are finally mixed into one audio channel which is then fed into the output.

Basic configuration
It is very important that you configure the Audio mixer pipeline to your specific needs. The following section aims to provide you with some basic information to help you set up the audio mixer pipeline.
Click on the EQ button to bring up the Equalizer. The Equalizer is used to adjust the volume level of different frequencies of the audio. This can be used to boost or reduce the volume levels of the bass, trebble and voice to have finer control over the final sound. More about the Equalizer can be found here
Clicking on the AGC button will bring up the advanced audio processors. They are explained in detail here.
The DSP button will bring up an interface that allows you to easily configure and use Winamp DSP plugins. More on that here.
Clicking on the Air out (or Cue out if visible) button will bring up the Output configuration dialog. This will allow you to select the correct audio output device, as well as adjust the latency of the audio. This is discussed in more detail here
In order to avoid skips and blips in the audio, the application must have a high priority so that the operating system gives it enough CPU time to fill all audio buffers in time. This is especially important if you have set the output to a very low latency and have a slow computer (1GHz or slower) We recommend setting the Process priority to a level of Above normalto High.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Crossfading

Having two player decks allows SAM3 to professionally crossfade between songs. Remember, you must set up the crossfade to match the format and sound of your station. A rock station should not have the same crossfade as a classical or dance station.
The SAM3 crossfader also comes with a gap killer capable of removing silence at the beginning and end of a song. This is vital for a good-sounding fade. We recommend leaving gap killer with the default settings.

The improved crossfading in SAM3 features auto-crossfade point detection, and various fade curves that can be set globally, or on a "per-track" basis.

  • Enable Fade out: Specified whether the track should contain a fade at the end of the track.
  • Enable Fade in: Specifies if the track should contain a fade at the start of track.
The following pertains to both Fade-in/out settings:
  • Curve: You can specify 3 types of fade curves
    • Default/S-curve: The S-Curve provides a nice "COS" style curve that really sounds the best in most situations. (See S-Curve below)
    • The S-Curve: Starts out slow, then accelerates quick before slowing down again. This produces a nice-sounding fade. The resulting shape of the curve looks like an S, thus the name S-Curve.
    • Exponential: This curve starts out slow, but increases exponentially to produce a very quick fade during the end of the fade.
    • Linear: The linear fade produces a constant rate of change in the volume during the fade. (Aka. the old SAM2 style fades) Sounds best in conjunction with tracks that already has a slow fade. (If you wish to force the track to fade out quicker) Sounds OK with most other tracks

  • Time: The duration of the fade > Note: This setting has no effect on the Fade-Out during auto-detected crossfades.

  • Level: Specifies the start/end volume level of the fade. A value of 100% means the fade will start/end at the minimum volume. For example, during a fade-out this means the fade will go to zero volume (i.e. -100dB). During Fade-in this means the fade will start at zero volume. Anything other than 100% means the volume level will start/end a bit higher. For fade-outs it is sometimes best no to fully fade out the track, so that the vocals can be heard during the final milliseconds of the track. Same goes for the fade in, starting at a higher volume allows the audio to be instantly audible while we continue with the fade.


Crossfade settings: There are 3 crossfade modes...
  • Disable crossfading : No crossfade. The next track will start immediately after the current track has completely finished playing.
  • Default/Auto detect: Will automatically scan the song for a certain dB level, and when the song drops below that value towards the end of the track - the crossfade will be triggered.
  • Fixed point: You can specify how many seconds before the end of the track the next track will start playing.
Fixed crossfade point (Time): Works in conjunction with Fixed Point mode above; specifies how many seconds before the end of the track the next track will start playing.


Crossfade point detection: Works in conjunction with Default/Auto detect mode above.

Trigger at [xx] dB:This specifies the dB level the automatic crossfade point detection algorithm will look for. As soon as the song drops below this level, towards the end of the track, the next song will start playing. The current song will also be faded out according to the time left till the end of the song. (See below)
Min/Max fade time: These values specify the min/max values the fade-out duration can be. For example, say the crossfade point is detected 10 seconds before the end of the track, and the maximum fade-out is only 6 seconds - then the fade will be only 6 seconds, resulting in the song being stopped 4 seconds earlier. If the crossfade point is detected 1 second before the end of the track, and the minimum fade out is 3 seconds, the following will happen. The fade out will be started 3 seconds before the end of the track, but the crossfade will actually start 1.5 seconds before the end of the track (3sec/2)
All the above settings can of course be overridden for each and every track.

[x] Do not crossfade or fade tracks [xx] seconds or less in duration . This will avoid crossfading or the fading of very short tracks like advertisements, promos and sound effects. Fading media like this usually sounds very bad. Imagine applying a 3 second fade-out to a 4 second track!

Note: Any content marked as "Allow overlay", i.e. "overlays" will not be crossfaded.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Gap killer

The Gap killer is used to remove near silence from the beginning and end of tracks. This ensures that there is no "gap" between tracks, and also helps in making cross-fades sound better.

To turn on the gap killer, make sure the Enable gap killer checkbox is selected.

  • If the Remove silence from beginning of track is checked, the gap killer will remove any sound below the Trigger level (specified in dB) from the beginning of the song, where 0dB is very loud and -100db is almost silence. The default setting of -24dB can be classified as "quiet" and is the recommended setting.
  • If the Remove silence from end of track is checked, the gap killer will remove any sound below the Trigger level from the end of the track.
  • The Detect and ignore spikes and blips will ignore scratches, blips and errors in the audio that might cause the gap killer to mistakenly allow silence because it detected sound above specified trigger levels.
  • Trigger end of song if more than [xx] seconds of silence - if either the beginning or middle of a song contains a period of "near" silence as specified in the dB values, the end of the song will be triggered if this period of silence exceeds the above specified time. Great for getting rid of "hidden tracks", but bad for songs recorded or encoded at very low volume levels, or tracks with long periods of very low volume audio. Such songs may be prematurely ended, or even be totally skipped. Note: For tracks like these it is luckily possible to disable to gap killer in the song settings for the track.

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Playlist Rotation Rules

As any professional DJ or program manager knows - you can not simply play songs randomly. Each station requires a format that makes the station unique and appeals to listeners. Also, with new laws like the DMCA, it is actually illegal to play songs in a random fashion. Luckily, SAM3's powerful technology can take full control of your playlist rotation logic and allow you to be legal while sounding professional.

Playlist rules
The following fields should be set to avoid playing the same song or artist too often. This is not only against DMCA rules, but actually makes for bad programming. Playing the same song 4 times in a row, or even 4 times in an hour can make the song become old to listeners.
  • Do not play the same album within [xx] minutes - At least [xx] minutes must pass before SAM3 will consider tracks from the same album for rotation again. >
    external image images%5Cdot2.GIF
    Note: In order for this rule to be applied effectively, you must make sure all songs in the playlist contain a valid album entry.
  • Do not play the same artist within [xx] minutes - At least [xx] minutes must pass before SAM3 will consider tracks from the same artist for rotation again. >
    external image images%5Cdot2.GIF
    Note: In order for this rule to be applied effectively, you must make sure all songs in the playlist contain a valid artist entry.
  • Do not play the same song or title within [xx] minutes - At least [xx] minutes must pass before SAM3 will consider the same song for rotation again. This includes songs with the same title, even if performed by different artists.
  • Keep [xx] songs in the queue - If you set this to 1 or more SAM3 will check the queue every 5 seconds, and if there is less than [xx] songs in the queue, SAM3 will insert another song to the bottom of the queue (Using the current playlist rotation logic).
  • If Use ghost queue is checked SAM3 will cache the next-to-play song in memory, allowing SAM3 to load the next song faster. This occurs because SAM3 does not have to apply any rotation logic at the moment of play. Highly recommended.
  • Cache queue count will improve SAM's performance by not having to make a database query each time it wants to check if the queue is empty. The only time you should disable this is if you modify the SAM queue via external scripts and database queries.
external image images%5Cdot2.GIF
Note: The above playlist rules are applied globally over SAM3, including the request policy. You do have the power to override the rules at different places to fit your needs. (i.e. The above rules do not generally apply to promos, station ID's, etc.)

Playlist rotation logic modules
SAM3 comes with a few built-in logic modules to suit the needs of most broadcasters. Here follows a brief description of each:
  • Category Playlist rotation logic module > This is the default and recommended playlist logic module. It allows you to easily specify the format of your station by selecting songs from categories in a certain order using certain selection methods . > Category based rotaton explained
  • Weighted Playlist rotation logic module > This module is very easy to use. It applies a basic weighted rotation . In other words, each song starts out with a weight of 60. Each time the song plays, it gets aged by decreasing the weight by a fraction, causing the song to be played less and less. Each time the song is requested, the weight is increased, causing the song to play more. > Thus, weighted rotation is "self-maintained": new and popular songs will be played more often than old and unpopular songs.
  • Web scripting based logic module > This module will make SAM3 contact a website each time it requires a new song for rotation or if a certain song event (like a song being requested) occurs. > Thus, if you know PHP, ASP, or any other web scripting language, you can take full control of SAM3's playlist rotation logic by writing your own logic with a web scripting language. >
    external image images%5Cdot2.GIF
    Note: The PHP web template that ships with SAM3 has a very basic web scripting interface. You can use that as a basis for your own logic scripts.
Each logic module has its own configuration section. Select the logic module you want to use, then click on the Configure button for the configuration section of the selected logic module.

external image images%5Cdot2.GIF
Note: More advanced playlist logic can be achieved with SAM's Playlist Automation Language (PAL)

||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||


external image images%5CHeader.jpg

Request Policy

SAM3 allows your listeners to make requests in real-time. SAM3 automates the entire request process - from logging the request to finally adding the request to the queue and playing it.
This is by far the most popular activity performed by visitors to a SAM3 powered website and it is what keeps most visitors coming back for more. Thus, it is highly recommended to use of the power of SAM's request function.
Another big improvement in SAM3 is the way requests are handled.In the past you had two options - enable requests, or disable requests. When requests are enabled, requests can be inserted into the queue at any random time which in many cases can have an undesired effect on your rotation logic. A good example is when you have a 4 part show, and a request is suddenly inserted between part 3 and 4 of the show, breaking the flow of the show.The only way to avoid this was to completely disable requests for the duration of the show. Thus during this time none of the listeners could make any requests.

Another option was to set the request policy to "Leave requests in list" for the duration of the show, but this usually caused all the requests made during the show to be inserted back-to-back in the queue as soon as the policy is changed again to move requests to the queue. Even during just normal usage, requests can severely compromise a well-thought out station programming rotation logic. To solve all of the above problems it is now possible to take complete control of when and how requests are inserted into the queue.

The first step is to enable requests, but set the policy to "Leave requests in list" and optionally also delay requests for xx minutes. Thus ALL requests made will stay in the request list - unless we specifically add requests as part of our rotation logic.





To do this you can use two methods:



1. Category based rotation

  • Under SAM->Config->Playlist rotation rules select the Clockwheel (Category rotation) logic module and hit the configure button.
  • Now modify your rotation clockwheel to insert requests at specified intervals.
  • Just hit the [+ Request] button to insert the appropriate clockwheel command.
2. PAL scripts

The other method is of course using PAL scripts.

Here is a simple example of a PAL script that will insert a request every 15 minutes, if a request is available.


[[code format="sourcecode"]] PAL.Loop := True; var Song : TSongInfo; Song := Req.QueueTop; if Song <> nil then begin writeln('Added request to queue:'); writeln(Song['filename']); Song.Free; {Dispose of the song object} end; code
external image images%5CHeader.jpg

SAM Technical Documentation

Welcome to SAM3 Technical Documentation. We hope you find answers to all your questions.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Introduction, What is SAM?

SAM is short for Streaming Audio Manager and was developed specifically with the needs of Internet broadcasters in mind. It combines six years of research with cutting-edge technology to bring you the power, features, and reliability professional broadcasters require. SAM takes control of all aspects of your broadcast and makes you sound professional while saving you time and money. With the flexibility, compatibility, and strong support network, it is little wonder SAM is considered the best Internet broadcasting tool available today.
This help file contains many sections that will help you discover the full power of SAM technology. We would, however, like to point out that this is not the only place you can get help for SAM. There are many other resources:
The AudioRealm member section: http://www.audiorealm.com/members/
Spacial Audio Forums http://www.spacialaudio.com/forums/
The AudioRealm discussion list. To join simply send an email to the following address: general-subscribe@spacialaudio.com
Spacial Audio Knowledge Base / FAQ http://www.spacialaudio.com/knowledge/
And of course the Spacial Audio support page: http://www.spacialaudio.com/support/
Please make an effort to read the help documentation first before asking general questions. This help documentation covers SAM usage in depth and most questions can be answered herein.
external image images%5Cdot2.GIF
Note: The Quick Start guides are only meant to give you a quick overview of how to get certain tasks done. If you require more help after reading a Quick Start guide, please refer to the detail sections for more information.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

external image images%5CHeader.jpg

Getting Started Using SAM and AudioRealm Services

Internet broadcasting is an exciting, cutting edge industry. SAM and AudioRealm services gives you the tools you need to make your broadcast dreams a reality. SAM can also make your present broadcast nightmares a thing of the past with one affordable solution. Let's get you streaming in 30 minutes or less....



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

SAM 30 Minute Quick Start Guide

The goal of this chapter is that any new user reading it can be up and streaming in less than 30 minutes.

This chapter is a quick start guide on how to setup a live Internet radio station using SAM Broadcaster and AudioRealm.com stream hosting services. We have offered advanced topics within the help file in the event you wish to obtain detailed information, but if you want to do it in 30 minutes it is best not to incorporate the advanced functions of SAM until you are up and running. Please refer to the rest of the help documentation and the website if you require further and/or advance help.




external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Quick Overview

Before we jump right in, let's discuss some basics regarding how internet radio works, the advantages of internet radio and what you will need to get started.




external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

How does Internet Radio Work?
The Internet can transfer any type of data including text, video and audio.
Basically Internet radio is the transfer of audio data over the Internet to listeners spread across the world.
To make all of this happen 4 things are required; a) Source audio (Audio files or Live audio)
b) Audio encoder & streamer (SAM Broadcaster)
c) Streaming server (http://www.AudioRealm.com/stream)
d) Player (WinAmp, Windows Media Player)


The audio encoder takes the source audio and encodes the audio into a continuous stream of audio data. This single audio stream is sent to the streaming server. The streaming server then acts like a broadcasting antenna by sending the audio data to all the listeners.

For listeners to tune-in to the audio stream, they must have some kind of player installed that is able to receive the stream of audio data from the streaming server, and then play the audio data over the speakers. Since compressing audio data requires large amount of computing resources, the computer running SAM should be a dedicated server.

The audio data is usually compressed to make it easier and more cost effective to stream over the Internet. For this purpose many audio file formats have been developed that all vary in quality, compression rates and features. Some examples of popular audio formats: MP3, mp3PRO, Windows Media and Ogg.

This document will explain how you can use SAM Broadcaster as your audio encoder, streamer and use the stream hosting services of AudioRealm.com to start your own professional online radio station.

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Advantages of Internet Radio
  • Start your own professional radio station for as little as $250, excluding hardware/operating costs such as a dedicated computers and ISP
  • Can be operated from home.
  • Many ways to generate revenue to fund your own station.
  • Reach an audience located across the world.
  • Start out small and grow as your station’s audience grows.
Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

What you will need to get started
First, you will need to decide which type of station you are going to run. Are you going to broadcast live content, pre recorded content, just playing audio source files or combination? Regardless of what you want to broadcast, SAM3 Broadcaster is the program that can handle it.

What do you need to set up an Internet radio station?
  • CD player
  • Ripper software (copies audio tracks from a CD onto a computer’s hard drive)
  • Minimum 48kbps Internet connection
  • Assorted recording and editing software (Optional)
  • Microphones (Optional)
  • Audio mixer (Optional)
  • Outboard audio gear (equalizer, compressor, etc.) (Optional)
  • Soundcard (Optional)
  • Dedicated computer with SAM Broadcaster software
  • AudioRealm Stream Hosting Server
Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Quick Stream Hosting Setup

This portion of the documentation will go over the process of planning and setup of AudioRealm.com stream hosting.

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Planning
Planning for your stream hosting is a key element in the planning portion of your station. Depending on the station you will either need to start small and increase as the need arises or you will need to start large and scale down after you have a feel for how many listeners you should really expect. If you are an existing organization with a large contact list or a terrestrial station with means to advertise to the masses and you plan to announce to all of your potential listeners you will want to be able to handle the initial traffic.

AudioRealm.com stream hosting offers 20 listeners as the minimum amount to start and we offer up to 500 listeners per server, if you wish to have more please contact us we are able to accommodate.

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

external image images%5CHeader.jpg

Setup AudioRealm Live Stream Hosting Account
  • Go to http://www.AudioRealm.com/stream
  • Select ‘Live Streaming’
  • Specify Server type ‘SHOUTcast’
  • Select the Maximum bitrate, this will determine the quality of your stream. Note: do not exceed your internet connection speed also allowing some room for emails and any other outgoing communications.
  • Select Maximum Concurrent listeners from the drop down box
  • Click Calculate
  • If the total monthly cost is within your budget click Continue
  • Member Details
    • If you are an existing member select ‘I’m already an AudioRealm member’ > >> > >> or
    • If you are not an existing member select ‘Sign me up (FREE)’
    • Enter a valid email address (notification of your server details and billing information will be sent to this email address)
    • Enter a username
    • Enter a password
    • Re-type your password
    • Read the Terms and Conditions and review the legal information (links are provided at the bottom of the page)
    • Check the box that indicates that you have read and understand the terms and conditions and that you have reviewed the legal information
  • Click Continue
  • Select your preferred payment method to make a payment right now.
  • SelectAutomated Monthly Payment’ this will ensure that your payment is made on time and that you will not have a lapse in service. > Note: any payment made by PayPal’s e-check, direct deposit, money order or check will take 4 days to process or until we receive and verify funds. A PayPal linked to your credit card is the fastest method and your account will be setup almost instantaneously upon completion of your order.
  • You will now be taken to the paypal.com site to complete your payment and setup a subscription for monthly payment > Note: If you do not currently have a PayPal account click on the ‘click here’ button next to the line that reads ‘If you do not currently have a PayPal account‘
    • Enter your PayPal login information
      • Enter username
      • Enter password
    • Click Continue
    • Confirm your payment by clicking ‘Pay’
    • You made a payment, now click ‘continue’ near the bottom of this page or you may exit this website at anytime by click ‘log out’ at the top of the page.
  • If you paid with a PayPal account linked to your credit card you should now be able access your stream hosting server by clicking here
  • Click Edit next to your new stream hosting account to obtain your encoder configuration information. Leave this window open or print the page, you will need information off it for your setup.
Related topics
*
Planning
*
General SAM setup



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Quick SAM Setup

  • Download SAM Broadcaster > NOTE: If you are unsure which database is best for you, just download the one with FireBird database support
  • Select ‘Save this program to disk’ and click OK.
  • Browse to the location where you would like to save the file (i.e.; desktop)
  • Once the file has been downloaded Click Start/Run/Browse find Installation file samdb-fb.exe and click Open.
  • Click OK to execute installation file.
  • Click Yes, then click Next after reading the welcome message
  • Click Accept (to agree to the software terms and conditions), and then accept all defaults, clicking Next until you click Finish to close the installation program. (or click next to accept the default install path, Click Next to accept the installation options for SAM and the SAM Database i.e. MYSQL) > NOTE: if you have an existing database installed on your dedicated system, you may need to change the username and password for the database, otherwise leave as the defaults. > Once the installation has completed, you will be prompted to view the SAM readme file and start SAM, click Finish. > Note: it is suggested you read the readme file, but for now we can set that aside.
  • A Welcome! Window will appear that will prompt you to ‘add demo files’ and ‘add my audio files to the media library (Recommended) click Continue. Note: You may wish to uncheck the ‘add demo files’ option.
  • Select the location of your audio files and click OK.
  • SAM Broadcaster should now be running, if it is not you may execute SAM broadcaster by going to Start / Run / Programs / SAM / SAM Broadcaster.
  • Optional: Restart your computer.
Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

How to Play Audio Tracks
Here is a quick overview on how to add files to SAM3, load them into the queue, and then play them.

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Adding Files to the SAM3 Media Library
Go to the playlist window located on Desktop A far left half way down and select the category into which you want to add files. Categories are used to split files into manageable groups or lists.
For this example, we will create a completely new category. Right-click on the root Playlist category and from the popup menu choose New. Then type in the name of the new category - we'll call it QuickTracks. Press [Enter] to save the changes.
Now right-click on the QuickTracks category and from the popup menu select: Add->Add Directory.
The Choose directory dialog will display. Browse to the directory containing the music you want added to the category. Now click on OK and a status window will display the progress of the files being added to the media library.
Once completed, you should be able to see the list of tracks added to the category in the Tracks in selected category window.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Adding Files to the Queue
The next step is to load the files you want to play into the queue. The queue contains a list of files that will be played from top to bottom.
Inside the Tracks in selected category window double-click on a song and it will be added to the Queue. Repeat this process until you have a few songs in the Queue. Note: You can also drag & drop songs into the Queue.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Playing the Files
First make sure you have the Virtual DJ set to Auto DJ mode, this option is set by default. You can select the Virtual DJ mode by selecting the drop down arrow just left of the Desktop A button in the toolbar. By doing so the virtual DJ will automatically load the next song from the queue when required and crossfade to the next track.
Next, make sure both Deck A and Deck B are visible. You may reset the layout of the screen by selecting ‘layout’ from the menu bar, your resolution (i.e.; 800x600 or 1024x768), default.
Click on the Play button in the toolbar just below file in the menu bar to start audio playback in the next available deck.
external image images%5Cdot2.GIF
Note: The Virtual DJ cues up the next track as soon as the currently playing track reaches the end and then starts playback of the newly cued track (while crossfading).



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

General Tips, Tricks and Features
  • You can quickly locate a song by clicking inside either the Queue or Playlist window and typing the name of the song you wish to find. This will instantly bring up a search window with matching results. Just double-click on the song to add it to the queue.
  • Drag & drop! In SAM3 you can drag track(s) from anywhere to almost anywhere. For example, you can drag a track from the search window onto the playlist, queue, or even directly onto the player decks. You can also drag from the search onto a category inside the Playlist window.
  • Learn the Shortcut keys - Like zippers, they make life so much easier.
  • More Dragging & Dropping - you can even drag & drop directly from Windows File Explorer!
  • Cool Trick: If a song is playing in a deck, hold down the [Shift] key while left-clicking on the Play, Pause, Stop or Next button. This will do a nice fade of the music to the specified state.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Encoder Setup
You have set up a streaming server the next step is to create an encoder that can supply the streaming server with a source stream.
· Goto Desktop B in SAM3 Broadcaster
· In the Encoders window click on the ‘+’ button
· Select MP3 and mp3PRO and Click OK
· MP3 (PRO) Encoder & Streamer Configuration
o On the Converter tab
§ Set Quality to Medium
§ Under Format select the format that matches what you purchased at Audiorealm.com for stream hosting. See the Audiorealm.com stream hosting account panel for bitrate. Check Auto Start encoder after 5 Seconds NOTE: be sure that ‘Allow scripts in stream’ is unchecked.
o Server Details tab
§ Server type is SHOUTcast
§ Server Details (found on your Audiorealm.com stream hosting panel).
· Enter Host in Server IP field
· Enter Port in Server Port field
· Enter password in password field
§ Station Details
· Type in your Station Name
· Select the genre from the drop-down box or type in your own Note: you may type in more than one genre comma separated.
· Type in your website URL
· Enter AIM ID (optional)
· Enter ICQ # (optional)
· Enter IRC Channel (optional)
· Check ‘List on public station listing (recommended) Note: this will list your station at SHOUTcast.com
· Check ‘Enable title streaming’ and be sure that $combine$ is in the field below ‘Enable title streaming’ to display titles.

o Click OK

o Your Encoder should now say ‘encoded (#) and streamed (#).

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Statistic Relay Setup
The final step is to create a Statistics relay for the streaming server.
A statistic relay simply grabs the current status and viewer count from each server, reporting the details to SAM3. Without a statistic relay, SAM3 will not know where listeners can connect to listen to your music and it will also not accurately report the count of listeners connected to your stream.
Additionally, without valid statistic relays your station will not show up on AudioRealm.com. This means you will not get any extra exposure and you will miss extra listeners coming from the AudioRealm portal and partner sites. For more information on listing your station at AudioRealm.com click here .
· Goto Desktop B in SAM Broadcaster
· In the Statistic Relays window click on the ‘+’ button
· Select SHOUTcast Statistic Relay, click OK
· Enter SHOUTcast server details (found on your Audiorealm.com stream hosting panel).
o Enter Host in Host field
o Enter Port in port field
o Enter password in password field
· Click OK
· Statistic Relay should now say ‘Active (OK)’

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

What's New from SAM2?

1. New audio engine
  • Most of the work went into our new awesome sounding, low-latency audio engine. The new audio engine is capable of working with latency as low at 15ms! That is 15/1000 of a second, which basically means that any change you make to the audio will be heard instantly. For example, if you change the EQ you can hear the change INSTANTLY - just as you would if you were using a hardware EQ. This also means by setting your latency low enough, you will not longer hear any echo when you use the VoiceFX.
  • SAM3 features a high-quality built-in audio processor (AGC). This can hugely improve the quality of your audio. Learn more here.
  • “KernelStreaming" is now supported. This audio mode completely bypasses the Windows audio mixer - which results in better sounding audio at much lower latencies!
  • Improved WinAmp DSP plugin support - it is now even easier to use Winamp DSP plugins inside SAM. Learn more here.
  • This is some of the SAM2 problems the new audio engines fixes:
- The start of songs being cut off
- The end of songs being cut off
- Skips, audio blips and stuttering, especially when using the VoiceFX
- Inaccurate custom fade points
- High-latency audio

  • Crossfading - We spent many weeks researching the best crossfading techniques and we believe you will be pleased with the results. SAM3 will by default automatically detect the best point to start a crossfade and then apply one of the smooth fade curves for the best sounding fades on the planet! You also have the option to set the fade settings for each song to make sure the fading sounds exactly like you want.
  • Que Points - You can now set custom Fade in, Fade Out, Track start, Track end, Intro and Outro points, as well as up to 10 custom cue points. You can also completely customize fade and other settings for each track.
  • Stream Support - We improved MP3 audio streaming (playback) support, and also added Ogg streaming (playback) support. Windows Media audio streaming (playback) is of course also supported.
  • Two main decks, Two auxiliary players, 1 hidden auxiliary player, 1 SoundFX player and 1 VoiceFX input all mixed in real-time with extremely low latency into a final output channel.
  • A long requested feature is the ability to preview the audio on a separate channel before playing it live over the air. This is now possible by setting up a cue output device. We recommend using two soundcards, but you can also use the front and rear speakers on a single soundcard.
  • Pitch and Tempo Control - The Pitch and Tempo of each deck can now be controlled directly from the deck.
  • Volume Control - Apart from being able to decrease the volume, you can now also "pre-amp" or increase the volume on each Deck.
  • New advanced gap killer with more "real-world" silence detection techniques.
2. Improved Decoders
  • All audio file decoders have been written from the ground up to be faster and more efficient.
  • Better MP3 streaming (playback) support. SAM3 now displays full title streaming information for any MP3 streams being played. SAM3 can also stream MP3 files hosted on a remote server.
  • SAM3 introduces Ogg streaming (playback) support, with title streaming.
  • The Ogg tag handler can now fully read AND write Ogg tags.
  • The WAV file decoder can now properly handle compressed WAV files.
3. Rotation Logic
  • We've put in a lot of work to reduce the repeating of the same track, or similar named tracks and artists.
  • We also improved the "random" selection of songs. Thus the phenomenon where it sometimes seems like songs are selected in alphabetical order should occur less.
4. Request Handling
  • We have given you more power over request handling by allowing you to specifically specify when & how requests are inserted into rotation.
  • Requests can now use a DNS name to authorize remote request handlers.
  • Learn more here
5. Improved VoiceFX
  • VoiceFX can now be configured in 4 different modes to suit any need!
  • Low-latency audio engine removes the echo problem
  • Can process the sound of your voice to make it sound better.
  • Stutter problem has been fixed
6. Improved SoundFX
  • SoundFX pages now load a lot faster
  • Bigger buttons which counts down the time of the active SoundFX item being played.
7. Other improvements worth mentioning
  • Auxiliary players now include a "Loop" button - great for running a music bed while using the VoiceFX
  • Mass tagger now saves a error log file to help you track down songs with bad tags or songs SAM is unable to write to.
  • New SAM Reporter with better script error handling.
  • Updated HTML output template
  • Slightly improved PHP template. Also handles missing album cover pictures a lot better.
  • Can automatically detect the Beats Per Minute of a song.
  • Easier to navigate category tree layout.
  • New "Select directory" dialog that loads a LOT faster.
  • Code in both the Statistic relays & Encoders that helps prevent you from typing in the wrong information.
  • Can now organize the items in the event scheduler.
  • Slightly improved fade control
  • New master volume control window


  • New "Add Mic/Line-in" dialog inside the queue


  • Ability to enter station name and description for WM Encoder.
8. Multiple database support

  • SAM now supports 4 different databases: FireBird, MySQL, PostgreSQL and MS SQL.
  • Updated PHP web template that has proper database abstration to support the above 4 databases seemlessly.


Related topics




external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Updated Request Handling

Another big improvement in SAM3 is the way requests are handled. In the past you had two options - enable requests, or disable requests. When requests are enabled, requests can be inserted into the queue at any random time which in many cases can have an undesired effect on your rotation logic. A good example is when you have a 4 part show, and a request is suddenly inserted between part 3 and 4 of the show, breaking the flow of the show. The only way to avoid this was to completely disable requests for the duration of the show. Thus during this time none of the listeners could make any requests.

Another option was to set the request policy to "Leave requests in list" for the duration of the show, but this usually caused all the requests made during the show to be inserted back-to-back in the queue as soon as the policy is changed again to move requests to the queue. Even during just normal usage, requests can severely compromise a well thought out station programming rotation logic. To solve all of the above problems it is now possible to take complete control of when and how requests are inserted into the queue.

The first step is to enable requests, but set the policy to "Leave requests in list" and optionally also delay requests for xx minutes. Thus ALL requests made will stay in the request list - unless we specifically add requests as part of our rotation logic.

To do this you can use two methods:

1. Category based rotation
  • Under SAM->Config->Playlist rotation rules select the Clockwheel (Category rotation) logic module and hit the configure button.
  • Now modify your rotation clockwheel to insert requests at specified intervals.
  • Just hit the [+ Request] button to insert the appropriate clockwheel command.
2. PAL scripts
The other method is of course using PAL scripts.
Here is a simple example of a PAL script that will insert a request every 15 minutes, if a request is available.

{========================================} PAL.Loop := True; var Song : TSongInfo; Song := Req.QueueTop; if Song <> nil then begin writeln('Added request to queue:'); writeln(Song['filename']); Song.Free; {Dispose of the song object} end; PAL.WaitForTime('+00:15:00'); {========================================}


{========================================}
PAL.Loop := True;
var Song : TSongInfo;

Song := Req.QueueTop;
if Song <> nil then
begin
writeln('Added request to queue:');
writeln(Song['filename']);
Song.Free; {Dispose of the song object}
end;

PAL.WaitForTime('+00:15:00');
{========================================}

With this new process you can now accept requests from your listeners 24/7, but still have FULL control over the format of your station.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

AGC - Active Gain Control

SAM3 introduces a professional sound processor that can make your broadcast sound like any professional commercial station - just without the cost!

The AGC (as we collectively call all the sound processors) includes:
- Gated AGC (Gated Average Gain Control)
- Stereo expander
- Bass EQ
- 5 Band processor (Which includes Limiter, Compressor and Expander)
- Dual band processor
- Clipper

Traditionally, you had to pay thousands of dollars for sound processor hardware - but with SAM3 no more! All this is included right into the default SAM3 install at no additional cost.

Sound processing can make your station stand out above the crowd - if used correctly! Incorrectly using sound processing can harm your station just as much...

In this chapter our goal is to help you use the AGC processors to get the best sound for your station.

Lets start by briefly discussing each process:

1. Gated AGC
The Gated AGC is used to "roughly" normalize the volume level so that the audio has an approximated constant volume level. The Gated AGC should be used together with the 5-band or 2-band processor because the Gated AGC on its own aims to simply provide a better input audio stream to these more fine tuned n-band sound processors.



2. Stereo expander
The stereo expander can give more "dimension" to the audio, and can especially make voice sound better. Great for use with VoiceFX module.

3. Bass EQ
The Bass EQ is used to emphasize the bass sounds & beats.



4. 5-band processor
The 5-band processor splits the audio into 5 frequencies, applying a compressor, limiter and expander to each band.



5. Dual-band processor
The 2-band processor splits the audio into 2 frequencies, applying a compressor, limiter and expander to each band.



6. Clipper
The clipper ensures that the audio volume level does not exceed the maximum. Unlike "hard" clippers, this clipper ensures a smooth clip making sure we retain the very best audio quality.



Correctly using the AGC
SAM3 has a very advanced multi-channel audio pipeline which allows you to configure it to your exact needs. In order to process the sound of your station properly you need to understand where in the audio pipeline to active the AGC, and how this decision effects the overall sound of your station.

You basically have 3 options:
1. Enable the AGC on the final mixed audio only
2. Enable the AGC on each player/audio channel, but not on the final mixer.
3. Enable the AGC on each player/audio channel - as well as the final mixer.



1. Enable the AGC on the final mixed audio only
PROS:
- Uses less CPU, since the audio processing only happens at a single point.
- Easy to config

CONS:
- The same audio processing is applied to all channels.
- Any audio processing will NOT be heard over the Cue output channel, only the final "Air" output channel.
- Likely to mess up the fading & crossfading of tracks, since even the fade will be normalized.
- Likely to mess up the fade-out/fade-in of the voiceFX module especially when the destination of VoiceFX is set to the mixer. NOTE: Some people actually like this though, since it has the "cool" effect where the volume level of the music stays constant, but as soon as you start talking the music level drops instantly so your voice can be heard clearly.

2. Enable the AGC on each player/audio channel, but not on the final mixer.
(This is the recommended setup)
PROS:
- Have exact fine control over you each audio channel should sound. We recommend setting DeckA, DeckB, Aux1, Aux2 and Aux3 to ALL have the exact same configuration.
SoundFX and VoiceFX though generally needs a more fine-tuned configuration. SoundFX is usually louder, while voiceFX generally deals with vocals that require a very specific configuration. In fact, each DJ of the station will probably need his own custom preset.
- Does not effect the fade-in/fade-out of songs. In fact, since the volume is normalized before the fade is applied, even songs with an pre-existing fade follow the configured fade curve more closely - resulting in much better sounding fades.
- Does not effect the Fade-out/in of the VoiceFX module.
- The audio processing is also audible inside the Cue output.

CONS:
- During the crossfade, or with multiple tracks playing the audio processing can use a LOT of CPU. If you have a 2GHz or faster machine you should not experience any problems.
- Even if each channel is optimized, after all of them are mixed together. the sound will most likely not be "as" optimized. This really only applies during crossfading, since in most cases only a single audio channel will be active at any time - making this negative hardly worth mentioning.

3. Enable the AGC on each player/audio channel - as well as the final mixer.
The way to use this method is to apply some basic audio processing on each channel, but to do the final major processing on the mixer. For example, enable only the AGC on each channel to make sure the audio volume level for each channel is properly boosted to a uniform volume level - and then only to the finer processing on the mixer after all the channels have been mixed into one.


Configuration
=
Refer to SoundSolution.pdf
There are minor changes in our version of the SoundSolution, so look out for those.

external image images%5Cdot2.GIF
Note: Beware of "over processing" the audio.
Turning on the AGC on each channel, and on the final mixer will probably sound worse - losing a lot of detail in the audio. Also, beware of using external DSP audio processing plug ins in conjunction with the built-in AGC. This might also cause a loss in audio detail.
Additional resources:
http://www.soundsolution.it/downloads/SoundSolution.pdf
http://www.soundsolution.it/content/view/19/35/
http://www.soundsolution.it/content/view/20/36/
http://www.soundsolution.it/content/view/24/38/



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Song Information Editor Interface - New with SAM3

Under the [Details] tab:

Play track [count] times and then [action] -This allows the track the be either Deleted from the Media library, or completely being deleted from the hard disk.
actions:
None - Play song only [xx] times.
Remove - Play song [xx] times, then delete from media library, i.e. delete from ALL categories
Erase - Play song [xx] times, remove from ALL categories, and also delete the physical file from the hard disk. Use with care!! Great for use with News and other "single play" files.

Also see the Categories under [Special->Play limit]

Under the [Reporting Fields] tab:

Can now specify different rights for the song
  • Royalty free. No royalty fee is payable on this music.
  • Download. Broadcaster may offer the track for downloading from a website or P2P sharing service.
  • On-demand. Broadcaster may use the song in an environment where listeners are able to listen to the track in an on-demand fashion. Steps should however be taken to avoid users being able to easily download or copy the track.
  • Broadcast. Broadcaster has the right to publically perform or broadcast the music.
Under the [Settings] tab:

Here you can set various custom settings for the track.
Cue points
Types of cue points.
Start: The point where playback will start from
End: The point where the track will end and be ejected. (Effectively the duration of the track)
Intro: The point where the first vocals start (and the DJ needs to shut up! ;)
Outro: The point where the vocals stop, and the DJ can open his mouth again...
Fade: The point where the fading out of the track should start.
XFade: The point where the next track will start playing.
Custom cue points: You can set up to 10 custom cue points to help seek to specified points in a file quickly.

Setting up a cue point:
  • Option 1: Double-click on the time window of the cue point to manually enter/change the time.
  • Option 2: Start playback in the player just above, and then click on the button containing the name of the cue point to set the time as the player reaches the correct point.
The [-] button clears the cue point, while the [>>] button will seek to the specified cue point.For custom cue points you must first select the index, then type in a short name/description of the point before setting up the cue point.

Beat-per-minute: Set the beats per minute of a track.
  • Method 1: Click the auto detect button to attempt to automatically detect the BPM value of the track.
  • Method 2: Click on the "Tab beats" button and then start the player. Now press on each beat until the "Tap on Beat" button goes away.
  • Method 3: Adjust the BPM manually by pressing the up/down arrows. The arrows on the left change the value by 1, while the ones on the right change the value only 0.1 for finer adjustment of the BPM value.
Metronome: To verify that your BPM value is 100% correct, follow these steps.
Start playback on the player and anticipate the next beat, trying to pause the player exactly on the beat. Now, while holding down [shift] click on the Metronome button to start the Metronome. Holding down shift will cause the player to resume playback the instant the button is pressed. If your BPM value is correct, you should hear the metronome sound exactly on the beat of the song.
If needed, adjust the BPM manually to better match the beat.

Notes: Make sure the Pitch and Tempo values of the player is set to zero, or else your beats will be configured incorrectly.

Other settings:
Gap killer - Specify whether the Gap killer should be applied to the track.
Gain - Apply pre-amp to the track, i.e. either increase or decrease the volume of the track. Great for making soundFX, advertisements and promos louder that normal tracks.

Applying settings:
  • The big [Apply] button will apply your settings to the player, so that when you start the player you can preview your custom settings.
  • The [Restore] button will restore the original player settings into the player.
  • The [Reset] button will restore the default player settings into the player.
Under the Fading Tab

Exact same details count as specified under the Config->Crossfading sections, except that you MUST check the "override" box next to each setting to override the default value for the track.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Configuration Interface - New with SAM3

Audio mixer pipeline
  • Completely new audio pipeline
  • Can click on the [EQ], [AGC], [DSP] and [Output] buttons to configure
  • The VoiceFx destination gives you a nice view of how the different VoiceFX modes work.
  • The Cue output channel is represented on the audio pipeline. There is one important point about the Cue channel - the final audio processing right after the mixer is NOT applied to the cue channel. N ow the you can click on the [Air out] and [cue out] buttons to configure the output settings.
  • For the sake of visual clarity), [Cue out] button is hidden if cue output is not enabled.
  • Process Priority - sets the priority of the whole application. A setting of High is recommended if your output is set to very low latencies.
  • Note: All 3 Aux Players can be configured by selecting the correct Aux player number from the dropdown in the great Aux box. Aux3 is a hidden player, mostly used in the Song information editor->setting to play the track while editing the song settings.
  • Note: EQ, AGC, DSP and Output config will be explained in separate section.
Crossfading

The improved crossfading in SAM3 features auto-crossfade point detection, and various fade curves that can be set globally, or on a "per-track" basis.

  • Enable Fade in: Specifies if the track should contain a fade at the start of track.
  • Enable Fade out: Specified whether the track should contain a fade at the end of the track.
The following pertains to both Fade-in/out settings:
  • Curve: You can specify 3 types of fade curves
    • Default/S-Curve: The S-Curve provides a nice "COS" style curve that really sounds the best in most situations.
    • The S-Curve: Starts out slow, then accelerates quickly before slowing down again. This produces a nice sounding fade. The resulting shape of the curve looks like an S, thus the name S-Curve.
    • Exponential: This curve starts out slow, but increases exponentially to produce a very quick fade during the end of the fade.
    • Linear: The linear fade produces a constant rate of change in the volume during the fade. (Aka. the old SAM2 style fades) Sounds best in conjunction of tracks that already has a slow fade. (If you wish to force the track to fade out quicker)Sounds OK with most other tracks
  • Time: The duration of the fade.
Note: This setting has no effect on the Fade-Out during auto-detected crossfades.

  • Level: Specifies the start/end volume level of the fade. A value of 100% means the fade will start/end at the minimum volume.For example, during a fade-out this means the fade will go to zero volume (i.e. -100dB). During Fade-in this means the fade will start at zero volume. Anything other than 100% means the volume level will start/end a bit higher. For fade-outs it is sometimes best no to fully fade out the track, so that the vocals can be heard during the final milliseconds of the track. Same goes for the fade in, starting at a higher volume allows the audio to be instantly audible while we continue with the fade.
Crossfade settings: There are 3 crossfade modes...
  • Disable crossfading : No crossfade. The next track will start immediately after the current track has completely finished playing.
  • Default/Auto detect: Will automatically scan the song for a certain dB level, and when the song drops below that value towards the end of the track - the crossfade will be triggered.
  • Fixed point: You can specify how many seconds before the end of the track the next track will start playing.
Fixed crossfade point (Time): Works in conjunction with Fixed Point mode above; specifies how many seconds before the end of the track the next track will start playing.


Crossfade point detection: Works in conjunction with Default/Auto detect mode above.

Trigger at [xx] dB:This specifies the dB level the automatic crossfade point detection algorithm will look for. As soon as the song drops below this level, towards the end of the track, the next song will start playing. The current song will also be faded out according to the time left till the end of the song. (See below)


Min/Max fade time: These values specify the min/max values the fade-out duration can be. For example, say the crossfade point is detected 10 seconds before the end of the track, and the maximum fade-out is only 6 seconds - then the fade will be only 6 seconds, resulting in the song being stopped 4 seconds earlier. If the crossfade point is detected 1 second before the end of the track, and the minimum fade out is 3 seconds, the following will happen. The fade out will be started 3 seconds before the end of the track, but the crossfade will actually start 1.5 seconds before the end of the track (3sec/2)

All the above settings can of course be overridden for each and every track. [x] Do not crossfade or fade tracks [xx] seconds or less in duration . This will avoid crossfading or fading of very short tracks like advertisements, promos and sound effects. Fading media like this usually sounds very bad. Imagine applying a 3 second fade-out to a 4 second track!

Note: Any content marked as "Allow overlay", i.e. "overlays" will not be crossfaded.

Gap Killer

Gap killer settings are pretty much the same as in SAM2, although the backend code has been hugely improved.
New: Trigger end of song if more than [xx] seconds of silence - if either the beginning or middle of a song contains a period of "near" silence as specified in the dB values, the end of the song will be triggered. Great for getting rid of "hidden tracks".
Bad for songs recorded or encoded at very low volume levels, or tracks with long periods of very low volume audio since this will trigger the end of the song prematurely.

Playlist Rotation Rules
  • Added new "Do not repeat album rule"
  • Also, SAM does a MUCH better job of preventing the same songs from being repeated too often.
  • The resetting of the weight balance after adding songs is no longer that important, since SAM will now use an average balance for new songs making them "go more with the flow" of the current weighted balances. Resetting the weight balance is still recommended on a periodical fashion, but SAM should do much better for people who never does this. This of course only effects people relying on weighted rotation or LemmingRules, since weighted rotation is one of the logics used by LemmingLogic.
  • Also, under category based rotation there is the new [+ Requests] button.
  • See updated request handling for details
Request Policy
Two major changes:
  • IP address list can now also accept DNS entries like www.audiorealm.com, etc. (Do NOT put an HTTP:// in front of name!)
  • "Leave request in list" is now a very good option, since you can now choose when to insert requests via the Clockwheel or PAL scripts.
  • See sam.requests.txt document for details
Registration Key
Now contains new 5x5 key structure. As always, you can copy & paste the complete key into the first edit box.

Important difference: The version of SAM available for download to the general public will NOT be unlockable. Users MUST download the FULL unlimited version from the secure client section . The key will work in the DEMO version, but still expire.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

General Interfaces - New from SAM3

Deck A & B

  • Beat match button (=) will change the player's tempo so that it matches the Beats-per-minute of the other Deck. Both tracks must have a valid BPM value, or else the button has no effect.
  • The [EQ] button brings up the Audio settings dialog which includes sections to change the Equalizer, AGC, DSP plugins and Output settings of the audio pipeline for all channels/players.
  • The [CP] button allows you to quickly seek to specified Cue Points
  • Intro/Outro - this display will show you the time left during the Intro stage and Outro stage - ie. the time just before the Vocals start, and just before the vocals end. This must be manually configured in the Song information editor.


[V][P][T]
Volume/Pitch/Tempo

Volume - increase or decrease the volume.
>0dB means the volume is getting boosted/pre-amped
<0dB means the volume is getting decreased
Volume should be left at 0dB in most cases. We recommend you adjust the volume of your speakers, or the Master volume instead of messing with the volume of the players.

Pitch changes the frequency/sampling rate of the track to speed it up or slow it down.
Tempo changes the speed of the track without changing the Pitch of the sound.
Thus you can speed up the music without the "Smurf" effect, or slow down the track without the "Demon" effect.

[air][cue]
When the Air button is selected, the audio passing through the player will be heard over the main output device. When the Cue button is selected, the audio will be heard through the cue device, if configured. This allows you to preview tracks before you play it over the main output.
Important: When both buttons are down, the audio will be heard on both devices.
In SAM Broadcaster, only the [air] audio channel is encoded by the encoders.

Aux1/Aux2

Exactly the same as Deck A & B with exception:
  • Few buttons are missing ([=],[>|])
  • Extra button - [Loop]
When down, the loop function will repeat the track when it reaches its end. This is great for playing a "music bed" while you talk over the voiceFX.

Playlist
Playlist window now has a "side category" view, much like you will find in Explorer
Note the new category layout.

Queue
  • New Add->Mic/Line-in which brings up the "Soundcard recording configuration" dialog. This allows you to configure the exact way a "mic://" song should be recorded
  • [x] Automatically select mixer volume control, when checked will change the recording volume control to the specified control. This is useful to force the correct input - i.e. record from WAVE in one instance, and then from MIC in another.
VoiceFX
  • Huge improvement over old voiceFX.
  • [auto] - if enabled (green light is on), the music will automatically be faded out/in when talking button is pressed.
  • [V][S]
    • S = Speed, is actually exactly the same as tempo. Tempo changes the speed of the audio without effecting the audio. This is the only mode that will work with VoiceFX since unlike songs, VoiceFX data is in real-time.
    • V = Volume
  • In "Soundcard" mode, the volume control changes the actual volume of the PLAYBACK line. i.e. it changes the volume as you will hear it over your soundcard. To demonstrate this, open up your mixer control on the playback controls interface, and change the volume in SAM. Notice how the volume changes in the mixer control.
  • In "Record to pipeline" modes, this controls the volume of the VoiceFX channel. This has no effect on the actual recording control line's volume.

Configuration:
Recording Modes: These are best viewed under Config->Audio mixer pipeline.

1) None: When talk button is pressed, SAM will simply automatically fade out the music. (If auto fade is enabled). No other action is taken. Works great for those that have an external Mic routed through an external mixer.

2) Mixer (Record to pipeline): Audio data is recorded from the soundcard, and fed as input audio to the VoiceFX channel. This mode allows you to perform audio processing on the audio, exactly like for example Deck A.
This also means that you will be able to hear yourself speak - if your latency in both the output and recorder is low enough, the "echo" should be tolerable/instant.
Otherwise, see mode 4 below.


3) SoundCard: SAM will play back the audio over the soundcard. Although this has the "echo" effect as well, the "echo" is instant. This mode is usually used in conjunctions with the "red" button on the encoders. That way you always encode exactly what you hear.

4) Encoders: Exactly like mode 2, except that the audio is only mixed into the audio right before the encoders. This means that this mode skips the main Mixer and Output - which of course means that it totally bypasses the mixer EQ, AGC and DSP plugins and also the Output - thus no echo.

Things to keep in mind:
  • VU meters are only available for modes 2 and 4
  • In modes 2 and 4 you can specify the latency of the recorder. If you hear skipping in your voice, you might need to increase the latency of both your output and recorder. Also, in these modes the [Mixer] button allows you to quickly jump to your soundcard audio mixer recording setup - which needs to be configured properly before using VoiceFX.
  • In mode 3, SAM can automatically "mute" or "unmute" the correct output volume control on your mixer. On some cheaper soundcards this might cause ALL the output controls to be muted. Automated "mute" should be disabled on these kinds of soundcards.
  • Mode 4 is only available in SAM Broadcaster.
Notes on AGC use with VoiceFX: The AGC can have a huge influence on how good your VoiceFX sounds. This will be discussed more on the AGC configuration itself.

SoundFX
Faster loading SoundFx categories. Biggest change is 12 buttons (instead of 9) which counts down the audio when playing. Pressing a button while actively playing will stop.
Tip: Set volume to +2.8dB (Highest volume value) since SoundFx generally needs to be louder than the playing audio.
[air][cue], volume/pitch/tempo control

Volume
Adjust the volume of the Air and Cue output devices separately. You can also mute the device. Muting the Air device has not effect on the audio going to the encoders.



Fade control
Same as old "DJ Control". Slightly improved GUI.



Encoders
  • For MP3, the configuration of the scripting changed slightly
  • For WMA, you can now specify the station information. This will appear in the player when the stream is played. (Under the scripting tab)
PAL scripts
Improved PAL editor
See "Edit" commands now available



Event scheduler
  • Can now move events up/down to sort them.
  • New [Request] button in "Add files to queue" event.


Clock
3D pie chart has been replace by 2D pie, to better represent the "clockwheel"



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

SAM General Use

This area of will explain, more in depth, some general uses and functions of SAM3.

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

How to load, queue and play audio tracks

This guide will give you a quick overview on how to add files to SAM, load them into the queue, and then play them.

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Adding files to the SAM3 media library
Open the Playlist window and select the category into which you want to add files. Categories are used to split files into manageable groups or lists. Read more here.
For this example, we will create a completely new category. Right-click on the root Playlist category and from the popup menu choose New. Then type in the name of the new category - we'll call it QuickTracks. Press [Enter] to save the changes.
Now right-click on the QuickTracks category and from the popup menu select: Add->Add Directory.
The Choose directory dialog will display. Browse to the directory containing the music you want added to the category. Now click on OK and a status window will display the progress of the files being added to the media library.
Once completed, you should be able to see the list of tracks added to the category in the Tracks in selected category window.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Adding files to the SAM3 Queue
The next step is to load the files you want to play into the **Queue**. The queue contains a list of files that will be played from top to bottom.
Inside the Tracks in selected category window double-click on a song and it will be added to the Queue. Repeat this process until you have a few songs in the Queue.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Playing the Audio Files
First make sure you have the Virtual DJ set to Auto DJ mode. By doing so the virtual DJ will automatically load the next song from the queue when required and crossfade to the next track.
Next, make sure both Deck A and Deck B are visible.
Click on the Play button on Deck A to start audio playback. Note: The Virtual DJ cues up the next track as soon as the currently playing track reaches the end and then starts playback of the newly cued track (while crossfading).



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

external image images%5CHeader.jpg

Tips, Tricks and Features
You can quickly locate a song by clicking inside either the Queue or Playlist window and typing the name of the song you wish to find. This will instantly bring up a search window with matching results. Just double-click on the song to add it to the queue.
· Drag & drop! In SAM3 you can drag track(s) from anywhere to almost anywhere. For example, you can drag a track from the search window onto the playlist, queue, or even directly onto the player decks. You can also drag from the search onto a category inside the Playlist window.
· Learn the Shortcut keys - Like zippers, they make life so much easier...
· More Dragging & Dropping - you can even drag & drop directly from Windows File Explorer!
Cool Trick: If a song is playing in a deck, hold down the [Shift] key while left clicking on the Play, Pause, Stop or Next button. This will do a nice fade of the music to the specified state .



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

external image images%5CHeader.jpg

Understanding Playlist Categories

Understanding playlist categories is crucial to effective use of SAM3. Categories will make managing and using your music easy and fast - but first you must fully understand their use. Please read the following guide carefully and make sure you understand the concepts discussed in each section before moving to the next.
external image images%5Cdot2.GIF
Note: When we type Special->Weighted rotation->Power hit we mean you need to locate the Special category, then find the child category Weighted rotation and then finally the Power hit category.

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Why use categories?
You can have just one big list in SAM. Just create a single category under SAM and dump all your files into it. But while you are at it, you might as well roll the rock in front of the cave door - dinosaurs might get in.
There is a reason we group things in life - so we have to think less (and do less)!
Not all songs are the same, nor do they have the same function. There are normal music tracks, but then there are Promos, Advertisements, Station ID's, News, Live shows, Interviews and so on.
We can go a step further to say that songs that seem to have the same function are in some ways not the same. Lets take some normal music files as an example. On a station we would think about them as all the songs the listeners really want to hear - so it seems like we can group them under the collective name of "Music listeners want to hear".
But, if we look closely, some music is more popular than others. Some songs are new; while others are so old that the copyright has expired! Suddenly, it seems we can create more "containers" - "Popular music", "New music", "Oldies".
Now let's take a look at just the "Popular music" container. We realize we can make even more containers such as "Popular music - Europe", and "Popular music - USA" because we realize musical tastes vary across the world.
We can probably keep on adding categories until the end of time - because for each "container" you will be able to find other "parameters" to split the category into even smaller "containers".
So it would seem that just the nature of music beckons for it to be sorted into logical groups or categories. "But sorting music into categories seems like a lot of work. I'm a certified lazy person - can SAM3 help?"
Yes - this is what makes SAM so powerful! SAM will automatically sort your music into categories - and for the few categories you have to sort manually, it is as simple as dragging & dropping files into the right category!



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

What is a playlist category?
- A category is a "container" that labels a collection of songs. Before anybody goes "Huh?", lets make the declaration simpler - because it's really a lot simpler than the former sounds.
- A category is a list of songs identified by a name.
Those of you that are used to applications like WinAmp can think of a category as an .m3u or .pls playlist file - but instead of keeping the list of songs in a file, it is kept in an internal database inside SAM3.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

How categories are used in SAM
The following is only a quick overview on how SAM3 uses categories.
As any professional station programmer will tell you - playing random songs will not satisfy a listener. A radio station needs a format - some template that guides how and when certain types of music must get played. A typical station must also play station ID's to let the listener know to which station they are listening, run promos to market upcoming events or shows, and then, of course, advertisements because stations can not survive on love forever.
So, a typical station format will look like this:
  1. Play a music file
  2. Play a music file
  3. Run station ID
  4. Run promo
  5. Play a music file
  6. Run Advertisement
  7. Run Advertisement
  8. Repeat above
Therefore, in steps 1, 2 and 5 we need to pull a song out of the "Music" category. Then for step 3 we need a "Station ID" category and for Step 4 a "Promo" category. Finally, we need an "Advertisement" category. As you can see from the description above, SAM needs to know how to choose songs from the media library to play. In other words, in what format should the music be played.

SAM Broadcaster can achieve this via different Playlist rotation logic modules and PAL scripting



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Smart categories
In SAM all categegories are not just lists of songs. Some categories contain artificial intelligence that can help you save a lot of time if you know how to use this feature. All this will be explained below.
1. Types of categories
Let's get down & dirty with the technical stuff.
First, SAM has 4 major category types.
1.1 Parent categories
These are categories like the Playlist root category. They have no other function other than to serve as a root parent for other categories. In other words, their only function is as a "container" of "containers".
external image images%5Cdot2.GIF
Note: You can not create a parent category. (You can however create a normal category that contains other categories along with songs. We will discuss this later.)
Features
  • Does NOT contain songs
  • Can have zero or more child categories
  • Can NOT be deleted.
Examples: Playlist, Special, Content, Groups
Parent categories normally have one of the following icons:
external image images%5Cplaylist.gif
external image images%5Cstar.gif
external image images%5Cfolder_opne.gif

1.2 Normal categories
Normal categories are the workhorse of categories. These are the category types you will use most often.
Normal categories contains a list of songs and can even have other child categories containing more songs.
Features of Normal Categories
  • Contains a list of tracks
  • Can have zero or more child categories
  • The SAME track can be listed inside the category more than once
  • Can usually be sorted
Examples: Any category you create under the Playlist root category.
Normal categories have one of the following icons:
external image images%5Cfolder.gif
1.3 Auto-generated categories
Auto-generated categories are powerful categories that need no management on your part. They are automatically generated each time you view them!
The Content->Sound FX->Sound FX (All) category is an example. This auto-generated category contains a list of ALL songs that are marked as a Sound FX.

Features of Auto-Generated Categories
  • Contains a list of tracks automatically generated from data in the media library.
  • Can not contain child categories
  • The same track can NOT be listed more than once in the category
  • Is usually sorted by some field.
Example: Special->Weighted rotation->Power hit
Auto-generated categories have one of the following icons:
external image images%5Cgenerate.gif
1.4 Grouped categories
Grouped categories can be thought of as 2-level categories where level 1 is the attribute on which songs will be grouped and level 2 the actual songs in that group. (They are a special kind of auto-generated category.)
Grouped categories are best explained via an example:
Goto the Groups->By Artist category. ( NOT the By Artist (A-Z) category.)
This grouped category groups all the songs together with the SAME artist. Select an artist name on the left and a list of songs performed by that artist will instantly be displayed on the right.

Features of the Grouped Category
  • Contains a list of groups, and then a list of tracks inside each group.
  • The same track will not be listed more than once inside the same group
  • List is auto-generated from data inside the media library.
Grouped categories have one of the following icons:
external image images%5Cfolder.gif


Phew. That was a mouth full. Lets recap quickly.
Key points
  • 4 major categories: > 1) Parent > 2) Normal* > 3) Auto-generated > 4) Grouped > *The ONLY categories you can manually create yourself are the Normal categories.
Note: Make sure you understand everything up to this point before continuing. Things get interesting from this point forward.

2. Category attributes
Those of you who have been paying close attention might ask: "Ok, so we can split files into categories and SAM automatically generates some categories for us. Big deal. Many other applications can do the same..."
SAM brings to music management a concept that has revolutionized application development - the concept of Objects with inheritance. RAD (Rapid Application Development) would not be possible without inheritance.
SAM brings to the world of automation the concept of management via song attribute inheritance .
Without straying too far off topic let's quickly discuss the concept of Objects with inheritance.
Let's use a Transportation vehicle as an example. One general attribute of a Transportation vehicle is its use as a vehicle to take a person from point A to point B.
We basically have two types of Transportation vehicles
1. Motorized vehicles 2. Human powered vehicles
One general attribute of a motorized vehicle is it is powered by some kind of engine or motor.
One general attribute of a human powered vehicle is it requires the physical effort of a human to "make it go."
Ok, lets make it interesting. A car has 4 wheels, a (bi-)cycle 2.
So...to build a motorcar we know it's a: 1) Transportation vehicle (Transports a person from Point A to Point B) 2) Must be powered by an engine 3) Must have 4 wheels
Key point: The motorcar inherited attributes from both Transportation vehicle and Motorized vehicle.
And a Bicycle is a 1) Transportation vehicle (Transports a person from Point A to Point B) 2) Must be powered by a human 3) Must have 2 wheels
Key point: The bicycle inherited attributes from both Transportation vehicle and (bi-)cycle.
Conclusion: By placing an object in a certain group we automatically know what to expect of that object. We know a motorcar has 4 wheels and an engine, and we know if you get into a motorcar it will be able to take you from one place to another. We also know what NOT to expect from a motorcar. We know it can not have two wheels - if it did have two wheels then it would cease to be a motorcar, and become a motorcycle instead. It also can not be a motorcar and a motorcycle at the same time - it needs to be either one or the other. To add to the mix, think about the following: If we classify an object as a (bi-)cycle, we know it can take you from point A to point B and has 2 wheels. We, however, do not know if it requires human effort or if its powered by an engine. The fact is, we don't care! The only stipulation is the object must have 2 wheels and be able to transport a human - that's it. If an object has those two attributes we know its some kind of (bi)-cycle.

So how does this apply to SAM?

Each SAM category has zero, 1 or more attributes associated with it. A complete list will be made at the end of this section, but lets just go over a few examples to explain the concept.
Browse to the Content->Sound FX category. This category has a song type attribute of "X". Meaning ALL songs added to categories under this parent will be assigned a song type of "X".
Lets go over an example step by step.
1. Right-click on the Content->Sound FX category and select New. Type "ExampleFX" as your category name.
2. Add a song to the Queue. Now bring up the Song information editor for the song and take note of the Type field. (It should display "S" if it was a normal song type.) Close the Song information editor.
3. Now drag the song from the Queue to the ExampleFX category.
4. Again open the Song information editor for the song. Notice how the Type changed to "X"! Ok, now change the "X" back to "S" and click on OK to close the Song information editor.
5. Now click on Refresh inside the ExampleFX category. Notice that the song you just added to the category is suddenly gone!
Lets slowly recap what just happened
  1. When you created the ExampleFX category it inherited the attributes of the parent category. The parent category in this example had the attribute that "if you want to belong to this category your song type better be 'X' or you will not show up."
  2. When we dragged the song to the ExampleFX category three things happened: > 2.1 First, SAM checked that the song was already added the the media library. In this case it was. (If it wasn't, SAM would have automatically added the track to the media library.) > 2.2 Second, it checked that the song's type matched the category attribute (Song type ='X'). In this case it wasn't, so it changed the type to 'X'. > 2.3 Lastly it added the song to the ExampleFX category.
  3. When we changed the type of the song back to 'S' inside the song information editor we effectively made the song invalid to still be part of the ExampleFX category because only songs of type 'X' can be listed inside it. Thus, when we refreshed the list of songs the song was removed from the list.
Lets continue. Browse to the Content->Sound FX->Sound FX (All) category. This is an example of an Auto-generated category discussed earlier, but, as you might have guessed, with the additional property of having an attribute assigned that specifies "only list songs of type 'X'".
  1. Now drag the song from the Queue into the Sound FX (All) category.
Two things just happened
  1. SAM checked if the song was already in the media library
  2. Changed the song type to 'X'
That's it! Since the list is auto-generated from all songs in the media library there is no need to store any additional information. This category simply shows ALL songs in the media library that has the attribute that the song type is 'X'.

Lets take a look at a more complex category
Browse to the Special->Weighted rotation category. Under it you will find a list of categories called "Power hit", "Heavy rotation", etc.
A Weighted category has the following attributes
  1. The song must be of type 'S'
  2. To belong to a specific weighted category the song's weight must be in a specified range.
For example to belong to the Power hit category a song must be a) Of type 'S' b) Have a weight of 80 to 100
So dragging a song into the Power hit category will do the following
  1. Add the song to the media library if needed
  2. Change the song type to 'S'
  3. Change the weight to (Minimum weight+Maximum weight) / 2. (Which is 90 in this case since 80 + 100 = 180 / 2 = 90)
Next, let's look at a category with zero attributes. Any category created under the root Playlist category will have zero attributes.
Thus adding a song to such a category will result in the following
  1. Song is added to the media library if needed
  2. Song is added to the category list.
And that's it. Nothing more. Neither the song type nor the actual weight gets changed.

Quick overview
  1. Categories have certain attributes.
  2. A category will only list songs that matches all the attributes of the parent category.
  3. A category will change the attributes of any songs added to it in order to match the attributes of the parent category.
  4. Some categories have zero attributes and thus will list all songs added without changing any attributes of the song.
  5. If you create a new category it will also inherit all the attributes of the parent category.
3 Categories and their attributes
3.1 Normal categories (Attributes: NONE)
  • Playlist
3.2 Song type categories (Attributes: Song Type)
  • Content (Attribute: Song Type)
    • Music (Song type = 'S')
    • Sound FX (Song type = 'X')
    • Station IDs (Song type - 'I')
    • Jingles (Song type = 'J')
    • Promos (Song type = 'P')
    • Advertisements (Song type = 'A')
    • News (Song type = 'N')
    • Interviews (Song type = 'V')
    • Other (Song type = 'C')
3.3 Special categories (Attributes: Song Type, Weight range)
  • Special
    • Weighted Rotation* (Attribute: Song Type = 'S', Weight range)
      • Power hit (Weight = 80..100)
      • Heavy rotation (Weight = 60..79)
      • Medium rotation (Weight = 40..59)
      • Light rotation (Weight = 20..39)
      • Rare rotation (Weight = 10..19)
      • No rotation (Weight = 0..9)
    • Overlay (Attribute: Overlay = Yes/No)
    • Song rights (Atrribute: Song rights, i.e. Broadcast,On-demand,Download, Royalty free)
    • Play limit (Atrributes: Play limit, and action)
*ALL weighted categories have a song type of 'S'.
3.4 Grouped categories
Grouped categories are a special case. The attribute of grouped categories is the data field by which the song list is grouped along with the actual value inside the data fields.
Currently grouped categories do not support inheritance. In fact, you can't even drag a song into a grouped category.
Eventually, future inheritance for grouped categories might be supported.

4. Directories - a special kind of category
The last type of category type is the one built into your operating system. The one that nicely groups your files into logical groups: a Directory. (Windows often refers to a directory as a folder. )
Rotation logic can be applied directly to directories making them act as a kind of special case for categories.
5. Drag&Drop maintenance
Now that you know all about categories start putting that knowledge into good use. Plan how you want your music organized, what categories you need and how they will be used.
Once you have created all the required categories, management becomes a very simple process of dragging&dropping files into the right category.
6. Putting categories to work
So your music media library is now nicely sorted into categories. Easy, wasn't it?
Now lets put these to good use.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Things you should know
This section contains important snippets of information in order to properly utilize SAM3.
· Keep your songs in a static location Before using SAM3; logically organize the complete music library on your hard disk. Use a directory structure like c:\music\"artist"\"album"\*.mp3. Once songs are added to the SAM2 media library, do not move the songs or SAM2 will have invalid songs and will not know where to find them.
· Any song that gets played is automatically added to the media library Any song that gets played on SAM2 gets automatically added to the media library. This includes songs directly added to the queue or songs inserted via a PAL script. These songs then show up under the Content->Music->Music (All) category.
· Deleting a song from a category does not delete the song from the media library When removing/deleting a song from a specific category the song will STILL be in the media library. To completely remove a song, select the Remove from ALL command.
· Some changes are not instantly reflected on the SAM3 display For example, changing the artist name of a song inside the song information editor will apply the changes, but will not immediately be visible. Refresh the list of songs in order to make the changes visible. The general rule to live by - "When in doubt, hit refresh." SAM3 caches song information in order to speed up display and control, and changes to the song data will not be immediately updated inside the cached information.
· Save the song information directly in the file tag after major changes Each time, after making changes to the song information, click the Save tag button to store the information directly inside the song file. This can prevent a lot of headaches later down the road in case: a) Your media library database gets corrupted and you have to rebuild it b) You move your files and re-add them to SAM c) You want to use the same song on other stations d) You accidentally delete songs from the media library and need to re-add them.
· Keep your media library consistent In general, try not to move songs around on your hard drive and do not directly delete songs from your hard drive. So how do you move or delete a song? a) Moving a song Move the song to the new location. Search for the song inside SAM, then open up the Song information editor, and click on the browse button located next to the filename. Browse to the new location of the song. The filename will be updated to point to the new location and all song information and statistical information will still be intact. b) Deleting a song Deleting songs is a bit easier. Find the songs to delete using the song search, and then use the Delete physical file function to delete the song file(s) from the hard disk.



Tips:
  • If retaining the song information and song statistics are not important to you, simply move the songs to the desired new location and then write a short PAL script to rescan both the old directory and new directory. That way, the old invalid entries will be deleted from the media library and the new files will be added to the media library.
  • Another tip for moving files: Create a custom category called "Moved" and then drag your songs into the "Moved" category directly from explorer BEFORE you move the files. This will give a list of all songs moved and you can use the song information editor quickly to update the new location of each moved song without needing to go search for each one.
  • Same tips can be used for songs you want to delete. A PAL script that rescans the directories will detect deleted songs and remove them from the media library.
  • Also, dragging songs you want to delete into a custom "DeleteUs" category will provide you with a complete list of songs you need to delete. Then simply select all the songs in this list and use the Delete physical file command to delete them all in one shot.

Drag & Drop management Make sure you understand categories - drag & drop management can either be a helping friend or the ghost that keeps moving songs into strange places.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Category Based Rotations

This section will provide a step-by-step guide to initialize a category-based rotation logic script. This section is by no means a complete overview of category based rotation, but will give a good start in exploring the power of SAM's rotation logic.
external image images%5Cdot2.GIF
Note: Advanced users can achieve the same logic as described here using a PAL script.

Related topics



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Configure SAM to use category based logic rotation
Lets first activate the SAM3 Category based rotation logic module.
Open up the SAM3 configuration and browse to SAM3->Config->Playlist rotation rules
Under Playlist logic modules select the Category Playlist rotation logic module and click on the Configure button.
This will bring up the Category rotation logic configuration dialog.
Ignore the values in the Adjust weight on events section for now and look at the Rotation clockwheel format section.
Once you have the Rotation clockwheel format window in front of you and can specify your own clockwheel format.



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004

external image images%5CHeader.jpg

Creating your own Rotation Clockwheel Format
A review of the buttons - from top to bottom:
  • + Category - Select a song from a category rule.
  • + Directory - Select a song from a directory rule.
  • + Request - Select a pending request to be moved to the queue.
  • + Comment - Add a comment or description to the clockwheel that helps you follow the logic or provides more information.
  • Clear - completely empties the clockwheel.
  • Load - Load a clockwheel format from a file.
  • Save - Save the current clockwheel format to a file.


Example clockwheel
[[code format="sourcecode"]] {# Add tracks from various categories #} Cat['Music (All)'].QueueBottom(smLemmingLogic, EnforceRules); Cat['Tracks'].QueueBottom(smLRPA, EnforceRules); {# Add a station ID followed by an advertisement #} Cat['Station IDs (All)'].QueueBottom(smRandom, NoRules); Cat['Advertisements (All)'].QueueBottom(smLRP, NoRules); {# Add a requested track to the bottom of the queue #} Req.QueueBottom; code


Category based rotation - some more examples



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
|| ||
external image images%5CHeader.jpg
|| || Category based rotation - Examples
Example 1: A very simple clockwheel
Click on the Clear button to start a new clockwheel; then click on the Category button.
This will bring up the Select category dialog. From the categories on the left choose the Tracks category.
On the right are various options:

Enforce playlist rotation rules
Specifies whether SAM will use the Playlist rotation logic rules when selecting a track out of this category.
Selection method specifies what logic to use when selecting a track. The Least recently played logic, for example, will select the song that hasn't played for the longest time. For a complete overview, please refer to the documentation Selection method .

For this example, check the Enforce playlist rotation rules checkbox and click the Lemming Rules selection method.
Now click on OK. The clockwheel format script should now look like this:
[[code format="sourcecode"]] Cat.QueueBottom('Tracks',smLemmingLogic, prEnforceRules); code
Now click on OK to save the current configuration.
SAM will now select a song out of the Tracks category EACH time SAM needs a song for rotation. SAM will ONLY select songs inside the Tracks category. If a song is not located inside the Tracks category, it will not be played.

Example 2: More advanced clockwheel
In this example, songs will be inserted from two categories, a station ID will run, and then a featured artist from files located inside a certain directory will be added to the queue.
Here is the final product:
[[code format="sourcecode"]] Cat.QueueBottom('Tracks',smLemmingLogic, prEnforceRules); Cat.QueueBottom('Music (All)',smWeighted, prEnforceRules); # Insert Station ID Cat.QueueBottom('Station IDs (All)',smWeighted, prNoRules); # Insert song from one of our featured artists SubDir.QueueBottom('C:\Music',smLRPA, prEnforceRules, NoScan); code
The first line is exactly the same as in Example 1.
The second line was created by clicking on the Category button and browsing to the Special>Content->Music->Music (All) category. The Weighted selection method was chosen and the Enforce rules checkbox checked.
For the third line, click on the Category button and browse for the Special->Sweepers->Stations IDs->Stations IDs (All) category. Do NOT check the Enforce rules checkbox since most stations only have a few station IDs that play often. Thus the Do not repeat song within [xx] minutes rule will almost never be able to select a valid station ID for play. Consequently, this command skips the playlist logic rules for station IDs and simply selects the one that has the best balance according to weighted rotation.
Then, on the next line, use a directory category to only select songs located inside a certain directory. To accomplish this, click on the Directory button and browse to the directory containing the music. (In this example, it was c:\music\ ). If the music is nicely sorted in subdirectories, and to have the logic also search the subdirectories for songs, check the Include subdirectories checkbox. Do not check the Rescan directory if there are a lot of files in the folder, as rescanning each time will waste considerable CPU power. Songs will have to either manually be added to the media library each time new files are added to the c:\music directory, or a PAL script will need to be created to automatically check for new files on a daily basis - or else the files will not be in the media library and SAM2 will not select them for rotation.

How SAM works with the clockwheel:
As SAM plays songs it will refer to the playlist rotation logic module each time it requires a song for rotation. The Category based rotation module decides which song to play according to a clockwheel format script.
The above script does the following:
First, select a song from the Tracks category, using Lemming Rules (which basically means random logic) and make sure the song selected obeys all playlist rotation rules.
Then select a song from all songs inside the media library (excluding Sound FX, stations ID, etc) using weighted rotation selection logic (song with higher weight will get played more often), once again obeying all playlist rotation rules when selecting the song.
The third song selected will be a station ID, selected from the list of ALL songs marked as a station ID. Once again, the weighted selection method is used, but we do not enforce the playlist rotation rules. (See notes below.)
Finally, select a song located inside the c:\music directory or a song located in one of the subdirectories located under c:\music. Use the Least recently played artist selection method logic since this will give us a nice rotation between artists. Playlist rules are enforced, but do not rescan since it might put our CPU under too much load with a large amount of songs under that directory.
external image images%5Cdot2.GIF
Notes
  • When a category selection method can not find a valid song that plays within the playlist rotation rules and Enforce rules is used, the specific selection will return an EMPTY result - meaning NO song will be inserted from that category and one from the NEXT category will be inserted instead.
  • A common mistake is to enforce rules on Station IDs, Sweepers, etc., causing them to be not valid under the rules and returning an empty result set. This in turn causes your clockwheel format to be "broken" - i.e., not playing songs in the correct "format"
  • Using rescan for small directories (Less than 1000 songs) will read the files inside the directory/subdirectories and also remove invalid files. This is very useful if you simply want to copy featured songs into a directory without needing to manually add them to the media library. Just be warned that for big directories running rescan in your playlist category script is NOT recommended. Rather, use a PAL script to rescan it daily or once every few hours.
external image images%5Cdot2.GIF
Note: This is a note or comment
||



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
|| ||
external image images%5CHeader.jpg
|| || Properly using Categories for rotation
Categories will make life easier and can make the music format sound like a professional radio station - if used properly. First, before reading this section, read the Understanding playlist categories section to get a proper background on the subject.
This section only applies if SAM3 is using the Category based rotation logic module or using a PAL script that inserts songs for rotation using categories.
Refer to the following examples
Things to keep in mind while working with category based rotation logic:
  • Make sure there are enough songs in the category to rotate within the bounds of the playlist rotation rules, or else the category will be skipped. This is a common mistake with categories like Promos, Station IDs, Sweepers, etc. Always use the NoRules parameter for those categories.
  • When using directories as categories, remember that the songs must already be in the media library before they can be selected for rotation. The Rescan flag will, of course, scan the directory for new files and remove invalid files - but that can take a lot of time and CPU with large directories.
  • Category names are not case sensitive, but spelling must be exactly the same as the actual category as located in the Playlist. > - A PAL script will warn you inside the output window if it could not find the specified category. > - The Category based rotation module currently will not report any problems with the category name. It will simply skip that category script line. Therefore, it is very important to double-check the name of categories in your scripts.
  • Parent and Grouped categories are not valid names for category-based rotation! > Parent categories do not contain any songs, only other categories. They cannot be used for category-based rotation. In the future, the support for grouped categories for rotation logic may occur.
  • If a category is the parent of other categories, but also contains a list of songs - from where will the selection be made? > This is the main difference between categories and directories > > a) Using the Dir['c:\music\'].QueueBottom(...) command, songs will only be selected from the main root directory. No songs from any subdirectories will be included in the search. > > b) Using the SubDir['c:\music\'].QueueBottom(...) command, songs will be selected from the main root directory and songs from any subdirectories will also be included in the search. > c) Using the Cat['MyCategory'].QueueBottom(...) command, songs will only be selected from the 'parent' category. No songs from any child-categories will be included in the search. Thus, it works similar to (a).
Related sections



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
|| ||
external image images%5CHeader.jpg
|| ||

Setting SAM to Broadcast over the Internet


  • Set up a streaming server (SHOUTcast, LIVE365, Icecast, Windows Media, etc.). > Note: If you need a streaming server, we recommend AudioRealm stream hosting .
  • Create an Encoder to stream to the server.
  • Create a relay for each streaming server to grab statistics from the servers. This will also cause your station to appear on AudioRealm.com and other station listing sites.
To broadcast over the Internet with SAM you need to do the following:



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
|| ||
external image images%5CHeader.jpg
|| || Setup a streaming server
To make your stream available to listeners you need a streaming server. Setup and configuration of streaming servers are out of the scope of this guide - you should refer to the specific server documentation for setup details.
SAM3 supports almost all of the popular streaming servers available today. SAM3 thus gives you the power of choice, allowing you to stream to almost any type of server or even multiple types of servers all at the same time!

Note: If you need a streaming server, we recommend AudioRealm stream hosting
|| || || ||
external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
|| ||
external image images%5CHeader.jpg
|| || Create an encoder to stream to the server
Once you have set up a streaming server, or purchased stream hosting from a provider, the next step is to create an encoder that can supply the streaming server with a source stream. A complete discussion about each encoder type can be found here.
external image images%5Cdot2.GIF
Note: Most streaming servers have the ability to relay a stream from another server. For example, a Live365 server can relay a stream directly from a Shoutcast server. Thus you only have to send one source stream to the Shoutcast server, which in turn streams a stream to the Livecast server, saving you bandwidth and CPU power since you only have to run a single encoder instance.
You can also stream at multiple bitrates. For example, you can stream at 24kbps WMA for modem users and 128kbps WMA for cable modem/DSL users. Note: You will need a server for each source stream. (In the case of Windows Media servers, the same server instance can handle multiple streams, but each stream has its own unique alias.)
||



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
|| ||
external image images%5CHeader.jpg
|| || Create a relay for each server
The final step is to create a Statistics relay for each streaming server. Remember, this includes relay servers. A statistic relay simply grabs the current status and viewer count from each server, reporting the details to SAM. Without a statistic relay, SAM will not know where listeners can connect to listen to your music and it will also not accurately report the count of listeners connected to your stream.
Additionally, without valid statistic relays your station will not show up on AudioRealm.com. This means you will not get any extra exposure and you will miss extra listeners coming from the AudioRealm portal and partner sites.

A complete discussion about all available statistic relay types can be found here.
||



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
|| ||
external image images%5CHeader.jpg
|| ||

Getting your Website Ready


In today's world, a website can no longer be a static page of text. To compete in the broadcasting world, your website must be informative, interactive and easy to use.
Luckily, by using SAM, you already have the edge over many other stations. SAM3 features advanced HTML and PHP output capabilities, making it a breeze to have dynamic updated web pages - even if you do not know a thing about web scripting or HTML! Also, SAM3 templates include a Buy CD link, which can provide an additional revenue opportunity.
SAM3 ships with two example website templates:
  • The PHP web template, located inside ...\program files\spacial audio\SAMBC\samPHPweb, contains a basic example of how to write a website using the PHP scripting language. This template is intended for more advanced users, since learning PHP can take some time and effort. We do, however, highly recommend PHP websites since the power of PHP for website creation is unmatched.
  • The second web template is located in ...\program files\SpacialAudio\SAMBC\samHTMweb. This template uses the built in SAM HTML output language.
This is only a quick overview of what to do in order to get a website up and running. For complete, detailed instructions, please refer to the HTML output section and the HTML output reference guide .
Steps for preparing your website
||



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
||

external image images%5CHeader.jpg

Steps for preparing your website
  • Get a good web-hosting provider.
  • Get FTP access to the website.
  • Configure HTML output as described in the Readme.txt file. Customize the web template to specific needs.
  • Make sure the request policy is properly configured to handle requests.
  • Associate pictures with songs and upload them.
  • Upload the complete HTML template to the website. (Including pictures and all subdirectories.)
  • Generate the playlist and upload it.
Your website should now be ready!



external image images%5Cdot2.GIF
external image images%5Cdot2.GIF
external image images%5Cdot1.GIF
Copyright Spacial Audio Solutions, LLC - 2004
|| ||
external image images%5CHeader.jpg