Boson Manual

Boson Version 1.3 / Manual Revision 12 / 02-Feb–2016

Table of Contents

Introduction

Welcome to Boson!

Boson is an audio editor which enables you to record, edit and convert digital audio data without loss in quality.

This kind of software is pretty handy and has been around since the 1990s: You could for example open a voice recording, remove unwanted parts and export the edited audio as a MP3 file. Or you could connect a tape deck to your Mac and digitize your old tapes.

The first programs of this kind started to appear when personal computers become powerful enough to process digital audio signals. And with time as computers grew more powerful so were the programs updated to keep track of new developments.

And here lies the big dilemma: Most audio editors that are available today are based of those old first generation programs and thus have to carry around much historic baggage.

Concepts and optimizations that were introduced with computers in mind that had merely 8 MB of RAM can be still found in today’s audio editing software.

That’s why we decided to develop Boson completely from the ground up doing away with constraints that other audio editing software still has to live with. For example Boson has features like instantaneous unlimited undo/redo that persists its state over multiple editing sessions; You can quit Boson and when you re-open your document (provided you saved it in the boson workspace format) all undo and redo information is still there. Boson also offers editing down to a resolution of one sample. Yes, that’s right - you can manipulate separate samples with Boson. Try this with any other audio editing software that costs under $500.

Also Boson was developed with the assumption that many of you will run the app on battery powered mobile Macs. That’s why you can disable all unnecessary screen updates during recording to save battery power and keep recording for hours from one battery charge.

Our other concern was usability. We are Mac users and love beautiful and easy to use software. So we naturally wanted Boson to be like that. That’s why we put a lot of effort into the user interface conception and design to support many unique Mac OS X features. For example Boson understands multi touch gestures like pinch to zoom and supports inertial scrolling.

We hope you will be delighted using Boson!

The Basics

The Editing Window

  1. Wave View

    This is where most of the action happens. Boson renders an audio signal’s graphical representation in this view. This simply is a representation of the signal’s volume at a given time. The higher the spike the louder the sound is.

    Single-clicking on the Wave View will set the cursor position to the clicked location and deselect all active selections. Double clicking will select the currently visible portion of the document.

    You can use your mouse’s scroll wheel to zoom in and out (by scrolling up/down) or to scroll through the document by holding shift and scrolling up/down.

    If your Mac has a touchpad you can zoom by using the two finder scroll gesture or by using the pinch zoom gesture. To scroll with a touchpad just two-finger scroll to the left/right.

    Selecting works as expected: Hold down the left mouse button and drag the mouse around.

  2. Toolbar

    The toolbar contains shortcuts to often used effects and functions like cut/copy/paste or amplify. To find out what each button stands for hover over it and wait till a tooltip will pop up.

  3. Time Line

    The numbers correspond to time code locations in the edited document. In the screenshot above you can see that the cursor (4) is located at ~02:08 minutes.

  4. Cursor

    The Cursor indicates the current playback/recording position within the document. You can move the cursor by left-clicking anywhere in the wave view. (This is disabled during recording for obvious reasons.)

    Generators, pasting, playback, etc. always are applied to the cursor’s location. So if you place the cursor at 05:00 minutes and generate 10 seconds of silence those 10 seconds silence will be inserted at 05:00.

  5. Transport Area

    These are standard transport buttons you know from iTunes and co. Pressing the red circle ‘record’ button will start audio recording. Pressing the play button will start playback and with the prev/next buttons you can move the cursor around. (The cursor snaps then to the vertical grid lines in the wave view).

    To the right and left of the transport area are VU bars. During recording these bars display the current input audio level and during playback the output level is shown.

  6. Mini Map

    The mini map always displays the whole document. The map is handy to orient yourself when the wave view is zoomed in as it highlights the range which is currently shown by the wave view and has its own cursor position indicator.

  7. Info Display

    In the info display’s upper section you can see the current document’s file name. Right-clicking on it will pop up a menu where you can chose to display the document in Finder.

    The numbers below the file name represent the current playback/recording position.

  8. Audio Channel

    As you can see there are two wave forms displayed. This happens when you edit a stereo audio file. The upper wave form represents the left audio channel and the lower wave form represents the right audio channel.

    You can limit selections to each channel by dragging near the outer edge of a channel. If you drag near the inner edge the selection will contain both channels.

  9. Info Label

    The Info Label displays either the document’s total length or if there’s a selection it displays the selection’s parameters (location and length).

    Right next to the label is an eye shaped button. Pressing this button results in the wave view zooming out/in to display the selected range.

    Next to the eye button is a blue “info” button. You can click it do display general information about the document and also edit its metadata (title, artist, etc).

  10. Device Selector (A)

    Clicking this speaker shaped button will open a popup which allows to change the current input and output device.

    There’s also a volume slider which changes the playback volume. (This slider has no influence on actual document data but only affects the playback volume. To change the document’s levels use “Edit” -> “Amplify”!)

