I Can Work This Thing!

Adding scripts to VoiceOver

Click here to skip introduction and jump to script files.

VoiceOver's capabilities can be extended through the use of scripts. A script is a small set of instructions for the computer that you can trigger with a keystroke. A script can speed up some tasks by automatically performing some actions that might normally take many steps to complete. Scripts can also provide access to some features that aren't accessible through the normal operation of VoiceOver by directly controlling applications.

VoiceOver scripts use AppleScript, the most common scripting environment for the Mac. Normally, each script is contained in a single file with an SCP extension. These scripts can be opened directly from the Finder, and you can review or edit them with the AppleScript Editor that is installed along with the Mac OS. However, to be able to quickly activate a script when needed, you'll probably want to use the VoiceOver Keyboard Commander to create a keyboard shortcut that can instantly trigger the script. To assist you with this, I will describe the basic process below. In many cases, though, you can adjust parts of these instructions to suit your own particular situation.

Once you have a script that you would like to use with VoiceOver, you should copy the script in to your user scripts library. It is actually possible for the script to be located anywhere on your computer, but some of the scripting tools will have an easier time finding your scripts if you store them in your user scripts library. Your user scripts library is located in your home folder, under Library, and then Scripts.

Now, you need to assign a keystroke to the script using the VoiceOver Keyboard Commander. The Keyboard Commander makes it possible for you to create your own custom commands for VoiceOver. Press VO-F8 to open the VoiceOver Utility. In the Utility Categories table, select Commanders. Next, select the Keyboard tab. If you've never use custom commands or scripts before, then be sure to enable the Keyboard Commander by checking the checkbox, and select a modifier key. The modifier key is a key that must be held down together with the keystroke that you assign. For example, if you select the left option key as your modifier, and you create a new command on the A key, then you'll need to hold down the left option key and press A to trigger your new command.

All of the commands that are active for the Keyboard Commander are shown in the Keyboard Commander table. TO add a new command, press the Add button, immediately following the table. When you press the Add button, a new row will be added to the Keyboard Commander table, and your focus will be moved to the key field on this new row. Press the key that you'd like to assign to the script. You can only press a single key on the keyboard without any modifiers. Once you've selected a key, press tab or use the VoiceOver navigation commands to move to the second column, where you'll find a pop-up menu for setting the action for this key. In the menu, select the Custom Commands submenu, and then select Run an AppleScript script. A file dialog will appear. Navigate to, and select, the script that you'd like to assign to the key.

That's it. When you hold down the Keyboard Commander modifier, and press the key that you selected, your new script should run. If it doesn't run, be sure that the Enable Keyboard Commander checkbox is checked, and review the Keyboard Commander table to be sure that the correct key was assigned to the new command.

Click the name of the Script from the list below that you want to download.

Move File Script

Use this link to download the Move Files Automator Workflow with instructions

Disclaimer: The information on this site is provided as a public service to the blind and visually handicapped community. While we have done our best to ensure the information provided is accurate, please realize the use of any information on this site is solely at your discretion and we take no responsibility for use or attempted use of this information.

Copyright © 2003-2015 Bibles for the Blind, Inc.
Report Errors and website comments to support@optimusmedia.com

Hosted by OptimusMedia.com