SPLAddonGuide

Joseph Lee edited this page Dec 29, 2016 · 8 revisions

StationPlaylist Studio Add-on Guide

Revision: January 2017 for SPL Studio add-on 17.01/15.5-LTS

Author: Joseph Lee

Introduction

Thank you for choosing Station Playlist Studio add-on for NVDA. This add-on guide is designed to get you started using SPL Studio with NVDA.

If you are new to NVDA, consult the NVDA user guide to familiarize yourself with how NVDA works and commands. If you are new to SPL Studio, please read the SPL Studio user guide that comes with the program to get to know various operations available in SPL Studio.

About the add-on and this guide

The add-on and this guide is shaped by you, the NvDA users around the world. If you wish to suggest features, report bugs or want to say hi, please use the contact information at the end of this document to contact the author.

Note: The features and commands described in this guide may change as new add-on versions are released.

What is StationPlaylist Studio

StationPlaylist Studio (oftened shortened to SPL or just Studio) is a radio broadcasting software which assists broadcasters with streaming live or recorded shows over the internet. In addition to live shows, SPL Studio assists a station with playback of songs around the clock, playing jingles at specific times and more.

What does the SPL Studio add-on do

The SPL Studio add-on for NvDA contains following features:

  • Announcing toggle states of various controls such as automation.
  • Ability to obtain playback and other status information from within SPL Studio.
  • Ability to configure status announcement verbosity.
  • announcing playback time such as remaining time for the current track.
  • Managing SPL Studio functions from other programs.
  • Announcement of when the end of track and song intros are approaching.
  • A handy alarm to let you know your microphone has been turned on for a while.
  • A central configuration dialog to configure various add-on settings.
  • Customize NVDA's behavior on a per show basis via broadcast profiles.
  • Switch between broadcast profiles instantly or let NvDA activate a specific profile before a show begins.
  • Ability to switch to SPL Studio from any program.
  • A dedicated mode to learn cart machine assignments.
  • Assisting with broadcasting via support for Spatial Audio's SAM encoder and StationPlaylist's own SPL encoder.

And so much more (some features are under development).

Add-on requirements and versions

Depending on the version of Studio you're using, you can choose between add-on versions 16.12 and 15.x. See the "differences" section below for a list of features not present in each version.

Version 15.0 LTS/16.10 and later

The SPL Studio add-on 16.10 and later requires the following:

  • An evaluation or a registered copy of Station Playlist Studio version 5.10 (5.00 for add-on 15.x) or later installed on a computer running Windows XP or later. If using Studio 5.10 or 5.11, use builds 43 and 13 or later, respectively.
  • NVDA 2016.1 (2015.3 for 15.x) or later. Certain functionality will require recent versions of NVDA.

Differences between 16.10 and 15.x

In addition to supporting different versions of Studio, add-on versions 16.10 and later and 15.x (termed LTS or long-term support releases) contain following differences:

  • In add-on 15.x, first six slots for Columns Explorer for Studio (see below) are reserved for Studio 5.0x columns, whereas this restriction is gone in add-on 16.10. Consequently, add-on 16.10 users can assign all ten slots to whichever column they wish to explore.
  • SPL Assistant, number row 7 through 0 are unavailable if you are using add-on 15.x with Studio 5.0x. Consequently, Control+NVDA+7 through 0 are unavailable in Studio 5.0x.
  • Track Dial is slated to be removed in 2017, whereas it'll remain fully functional in add-on 15.x. It's replacement, Columns Explorer and Column Navigator (Control+Alt+left/right arrow/home/end keys) are available in add-on 15.x LTS and later (including 16.x).
  • A warning dialog will be shown if you attempt to use add-on 16.x on a computer running Studio 5.0x. The first major add-on release for 2017 will drop support for Studio versions earlier than 5.10 completely.

Unless otherwise noted, the material in this guide also applies to 15.x LTS.

About version numbers

Until 2016, add-on versions were identified by major.minor. This has changed in late 2016 so versions are now identified by year.month.revision. For long-term support versions, year.month will correspond to the LTS release date (e.g. 16.10.4-lts).

Obtaining, installing and updating the add-on

To download the add-on, click the following link: Download SPL Studio add-on

Installing SPL Studio add-on

You can install the add-on in a number of ways:

  1. If you are using NVDA 2012.2 or later on your computer or if you are using a portable version of NVDA, go to NvDA menu, select Tools, then choose Manage Add-ons. From Add-ons Manager, select install, then navigate to the folder where you downloaded the add-on file. Press ENTER on the add-on file, and NVDA will ask if you wish to install the add-on. Once installation is complete, NVDA will ask you to restart NVDA for add-on to run.
  2. If you installed NVDA 2012.3 or later on your computer, using the file manager of your choice (Windows Explorer, for example), navigate to the folder where you downloaded the add-on file. Press ENTER, and NVDA will ask if you wish to install the add-on. Once installation is complete, NVDA will ask if you wish to restart NvDA for the add-on to run.

Notes:

  1. If you are upgrading from a prior version of this add-on, NVDA will ask if you still wish to install the add-on. Say Yes to continue.
  2. If you are upgrading from add-on versions prior to 2.0, remove the previous version first before installing 2.0 or later. This is not the case for users upgrading from 2.0 or later versions.
  3. To use touchscreen commands, you need to install NVDA 2012.3 or later on a computer running Windows 8 or later.
  4. Once add-on 5.0 or later is installed, you cannot go back to an earlier version of the add-on, especially to a 4.x release.
  5. Downgrading from add-on 6.0 or later to an earlier version will cause broadcast profiles to be lost.
  6. You cannot go back to an earlier version of an add-on after installing add-on 7.0 or later due to configuration format change.
  7. If using NvDA 2016.1 and later, you need to disable audio ducking (NVDA+Shift+D), otherwise volume of audio from Studio will be lowered each time NVDA speaks. A reminder dialog will be shown after installing add-on 6.3 or later (you can tell NVDA to suppress this reminder dialog).
  8. Installing the add-on on a computer running an unsupported version of Studio is not supported.

Updating Studio add-on

From time to time, the add-on receives updates that include new and changed features, bug fixes and so on. You can easily update to newer add-on releases by pressing SPL Assistant, Control+Shift+U (first assign a command to enter SPL Assistant layer). Alternatively, NVDA can check for add-on updates automatically. When the add-on tells you that an update is available, say yes so your default web browser can prompt you to open or save the add-on installer.