Basics of Audio Editing

Audio editors conceptually work similar to text editors. The cursor is regarded as the insertion point. Operations like record or paste always take place at the cursor location. Other operations like effects, delete or copy are applied to selected ranges.

To move the cursor just click inside the wave view. You can also specify the location more accurately by going to the “Transport” menu and choosing “Go to Custom Location”.

Selecting a certain range again is similar to a text editor: Click and drag inside the wave view to select a range. The selected range will be highlighted. There’s also a “Select Custom Range” command in the “Edit” menu for more accurate selection.

Boson has some advanced selection features: For example you’re not limited to having just one selection at a time. You can have multiple selections. To add a selection just press the CMD key while you drag inside the wave view. You then can apply effects to those selections at once. For example you could select from 05:00 to 05:10 and from 06:00 to 06:15 and apply the ‘reverse’ effect. This would result in only the selected ranges being reversed and the rest of the document would stay unchanged.

Please note that copy and paste works only with one active selection. You can’t copy multiple selections. (Though this is supposed to change in a future update).

Contrary to other audio editors selections in Boson are not limited to always selecting all channels at once. You can select just the left channel or just the right one. To achieve this just drag at the outer edge of the channel area you want to select. If you drag on the inner edge both channels will be selected.

Existing selections can be altered. If you hover over a selection’s left or right edge you can click and drag to resize the selection. (The mouse will change to a resize cursor to notify you of this option). Also pressing the shift key while left-clicking inside the wave view will extend the active selection.

Of course there’s the possibility to undo and redo any changes you perform. So feel free to experiment. (Don’t forget: There’s no right or wrong - if it sounds good it is good.)

Files and Documents

Creating Empty Documents

Creating a new empty document possibly is the easiest part of Boson. Simply select “New” from the “File” menu and you’re ready to go. Boson will create a new empty document with the format specified in the Boson settings panel.

If you need a specific document format select “File” -> “New with parameters” and enter the desired sample rate, bit depth and channel layout.

Opening Documents

Opening an audio file with Boson is straight forward. Either drag and drop the file onto Boson’s icon in the dock, use the Finder’s “Open With…” function or in Boson select “File” -> “Open”.

Saving Documents

If you’re pleased with your work you’re going to want to save it. Luckily saving is pretty simple, too. Select “Save” from the “File” menu and Boson will save the changes you made to the original document. If you don’t want to change the original file but save your changes to a new file select “Save As…” from the “File” menu and chose a new location to save the document to.

You should also use “Save As…” whenever you want to change the file’s format. For example if you want to save a OGG file as a MP3 file select “Save As…” and chose the MP3 format from the file format dropdown in the save as dialog.

Please be very careful when you use “Save” as the original file will be overwritten. And once you close the document in Boson there will be no way to undo this!

Importing Audio Files

You can also open multiple files in one Boson document. Just use the “File” -> “Import” menu item and the file you select for opening will be inserted at the cursor’s location in the current document. You can use this method to stich multiple single audio files together.

Recording

Boson is not just an audio editor but also a full blown audio recorder. You can record from any audio device that is recognized by OS X.

Recording Audio from the built-in Microphone

Most Macs come with a built in microphone. Usually this mic is used for Facetime or Skype. But it can also be used to create recordings in Boson.

Usually the built in mic is pre-selected as the system’s default audio input device. So all you have to do is to press the red “Record” button in Boson’s transport area. Boson will start and keep recording until you press either the Pause, Stop or Record button to stop recording.

