This page describes scripts for each of the supported Ots AV applications. To choose between the various applications, navigate level one headings in this document.
To allow the Time Remaining feature to work, which lets you determine how much time remains in a deck that is playing, you must register a DLL file, which is provided in this archive. The DLL file is called DazUtil.dll, at it will also be placed in your settings\enu folder, but you can move it to any folder you like. Moving it is not a bad idea, since it will then remain even if you change versions of jaws and delete the old jaws folder. But, you should not move it after you have registered it, since the act of registering it tells windows where it is located. A great place to put it would be c:\windows\system32. Assuming you have placed it there, go to the start menu, and choose run.
When the run dialog opens, type in the following:
regsvr32 c:\windows\system32\DazUtil.dll
After you click the OK button, if you have typed the command correctly, Windows will register the DLL, and you will get a happy little success message.
In addition, you must have a copy of an authorization file, snow_otsjuke.jsb in your user-specific settings\enu folder. If you are running the scripts as a demo, you need to download the temporary authorization file appropriate for your version of JAWS. If you purchase these scripts, you will be sent a permanent authorization to replace this temporary file.
If you have a demo copy of these scripts, you can obtain an authorization file for 30 dollars US by sending an e-mail, specifying your jaws serial number, to the SnowMan Snowman@SnowManRadio.com.
The Scripts should function in demo mode for about a week, giving you plenty of time to get acquainted. After a week, they will become unusable. At that time, delete all otsAVPro files from your user-specific settings\enu folder to avoid annoying error messages.
To learn about the scripts, check the hot key help by using insert+h. Then, use your up and down arrow keys to explore the list of hot keys.
Due to recent handling of graphics and frames in JAWS, we have had a lot of trouble keeping up with the many different combinations of screen reader and Operating system versions, each of which works differently. These scripts were developed using 1024 by 768 screen resolution, and 32-bit true color depth. You will have best results if you can use these same settings.
If RefreshScreen did not correct problems finding controls, , it may be necessary to label the graphics for your particular system. This is discussed in more detail below as a remedy. but, we are now recommending that you always do this when installing the scripts. You should only need to do this once. But, it takes several minutes, and you should not type any keys while the automatic labeling is in progress.
If your problems in locating graphics are not occasional, but are total and complete, you may need to relabel the graphics on your system. This is because, due to some internal problems with Jaws, graphics labeled on one system do not always translate correctly to another system.
First, to make sure all the graphics are available, import music into your media library. Then use the edit menu to generate a play list. In the generate Playlist dialog, uncheck the item that causes Ots AV to start playing automatically when the playlist generation is complete. This will allow JAWS to label the graphics while Ots AV is not playing any tracks.
Once a Playlist has been generated, , start the auto graphics labeler with control+insert+g. You will hear a strange, wheedally wheeddally type audio sounder as Jaws moves to, and tests each graphic. There is quite a number of graphics, so this will take a couple of minutes. Please chil out, and do not touch the keyboard while the labeling proceeds. When it does complete, it is generally a good idea to restart jaws to make sure the graphics take affect.
If this does not work. press control+l to focus on the playlist. Next, try insert+escape to refresh the off screen model. And as a last resort, alt tab away from Ots AV and release the keys. When focus moves to another aplication, alt+tab back to Ots AV. If you still have problems, if even the last resort did not work, close and restart jaws.One of these usually is enough to get things started again. We eagerly hope that FreedomScientific will address the keyboard handling problems in their next release.
Start the Ots Player. Make sure JAWS is set up to speak all graphics, not just labeled graphics. Do this with insert+v, then g. Press space bar until JAWS says, all.
Go to the Options menu and choose the Window mode submenu. This is normally set to compact. But, you should select Normal, and press enter. This will get returned to the compact setting when you restart jaws, or alt tab back into the Ots Player.
Use the JAWS cursor to explore the group of graphics immediately below the menu bar. You will hear jaws speak the tool tips, which identify the meaning of each graphic, as well as a graphic number. You can use insert+left and right arrows to move from one graphic to the next.
When on each of the graphics, press shift+insert+g. Please note that this is a different hot key than the one used to do autoGraphics labeling. This wil cause jaws to grab the tooltip, and create a label for this graphic. Repeat this until all graphics with tooltips have been labeled. When this process is completed, you should hear tooltip names instead of graphic numbers as you arrow around with the jaws cursor, and the script controls should now work as expected. In fact, you'll probably hear the tooltips spoken twice now.
There are a couple of unexpected things here. The Pause graphic, actually becomes an "Unpause" graphic when you click it while a track is playing. So, you'll need to start a track playing, and use the jaws cursor to find the Unpause graphic, and label it separately. Also, on some systems, jaws speaks the name of the find button when the tool tip for the Stop controls appears. Just go ahead and label this as normal. The Stop label appears to get applied to the proper graphic.
To make sure your decks are properly positioned, choose Deck Positioning in the options menu, and choose top.
This was always a problem with jaws 10.0 and scripts prior to 1.1d. However, that is fixed in scripts version 1.1d.
To tell Ots AV what music to play, you must import folders of OTS, or MP3 files into your Media Library. This becomes a list of songs you can choose from. You can then let Ots AV randomly select songs to build a play list, or you can search for tracks yourself. Typical use involves randomly generating a playlist first, then deleting unwanted tracks and manually searching for tracks to add to the list.You can modify the list in real time as Ots AV is playing music.
Recent versions of Ots AV include a live input which allows you to connect a microphone for use with Ots AV. You can talk over the music, or talk when both decks are stopped, and your voice is fed through that same great compression software that gives Ots AV that cool professional, punchy sound.
You can browse these lists with up and down arrow keys, and can even search for a ntitle, artist, or start time in the list that currently has focus by using the control+shift+f command. If the selection can be found, the selection will be taken to it.
You can cut and paste to move songs between the various lists. Hot keys are provided to place focus on each of these lists. When dialogs are closed, or when Ots AV gains focus, the scripts will attempt to place focus back in the list which most recently had focus. Insert+tab should tell you which list has focus at the moment, but you can always just press the appropriate hot key to focus on the one you want.
Each entry in this list consists of four fields, start time, title, artist, and length. The scripts are intelligent enough to skip the start time field when you are arrowing up and down. This allows you to hear song title first, rather than having to listen through the start time before getting to the title.
Hot keys are also provided to repeat the entire entry including start time, or to just repeat the title, artist and length. Press control+l to focus here.
Hot keys are provided to allow you to set rating or category information, to find a track, or to automatically add the selected track to the playlist. Before you do that, you should switch to the Playlist, and select the track before which the new track should be added. Then, switch to the media library, locate the desired track, and press the hot key. The track will be added, and focus will return to the media library.
Another way to add tracks to the playlist is to press control+o to open the search dialog. This is discussed in more detail elsewhere, but allows you to type in artist or title information, and then browse a list of entries that matched your criteria. Then, hot keys are provided to allow you to copy the track to deck A, deck b, playlist as next, or the clipboard.
Press shift+control+l to focus in the media library.
You can now pop a track out of either deck, into the clipboard. This is handy when you change your mind at the last minute, after the deck has already been loaded.You can then paste the track wherever you want it.Control+Shift+w pops the left deck, and control+shift+u pops the right deck.
For each deck, there are two toggle buttons, one for choosing whether the deck is placed on the air or not, and the other for choosing whether the deck is routed to the queue channel. All four combinations are actually possible. So, if the scripts get out of sync with Ots AV, it is possible to have a deck routed to both queue and air channels, or routed nowhere at all. These two states are less likely to be useful, and are not intended. But, if it ever happens to you, you need to toggle one of the two buttons in order to return to a valid state. So, two emergency hot keys are provided to help correct this situation. Alt+control+minus on the numbers row toggles the cue button for deck A, while alt+control+equal sign toggles the cue button for deck b. This allows you to get back to valid states. This problem is very rare, but, at least, a work around is now provided.
You can use the jaws cursor to help set this up.
Move to the top of the application, and cursor down, looking for a line that says:
SelectBetweenPitchAndDirectionControls
Further to the right on that line, is a set of graphics, four of which are the buttons to control which output to use.
Of those four, there are two for decA and two for DecB.
When you click one of those braphical buttons, it will change to a different graphic, indicating it's state.
First, press alt+control+f2 to put decA to air, and alt+control+f6 to put decB on air.
Then, examine, and click if necessary, the four buttons.
The pattern you should see, for both decks to go to air, and not to the cue, is as follows:
DeckToAirOn DeckToCueOff DecToAirOn DecToCueOff
As you click a graphic, it will toggle between on and off states.
Click as needed to establish the above pattern.
Once you have done this, if necessary, the alt+control f1-f2 and alt+control f5-f6 hotKeys should manage these for you.
To use this feature, you need a second sound card, and need to go to the view menu, output configuration, and use the jaws cursor to enable the cue output, and click the, set, button in order to choose a sound card to serve as the cue output.
These keys for auditioning tracks are different from the PlayThis track hot key, alt+n. The alt+n places a selected track on the air immediately. To use this key, cursor down the playlist to find a track you want to play right now. Press alt+n, and the presently playing track will be faded out and ejected from it's deck, and the selected track will start playing in the idle deck. In contrast, the audition keys do not cause ejection from the other deck, but allow it to continue playing on the air while you audition the selected track. Also, the audition keys do not remove the selected track from the playlist.
You can also use alt+i to insert any of the special directives provided by Ots at the current position in the playList. You can have more than one directive, such as stop and reload, and turn on the microphone, or to pause the playlist until a given time is reached.
key control+c copies the song your cursor is focused on, into the work area. You can do this from the play list or from the history list. The song will remain in it's initial location, and also will be placed at the end of the work area.
The following keys apply to Deck A. These can be extended to keys f5-f9 when discussing Deck B.
For Deck A:
Load a track into Deck A, press control+shift+f2.
Start Deck A playing, press f2.
Start Deck A playing, and enable autoDJ, press shift+f2.
Pause Deck A, press f1 while deck A is playing.
Stop Deck A, and return to start, press f1 twice.
loop on a small region, or slide these regions left and right with control+shift+f3 and control+shift+f4.Resume normal playback with f2.
Hot keys are provided to speak the title of the track playing in each Deck, f11 and f12 perform this function for Decks A and B respectively.Additional Deck status is acquired using control+shift+A or control+shift+b.
To toggle automatic announcement when a song is loaded into a deck, use control+f11 and control+f12.
There are two methods for doing this calculation. If the other deck is empty, then the next track will be the top item in the playlist. The scripts subtract the present time of day from the start time of the top item, and report the difference in minutes and seconds. This method is fairly accurate. If it does not work on your system, one possibility is that the utility DLL, called DazUtil.dll is not registered in your system. Consult the installation instructions on how to get that DLL registered.
However, if the other deck is also loaded, then the next item to play will be the track in the other deck, not the top item in the playlist. We no longer know the start time for the second deck, and thus have very little to go on.Therefore, the scripts attempt to capture the length of a track when it is loaded into a Deck. This includes when a track is moved into a deck from the playlist, but also includes copying a track from the search dialog. If the track length is not known, the scripts will open the search dialog, and attempt to find the next track in the media library in order to learn the track length. There are, unfortunately, still cases where this process becomes confused due to the pseudo random order in which jaws sometimes processes events. So, it is possible that a deck can be associated with the incorrect start time. However, as we shall see shortly, the consequences are very minor.
If this second method of calculating time remaining is necessary, the scripts scan a progress bar which is created for each Deck by Ots AV, calculate the percentage of completion from this bar, and apply that percentage to the track length associated with this deck. As an example, a trakc which is 4 minutes and 40 seconds long, and which is 98 percent complete, will have 5.6 seconds remaining. The scripts would report 5 seconds remaining.
However a track that was only 3 minutes and 30 seconds in length, but which was 98 percent complete, would have 4.2 seconds remaining. Jaws would say 4 seconds remaining. So, while we had the wrong start time, the time remaining reported was off by only one second when it came down to those last remaining seconds. Every effort has been extended to assure that the correct start times are loaded, but there are so many variables to this problem that absolute accuracy can not be guaranteed.
If, for some reason, jaws fails to detect a track being loaded, and, therefore, does not know the length of the track in minutes and seconds, the scripts will revert to speaking the percentage complete. A four minute track has ten seconds remaining when it is about 96 percent complete. So, you can still get a pretty good qualitative feel for when the track is going to end.
also, you can adjust to any other time zone you wish. To do this, you must set an offset which represents the number of hours between local time on your computer, and the time zone you want. Once yu set this up, if you are running jfw 3.7 or later, the offset will be saved in a otsAVPro.ini file in your settings\enu folder. This will be reloaded each time you switch focus to Ots AV. However, if you are running an earlier version, you must set this up each time you start jaws.You must also change this setting manually to account for daylight savings time.
To set the offset, press shift+alt+t. This is a list of offsets which you can choose with your arrow keys, or by just typing the letter that corresponds to your offset.
Let's assume we wanted to set up the offset between local time and universal time. To figure out the offset, a value of 0 means you live in England or somewhere that is actually the same as universal time. In creasing offsets mean you are moving west from England. When we are on standard time, the East coast of the United states, would use a value of 5, which is an offset letter of f. the west coast would use a value of 8, for a letter of i. This wrapps around such that users in Germany, which is one hour east of GMT would use an offset value of 23. This equates to an offset letter of y. So rather than cursoring down through the list looking for 23, our German friends would simply type the letter y, then press enter to make the selection.
To hear the adjusted time spoken, press control+shift+t.
Only certain sound setups will be able to use this feature. You need to have multiple sound cards, such that Ots AV uses one of the cards, and winamp uses another card. This is because, the special sounds triggered by the hot keys are played through a copy of winamp. If you are ShoutCasting, you will need to have a separate copy of Winamp as your transmitter, and will need a mixer to combine the Ots AV and Winamp outputs in analog before sending the combined pair to the transmitter sound card.
to use this, go to the edit menu, generate playlist dialog, and load your favorite template. You can then generate a playlist, or simply cancel out of the dialog. Either way, the selected template will stay loaded. The AutoGenerate feature will use that same template when it generates your next playlist, as long as Ots AV is still running.
The scripts key on the appearance of the track titled
Toggle this feature on or off with the control+shift+p hotkey.
The Ots AV MP3 converter has no menus. The controls are accessed by pressing tab and shift tab keys to move among the various controls. In addition, the scripts provide hot keys to immediately focus on controls of frequent interest. The insert+h help dialog lists all hot keys. Use your arrow keys to explore this list. In many cases, you can just press enter on the item you desire and it will be performed. You will save time, however, by learning the hot keys and pressing them directly. In some cases, where the item is more informational than an actual function, pressing enter will cause no action. You can always press escape to exit the insert+h dialog without performing any action.
In general, press space bar on a check box to toggle it's state, or on an action button to activate it.
There are three main panes to this application.
1. The MP3 files pane, where your MP3 files are listed.
Both of the files panes consist of a button to select which disk drive to use, a button to go up one level in the folder structure, an edit box where the path of the present folder is displayed and can be edited, and a list of files in the present folder.
When pressed using the space bar, the select drive button will bring up a list of disk drives. Select one with the arrow keys, and press enter. The current path will be spoken, and you will be focused in the corresponding files list.
Likewise, if you edit the path name and press enter, the files list will be updated to the new folder, and you will be focused in the corresponding files list.
The button to go up one level is not strictly necessary since you can do this by pressing backspace in the files list. Doing so will cause the new path to be spoken, and focus to return to the files list.
When focused in one of the files lists, you can use the arrow keys to highlight files in the usual way, Shift+downArrow selects the current and next files etc. Insert+shift+DownArrow lists all selected files. This list appears to behave exactly like explorer, even allowing multiple non-contiguous selections by holding down the control key.
this list can contain both files and folder names. Normally, you can infer whether an item is an mp3 file or a folder simply by its name. But, if you have doubt, press the SayLine key insert+upArrow, and jaws should say either file, or folder, before speaking the name. This is done by recognizing the graphics that appear to the left of the name. These graphics were labeled at 256 colors and 800 by 600 resolution. If these are not recognized on your system, and you want this feature to work, you may need to relabel them yourself. If you need to do this, switch to all graphics verbosity, place the jaws cursor on the graphic, and press insert+g. Then type the word you want spoken, any name is valid, and then press enter. don't use the tab key to find the OK button in the graphics labeler. The scripts can not presently determine that the graphics labeler is active, and the tab key has been redefined to work with this truly weird application.
The options pane consists of two or three groups of radio buttons, and some check boxes. The tab key will move you from one group of radio buttons to the next, as well as to each of the checkboxes, then on to a set of action buttons. When in a group of radio buttons, the up and down arrow keys cycle you through the radio buttons in the present group.
Once you press the space bar on one of the action buttons to start a conversion, the converter will behave differently depending on what options you have chosen. In some cases, it will prompt for further information. You can use the tab key to move through the various fields requested in the standard manner.
After closing the OTS MP3 Converter, I always have to minimize all apps with insert+f6 before I can alt+tab to other applications. This is not a function of the scripts. But Perhaps, future versions of the scripts can remedy this situation.
If your ots player script controls do not function as expected, see the section on Labeling Graphics In The Ots Player in the trouble shooting section above
Use the file menu to open an ots file, or press enter on an ots file in explorer to activate this program and begin playing the first track in an OTS file.
When the program opens, focus is placed in the list of tracks. Use up and down arrow to browse the list of tracks. Press enter on a track to start playing it. Incidentally, this is the normal enter, not the numPad enter.
Press insert+pageDown to hear the status line, the name of the currently playing track, and the time. The time, at the right end of the status line is composed of two fields which are of the form : aa:bb/cc:ddwhere aa:bb is the time elapsed in the track, and cc:dd is the total length.
The scripts organize the controls in the OTS Player to look very much like the winamp hot keys.
To stop play back, press the v key.
Also, you can start continuously skimming backward or forward through the file by pressing insert+NumPad Left Arrow, or insert+NumPad right arrow respectively. Again, play must already be in progress for this to work. To stop the skimming operation, press 5 on the NumPad.
Use insert+h to explore a list of hot keys using your arrow keys. Then, press escape to return to the main program.
Purchase of these scripts entitles you to scripts for all three of the applications described here. Click on the link below to contact the SnowMan to purchase a permanent authorization file. Please include your Name and jaws serial number so your authorization file can be constructed. If you want to pay by credit card, do not include your credit card numbers. The SnowMan will send you an invoice via the ProPay system. You will receive a link to a secure web site where you can enter your credit card information. They will send us a notification when your transaction is complete, and you will receive your permanent authorization file via e-mail attachment.
Naturally, we would love to hear from you. Send e-mail to:Snowman@SnowManRadio.com.
Use your backspace key to browse the rest of the JAWS scripts offered by The SnowMan.
Summary of Functions
Here is a brief summary of functions supported by hot keys:
Stop
play, automatically enables auto DJ
Previous Track
NextTrack
Insert stop And ReQueue directive before focused item
Enable or Disable Auto DJ
check AutoDJ Status
Start Either deck and enable auto dj.
Force live input off
Start the music and kill the mike.
Search for a track in the database.
Audition a track in either deck.
play a selected track right now.
Eject Eitehr Deck.
Pop the track in either deck back to the clipboard.
Find out when the next station ID will play
Speak the status of either deck, including which song is playing in that deck
Determine the time remaining for either deck
Focus on main Play list
focus on history
focus on Work Area
Focus on Medial Library
Speak Universal or adjusted Time
Assign a rating to a selected track.
Assign the selected item to a category.
Add the current item in the library to the playlist.
toggle the automatic playlist generation feature on or off
Ots MP3 Converter
The Ots AV program can play MP3 files directly. But, it is handier in many cases to use the OTS proprietary format. Sound files must be converted from MP3, into the OTS format. This is done using the Ots MP3 converter application.
This is no longer required for OtsAV, but is included here In case you still have Ots DJ.
2. The OTS files pane, where your OTS files are placed.
3. the options pane, consisting of a series of radio buttons, or checkboxes which you can set up to control the way the converter behaves. In addition, there are several action buttons wich cause various things to happen.
Ots Player
The Ots Player is similar to winamp, in that it allows you to listen to selected OTS audio files. It is the program that runs if you press enter on an OTS file when in explorer. An OTS file can contain one or more audio tracks. You can play any of the tracks listed in an OTS file by arrowint to the selection you want and pressing enter.The nice thing about the OTS player is that it is extremely quick, very responsive.
z = previous track
b = next track
c = pause.
Start playback from the start of this track, press x or enter.
Use the NumPad arrow keys to skip backward or forward in the currently playing track.