Note: You cannot use this feature to update between add-on branches. If you wish to do this (say, going from stable version to a development version), you need to install the desired version manually. Also, if using development snapshots, one way to tell add-on revision is the date when the add-on was released, which is displayed alongside the version text (e.g. 7.0-dev (2016-01-14).

Welcome dialog

When you start Studio after installing the add-on, a welcome dialog will be presented, giving you essential information about the add-on and basic concepts. After dismissing this dialog, from Studio window, press Alt+NVDA+F1 to reopen this dialog.

Using SPl Studio with NVDA

This section describes features available when using SPL Studio with the included add-on.

About add-on commands

You can use many of the native SPL Studio commands to control the program. In addition, NVDA provides additional commands (including layer commands) to read status information and to control SPL Studio from anywhere. In addition, a dedicated touchscreen mode for Studio called "SPL mode" is available on touchscreen computers to perform touch gestures.

The layer commands

NVDA provides two layer command sets when using Studio for various tasks and to announce status information:

  • SPL Assistant: this layer set, available from within SPL Studio, allows you to obtain various SPL status information such as whether a track is playing, automation status and so on.
  • SPL Controller: this command set, available everywhere, allows you to control SPL Studio from anywhere, including playing the next track and turning microphone on and off.

We'll meet these layer commands and how to use them throughout this guide.

Note: Starting with add-on version 2.0, the layer commands are not assigned so you can assign your own commands. So whenever you see SPL Assistant or SPL Controller, substitute your command (e.g. if you have assigned NVDA+grave accent for SPL Controller, press NvDA+Grave to access SPL Controller layer).

Track playlist

When you start or switch to SPL Studio, you'll be placed in the track playlist. This is a list of tracks you have added to be played via Studio. On top of the track listings is an hour marker to tell you the tracks you have added for this hour.

For each trakc in the playlist, a selector (checkbox for Studio 5.01 and earlier, check mark for Studio 5.10 and later) is available to select tracks for playback. As you select tracks in the playlist, Studio will show the total length of the playlist, useful if you wish to know if the selected track fills the current hour slot.

If you press NvDA+Up Arrow (not the numpad up arrow) or NvDA+Tab, NVDA will tell you the track information such as duration, artist, whether the track is selected for playback and so on. You can also let NvDA play a beep to indicate the track category, and when you reach top or bottom of the playlist, NVDA will play a beep to let you know of this fact. You can configure these behaviors from add-on settings.

Note: If you are using Studio 5.10 and later, tell Studio to use accessibility mode from options dialog's advanced tab.

Track playback controlls within Studio window

You can use native SPL Studio commands to control track playback. Here is a list of the commands:

  • ENTER or P: play the selected track.
  • U: Pause or continue playing the track.
  • S: Stop track with fade out.
  • T: Instant stop.
  • Alt+Down arrow: Skip to next track.

From Studio window, to see if a track is playing, press the SPL Assistant command. NvDA will play a beep. Then press P, and NVDA will announce if the track is playing or stopped.

Reviewing information about a track with Track Dial

Visually, the playlist viewer is shown as a table. Each row corresponds to track entries and various information about a track (called tags) is arranged into columns (6 for Studio 5.01 and earlier, 18 for Studio 5.10 and later). To help you review these columns, NVDA provides Track Dial mode where you can use arrow keys to navigate between columns.

If you wish to review individual columns for the track entry, press the command you assigned for toggling Track Dial. Alternatively, open SPL Settings dialog and check Track Dial Mode. When you toggle Track Dial by pressing the shortcut key while status announcement is set to beeps (see below), a high beep will confirm that Track Dial has been enabled, and a lower beep will tell you when it is off.

While in this mode, pressing left and right arrow keys will let you review each column and its content such as artist, duration, category and so on, similar to flipping volume dial on a radio. A beep will be heard when you reach the edge of the track item row. When you are done reviewing columns, press the Track Dial toggle command to turn Track Dial off. Track Dial setting is permanent.

Note: In Track Dial mode, you cannot use up and down arrow keys to move to the column above or below the currently reviewing column. However, NVDA will remember which column you were browsing so you can use left and right arrow keys to review surrounding columns. Also, when entering Track Dial, NVDA will announce which column you were reviewing last (except for the leftmost column).

Columns Explorer

Another way to review track columns is telling NVDA which columns you'd like to obtain information from. This is called Columns Explorer and is activated when you press SPL Assistant, followed by a key from the number row (more on SPL Assistant layer below). Alternatively, press Control+NVDA+number row commands to review data for individual columns.

By default, the following columns or slots are defined:

  1. Artist.
  2. Title
  3. Duration
  4. Intro
  5. Category
  6. Filename

Notice that these are the columns shown when using Studio 5.01 and earlier. For Studio 5.10 and later, slots 7 through 10 (0 key) announces year, album, genre and time scheduled columns.

To configure column slots, open add-on settings, then select Columns Explorer. You'll be greeted with ten combo boxes (one per column slot) where you can select columns you'd like to explore when SPL Assistant, number keys are pressed. If you are using Studio 5.0x with add-on 15.x installed, you'll see six combo boxes instead.

Customizing column announcements

By default, NVDA will announce all available information about a track. However, you can ask NVDA to not announce certain columns or change column announcement order.

To customize column order or exclude certain columns from being announced, open add-on settings, then uncheck "use screen order" checkbox. Then select "Manage column announcements". The controls in this dialog are:

  • Column checkboxes: Check the boxes to let NvDA announce the selected column, or uncheck them to suppress announcement of unchecked columns.
  • Column order: This list shows column announcement order. Use move up/down buttons to change column order.

After configuring column order or announcement, select OK, then select OK from the main settings dialog.

Notes:

  1. To return to default behavior, from add-on settings, check "Use screen order". Artist and title are always announced.
  2. For studio 5.0x users, you can reorder artist, title, duration, intro, category and filename columns, while users of Studio 5.10 can reoder other columns in addition to these six.

Track comments

In case you receive a request from someone and need to write it down, you can use track comments feature to add, change, review or remove comments (notes) for tracks. As you move through tracks, you may hear NvDA say, "has comment" or play a beep to indicate existence of a track comment for the selected track. Press Alt+NVDA+C to let NVDA announce track comments if any, or press it twice to copy track comment to clipboard so you can review it from somewhere.

To add a track comment, press Alt+NVDA+C three times. Type your comment and press ENTER. Leaving the track comment empty will remove track comments.

Note: You cannot add track comments to hour markers, break notes and other such tracks.

Playlist and time information

As you work with SPL Studio, the following commands are available to obtain various information about current playlist and the currently playing track:

  • Alt+Shift+T: announces elapsed time for the currently playing trakc.
  • Control+Alt+T: Announces the remaining time for the currently playing track.
  • NVDA+Shift+F12: Announces broadcaster time (time as reported by Studio such as 5 minutes to 2).
  • SPL Assistant, H: Announces the duration of the playlist for the hour slot.
  • SPL Assistant, Shift+H: Announces remaining track duration for the current hour slot.
  • SPL Assistant, P: Announces whether a track is playing.
  • SPL Assistant, C: Announces the title of the currently playing track.
  • SPL Assistant, N: Announces name and duration of the next track if selected.
  • SPL Assistant, S: Announces the time when the selected track will be played (scheduled).
  • SPL Assistant, Shift+S: Announces length of time before the current track will play (i.e. starts in; you should use this command about a second after moving to a new track).
  • SPL Assistant, D: Announces duration of the remaining tracks in the playlist (may become inaccurate (up to several seconds) for very long playlists).
  • SPL Assistant, Y: Announces whether the currently loaded playlist has been modified.

In addition, you can assign a command via NVDA's Input Gestures dialog to announce time in hours, minutes and seconds as reported by Studio.

Setting options and announcing option status

Besides track and time information, NVDA allows you to use native Studio commands to change various options such as microphone on or off, automation and so on. As you change these options, NvDA will announce new values either as words or beeps. To change these options, use the SPL commands as follows:

  • A: Toggle automation.
  • L: Line-in.
  • M: Microphone on/off.
  • N: Microphone on/off without fade.
  • R: Enable or disable record to file.
  • Control+T: Cart edit/insert mode on or off. If status message is set to beeps and if cart insert mode is active, you will hear "insert" when you press this command and status changes to cart insert mode on.

To announce current values for these options, enter SPL Assistant layer, then press the corresponding native command from the list above (except where noted). For example, to hear if automation is enabled, enter SPL Assistant then press A.

Additional commands and exceptions for SPL Assistant layer include:

  • U: Studio up time.
  • T: Cart edit/insert mode status. To change cart edit mode status, press Control+T (Control+T is a native SPL command).
  • I: Listener count (I as in "Internet listeners").
  • Control+K: Drop a place marker on the selected track.
  • K: Move to a predefined marker track. See place marker section for more details.
  • Shift+P: Pitch for the current track.
  • Shift+R: Report library scan results (number of items scanned) or track current library scan in the background.
  • W: Weather and temperature (see below).
  • F1: Shows a dialog listing available layer commands.
  • Shift+F1: Opens the online user guide using the default web browser.
  • F9: Mark the start of track time analysis.
  • F10: Performs track time analysis. See track time analysis section for more details.
  • F12: Switches between current and an instant switch profile. See instant switch profile section for more details.

Note: When the microphone is turned on with or without fade, pressing M from SPL Assistant will tell you the current microphone status.

SPL Assistant command layout

NVDA isn't the only screen reader with scripts for Studio. There are scripts for JAWS for Windows and Window-Eyes that provides similar functionality to NVDA add-on.

The SPL Assistant layer commands described throughout this guide are the default commands when the add-on is first installed. You can change layer command compatibility by going to Advanced Settings in add-on settings dialog. See the section on advanced settings for details and commands used when compatibility mode is active.

Status announcements

Sometimes, you might find that NVDA might be too verbose when announcing status information such as toggling automation from the main playlist window. You can ask NVDA to play beeps instead of announcing status for these options while toggling them.

To change this (which will become permanent), open SPL add-on settings and select Beep for status announcements checkbox. When you change status announcements to beeps, NvDA will play beeps to indicate events such as toggling microphone, end of track announcements and so on. These settings will also work if you are using SPL Controller to toggle Studio options (see below).

Message verbosity

When status such as automation changes, you may not wish to hear the complete announcement. If you would like to hear just enough information, you can change message verbosity from add-on settings dialog.

There are two verbosity levels to choose from:

  • Beginner: Gives you more verbose information such as which status has changed. For example, when you press A from playlist viewer, you will hear "Automation On/Automation Off".
  • Advanced: Announces just enough information to let you know something has changed. For example, press A from playlist viewer to hear NvDA say "On" or "Off". In this case, you'll know that you've changed automation status.

Note: If you set status announcement to beeps, you'll hear a longer tone when verbosity is set to beginner, and a short tone will be played otherwise (exceptions include microphone alarm). Also, cart edit/insert mode toggle isn't affected.

Track time alarms

You can ask NVDA to either play a beep, announce a warning or do both when end of track (outro) or intro is approaching. By default, NVDA will play a beep when five seconds are left on the outro and intro, respectively.

To adjust the alarm value or to disable them, press Alt+NVDA+1 or Alt+NVDA+2 to open end of track or song intro alarm dialogs, respectively. From here you can adjust:

  • Alarm value: adjust the alarm value by using the arrow keys or entering the new value. Depending on the alarm type, you can adjust the value between 1 and maximum (59 for end of track, 9 for song intro).
  • Enable/disable alarms: check the box to have NVDA notify you when end of track or song intro are approaching (check to enable).

Note: these options can be found in add-on settings dialog. Values entered into the alarm dialogs and/or add-on settings dialog will be saved. Also, when you uncheck alarm notification checkboxes from add-on settings dialog, the alarm entry field(s) will not appear.

Braille Timer

If you are using a braille display, you can ask NVDA to display remaining time for the track and/or its intro on a braille display. Press Control+Shift+X to step through braille timer options. Alternatively, select the desired option from the add-on configuration's braille timer combo box. You can choose from braille timer off (default), braille track endings, braille intro times or braille both track endings and intro times. Note that you need to be in Studio window in order to see time on a braille display, and NVDA will remember this setting even when it restarts.

Track time analysis

If you are unsure as to length of time required to play selected tracks, you can ask NVDA to perform track time analysis. First, move to the starting track, then press SPL Assistant, F9. Then move to the last track and press SPL Assistant, F10. NVDA will announce number of tracks followed by total length of the selected tracks. Analysis can be performed even if you select tracks backwards (that is, if you wish to count total length of the tracks prior to the marked track).

Note: You can assign a custom command for time analysis (SPL Assistant, F10). Track time analysis will not work properly outside of playlist viewer.

Time range finder

If you need to fill an hour slot with a track, you can find one by using time range finder. To use this, first assign a command to open this dialog, which consists of two groups of edit spin boxes (minimum and maximum duration, respectively), with each group composed of two spin controls for minute and second. Once you define the duration range, press ENTER and NVDA will either place you on a track or tell you if there aren't any tracks with duration within the just defined range.

Track finder

If you are focused on the track list and wish to find a track (by artist name or by song title), you can use track finder to locate the desired track. To find tracks, press Control+NVDA+F (or SPL Assistant, F), then type the part of the name of the track. NvDA will locate the track with the given name, or if it cannot find it, will alert you that it cannot do so.

If you have searched for a track before, press NvDA+F3 to find forward or NVDA+Shift+F3 to find backward.

Note: Track search terms are case-sensitive.

Column Search

Track Finder is not limited to searching for artist or title. You can ask NVDA to find certain information from columns. To activate this, first assign a command to open column search, then press the newly assigned command to open Column Search dialog.

This dialog includes the following:

  • Search field: enter the information you wish to find in a column.
  • Columns: This combo box allows you to specify which column you wish to search for the entered information.

Note: Pressing NVDA+F3 or NVDA+Shift+F3 will continue to search artist and title.

Place marker track

There are times when you need to mark a track to return to after editing a playlist. NVDA allows you to define a track as a place marker track so you can return to it later.

To define a place marker track, press SPL Assistant, Control+K. NVDA will say, "place marker set". To return to the marked track, press SPL Assistant, K.

Note: You cannot set a breaknote or hour marker as place marker track, and if you delete the place marker track, place marker will be gone. Place marker commands will not work outside of playlist viewer.

Cart Explorer

SPL Studio allows you to assign up to 96 carts, or jingle machines. When the cart command is pressed, Studio plays the assigned jingle. You can also edit jingle assignments while cart edit mode is active.

The cart commands are:

  • F1 through F12 either by themselves, or in combination with Shift, Control or Alt (e.g. F2, Shift+F11, Control+F5, Alt+F12).
  • Number row from 1 through 9, 0, hyphen (-) and equals (=) either by themselves or in combination with Shift, Control or Alt (e.g. 5, Shift+-, Control+=, Alt+0). This set is unavailable in Studio Standard.

Hint: because Alt+F4 is a cart command, press Control+Alt+X to quit SPL Studio.

Note: The modifier assigns carts to "banks". There are four cart banks that comes with SPL Studio: main (without modifier), and one each for shift, control (CTRL) and alt. You can access each cart bank from the menu bar.

To help you learn what jingle will play when a given cart key is pressed, NVDA allows you to explore cart assignments. Press Alt+NVDA+3 to enter Cart Explorer. When you press the cart key once, NVDA will tell you which jingle is assigned to that cart key. When pressed twice, the jingle associated with the cart command will be played. Once you've explored the cart assignments, press Alt+NVDA+3 to leave Cart Explorer.

Hint: If you toggle cart edit mode or use cart insert mode, NVDA will remind you that Cart Explorer is active if this is such a case. Also, if you are using Studio Standard and press number row keys (with or without modifiers) while cart explorer is active, NVDA will alert you that the cart command is unavailable.

Note: Cart explorer will not operate properly if:

  1. Either you have custom names for your carts or saved your cart with a different name, or loaded other cart banks besides your own. Cart explorer will not pick up cart names for additional cart banks you insert into a cart bank (main, shift, control, alt). For example, if you have cart assignments for main cart bank and add cart entries from another user's main cart bank, cart explorer will not announce cart assignments from the added cart bank. For best results, do not load another cart bank apart from your own, or if you are the only user, do not add any other banks besides default user's cart banks.
  2. If one or more cart banks doesn't exist or your user name starts or ends with whitespace (" "). If this is the case, NvDA will report that some cart banks were not found and will not enter cart explorer.

Music Library scan

As your music collection grows, you might wish to teach Studio where it can find tracks for your shows. To help you with this, Studio has an option to remember where you've stored your music files. This can be access from Studio's options dialog under folder name section.

Once you've selected your music directory, Studio will scan the folder location for available tracks once you close the Options dialog. As the scan information is not available, NVDA will not be able to tell you when the scan is finished. Fortunately, you can use one of the following methods to monitor the current library scan: from insert tracks window or from anywhere.

You can monitor the progress of a library scan from Insert Tracks dialog (Control+I) by asking Studio to perform library scan by pressing Control+Shift+R. As the tracks are being scanned and depending on scan announcement setting (see below), NVDA will tell you the progress of the library scan. Alternativley, once you tell Studio to scan your music library, after closing the Options dialog, enter SPL Assistant, then press Shift+R to monitor the library scan in the background. NVDA will periodically announce "scanning" followed by number of items scanned. Once the process is complete, NVDA will announce total number of items scanned.

To toggle library scan announcement options while scanning the library from inser tracks window or in the background, press Alt+NVDA+R (R for rescan) from Studio window. This command will cycle through the options listed below. Alternatively, from the add-on configuration dialog, select an option from the library scan announcement combo box.

The available options are:

  • Do not announce ("off"): by default, NVDA will not announce that a library scan is happening.
  • Announce start and end of a scan ("start and end only"): NVDA will notify you when a library scan starts and ends.
  • Announce progress of a scan ("scan progress"): In addition to start and end announcement, NVDA will say "scanning" periodically to tell you that a library scan is in progress.
  • Announce progress and number of items scanned ("scan count"): NVDA will announce number of items scanned so far as the scan takes place.

Note: words in parentheses are the options from the scan announcement combo box.

Hint: If you set status announcement to beeps, NVDA will play a high and low tone when the scan starts and completes, respectivley. Also, NvDA will play a middle tone during a scan to alert you that a scan is happening.

Note: to monitor the progress of a library scan from insert tracks window, do not move away from Insert Tracks dialog until the scan is complete. This does not apply if you start library scan monitoring via SPL Assistant method, as NVDA will announce scan progress from any program including from within Studio. Also, if using Studio 5.10 and later and library scan progress is set to scan count, you may hear repeats. Don't worry - this is the case when it takes a long time to perform library scans.

Track Tool

You can use Track Tool to set intros, define cue positions and so on. NVDA allows you to find out if intro position is set on a particular track.

To use Track Tool, highlight a track from within Studio's track list, then press Control+K. Alternatively, press Control+K without selecting any track, then from within Track Tool window, press Control+O to load a track into Track Tool. As you move through the tracks list, you'll hear a beep if intro has been set on a track. NVDA will also tell you the values for cue, overlap and so on if they are set.

From within Track Tool, press Control+NVDA+number to hear various information about the selected track. For example, press Control+NVDA+3 to obtain track duration.

Following are the information you can query regarding a track in Track Tool:

  • Control+NVDA+1: Artist.
  • Control+NVDA+2: Track title.
  • Control+NVDA+3: Duration of the selected track.
  • Control+NVDA+4: Cue time.
  • Control+NVDA+5: Overlap duration.
  • Control+NVDA+6: Length of the intro.
  • Control+NVDA+7: Segue.
  • Control+NVDA+8: Path to the file.
  • Control+NVDA+9: Album
  • Control+NVDA+0: CD code for this track.

Hint: You can use Track Dial mode in Track Tool to review individual columns. You can either leave this command unassigned (by default, NVDA will use the command assigned for toggling Track Dial from Studio window), or assign a command to toggle Track Dial in Track Tool. Note that you can use Track Dial for Track Tool while Studio is active.

Microphone alarm

When you are interviewing someone or talk during your show, you may forget that you have your microphone turned on and find out that you are speaking while the next song is playing. Just in case you forget to turn off your microphone, NVDA will let you know via a sound that your microphone has been active for a while. To configure the microphone alarm (often shortened to mic alarm), press Alt+NVDA+4, then type how many seconds should NVDA wait before alerting you about your microphone status. To turn this off, enter value of zero (0). This setting is permanent and is turned off by default.

You can also ask NVDA to give you periodic notifications about microphone being on. This can be configured from microphone alarm dialog (between 0 and 60 seconds, with 0 being announce once). See add-on settings section for details.

Weather and temperature

You can ask Studio to show you temperature and weather information for your local area. Once this is configured, from SPL Assistant, press W. Alternatively, assign a command to announce weather and temperature without invoking SPL Assistant.

Metadata streaming

You can ask Studio to use up to five streams to stream track metadata. These include the DSP encoder address and up to four additional URL's, and NvDA can be told to announce if metadata streaming is enabled and connect to predefined servers if any.

To configure when NVDA should announce metadata streaming status and connect to these servers, open add-on settings and select an option from metadata streaming notification and connection combo box. You can choose between off (not announced and connected), startup (connected and announced when Studio starts) and when switching to an instant switch profile (see instant switch profile section for more details).

To configure which streams should be enabled, go to manage metadata streaming, then check the boxes for streams you wish to connect.

To quickly enable or disable metadata streaming on the fly, press the command you assigned to open metadata streaming options dialog. Check the stream box to enable or uncheck to disable metadata streaming and click OK.

Note: When toggling metadata streaming on the fly, you can check "Apply to selected profile" checkbox to let NVDA store toggle values to the selected profile to be used next time Studio starts.

Using touchscreen commands

If you have NVDA 2012.3 or later and add-on 5.0 or later installed on a touchscreen computer, you can use touchscreen gestures to perform some add-on commands. These commands are grouped under a touch mode called "SPL mode". While Studio is focused, perform three finger single tap until you switch to SPL mode.

The commands in SPL mode are as follows:

  • Two finger flick right: open end of track alarm dialog.
  • Two finger flick left: open intro alarm dialog.
  • Two finger flick up: announces broadcaster time.
  • Two finger flick down: announces remaining time for the currently playing track.

Note: When you switch away from Studio, you'll be placed in object touch mode.

Studio add-on preferences

One of the strengths of NVDA is that it contains dedicated dialogs for various settings, such as voice, browse mode and so on, all housed in preferences menu. Just like any other settings, SPL add-on comes with its own settings dialog. As long as you are running Studio, you can open this dialog by going to NVDA's preferences menu and selecting "SPL Studio Settings" item or pressing Alt+NVDA+0 (zero) from Studio window.

Most of the settings in this dialog were discussed throughout the add-on guide. Here is a complete list of available settings and their options:

  • Broadcast profile and associated controls: See next section on profiles.
  • Beep for status announcements (unchecked by default): See status announcement section. Status messages can be announced as beeps or words when this option is checked or unchecked, respectively.
  • Message verbosity (beginner by default): See message verbosity section for more details and an entry in frequently asked questions for a complete list of messages that'll be affected by this setting.
  • End of track alarm (default is 5 seconds): See end of track alarm section for more details.
  • Song ramp (intro) time (default is 5 seconds): See intro alarm section for more details.
  • Braille timer (off by default): select the desired braille timer option from this combo box. See braille timer section for more details.
  • Microphone alarm (0 (disabled) by default): See microphone alarm section.
  • Microphone alarm interval (0 by default): Use up and down arrow keys to change the microphone alarm interval between 0 (announced only once) and 60 seconds. See microphone alarm section for more details.
  • Alarm notification (beep by default): Selects alarm notification type. You can select from beep only, message only or both. See alarms section for more details.
  • Library scan announcement (off by default): select the announcement option from this combo box. See library scan section for more details.
  • Announce hour values when announcing track or playlist duration (on by default): If duration of the track or a playlist exceeds one hour, NVDA will announce minutes and seconds or hours, minutes and seconds when this option is disabled or enabled, respectively.
  • Track Dial mode (disabled by default): see Track Dial section for more details.
  • Beep for different track categories (disabled by default): Enabling this option allows NVDA to play different beeps for different track categories when moving between tracks in playlist viewer. See playlist viewer section for details.
  • Notify when located at top or bottom of playlist viewer (enabled by default): If this is turned on, a beep will be heard when you are at the top or bottom of the playlist.
  • Track comment announcement (off by default): Select how NVDA will notify track comments if it exists. You can choose from off, message, beep or both. See track comments section for details.
  • Metadata streaming: The metadata streaming combo box and manage metadata streaming button and the subsequent dialog controls when Studio will connect to metadata streams and to announce streaming status. See metadata streaming section for details.
  • Column order controls: The next two controls (Use screen order checkbox and Manage column announcements button) controls column announcement order. See column announcement section for details.
  • Columns explorer: The next two buttons opens dialogs where you can configure columns explorer slots when you use Studio and/or Track Tool, respectively. See Columns Explorer section for details.
  • Announcing various status messages: Select "status announcement" button to open a dialog containing three checkboxes and a combo box to configure announcement of certain status information. These include announcing scheduled time for the selected track, listener count and name of the currently playing cart and the track name (default is automatic; select between automatic (announced at all times), while using other programs and off (not announced)).
  • Advanced settings: This dialog allows you to configure various advanced options. See the next section for details.

After configuring the above settings, select OK from main settings dialog to save your changes or Cancel to discard them.

Note: you can use this dialog to reset add-on settings and other data to default values (applied to all profiles). To do this, select Reset settings button, check the checkboxes for various data items (instant switch flag, time-based profiles, encoder settings and track comments), then answer yes when prompted. If no checkboxes are checked, only add-on settings will be returned to defaults. The add-on configuration dialog will close automatically once default settings are applied.

Advanced settings

The following are options in advanced settings dialog:

  • Automatically check for add-on updates (enabled by default): Check this box if you'd like NVDA to check for updated version of the Studio add-on (requires you to use Studio while checking for updates).
  • Update check interval (weekly or 7 days by default): If automatic update check is turned on, this option will let you choose the update check frequency between 1 day (24 hours) and a month (30 days).
  • Update channel (channel list varies): This combo box allows you to select the update channel. If you are using Test Drive (try) builds, this combo box isn't available, as you'll receive updates from Test Drive channel. See update channel entry in FAQ's below for detials.
  • Use SPl Controller to invoke SPL Assistant (disabled by default): If you check this box after assigning a command to invoke SPL Controller layer (see below), you can use SPl Controller command you assigned to invoke SPl Assistant layer. This is useful for people used to other screen readers where a single layer is used to access functions normally performed by both Controller and Assistant layers in NVDA.
  • Assistant layer layout (NVDA by default): By default, NVDA will use the Assistant layer commands described throughout this user guide. You can choose between this default command set, JAWS for Windows or Window-Eyes, with layer commands used by these screen reader scripts replacing commands in the SPL Assistant layer. For example, with JAWS for Windows layout active, pressing SPL Assistant, R will announce playlist duration (default is SPL Assistant, D). See the list below for SPL Assistant command changes between layouts.

Following are SPL Assistant command assignments when JAWS for Windows layout is active:

  • C: Cart Explorer (you can toggle this by pressing Alt+NVDA+3).
  • L: Listener count.
  • R: Playlist duration.

Following are SPL Assistant command assignments when Window-Eyes layout is in use:

  • E: Elapsed time of the currently playing track.
  • G: Metadata streaming status.
  • R: Remaining time for the currently playing track.

Other SPL Assistant commands are same across all layouts.

Broadcast profiles

In a recent version of NVDA, a feature was added to let you customize NvDA settings to be applied while using a program or during say all. This is called "configuration profiles". By default, you would use normal configuration, and you can create new profiles to be used anywhere or when using an app. Consult NVDA's user guide on configuration profiles.

StationPlaylist add-on takes this one step further. If you host multiple shows, you can ask NVDA to honor your Studio add-on preferences for the duration of a particular show. This is achieved via broadcast profiles, a collection of settings to be applied in a given moment upon request.

So far, we've dealt with only one profile: normal profile. By default, NVDA uses default broadcast profile when adjusting settings. You can then use this profile to create new profiles based on this profile, or create a new profile with default settings applied.

As of add-on 7.0, the following settings can be stored in profiles:

  • End of track notification toggle.
  • End of track alarm.
  • Intro notification toggle.
  • Intro alarm.
  • Microphone alarm.
  • Microphone alarm interval.
  • Use screen order when announcing columns.
  • Column announcement order and included columns.
  • Metadata streaming URL's.

Broadcast profiles are managed from Studio add-on settings dialog. Profile-related controls are as follows:

  • Broadcast profile: Lists currently loaded profiles. By default, normal profile is in use (top of the list), with the active profile selected by default. For each profile, a flag will be shown alongside the profile name denoting current profile status, such as whether this profile is the currently active profile. See the next list for more information.
  • New: Allows you to create a brand new broadcast profile with default profile-specific settings applied. Profiles are saved into a folder in the add-on folder.
  • Copy: Allows you to create a new profile using settings from an existing profile.
  • Rename: Lets you rename a profile (not availible for normal profile).
  • Delete: Deletes a profile (say "yes" when prompted; you cannot delete the normal profile).
  • Triggers: Configure profile activation and other settings. See the triggers dialog section for details.
  • Countdown timer until switching profiles (15 seconds by default): This is used to let NVDA announce seconds until a time-based profile is activated (see time-based profile switching section for more information).

The possible profile flags are:

  • Active: The selected profile is the active profile. This is set regardless of whether this profile became active when instant profile switching was invoked (see below).
  • Instant switch: The selected profile is set as the instant switch profile (see instant switch profile for details).
  • Time-based: At a specific date and time, NVDA will switch to the selected profile automatically. Just before this happens, NVDA will run a countdown timer to let you know that profile switching will take place.

Note: Multiple flags can be set on certain profiles.

Creating a broadcast profile

There are two ways of creating a broadcast profile: brand new or as a copy. Select the desired option and answer the following questions when the new/copy profile dialog appears:

  • Profile name: Enter the profile name, such as the name of a show you are hosting. You cannot enter a name that is already in use.
  • Base profile (when copying a profile): Select the profile that'll become basis for the new profile. Settings from the selected base profile will be copied to the new profile. For brand new profiles, settings from normal configuration minus profile-specific settings will be applied.

Renaming and deleting broadcast profiles

To rename a profile, select "rename" button, then enter the new name for the profile. Just like new profiles, you cannot enter a name that is already used.

To delete a profile, select "delete" button, then say "yes" when prompted. You'll be returned to add-on settings with the normal profile activated.

Note: You cannot rename or delete the normal profile.

Triggers dialog

The triggers dialog is used to configure profile switching settings. The following controls are available:

  • This is an instant switch profile (checked if this is the case): If you need to use a profile during a show (especially when you don't know the duration of this show), it is best to define the show profile as instant switch profile. Once defined, you can press SPL Assistant, F12 to switch between current and show profile.
  • This is a time-based switch profile (checked if this is the case): If you would like a profile to become active at a certain date and time, you can define a profile as a time-based profile. After checking this box, select the switch day(s) and specify when this profile should become active with an optional duration in minutes.

Notes:

  1. If you rename the switch profile, the switch profile setting will carry over to the just renamed profile. If you delete the selected profile, instant switch and time-based switching setting will become undefined.
  2. After specifying switch date and time, NVDA will present an error dialog if another profile is occupying the time slot you've just specified (time slot refers to switch hour and minute plus duration in minutes). For example, if you tell NVDA to switch to an hour-long show profile at 12 noon every day and if another profile has taken this time slot (say, a 12:30 show on Mondays), NVDA will present an error dialog and will let you specify a different switch date and time.
  3. When you start or restart NVDA while Studio is active, NVDA may switch to a time-based profile automatically if current day is the switch day and current time falls within the switch time slot.

SPL Controller

The SPL Controller is a set of commands used everywhere (except Studio itself) to control various aspects of Studio's functionality. For example, you can use this to start playing the next track right after a Skype call, or disable automation for the time being while conducting a live interview or tweeting.

To use these commands, enter SPL Controller layer. NvDA says, "SPL Controller." Then press the keys for the desired function from the list below.

SPL Controller commands

after entering SPL Controller, press one of the following commands:

  • A: Turn automation on.
  • Shift+A: Turn automation off.
  • M: Turn on microphone.
  • Shift+M: Turn off microphone.
  • N: Turn on microphone without fade.
  • L: Turn on line-in.
  • Shift+L: Turn off line-in.
  • P: Play the next track.
  • U: Pause or continue playing.
  • S: Stop with fade out.
  • T: Instant stop.

Notice that the commands are same as SPL control commands available while SPL Studio is used. Also, the toggle commands by themselves enables a particular option, while pressing shift with the toggle key disables it.

Note: you'll hear beeps when you turn microphone on or off.

Additional SPL Controller commands include:

  • R: Announce remaining time for the currently playing track in seconds.
  • Shift+R: announce number of tracks in the library.
  • E: Announce number of encoders being monitored along with stream labels for them if defined.
  • I: Announce listener count.
  • F1: Shows a dialog listing available Controller commands.

Quickly switch to SPL Studio

There are times when you might wish to switch quickly to SPL Studio from other programs (for example, if you wish to search a song from the playlist). To switch to SPL Studio from another program, press the command you assigned for this command (for 2.0 and above; for 1.2 and earlier, press NvDA+Shift+grave accent).

Broadcasting with SAM and StationPlaylist Encoders

Now that you know about how to use Studio, it's time to make your presence known on the internet. You can broadcast your show online using Studio, a stream encoder and a streaming server.

The SPL Studio add-on supports SAM Encoder from Spatial Audio. In addition, if you are using Studio 5.00 or later, you can use SPL Encoders which ships with Studio. SAM Encoder is a Winamp plug-in that encodes your show to a format ready for broadcasting. A popular streaming protocol/server is SHOUTcast, and you can use SHOUTcast servers from various websites to stream your show (you can try it out by installing SHOUTcast server on your local computer). Consult the documentation for Studio, SAM Encoders and other websites to learn more about how to stream your show online.

When you use SAM or SPL Encoder with NVDA, the following commands can be used from the encoder window:

  • F9: Connect to a streaming server (for example, SHOUTcast). NVDA announces "connecting", followed by either a beep when connected or error messages (if any). If you tell NvDA to switch to Studio or play the first selected track after connecting, NvDA will switch to Studio window or play the first track when connected to the streaming server, respectively.
  • F10 from SAM encoder, not available in SPL encoder: Disconnect from a streaming server (NVDA will announce, "disconnecting"). If you are using SPL encoder, from the encoders list, press Shift+TAB until you reach "disconnect" button and press ENTER.
  • Control+F9/Control+F10 (SAM encoder only): Connect or disconnect all encoders, respectively.
  • F11: Sets whether NVDA will switch to Studio window when the selected encoder is connected.
  • Shift+F11: Sets whether Studio will play the first selected track when the selected encoder is connected.
  • Control+F11: allows you to monitor the selected encoder in the background for connection changes. To disable background monitoring of all encoders (of any type), press Control+F11 twice quickly.
  • F12: Opens a dialog to give custom labels for the selected encoder. NVDA will remember your labels and will announce them as you move between encoders.
  • Control+F12: Select the encoder position you have deleted and let NVDA realign stream labels and encoder settings.
  • Alt+NVDA+0: Opens encoder settings dialog. See encoder settings section for details.

Note: there might be a delay when a connection is established; during this time, NVDA may appear to freeze (but it isn't; NVDA is keeping an eye on status changes). During this time, you can still perform NVDA commands such as announcing current time; if you are using add-on version prior to 3.3, do not move away from the encoder window until connection is established. Also, settings such as focusing to Studio is saved across sessions.

Encoder status columns

You can use Control+NVDA+number commands to review encoder status. The following columns can be reviewed:

  • Control+NVDA+1: Encoder position.
  • Control+NVDA+2: Stream label.

For SAM Encoders:

  • Control+NVDA+3: Encoder format.
  • Control+NVDA+4: Encoder status.
  • Control+NVDA+5: Status description.

For SPL Encoders:

  • Control+NVDA+3: Encoder settings.
  • Control+NVDA+4: Connection status/transfer rate.

Encoder settings

The encoder settings dialog is used to centralize various commands used to configure encoder preferences. The available settings are as follows:

  • Stream label: Enter the label for this encoder.
  • Focus to Studio when connected (off by default).
  • Play first track when connected (off by default).
  • Background monitor (off by default).
  • Play connection tone (on by default).

These settings will be saved across sessions.

Frequently asked questions

Here is a list of frequently asked questions when using NVDA with SPL Studio:

Q. Is Studio accessible without using the add-on?

Yes. The benefits of using the add-on are for announcing status information and to make broadcasting more efficient through status messages, alarms and so forth.

Q. In SPL add-on 1.2, when I press NVDA+Grave or NvDA+shift+Grave, NvDA says, "SPL Studio is not running."

You need to run SPL Studio in order for these commands to work.

Q. After installing SPL add-on 2.0 or later, I cannot switch to SPL Studio, run SPL Controller, etc.

In version 2.0 and later, some commands were removed. You can get them back by assigning your own commands to the following commands from Input Gestures dialog (see NVDA User Guide for details on Input Gestures dialog):

  • Entering SPL Controller layer.
  • Entering SPL Assistant layer.
  • Switching to SPL Studio from any program.
  • Announcing time in hours, minutes and seconds.
  • Toggling Track Dial (to do this, first select a track, then open NVDA's input gestures dialog).
  • Toggling Track Dial for Track Tool: same as above, except first select a track from Track Tool, then open Input Gestures dialog. In add-on 6.0, this is optional.
  • Column Search.
  • Announcing weather and temperature information.
  • Announcing title and duration of the next track if any.
  • Announcing title and length of the currently playing track.
  • Announcing metadata streaming status.
  • Opening a dialog to quickly toggle metadata streaming.

Q. Can I use SPL Assistant commands from Studio windows other than playlist viewer?

Yes with one exception: you can use various SPL Assistant layer commands outside of playlist viewer (say, from within insert tracks window) except jumping to place marker track (K). Also, when pressing SPL Assistant, D (remaining time for the entire playlist), sometimes you'll be asked to move back to playlist viewer, and from then on, this command will work regardless of where you are in Studio.

Q. How can I tell NVDA to use a different sound card from the card used for streaming radio shows?

To change sound cards for NVDA, Open NvDA menu, go to Preferences then open Synthesizer dialog. Alternatively, press Control+NVDA+S to open this dialog from anywhere. Press TAB to go to output device combo box, select the desired sound card for NVDA, then press ENTER. To switch back to the original sound card, repeat these steps, then choose the original sound card from output device combo box.

Q. When a track is playing, I don't hear the artist and title of the currently playing track.

Due to an issue with Studio itself, you need to install add-on 5.6 or later to let NVDA announce name of the currently playing track automatically.

Q. How can I view latest cart assignments?

After you edit cart assignments via cart edit mode, reenter cart explorer to view updated cart assignments.

Q. When I try to switch to Studio, NVDA says, "SPL minimized."

You can ask Studio to run from system tray. If this is the case, NvDA will announce that Studio is minimized to system tray. To open Studio, go to system tray, select Studio icon and open pop-up menu. Select "restore" from the menu that appears.

Q. When I arrow through tracks, NvDA only announces artist name and the status of the check box.

You need to have "report object descriptions" turned on. Go to NVDA menu, preferences, then Object presentation. Enable reporting of descriptions. Also, You can ask NVDA to announce track descriptions only in Studio via Configuration Profiles dialog under app-based triggers (to do this, open Configuration Profiles while Studio is focused; when creating a profile, select SPLStudio, then while Studio is active, change the desired settings).

Q. Which status announcements are affected by different verbosity levels?

The following toggle announcements are affected by verbosity levels, particularly advanced level where either a shortened text or a short beep will be heard:

  • Automation.
  • Microphone.
  • Line-in.
  • Record to file.
  • cart edit/insert (prior to December 2016).)

Note: Starting with add-on 16.12/15.4-LTS, cart edit/insert mode toggle will be announced regardless of verbosity level and status announcement type (beep or speech) as cart edit status text also displays cart insert mode status.

Q. How can I monitor a lengthy library scan?

Open Insert Tracks dialog (Control+I). If you've selected progress announcement from library scan announcement options (see above), NVDA will announce the progress of a scan. Don't move away from this window until the scan is complete. Alternativley, you can monitor a lengthy scan from anywhere by using the SPL Assistant method described above.

Q. In Studio 5.10 and later, during a library scan, NVDA repeats current scan count.

This is expected if it takes a long time to perform library scans, particularly if scanning an entire drive. Don't worry if you hear repeats.

Q. Is there a way to migrate stream labels from add-on 3.x to 4.x?

No. Due to incompatible formats used when storing stream labels, NVDA will not migrate stream labels from add-on versions earlier than 4.0. If you are using add-on version 4.0 and later, your stream labels and settings will be preserved across add-on upgrades.

Q. I did something and NVDA no longer remembers stream labels and end of track alarm setting.

Your configuration files have been deleted from your NVDA user configuration folder, or there was a problem with the configuration file. You can get them back by reentering stream labels and entering the desired setting for end of track alarm.

Q. When I start Studio, I get an error saying add-on configuration has been reset to defaults.

If NVDA determines that there were serious problems with your configuration file, some or all settings will be returned to defaults. Please configure the add-on settings to your liking, and barring further problems with the configuration information, the error dialog will go away next time you restart NVDA or Studio.

Q. When I start Studio, NVDA says, "cannot find instant switch profile".

You might have deleted or renamed the file associated with a previously defined instant switch profile. Please assign another profile as an instant switch profile.

Q. When announcing tracks, which columns can NVDA suppress and reorder?

You can customize announcement and/or order of announcement for the following columns:

  • Artist (reorder only)
  • Title (reorder only)
  • Duration
  • Intro
  • Category
  • Filename
  • Outro
  • Year
  • Album
  • Genre
  • Mood
  • Gender
  • Energy
  • Rating
  • Tempo
  • BPM
  • Time scheduled

Notice that these are the columns visible when using Studio 5.1x and later.

Q. When I perform various add-on commands from Studio 4.33, I get the message, "information not available".

This could be due to following issues:

  1. You are using Studio 4.33 with add-on 4.0 or later. Add-on 4.0 does not support Studio versions earlier than 5.00.
  2. Certain commands, especially time commands require that you're focused on the main playlist window. If you open another window such as Options dialog and try to perform some time-related commands, NVDA will announce the message above. This is the case for add-on versions prior to 7.0.

Q. When trying to switch profiles, NVDA says, "no instant switch profile is defined".

Before switching profiles, you need to define an instant profile. See instant switch profile section for more details.

Q. When I try to switch to another profile, NVDA says, "you are already in the instant switch profile".

You need to be using a profile different from that of the instant switch profile before you can switch profiles.

Q. Can I monitor connection attempts from somewhere other than encoder window?

If you are using add-on version 3.3 and later, you can press F9 or Control+F9 from an encoder window to connect to a streaming server, then move to another program. NVDA will monitor for connection attempt status (connected or an error message).

Q. How can I monitor all encoders when connecting all of them at once by pressing Control+F9 from SAM encoder window?

Move through the encoders and press F9. Note that you should not set any encoder to trigger NVDA to focus to Studio when connected. Instead, please set one of the encoders to trigger Studio to play the first track when connected.

Q. Playback volume is lowered in Studio whenever NVDA speaks.

You need to disable audio ducking (NVDA+Shift+D).

Q. NVDA responds slowly when I press V from playlist viewer and Studio opens SPL Recorder.

This is one of the limitations of Studio and/or the add-on. One owrkaround is to use a dummy encoder for recording a show.

Q. What is the best way to suggest new features, send bug reports or connect with other add-on users?

There is a dedicated mailing list for users of NVDA and SPL, which can be found at http://groups.io/g/nvda-spl.

Q. Can I test the absolute latest version of the add-on for testing purposes?

Yes (called Studio Add-on Test Drive program). Anyone can test latest version for free. First, subscribe to NvDA SPL list, then look for messages regarding Test Drive builds (sometimes called try builds). Note that try builds are bleeding-edge code (equivalent to NVDA's next snapshots), so don't try them in a production environment.

Q. I keep hearing about LTS releases. What are they?

LTS stands for long-term support. This is a special version of a software that will be supported for a very long time.

Usually a major version of the StationPlaylist Studio add-on for NVDA receives support until the next major version is released (typically several months). However, because there are broadcasters who would like to use a stable version of the add-on for a long time (either because they have to or they cannot upgrade to the latest version of Studio), a long-term support version of the add-on is released every few years to give people time to upgrade to a future stable version of Studio. In addition to longer support period (at least a year), a LTS version of the add-on is the last version to support the oldest stable Studio version.

As of 2017, add-on versions 3.x (September 2014-June 2015) and 7.x/15.x (April 2016-December 2017; 15.x since October 2016) were designated as LTS releases, supporting Studio 4.33 and 5.01, respectively.

Q. Which versions of Studio are supported by which add-on releases?

  • Studio versions prior to 5.x: add-on 1.0 to 3.9 (January 2014-June 2015).
  • Studio 5.0x: Add-on 1.0 to 7.5, 15.x (January 2014-December 2017).
  • Studio 5.1x: Add-on 3.2 to 18.x (November 2014-December 2019).
  • Studio 5.2x: Add-on 16.11 to 20.x (November 2016-December 2021).

Q. What are update channels?

With the introduction of Test Drive Program (see above), it became possible for you to choose the frequency of updates and where to get updates from. As of 2016, there are four regular and two limited time channels:

  • Canary (or source code level): This includes development branches other than the ones below and is meant for add-on developers (currently one).
  • Try builds: This is for Test Drive Program participants, or in some cases, for the add-on developer to work with one or more users in testing features and troubleshooting bugs.
  • Public snapshots: This designates "master" branch in the source code repository and includes features tested by try build users and will show up in the next stable version.
  • Stable: Designates stable releases ("stable" branch in the source code repository).

In addition, "beta" and/or "long-term support" (LTS) channels appear during beta testing phase or to support a major version for a long time, respectively.

Q. Can I switch between all available update channels?

Different release types will support different update channels. The possible channels for each release type are:

  • Canary and try builds: update to respective channels only (canary is source code only). For these releases, update channel combo box will not appear.
  • Snapshots: to other snapshot builds or beta builds if this is such a case.
  • Beta: Only beta builds (several snapshot updates, then to the stable build in the end).
  • Stable: Stable build only, or to beta or long-term if there is an active beta testing cycle going on or if an LTS version is being maintained, respectively.
  • Longterm: Stable or LTS.

Credits and contact information

If you have suggestions, bug reports or just want to drop by and say hi, you can contact the author using the following contact information:

There is a dedicated forum for people using StationPlaylist suite, and you can subscribe by sending an email to stationPlaylist-subscribe@yahoogroups.com. In addition, there is a dedicated mailing list for people using NVDA and Studio, which can be found at https://groups.io/g/nvda-spl.

Lastly, if you'd like to take part in shaping the future of the Studio add-on and help test new features, you can join the Studio Add-on Test Drive program available to NVDA SPL list members. Whenever new features are available, you'll be a part of the first group of users to experiment with a new feature and provide feedback.

Credits: I (Joseph) would like to thank the following people for giving me and others inspirations behind the SPL studio add-on for NvDA:

  • Geoff Shang: For coding the initial version of the add-on and making it available.
  • Jamie Teh from NV access: For providing a workaround for track listings.
  • Brian Hartgen: For JAWS for Windows scripts for SPL Studio and the idea behind SPL Controller and Assistant layer commands.
  • Jeff Bishop: For Window-Eyes scripts and commands used in SPL Controller and Assistant commands.
  • Tyler Spivey: For the actual layer command facility.
  • Ross Levis: The head developer of SPL Studio for continued support for screen readers in SPL Studio.
  • Roger Stewart: For suggesting this add-on and for continued testing and reports.
  • Duyahn Walker: For useful suggestions and bug reports.
  • Shaun Oliver: For continued suggestions on encoder support.
  • Jerry Mader: For useful suggestions and feature testing.
  • Jerry Jicha: For useful feedback and feature testing.
  • And many other supporters and testers.

End of SPL Studio Add-on Guide