During recording the blue VU bars at the bottom of Boson’s editor window display the incoming audio level. You should try to keep it at mostly –3 db. (You can adjust the microphone’s sensitive in the System Preference’s “Sound” panel).

If the VU bars don’t move even though you’re speaking into the mic possibly a different audio device has been selected for input. In this case just click the speaker icon in the top right corner of Boson’s editor window (not to be confused with the OS X speaker icon in the menu bar!) and select “Built-In Microphone” under “Input Devices”.

Selecting the Built-In Microphone as the input device

Everything should work now. If not visit the System Settings and adjust the microphone’s input sensitivity.

Recording Audio from external Audio Devices

While the built in microphone is great for quick voice memos its recording quality usually isn’t good enough for more “professional” applications like recording podcasts or singing or recording an instrument.

For that the market offers a plethora of inexpensive external USB audio devices. From “sound cards” that offer 3.5mm jacks to USB microphones like the Yeti Blue to more expensive professional mixing devices there’s a tool for every imaginable purpose.

The home user can achieve great results with inexpensive USB sound cards and USB microphones. In the price range from $30 to $100 there’s many products to choose from. And as long as they come with OS X support Boson can make use of them.

If you want to record a podcast or someone playing an instrument we would strongly recommend a Yeti Blue USB microphone. For the price of ~$100 you get absurdly great quality that is only matched by far more expensive professional gear.

If you want to digitize tapes you can use virtually any USB sound card that offers the right input jacks (usually 3.5mm or Chinch).

For digitizing Vinyls you will need a special pre-amp that will cost between $30 and $50. You could get away with a normal USB sound card but you would have to invest more time in mastering and adjusting the recordings.

Once you have your USB audio device connected to your Mac and installed all drivers (make sure the system recognizes the device via the System Setting’s sound panel) recording from that device is straight forward: First select the device as the input source by clicking on Boson’s speaker button in the upper right corner. Then just press the “record” button. Voila.

Recording Audio from other Applications

Sometimes you want to record something that’s in your computer. Like a Skype call or a Youtube video.

Though this is not as straight forward as recording from the microphone or a USB device it’s still manageable and needs ~10 minutes of one time setup. The idea is to route the system’s audio through a virtual audio device, record the audio and forward it to your speakers. Don’t fear, it’s really simple!

First you will need to download and install a software tool called “Soundflower”. You can get it either through searching on the internet or directly from our website at: http://gedanum.eu/download/soundflower_2.0b2.zip

Once you downloaded and installed Soundflower you will need to create an aggregate audio device using OS X’s built in “Audio Midi Setup” application:

After you have successfully installed Soundflower start Audio Midi Setup which is an OS X system tool that lets you create virtual audio devices by combining several real devices into one virtual device. It’s located in /Applications/Utilities/Audio Midi Setup.app

Now you have to create a “Multi-Output Device”. This is necessary because otherwise you wouldn’t be able to hear any audio playing through your speakers while you record.

To create this “Multi-Output” Device click onto the little Plus Icon in the lower left corner of the Audio Midi Setup Window and select “Create Multi-Output Device”. Activate the checkboxes for “Soundflower (2ch)” and your sound card in the right part of the window.

Creating the Multi-Output Device in AudioMidiSetup.app

Once the device is created you will have to set it as the default output device. To do this open System Preferences, select the Sound panel and select the “Multi-Output Device” as the default output device. (Don’t forget to set your Mac’s volume to 100% before switching to the Multi-Output device!)

Setting the Multi-Output Device as the default output device in System Preferences' Sound Panel

In Boson select “Soundflower (2ch)” as the recording device by clicking on the speaker icon in the editor window’s upper right corner and selecting “Soundflower (2ch)” under “Input Devices”.

Now whenever any app on your Mac plays audio it can be recorded by Boson.

(You should restart the apps you want to record to make sure they use this new device. Also don’t forget check if the app you want to record from has an option to select an audio device for output.)

Effects

Applying Effects

To apply effects you will have first to select some audio. Then select the effect you want to apply from the ‘Effects’ menu. Some effects (like convert to stereo/mono) will ignore your selection and be applied to the whole file.

If an effect has options (like generate silence) a dialog will pop up where you will be able to alter some effect settings.

All effects can be undone/redone using “Edit->Undo/Redo” and most effects have live preview so feel free to experiment. There’s no right or wrong with effects - what sounds good is good!

