This file is generally relevant to Sound Forge 8.0 as well.
Sound Forge gives you access to a wide variety of tools with which you can shape your audio project to your exacting requirements. As such, the user interface is replete with controls which are rendered accessible by these scripts. Many of these controls are sliders which allow you to use the arrow keys, or page up and down keys to change the value of a given parameter. Without the aid of scripts, the value of these sliders can not be read. These scripts cause the value of the slider to speak as you change it, and allow you to read the present value with the SayWord command.
But, beyond just making the intended user interface accessible, these scripts ad extra features that go beyond what is available to the sighted user. This includes such things as the
Two files are required to install these scripts. The name of the first file depends on which version of Jaws you are running. Note, If you are running Sound Forge 8, you will need Sound Forge version 8.0b. You can get the sound forge 8 scripts here by clicking the next link. But, do come back here and read, because almost all of this discussion is equally relevant to sound forge 7 and 8. Sound Forge 8 Page
The Sound Forge 7 scripts are here: For Jaws 4.x, Download File jfw4_forge70_626.zip.
For JAWS 5, 6 and 7, Download File jfw5_forge70_v632.zip.
These files contain the scripts required for your version of jaws. Place the contents of the appropriate Zip archive, into the settings\enu folder under your jaws main folder.
If you have not yet purchased a copy, but want to take the scripts for a test drive, you can
download a demo authorization file here.
Make sure you choose the correct one for your version of jaws.
temporary Authorization File for JAWS 5.0 or later temporary Authorization File for JAWS 4.5
Unzip the snow_forge60.jsb file from this archive, and Place it in your settings\enu folder.
To make sure the scripts are installed correctly and are operating, while in sound forge 7.0, Press insert+q. Jaws should report Scripts version 6.32, for Sound forge 7.
Also, check out the hot key help using insert+h. Use your up and down arrow keys to browse the list of hot keys. Press escape to close the list and return to Sound forge.
If you are running the demo version of these scripts, you will have approximately ten minutes to play with the scripts before the scripts will cease to function. You can get another ten minutes by closing and restarting jaws. To obtain an authorized copy, write to Snowman@SnowManRadio.com.
To interact properly with sound Forge, the scripts need to locate and click various graphical buttons on the sound Forge Screen. With the multitude of operating system and video card combinations in use, we are finding that graphical images labeled on one computer, will generally not work properly on another machine. This is why there is an extensive discussion of graphics relabeling under the trouble shooting section. Expect to have to relabel your graphics with the AutoGraphics labeler as described there.
In addition to allowing access to all the controls and sliders in the Sound Forge user interface, these scripts allow you to use your arrow keys to skim through the audio, much like you do when skimming with your CD player. So, locating specific sound passages strictly by listening to the audio is a snap. This means that, when you operate the NumPad arrow keys, the sound file should start playing from the cursor. Specifically, when you press a right arrow, for example, the sound cursor will move forward in the file, by an amount controlled by the zoom ratio, and playback will begin from that point. Likewise, when you press a left arrow, the cursor will move backward in the file, and playback will start from the new position.
The Zoom Ratio is controlled by the up and down arrows. Higher zoom ratios mean that the sound cursor will move further in response to an arrow key. Typical use is to use higher zoom ratios to move quickly through the file to find a general location, then to decrease to zoom ratio to make finer and finer adjustments to the cursor position.
You can also use page up and page down or control+pageUp and control+pageDown to make larger jumps through the file. The control modifier makes larger jumps. You can use control with the left and right arrow keys, but this has special meaning in certain situations. If there are no markers, and no cut points, this makes jumps which are larger than regular arrow keys, but less than the page up and page down. However, if there is a marker in the direction you are moving with the control arrow key, Sound forge will jump all the way to the marker. This is handy, but the qualifications on behavior are something to be aware of.
There are a few modes which you can set which control exactly how this scanning feature operates. Each mode has it's intended purpose, as we shall see below. Use the alt+shift+NumPad 5 hot key to rotate between scanning off, relative, absolute and blip modes.
You can control the zoom ratio using the up and down arrows. This will cause sound forge to move in larger steps with higher zoom ratios, and smaller steps with smaller ratios. The duration of the blip played is also a function of the zoom ratio. Typically, you lower the zoom ratio using the UpArrow key when you want to make finer adjustments to the cursor position. You increase the zoom ratio with the DownArrow key when you want to make larger movements with each press of the left or right arrow keys.
Tip: you can turn on loop playback with the Q key while in blip mode, and sound forge will repeatedly play the small selection. This can sometimes give a better view of the adjustments you are making.
If you have data selected, and attempt to use blip mode while pressing the shift arrow keys, the scripts will revert to absolute mode. This is because blip mode makes use of a temporary selection which can not be established without redefining your selection.
When you exit blip mode, if you press the space bar, you will usually find that data is still selected due to the way blip mode is implemented. This selection will be cleared when you operate the arrow keys, or you can press the s key to undo the selection.
When data is selected, you can telll the scripts to either play the selection, or play from cursor. Use the shift+control+NumPad 5 to select the desired mode. Often, such as when adjusting the end points of a large selection, you want to play from cursor to hear the details at the point of interest.
When data is selected, pressing the space bar will honor the rules established by the mode you have selected, i.e. play selection, or play from cursor. Also, you can use alt+control+t to hear the start and end times of the selection, or shift+alt+t to hear the length of the selection.
If you have a braille display, the length of the selection is displayed.
Let's suppose that we just established a marker at the left end of our intended huge selection, and dropped a marker there. Now. page down to find the point for the right end of the selection. The page down key just discarded the temporary selection, and now, nothing is selected at all.
Again, when you get near the intended right end of the selection, you can use blip mode to precisely locate the point where the selection should end. Once the cursor is there, press shift+control+LeftArrow. This will select from the cursor location, clear back to the marker we established earlier. Now, you can use the home and end keys to jump back and forth between the left and right ends of the selection. And you can press shift+alt+t to hear the duration of the selection to assure yourself that the operation was successful. Don't use any of the arrow keys by themselves, or you will discard that selection. But, if you want to make a fine adjustment to the right end, for example, press the end key. This will move the cursor to the right end of the selection, but leave the selection in effect. Now, use shift+control+NumPad 5 to change to play from cursor mode. Now, when you press the space bar, you will not hear the selection, but will start playback from the right end of the selection. To shorten the selection, press shift+LeftArrow. To lengthen it, press shift+rightArrow. In either case, you will change the length of the selection by an amount controlled by the zoom ratio, and will hear playback from the new selection end point. Do not use blip mode for this, unless you don't mind undoing your selection. Fortunately, you have a marker established, so, if you do lose the selection, you can still find the intended right end of the selection, then just use shift+control+LeftArrow to select all the way back to the marker.
To Drop a marker, press the m key. To move to a marker, press control plus the arrow key in the direction of the marker. Sound Forge will move all the way to the marker with a single key press.
If you think you are at a marker, press Alt+control+m. Jaws will tell you if you are at the marker or not. If you are at the marker, you can press alt+shift+m to delete the marker.
However, if you want to automatically monitor the level indications. double click the f12 hot key while recording, or while in the record dialog. Jaws will say "Clip Monitoring Active". As long as the record dialog is still open, the scripts will check the level indicators once per second for clipping in either channel. Because this is a peak level indicator, once clipping occurs, the clip status will remain until you clear it. Jaws will say "clip" once for each channel which has clipped, and will repeat this once per second to make sure you are aware of it. To clear this status, press shift+f11 or shift+f12 depending on which channel you want to reset. While clip monitoring is active, you can still press the f11 and f12 keys to read the status of the corresponding channel. In this way, you can determine which channel clipped.
Clip monitoring will cease when the record dialog is closed. It will not automatically activate next time you record. You need to intentionally activate this feature for each session in which you want to use it.
With some combinations of certain versions of jaws and Windows, the one second periodic monitoring schedule is not reliably maintained. This is out of the control of script development and, unfortunately, can not be addressed.
To assign a hot key to a file, make sure you are focused in the data window, and control+tab to the file you want to mark. Then, press shift plus the hot key you want to use. valid keys are 0 through 9 on the numbers row. Jaws will speak the name of that file, and record the assignment.
You can now move to other files, open new files, or perform any other actions you want. When you want to return to the marked file, while focused in the data window, press the numeric key you assigned. Jaws will speak the name of the file, and focus will be placed on that file. Of course, if you have closed the file, you are notified that the file is not currently open,and no action takes place.
Because sound forge remembers what files you had open when it is closed, the scripts remember your hot key assignments as well. So, when you reopen sound forge, those same assignments will be present. No need to worry about deleting unused assignments. Just reassign them when you need them.
If you have data selected, the time becomes the selection length, and is enclosed in less than and greater than signs, such as <00:01:23.456>. These signs make it very obvious whether or not data is selected.
Also, while focused in the data window, you can press a routing key to jump playback through the file. The scripts will calculate a new start time based on the routing key you pressed, the total number of routing keys on your display, and the total length of the file. It will then jump sound forge to that location and begin playback. this is very handy for quickly jumping around the file.
The amount of time between two adjacent routing keys depends on the length of the file, and how many keys are on your display. The way to calculate this, if you care, is the total time divided by the number of keys. For example, on a 32 character display, with a 5 minute file, the time jump from one key to the next is calculated as 300 seconds divided by 32 keys, or about 10 seconds per key.
Of course, the routing keys work as normal if you are not focused in the sound forge data window.
If a list appears, use your arrow keys to explore the list, or just type the first letter of your favorite item, then press enter to click the button.
Press insert+h while in the pluggin manager to see what hot keys apply to your version of Sound Forge. The sound Forge 8 pluggin chainer is slightly different.
In Soundforge 7, Some commonly used items have direct hot keys. for example, alt+p to preview the sound. Press alt+A to add a plug in to the chain. A dialog will open which allows you to select a plug in to add. You must click the Add button, by tabbing to it and pressing the space bar. In this way, you can add several plug ins consecutively. When you are done adding plug ins, press Ok. You are then placed in a multi-page dialog, with one page for each plug in in your chain. As you press the tab key, you move through the various parameters which can be changed for the currently selected plug in. To move to the next plug in in the chain, pres control+tab. Or, press shift+control+tab to move to the previous plug in. This navigation does wrap around, but the scripts always tell you which position the current plug in occupies in the chain.
You can modify the order in which plug ins appear in the chain. To do this, the scripts enter a special mode, as described in the help. Press insert+f1 while focused in the Audio Plug In Chainer for more details. But, suffice it to say that you have complete control over the order of the plug ins, and that you can selectively enable or disable any plug in.
If your NumPad arrow keys do not cause playback, yet you have a single audio file loaded, and have the scanning mode set to absolute or relative, here are a couple of things to check. Use the alt+control+numpad 5 toggle key to change between original and standard stop methods. This has to do with how the scripts operate the transport controls. The standard method uses graphical buttons to control playback. The original method uses the menus to control playback. The standard method is much more responsive and is preferred. If the arrow keys cause playback in the original stop method, but not when using the standard stop method, then the scripts are probably clicking the incorrect location for the PlayNormal graphic. In some cases, this can cause the Plug In chainer window to pop open. Before you proceed, you must close that Plug In Chainer window. press alt+9 on the numbers row to focus on the Plug In chainer. then, press control+f4 to close that window. Now, do not use the left and rightr arrow keys until the remedies below have been attempted, because the Plug In Chainer window will most likely pop open again.
when playback does not occur when you operate the numPad arrow keys, then the first step is to retrain the location of the graphical controls. To retrain these locations, both in Sound Forge 7 and 8, press alt+control+shift+t. Then, use your up and down arrow keys to choose yes and press enter. The retraining process takes only a second or two. Once complete, the resulting information is stored in the forge70.ini file in your settings\enu folder. This should allow the standard stop method to work correctly. If not, then, if you receive a message that jaws was unable to locate a graphic, then you are the lucky recipiant of idiosyncratic behavior, where in jaws does not recognize graphics labeled on one machine, but used on another. This has become increasingly common with jaws and Windows XP. You will need to relabel the graphics as described below. then, you will need to retry the retraining exercise with alt+control+shift+t.
Sound Forge 8 does not use these graphics. But, Sound forge 7 does use them. Because of the problems with graphics, there are systems in which the AutoGraphics Labeler described below does not detect any tool tips, and thus labels 0 graphics. On other systems, even though graphics are labeled, the retraining exercise fails because the JAWS FindGraphic function is unable to find graphics by name. In such cases, it is possible to label the most crucial position yourself. Near the bottom of the sound window in Sound forge is a series of buttons. These are labeled GoToStart, GoToEnd, Stop, PlayNormal, and Open PlugInChainer. If the AutoGraphics labeler succeeded, you might be able to find these with the jaws cursor. If not, you may need a sighted person to position the mouse for you. The text labels do not appear on screen until the mouse is positioned over the button. the one we want is the PlayNormal button. Position the mouse on that button, and press alt+control+shift+A. This will capture the screen coordinants and record them for future use, and should enable your NumPad arrow keys to perform audio scanning..
Navigate to the settings\enu folder for the version of jaws you are running. Locate and delete file forge70.jgf. This is the jaws graphics file which will be recreated with the automatic labeling process.
Now, return to Sound forge and make sure you have a single sound file loaded, and are focused in the main data window. Press alt+0 on the numbers row to focus in the data window. Use your jaws cursor to explore the Sound Forge window to make sure no other windows have come open. Most likely, is the audio plug in chainer window which will pop open if the scripts clicked the incorrect location when attempting to start playback when you used the scanning arrows. Find the close symbol and close any open windows other than the single sound file you loaded. Leave that sound file window open. Just make sure the audio plug in chainer is not open.
Next press control+insert+g. This starts a special version of the jaws autoGraphics labeler. You will hear an announcement, along with a repeated wheedally wheedally sounder. The sounder plays each time jaws moves on to the next graphic. If the graphic posts a tool tip, the scripts will capture the tool tip and label the graphic. You will hear the tool tip spoken. You may hear wheedally wheedally sounds with no speech. These are cases where the graphic did not produce a tool tip and thus can not be labeled, but jaws is waiting just to make sure. This entire process takes a minute or so. Do not use your keyboard while labelling is in progress. When the process completes, jaws will announce the number of settings derived, and that wheedally wheedally sounder will cease.
If you did not hear jaws speak any tool tips as this process took place, and, at the end of the process, jaws says that zero settings were derived, then no tool tips were posted. There is a setting in the view menu|toolBars dialog, which must be checked to allow tool tips to be displayed. Make sure that item is checked. Also, with windows XP, I did see a case where, even though tool tips were enabled, Sound Forge was not posting them. However, when I closed Jaws, the tool tips started appearing. After restarting jaws, the tool tips continued to appear, and the graphics labeling worked properly. I have no idea why this is. Your guess is as good as mine. but, it is important that those tool tips appear and are spoken in the labeling process.
Starting with scripts version 6.3, ToolBars are no longer needed. Since these can cause trouble if they float around, obscuring other windows, proceed to the View Menu, the toolbars dialog, and make sure all tool bars are unchecked.
Sound forge is a very versatile program, allowing the user to rearrange the screen in all kinds of ways, some of which can make things essentially unusable for blind folks. As a last resort, if your scripts used to work, but things somehow got changed, you can force sound forge back to it's installation defaults. Close Sound forge. then, move to the icon on your desktop which would start sound forge, and hold down the control and shift keys and press enter. Continue to hold down the control and shift keys until the program opens fully. This will probably override other preferences you have set up yourself. but, it should make the screen format revert to a usable state. Among other things, You will have to reset your sound card choices in the Options\preferences|wave page.
One thing that causes problems, is the minimize symbol that is associated with each opened sound file. don't click that minimize symbol with the jaws cursor. it seems to make the transport controls disappear. If you do that, close and reopen that sound file.
Once you have successfully trained the main window, switch focus to another application. Then, return focus to Sound forge. This causes jaws to read the new graphics file you just created. Then, use shift+alt+control+t and select to retrain the controls. This retraining process should succeed this time, and the scanning arrow keys should work properly.
Now, activate the Audio Plug In Chainer with alt+9 on the numbers row. Then press control+insert+g again to label the graphics in the plug in chainer. Again, do not press any keys while labeling is proceeding. When that completes, use control+f4 to close the plug in chainer window.
Finally, use control+r to activate the record dialog. Once the record dialog is open, press control+insert+g again to label the graphics that appear in the record dialog. Again, most graphics in here do not produce a tool tip. but five or six tool tips should be spoken before this process completes. Again, you may need to run this a second time to get it to find the important graphics, such as record. Then, press escape to close the record dialog. Again, it's a good idea to restart jaws, or to switch to another application, then back to Sound forge, to put the new graphics in effect.
In this dialog, when you press the tab key, jaws speaks the center frequency of the band of the slider gaining focus. Use the up and down arrow keys, or page up page down to change the gain of that slider. Or press numPad 5 to read the present value. Values are reported in Decibels.
We have heard of cases where JAWS no longer recognizes the slider controls as sliders. We know this means that window class names changed on an individual's system, but do not know the root cause. the solution is to tab to a slider, then press JAWSKey+7 on the numbers row to activate the Window Reclassification dialog. PYou will be focused on an edit box showing the true class name. Usually, it has the word Fader somewhere in that name. press the tab key to go to the list of classeswhich JAWS can assign to this window. Press the S key and choose Slider. Then, tab to the add button and press enter. This tells jaws to think of that weird window class as a slider. Then close the window reclass dialog.
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.