Important Messages, such as Service Disruption and Opening Times.

Our office hours are Monday to Friday, 9 AM to 5 PM UK time. We will try to give assistance to those people not living in the UK outside of those hours if possible.

JAWS Scripts for the Sonos Controller


Thank you for installing the JAWS scripts for the Sonos Controller. Sonos produce a range of sound systems, which are capable of streaming internet radio and online music services, such as TuneIn Radio, Apple Music and Spotify. You can also configure the players to use your own music library. In order to control all aspects of the devices, you need to use the Sonos Controller program for a Smartphone, tablet or PC. The JAWS scripts concern the Sonos Controller for Windows.
To learn more about Sonos devices, you may like to purchase the comprehensive guide to Sonos from a blindness perspective, Sonosthesia.

The scripts are distributed free of charge by Hartgen Consultancy. Because they are made freely available, what follows is a quick start guide concerning the functions of the scripts rather than a tutorial on the use of the Controller. Technical Support is not available for these scripts. They were developed for personal use. We hope you find them beneficial.


Simply Download the Installer for the scripts and run it. You should be able to install the scripts into JAWS version 14 and above.

Script Objectives.

There were two main objectives when preparing the scripts.

First, while most of the Controller is accessible, JAWS spoke rather too much (and often inaccurate) information when Tabbing through the options, which is the way in which you navigate all of the screens. This additional speech has been removed.

Many of the Setup screens contain explanatory text which cannot be read even with the JAWS Cursor. The scripts do allow you to read it if you wish.

Script Functions.

While it is possible to interact with most of the setup screens for configuring new players without reading the explanatory text on screen, it may be helpful to do so if you are a new user.

If you wish to read the text pertaining to a specific setup screen, press F12. After a short pause, you will hear the available text. Prior to interacting with any controls on the screen after the text has been read, press the NumPad Plus key to return to the PC Cursor.

As previously stated, when devices have been configured you can move through the screens in several ways. You can press Tab or Shift+Tab, use the Arrow keys, or keyboard shortcuts to activate common options. A menu bar is also available by pressing the ALT key. A list of keyboard shortcuts can be viewed by pressing Insert+H. This reveals a convenient list box, so you need not remember all the shortcut keys if you do not wish to. Simply press Enter on any one of them to activate it. First letter navigation is also available in this list box so you can find what you want quickly.

Because some controls, (such as interaction with Tabbed Pages and Radio Buttons) are not used in the way you would expect, additional guidance is provided automatically when you navigate to them so you will know how to work with them.

A keystroke exists to read the current song title and artist. This also allows you to hear what is upcoming, although the list of upcoming songs can be accessed easily via the queue list box. Press the keystroke twice quickly to place the content into the JAWS Virtual Viewer to review spelling.

Keystrokes exist to read the elapsed and remaining time of a playing song. This is delivered in a minutes and seconds format, such as 2 minutes 40 seconds remaining.

If you enter a music source, such as TuneIn Radio, Apple Music or Spotify, you can either view categories from the list box or press Control+F to find what you are looking for, then press Enter. JAWS will announce which section you are searching, such as "Searching Apple Music", so you are sure which source you are working within. Note that without the scripts, JAWS will always report that no results are found when you press Enter, even if they are, and will persistently announce this when navigating through. This has been corrected when the scripts are running.

When moving into various sections of sources, such as Apple Music, you can always press Escape to move back through levels. Press Control+U to move back to the main menu.

Keyboard Shortcuts.

  • Play/Pause Control+P.
  • Toggle Shuffle Control+E.
  • Toggle Repeat Control+R.
  • Toggle Crossfade Control+T.
  • Toggle Mute Group or Room Control+M.
  • Mute All Control+Shift+M.
  • Main Menu Control+U.
  • Go to Favourites Control+Star.
  • Scroll to Current Song in Queue Control+L.
  • Clear Queue Control+Shift+L.
  • Previous Track Control+Left Arrow.
  • Next Track Control+Right Arrow.
  • Say Song Information Control+Shift+S.
  • Say Elapsed Time ALT+Shift+T.
  • Say Remaining Time Control+Shift+T.
  • Decrease Volume Control+Numpad Dash.
  • Increase Volume Control+Numpad Plus.
  • Select Next Room Group Control+Full-Stop/Period.
  • Select Previous Room Group Control+Comma.
  • Play the Selected Track Next Shift+Enter.
  • Add Selection to Queue Control+Q.
  • Replace Queue with Selection Control+Shift+Q.
  • Resize Queue Control+G.
  • Update Music Library Control+Shift+I.
  • Find Control+F.
  • Close Active Window Control+W.
  • Read Help Text Which is Inaccessible F12.