Built-in Effects

These are the most important built in effects that come with Boson. This list is not extensive as we’re adding new effects with every update.

Effect Rack

With the Effect Rack you can chain multiple effects before applying them. You can turn on/off each effect, change the effect settings, add new effects, remove them - all that while being able to hear a live preview of how the result will sound.

The Effect Rack is accessible via the “Effects -> Effect Rack…” menu item. Selecting this item will open an empty Effect Rack. You can then add effects by either double clicking the effect entry in the upper list (“Available Audio Units”) or simply by using Boson’s’ “Effects” menu.

Once you have added an effect to the rack it will show up in the lower list (“Audio Units to be applied”). By double clicking on the entry you can open the Audio Unit’s user interface to change its settings. The same can be acheived via the “Edit” button. (You can close the effect’s UI and re-open it later. The settings will be kept as long as you don’t remove the effect from the rack or close the rack).

Note: You can add the same effect multiple times without any problems! A chain of 5 “Distortion” effects each with its own settings is possible.

If you’re not sure if you want to keep the effect you can temporarily disable it by pressing the “on/off” button to the left of the effect’s name. And if you really want to remove the effect you can use the “Remove” button.

An effect’s’ position in the chain can be changed by dragging it around with the mouse. (Just like you drag files in Finder, etc). Just click and hold the effect’s name and move it into the desired position. As the order of effects in the effect chain is significant this is an important feature. (More about that later).

In the lower area of the Effect Rack panel you will find to the left three playback control buttons and to the right a “Cancel” and an “Apply” button. Pressing “Cancel” will clear the rack and close it. Your audio document will not be changed. If you press “Apply” on the other hand the effect rack will be applied to the document.

Effect Rack application follows a few simple rules:

  1. Only Effects that are “on” (the on button is blue) are applied to the document.
  2. The effects are applied in the order from top to bottom.
  3. The effects are conceptually ordered in a chain: The first effect in the list gets fed the raw audio data. Then its output is taken and fed into the second effect and so on until there’s no more effect in the chain. The last effect’s output is written to the document. This makes the order in which you add effects significant: “Distortion -> Reverb” will lead to a different result than “Reverb -> Distortion”!
  4. The effect chain is applied only to the selected parts of your document. So make sure you have the right parts selected. If you want to apply the effect rack to the whole document either select the whole document or remove all selections. (No selections = application to the whole document).
  5. Once the Efffect Rack has been closed its state can not be restored. You will have to re-build the effect chain from scratch. So make extensive use of the live preview feature! (We are planning to let you save & restore effect chains in a future update.)

Third Party Effects (Audio Units)

With version 1.3 Boson fully supports third party Audio Unit plugins. You can load any 64bit Audio Unit that is installed on your Mac. The only type that currently is not supported are Audio Unit Instruments and Mixers (which aren’t really useful for single track audio editing anyway).

You can access your Audio Units via the “Effects -> Audio Units” menu. The plugins are sorted by manufacturer. When you decide to load a plugin for the first time in a Boson session you will be asked to lower your security settings. Click on the “Lower Security Settings” button to load the Audio Unit. Please note that this lowering of settings is needed as otherwise the Mac sandbox which Boson runs in wouldn’t allow to load foreign code (the plugin) into Boson.

If you can’t find a plugin please make sure that:

If an Audio Unit causes crashes or causes other problems please make sure that it works with other applications before contacting us. We can not offer any support for 3rd Party Units. Please contact us only about issues with AUs if you are certain that Boson is the cause of the problems. (Of course reports about not working/loading AUs are welcome. We’ll look into it and try to improve compatibility).

Note: If you don’t know where to get free Audio Units you can click on the ’Effects -> Audio Units -> Download Free Effects" menu item to get a list of Audio Units available for free.

Settings Panel

General Settings

Help & Support Settings

Recipes / Cookbook

Recipes are step by step instructions for most commonly performed tasks with Boson.

Creating a voice memo

  1. Create a new Boson document by selecting “New” from the “File” menu
  2. Click on the speaker icon in the editing window’s upper right corner
  3. Make sure that “Built-In microphone” is selected under “Input Devices”
  4. Press the record button and start speaking
  5. When done press the stop button

