Thank you for downloading and installing the Window-Eyes scripts for StationPlaylist Studio. You may wonder, "What is StationPlaylist Studio"? Taken directly from the StationPlaylist Studio Web site:
Studio is simple to use on-air broadcast automation playout software for the studio and/or DJ. It plays all your media files with manual or intelligent automatic crossfading. Play jingles, commercials, news, songs. live streams, live inputs from your sound card, satellite feeds etc. Includes an Internet stream encoder, voice track / song ramp overlapping, mic button with music fade, many automation and live assist features such as 96 cart slots for instant jingles, and much more...
StationPlaylist Studio is already one of the most accessible applications written for screen readers today. This is due to the terrific direct work done by the developers of StationPlaylist Studio along with screen reader companies and assistive technology experts to insure that it remains very accessible. We want to sincerely thank all of those who have contributed to the ongoing accessibility of the application.
While Studio is accessible out of the box, these scripts ease its use by providing time-critical access to information while broadcasting.
The scripts provide the following functionality:
Credit must be given to Brian Hartgen and Jonathan Mosen for many of the ideas seen in the Window-Eyes scripts. We appreciate their time and efforts in the original ideas behind many of the concepts presented here.
Many of the features contained in these scripts would not have been possible without the direct support of the StationPlaylist Studio developers work in making minor changes to the application. A very sincere thanks goes out to Ross and others at StationPlaylist for contributing the many hours of time in consulting and development work to make these scripts possible. Again thank you.
The scripts require StationPlaylist Studio version 4.3 build 10 or later. Check your Help, About window for the version of Studio you are running. It should be:
version 4.30 Build 4.3.0.10
If you are running an older version of StationPlaylist Studio, consult the download links provided to you by the company or contact them for support. This assumes you are currently under a maintenance plan or have support for your current version of Studio.
The scripts check to insure that you are running this build and if you are not will announce a message stating so and will abort. It is critical that you upgrade to this release.
As for installing the scripts, download the package from GW Micro's Script Central and simply install the package. No additional steps need to be taken.
You can expect that bug fixes and enhancements will be posted quite frequently when user-feedback is submitted or if issues are encountered with the scripts. It is suggested to check for script updates often to insure you are on the latest version. This can be accomplished via the following methods:
Help is available via the following methods:
The StationPlaylist Studio scripts have a very rich array of configurations available to you. Use the Script Preferences dialog to review all potential configuration options. The key to open the dialog is Control-Alt-Windows-P. You can also open the dialog from the StationPlaylist Studio Scripts submenu in the Window-Eyes control panel. Pull down the Scripts (Alt-R) menu to locate this sub-menu.
The Window-Eyes StationPlaylist Studio scripts can integrate well with the very popular Qwitter application. Use the Script Preferences dialog or the Script menu in the Window-Eyes control panel to convert some of the script hotkeys to other assignments that will not conflict with Qwitter. Here is a listing of keys that are changed when this process is invoked:
Check For Update - Control-Alt-Windows-U Email Author - Control-Alt-Windows-Shift-M Script Debug Mode Toggle - Control-Windows-` Script Preferences - Control-Shift-` Speak Track Time - Control-Shift-H Elapsed Time of Playing Track (the global key) - Control-Shift-J Key Remaining Time of Playing Track (the Global Key) - Control-Shift-K
Window-Eyes scripting provides the ability to add submenus to the Script menu within the Window-Eyes control panel. The StationPlaylist Studio scripts take advantage of this and provide the following options:
Open the Script Help.
Open help on keyboard commands provided by the StationPlaylist Studio application itself.
Open this manual.
Open the Script Preferences dialog.
If you run into an issue with the StationPlaylist Studio Scripts then you may be asked to turn on Debug Mode and send information to CSE Designs. Use this menu option to enable and disable this functionality.
There may be times that you would like to reset all of the script configuration settings and hotkeys to their defaults. Use this menu option to perform that action.
Toggle the Studio scripts on and off.
Open the Message Maintenance window to control what is spoken by the scripts.
Open the Hotkey Global State Manager window.
Open the Notes list.
Move keys that conflict with the Qwitter application to new keys.
Open your browser to the Paypal site to donate to the author.
Open your E-mail client to contact the script author.
Check for a newer version of the StationPlaylist Studio scripts.
This section describes all of the hotkeys available within StationPlaylist Studio.
This document describes the default hotkeys provided by the scripts. If you change them using the Hotkey Manager, you will need to keep this in mind when reading the documentation.
Many key descriptions have help text extracted from the StationPlaylist Studio manual with slight revisions.
StationPlaylist Studio contains two Status Bars within the application. The following keys provide direct access to each of the items contained on the Status Bars:
Get the amount of time that Studio has been up and available.
If a Cart is currently playing then pressing this key will announce its name and filename information.
Studio has the ability to monitor the number of people listening to a Shoutcast or Windows Media stream. Pressing this key will announce the number of listeners of your stream. This requires configuration within StationPlaylist Studio. Consult the Studio documentation for setup instructions.
Announces the current play status of Studio. This key is available in any application.
Announces the current state of Automation mode in Studio.
Announces the current state of your microphone (whether it is on or off).
Announces the current state of the Line In port on your sound card (whether it is on or off).
Studio has the ability to record your stream to a file. This requires configuration of Studio's options. Press this key to get the announced status of this recording mode.
Announces the current state of Cart Edit mode.
Announces the current Hour Marker Status within Studio.
This section describes hotkeys available within the track list (otherwise known as the Play List).
Speak the checked state of the current Track List item.
Speak the information in column 1 for the current Track List item.
Speak the information in column 2 for the current Track List item.
Speak the information in column 3 for the current Track List item.
Speak the information in column 4 for the current Track List item.
Speak the information in column 5 for the current Track List item.
Speak the information in column 6 for the current Track List item.
Enter a term to search for within the track list. The search will go forward from the current location looking for the item. If it is found then focus will be placed on this track. If it is not found then a message will be spoken stating so.
Enter a term to search for within the track list. The search will go backward from the current location looking for the item. If it is found then focus will be placed on this track. If it is not found then a message will be spoken stating so.
Search for the previously entered string within the track list. The search will go forward from the current location looking for the item. If it is found then focus will be placed on this track. If it is not found then a message will be spoken stating so.
Search for the previously entered string within the track list. The search will go backward from the current location looking for the item. If it is found then focus will be placed on this track. If it is not found then a message will be spoken stating so.
By default Window-Eyes will read all columns of the track list as arrow keys are pressed along with the column headers for each column. You may not want to hear all of this detail. For this reason the scripts now provide for the ability to customize the columns spoken and their associated headers as well. More information will be provided on the level of customization provided later in this manual. Use this key to toggle the custom reading of the track list on and off. This setting is remembered from session to session.
Use this key to toggle Enhanced Arrow Key mode on and off. When the feature is enabled you can move from column to column using the arrow keys. If you have hidden any columns then these settings are respected and you are moved to the next configured column in sequence. Moving Up and Down read the current column of the current track that has focus. Using Home will move you to Column 1. Pressing End will move you to column 6. Pressing Up Arrow or Down Arrow at the top or bottom of the Track List will announce Top or Bottom respectively. Control-Home and Control-End will announce the column at the top or bottom of the Track List respectively. Once this mode is turned off then if Custom Track List Reading Mode is enabled then it will return to being available.
Announces the current position within the Track List. This does include Hour Marker items within the Track List, so keep this in mind when getting this information.
Pressing this key will copy the track information to the Windows Clipboard. The information is extracted from the Studio list view and presented in a human-readable form that Window-Eyes can handle perfectly. Press the key a second time in quick succession to place the contents of the retrieved information into a read-only edit window for your review. The second key press must take place within a half of a second from the first key press.
Show the Track Properties seen if one hovers over the Track Icon using the mouse. This information is retrieved and placed into a read-only edit window for easy review.
Announces the track time of the currently highlighted track. A second press of the key will speak the intro time of the track.
Announces the Elapsed time of the currently playing track. All types are supported. The key Control-Windows-J can be executed outside of Studio (meaning it is globally available in any application).
Announces the remaining time of the currently playing track. All types are supported. The key Control-Windows-K can be executed outside of Studio (meaning it is globally available in any application).
Announces the name and time duration of the next track expected to be played.
Announces the name of the previous track played.
When a track is not playing, this field displays the scheduled time for the track: the same time that appears in the Status Bar. When a track is playing, and the selected track is below the track playing in the playlist, this field displays the actual time the selected track will play based on the current time, the position of the track in the playlist and the remaining time of the current track playing. When a voice track or cart track is playing, this data changes to show Voice Track Elapsed and Cart Elapsed times. The scripted key will handle the announcement of all types described here.
When a track is playing, this is the length of time remaining before the selected track will start, if play is not interrupted.
This is the total duration of all tracks in the selected hour. Selected hour refers to the tracks between the hour markers above and below the selected track.
This is the total duration of the remaining tracks in the current hour, including the time remaining in the current track.
Announces the amount of time left in the current hour according to Studio's clock.
This key invokes Cart Learn Mode. In this mode pressing any of the up-to 96 cart keys will speak their currently assigned name. Pressing the same key again within half of a second of the original key press will invoke the associated cart. Cart Learn Mode allows you to review the cart assignments without activating them or going into edit mode to review their current configurations. Press Grave Accent again to toggle off cart learn mode. Pressing Control-T will enter Cart Edit Mode and will disable Cart Learn Mode.
This section describes available keys that do not fall into other categories.
Open the Script Preferences dialog to review all configuration options available in the scripts.
Press this key to get the time as reported by Studio (as in 10 minutes to 12). Press the key a second time within a half of a second to get the time as reported by Studio's clock itself.
If you have a Braille display connected then you can turn this feature on. Pressing the Window-Eyes Time Hotkey twice quickly (within a half of a second of the first key press) will start the Braille Clock Time to be displayed on the Braille display. Press a key on the Braille display to stop the clock time from displaying. Turning off the Braille Clock Time function will also return the Braille display back to its original usage. The state of this command is remembered from session to session.
Press this key to get the currently playing track as reported by Studio. Press this key a second time within half of a second to hear the title of the window as reported by Window-Eyes.
Studio provides the ability to monitor weather services such as Weather Underground as well as USB temperature probes. This information, if configured in Studio, is displayed on the top part of the Studio window and can be announced by pressing this key. Configuration is required before this information will be displayed and the feature requires the Professional version of StationPlaylist Studio.
While you are broadcasting, it is often necessary to switch back to Studio quickly to continue performing your broadcasting activities. Press this key to set focus into the Track List.
Toggle the scripts on and off. You may want to do this if the scripts for any reason give you trouble.
Use this key to toggle the debug mode of the scripts on and off. The state of this command is remembered.
If you run into situations where the scripts do not perform as you expect, please contact the script author. The script author may ask that you provide a data dump so that it can be reviewed to determine the reason why things are not functioning correctly. This key should not need to be utilized unless directed by support staff.
Many native keyboard commands within Studio perform actions that are not a part of the scripts. As a part of the scripts, status information after the invoking of the keys described below will be announced.
Keystroke1/2/2010 9:26:38 AM | Description |
---|---|
Control-A | TickAllTracks|
Control-Shift-A | UntickAllTracks |
P | Play |
U | Pause |
S | Stop |
T | Instant Stop |
E | Stop Cart |
A | Automate |
M | Toggle Mic on and off |
N | Toggle Mic on and off with no fading |
L | Toggle Line In on and off |
Control-T | Edit Carts |
Control-Shift-U | Mute |
R | Record to File |
Control-D | Disable Control Keys |
It is possible to control exactly what is spoken when moving around in Studio's track list:
This section documents the dialogs used to perform this level of customization.
Press this hotkey to open the Custom Track List Reading Settings dialog. After this dialog has opened you will first be presented with a list box of the 7 columns for which configuration can be manipulated. There are 6 visible columns and the checked state of the track list item is considered the seventh column and is configurable as well. The further sections of this part of the manual document each control seen in the dialog.
This list box contains the seven columns that can be configured:
The Checked State column allows you to determine when the Checked State of the current Track List item is spoken.
These two buttons allow you to adjust the order that columns are spoken in to give you the most flexibility. The buttons become enabled and disabled as needed as you arrow through the list box of columns.
Use this button to remove or hide a column from speaking. For example, for many the Category column may not provide useful information so you can simply ignore that column in the Track List.
Use this button to save your changes.
Use this button to reset the column display to the original defaults.
The next seven checkboxes in the dialog allow you to determine if the column header for each column is spoken or silent. You may wish to turn off the Artist and Title column headers to speed up the reviewing of track lists while broadcasting.
Use this button to save your column header settings.
Use this button to remove the custom column header settings previously made to return the speaking of column headers to their original state.
Use this button to close the dialog.
Caution: This section of the scripts should be used with extreme caution as changing these values could dramatically affect the way that the scripts behave.
Many of the functions contained in the Studio Scripts utilize specific settings to determine when events occur. This section of the manual documents these settings and associated events. You should not change these settings unless you feel that you fully understand the impact they will have on the running behavior of the script.
Use this key to open the Time Interval Settings dialog. The further sections of this part of the manual document each control seen in the dialog.
Use this setting to control the amount of time between updates to your Braille display when the Braille Clock Time feature is on.
This setting controls the amount of time to wait for actions to take place after Control Keys are pressed to eliminate speech from those actions. Caution should be utilized with th is setting.
This setting controls the amount of time between checks for Track Introductions, Voice Tracks, Track Endings and more.
This option controls the amount of time that is used between key presses for the key to be seen as a second key press. The default is a half of a second or 500. You may find that this is to short or to long. Adjust this setting to meet your needs.
Use this button to save your changes.
Use this button to cancel your changes.
Use this button to return the settings back to their factory defaults.
If you have opened this dialog from the Script Preferences dialog then this button will return you to the main Script Preferences dialog.
Use this button to close the dialog.
The scripts provide for two timed event notifications. These are:
Press this key to bring up a custom dialog where all alert notification settings can be controlled. From here you can use checkboxes, slider controls and common file dialog boxes to adjust the alert notification events and their associated time watch intervals. One checkbox controls whether or not a sound plays or speech is heard for warning events. Pay close attention to this especially if you only have one sound card. If no sound playback is invoked then the word Complete will be spoken when the event fires. To define the sound that plays then click the Browse button to look for a WAV file to play. The file must reside in the current script profile directory and the common file dialog places you into this folder when browsing for a file. Once all of your selections have been made simply press the Save button to commit the settings and to invoke the associated events.
Press this key to turn on and off the displaying of timed event count down timers on your Braille display.
Use this key to turn on and off the monitoring of Voice Track Introductions.
Use this key to turn on and off the monitoring of Track Endings.
The scripts provide the ability to get the time and weather from any city in the world. The following keys support this functionality:
Press this key to define a new city. This is the first step when starting out with these features.
Use this key to select a city for which you wish to get the time or temperature.
Press this key to get the time of the currently selected city.
Press this key to get the weather of the currently selected city.
Press this key to toggle between Celsius and Fahrenheit temperature conversions.
In prior versions of the script a few keys were provided to allow for their use outside of StationPlaylist Studio. It is now possible to define almost all keys to either be Global (meaning that the key can be used outside of Studio) or a normal key. This section of the manual describes the process for modifying these keys. Once the changes are made they are saved to a custom file and future versions of the scripts will not overwrite the newly made configuration changes.
Press the default hotkey (Control-Windows-Alt-K) to open the Hotkey Global State Manager window.
The first control in the window is a list box containing all keys defined in the StationPlaylist Studio scripts. Select the key you wish to change.
This is a read-only edit control that shows the current hotkey for the hotkey selected from the list above.
The next control is a read-only edit box that allows you to review the description of the selected key. Use this to confirm your selection before proceeding.
Some keys are capable of being silenced (meaning no speech will be spoken when performing the action). These are mainly keys in the Studio Track List (mic on/off, Line In on/off, Pause, etc). Check the Checkbox to silence the selected key.
You are then presented with a group of radio buttons. You can select from Normal (meaning the key only acts inside of StationPlaylist Studio) or Global (the key works outside of the StationPlaylist Studio application). Depending on the key you may only have one option available to you in this group of radio buttons. This is by design. Some keys can only be executed within the StationPlaylist Studio application itself due to technical issues. Many of these may become opened up in future versions of the scripts. Select the option you want for the specified key. You can continue to make changes to as many hotkeys you wish before actually saving your changes.
Perhaps you have customized a key in a prior session. You now want to remove the custom setting and return the key to its original setting. This button will only be available if you have previously defined a custom option for the key. This key is automagically saved on the press of the Remove button unlike other operations in the dialog. Keep this in mind when pressing the Remove button.
Open your browser to the Paypal site to donate to the author.
Open your browser to the Paypal site to donate to the author.
Press this button to Save your changes that you have made. This is the default button in the dialog so pressing enter will also invoke the button. The save operation will complete and tell you the number of changes made and then the window will close.
Press this button to Close the window.
It is very important that flexibility be provided to allow the broadcaster to hear what he or she would like to hear from the provided scripts. Many users may want less information spoken while others may want more. For this reason, the Message Maintenance window has been provided. This section of the manual will document its use.
Press the default hotkey (Control-Windows-Alt-M) to open the Messages Maintenance window.
Window-Eyes provides for three different menu levels (Beginner, Intermediate and Advanced). The Messages Maintenance window allows you to define messages per menu level verbosity. You may want information spoken differently per menu level configured.
Once the window opens you are presented with a tree view that is the heart of the Messages Maintenance window. The first branch of the tree view is named:
StationPlaylist Studio Script Messages
The tree view contains the following items underneath the parent branch:
All of the messages provided by the StationPlaylist Studio scripts are grouped into the Beginner node of the tree view. You can edit these messages in this node of the tree view or copy their values to the other nodes of the tree view (Intermediate or Advanced). These messages as defined in the Beginner node will speak for all verbosity levels unless you copy one to the other verbosity types.
Copy the highlighted message to the Intermediate node of the tree view. That message once copied can be edited and it will speak if the Intermediate Menu Level is selected in the Window-Eyes control panel.
Copy the highlighted message to the Advanced node of the tree view. That message once copied can be edited and it will speak if the Advanced Menu Level is selected in the Window-Eyes control panel.
Close the Message Maintenance window.
Edit the highlighted message in the tree view. Once the edit button is selected new controls will become activated as described below.
This is a read-only edit box containing the name of the message being edited. Its name can not be changed.
This is a fully editable text box where the text of the message is displayed. Change it to whatever you would like.
Save the edit changes to the current message.
Cancel the edit session on the current message.
The Studio Scripts allow you to take notes or bring text in from external sources for very easy retrieval. This section of the manual documents all of the functionality contained for Custom Notes.
Press Control-Alt-Windows-N to open the Add Note window.
Each control found here will now be described.
Enter the title of the note. Any one line description can be entered here and you are not limited in what characters can be utilized.
Enter the text of the note or use the buttons described below to add text to the note. This is a multi-line edit control so the use of the
Use this button to save the note.
Use this button to cancel the note being added.
Perhaps you wish to start your note over. Use this key to erase/clear the text out of the note.
Use this button to paste text from the clipboard into the note.
You may wish to bring in text from a text file (a file that has a txt extension) so that the text can be easily reviewed. Use this button to open a standard Windows Open Dialog box to locate the file and retrieve its text.
If you have Microsoft Word installed then you can use this button to spell check the text of the note.
Use this button to close the Add Note window.
Press Control-Alt-Windows-Comma (,) to open the Notes List window. From here you can maintain all of the notes added through the Add Note window.
Each control found here will now be described.
The first control is a list box containing all of the notes added to the Custom Notes feature. You can arrow through the note and as you do the text of the note will appear in the next control described.
The next control is a multi-line read-only edit control that allows you to review the text of the note.
This button allows you to make the previous edit control editable to allow you to edit the contents of the note. Once you do this this button becomes disabled and the Save button becomes available.
Cancel the edits currently being made to a note and return the note to its original text.
Use this button to save the changes you have made during your edit session.
Use this button to remove the note.
Use this button to copy the text of the highlighted note to the Windows clipboard.
Use this button to close the Notes List window.
The following items can not be performed outside of the StationPlaylist Studio Application:
If the main StationPlaylist Studio window has focus then these issues are not a problem. It is only when StationPlaylist Studio is minimized or not in focus. These are hoped to be rectified in a future version of the Scripts.
Credit must be given to Brian Hartgen and Jonathan Mosen for many of the ideas seen in the Window-Eyes scripts. We appreciate their time and efforts in the original ideas behind many of the concepts presented here. In addition, Brian Hartgen has provided many useful ideas to improve the scripts and for this I am greatful. Listen to both Brian and Jonathan on The Legend as they use StationPlaylist Studio to broadcast their shows.
A sincere thanks again goes out to the team at StationPlaylist. Without their efforts these scripts would not have been possible.
The assistance of GW Micro has been a fantastic resource in the development process of the scripts and again they show their commitment to work with third-party developers to assist in development guidance and direction. Thank you GW Micro!
Beta testers played a crucial role in finding issues as well as suggesting enhancements to the scripts. Thank you beta team.
A very special thanks goes out to Jared Rimer from the Jared Rimer Network for all of his hours of testing with me with the Studio scripts.
Darrell Shandrow assisted in reviewing documentation for the project. Thank you Darrell.
Corrected a bug in Studio Version checking logic.
Manual updates.
Initial release.
Press Control-Windows-M to open your e-mail client to e-mail us for support. You may also directly e-mail support@csedesigns.com for assistance.
For those of you on Twitter you can Follow CSEDesigns to obtain technical support on the StationPlaylist Studio scripts. Keep in mind that response times may vary with messages sent to the Twitter account.
This is just the beginning of what is to come for the StationPlaylist Studio scripts. If you have suggestions or bugs to report about the scripts then please contact us. We are here to insure that your experience with the scripts is a rewarding one and we will be extremely responsive to bug fixes and enhancements as they come in from users. Refer to the prior section in the documentation for our contact information. Now, go get the scripts and happy streaming everyone.