Correcting audio levels of a quiet/loud recording

  1. Select the too quiet/loud section (or don’t select anything to correct the whole document)
  2. Select “Normalize” from the “Effects” menu
  3. Move the slider to –3db
  4. Click on “Apply”

Removing unwanted parts from an recording

  1. Locate and select the unwanted parts
  2. Select “Delete” from the “Edit” menu
  3. Alternatively you can select “Silence Selection” from the “Effects” menu if you don’t want to change the document’s length

Recording from YouTube (or any other website/application)

  1. Make sure Soundflower is installed and set up properly (See Recording Audio from other Applications for instructions)
  2. Open the system preferences and select “Sound”
  3. Go to the “Output” tab and select “Multi-Output Device” as the default output device
  4. Switch to Boson and create a new document by selecting “New” from the “File” menu
  5. Click on Boson’s speaker icon and select “Soundflower (2ch)” as the input device
  6. Click on the record button to start recording
  7. Switch to Safari and play the youtube video you want to recrod
  8. If recording doesn’t work at first make sure to quit and re-start Safari
  9. If recording still doesn’t work make sure you have set up Soundflower correctly and assigned the correct input and output devices as described in Recording Audio from other Applications

Converting an OGG file to MP3

  1. Open the OGG file with Boson by selecting “Open” from the “File” menu
  2. Select “Save As…” from the “File” menu
  3. In the upper left format drop down select “MPEG–2 Audio Layer III (.mp3)”
  4. Fill in meta tags if neccessary
  5. Click on “OK” and select a location to save the MP3 file
    Save As MP3

Creating an iPhone ringtone

iPhone ringtones are normal M4A files with a .m4r file extension and a maximum length of approx. 40 seconds. Let’s create one of these!

  1. Open a song or record something you want to use as your ring tone
  2. Locate and select a section of the file to be used as the ringtone.
  3. If the section is longer than 40 seconds select it and from the “Edit” menu select “Crop”.
  4. Now select “Save As..” from the “File” menu
  5. Select “MPEG–4 Part 14 (.m4a)” from the Output File Format dropdown
  6. Make sure that “Show output file in Finder after export.” is checked
    Select the right format!
  7. Click on the OK button and select a save location
  8. Before pressing the “Save” button change the file’s extension from .m4a to .m4a in the filename text field
    Dont forget to change the files extension!
  9. After the export completes Boson will select the exported file in Finder
  10. If you didnt’t change the file extension to .m4r in the save dialog you will have to do this now in Finder.
  11. Send the file to your iPhone and enjoy your new ringtone

Adding an eerie ghostly effect to a voice recording

  1. Create a voice recording (say something - this effect is best with spoken words)
  2. From “Effects” menu select “Reverse”
  3. Now from “Effects” menu select “Matrix Reverb”
  4. Select the “Large Room 2” preset from the top dropdown and click “Apply”
  5. Select “Reverse” from the “Effects” menu
  6. Play it back.
  7. Try out this recipe with different Matrix Reverb presets

Digitizing an analogue tape

  1. Acquire and set up an external USB sound card. (Using your Mac’s Line-In port won’t work as these are usually not pre-amped and the recorded signal would be far too faint).
  2. Connect the tape deck via a Chinch or 3.5mm cable to the sound card’s input jack.
  3. Create a new document in Boson.
  4. Select the USB device as the input source by clicking on Boson’s speaker icon and selecting the correct device under “Input Devices”.
  5. In Boson press the record button.
  6. Press play on your tape deck.
  7. Adjust the tape deck’s output volume so that the loudest peaks are at around –3db.
  8. After you adjusted the output volume rewind your tape back to the beginning.
  9. Press stop in Boson and go to “Edit” menu and select “Undo”.
  10. Now press the record button in Boson and the play button on your tape deck.
  11. When done press stop.
  12. Now go to “Edit” and select “Normalize”. Move the slider to –3db and press “Apply”.

FAQ

How can I improve recording quality?

The only surefire way to improve quality is to improve the source signal. If you’re using a bad headset to record your memoirs no amount of editing and mastering will make the recording sound good.

So if you’re serious about producing great sounding results consider investing into a good microphone. (The Yeti Blue is a great bargain at ~$100 which offers quality usually found only in more expensive pro microphones).

Recording is draining too much battery power. What can I do?

Go to the “View” menu and make sure “Update WaveView during recording” is unchecked. If this setting is off then Boson won’t waste any power on updating the wave view during recording. Which results in around 80% less battery power drained.

I’m trying to open a file that is not supported. What can I do?

First try to convert it with another application into a file format that is supported by Boson. If that doesn’t work or you can’t find an app to convert then drop us an email and we will try to help you.

When I convert a document to mono the right channel just gets dropped? Why?

This works as intended. Boson just drops the right channel and keeps only data from the left channel. If you want to keep data from both channels use “Convert To Mono [Mixdown]” (see also next question).

How to correctly convert a file to mono?

If you want to keep data from both channels when converting to mono you will have to use the [Mixdown] version of “Convert To Mono”. Also after conversion you usually will want to apply the “Normalize” effect to the document because [Mixdown] simply adds both sample values. So if you mix two samples with values 0.8 and 1.0 the result will be one sample with the value of 1.8. Which is outside max volume (1.0). Normalizing the audio will fix this.

Boson can’t opern some M4P files. Why?

M4P files usually are DRM protected by Apple and can only be read by iTunes. Sadly it’s not possible (nor legal) for us to include a feature to read such files. As a workaround you could try to record the audio from iTunes via Soundflower. See Recipe 3 for how to achieve this.

Which Sample Rate should I generally use?

44.1 kHz

44.1 kHz (44100 Hz) is the sampling rate of audio CDs giving a 20 kHz maximum frequency. 20 kHz is the highest frequency generally audible by humans, so making 44.1 kHz the logical choice for most audio material. High quality tape decks using metal tape, and medium quality LP equipment can reproduce 20 kHz (higher for top quality LP equipment, though some of this is harmonic distortion inherent in the medium). Note that the upper limit of human hearing falls rapidly with age. While people in their teens can hear 20 kHz, many older people cannot hear above 14.5kHz.

48 kHz

48 kHz (48000 Hz) is the sample rate used for DVDs so if you are creating DVD audio discs from your Boson projects you may prefer to work with this setting.

What’s the trade off when using a high sampling rate?

The sampling rate determines how many digital samples of audio are stored per second. So a 48khz sampling rate means that Boson stores 48000 samples per second of audio (per channel). Using a significantly higher sampling rate increases this amount. While 192khz for example is something modern Macs can cope with it uses 4 times as much data per second as 48khz. So your audio documents get 4 times bigger and your Mac has 4 times more work to do to process the audio when you edit the document.

Example calculation for a stereo document:

sample rate * byte per sample * channels = data per second of audio  
48khz:   48000 * 4 * 2 = 384 KB/s.  
192khz: 192000 * 4 * 2 = 1536 KB/s = 1.5 MB/s.  
384khz: 384000 * 4 * 2 = 3072 KB/s = 3.0 MB/s.

Most users won’t need a higher sampling rate than 48khz so you should have very good reasons to work with higher sampling rates!

How do I correctly set the sample rate?

Because of how OS X handles audio hardware Boson can not physically set the audio hardware to use the current document’s sampling rate. Rather during recording/playbeack the audio stream gets converted on the fly to the document’s sample rate if both sample rates don’t match.

So once you have decided which sample rate you want to use for your work you should set this sample rate in the OS X “Audio MIDI Setup.app” which you can find in /Applications/Utilities.

Open the utility, select your audio device in the left hand list and set the appropriate sample rate in the input and output tabs. (See screen shot).


Setting a device’s native sample rate …

Once you have done this there will be no resampling performed if the Boson Document’s sample rate matches your audio device’s rate.

Support

You can contact us 24 hours a day over at: support@gedanum.eu

I have read the manual and still need help!

Don’t panic! ;) We’re here to help you out. Just drop us an email and describe what problems you have with Boson. We’ll try our best to help you! (Please mention what Mac you use, which version of OS X is installed and what version of Boson you’re running).

About leaving reviews.

If you like Boson please leave us an review in the App Store. This helps us tremendously! And if you don’t like Boson just contact us and tell us what you don’t like about it. (We can’t answer to App Store reviews so please write us first!).

Thanks for using Boson and have fun!