{"id":28729,"date":"2023-07-07T11:12:06","date_gmt":"2023-07-07T18:12:06","guid":{"rendered":"https:\/\/www.podfeet.com\/blog\/?p=28729"},"modified":"2023-07-08T06:55:00","modified_gmt":"2023-07-08T13:55:00","slug":"voiceover-test-apps","status":"publish","type":"post","link":"https:\/\/www.podfeet.com\/blog\/2023\/07\/voiceover-test-apps\/","title":{"rendered":"How I Test Apps for Accessibility with VoiceOver"},"content":{"rendered":"
\"Follow
Follow My Leader was a Big Influence<\/figcaption><\/figure>\n

I am not blind, but ever since I was 9 years old, I have been fascinated by assistive tech for the blind. When I was 9, I read a book called Follow My Leader by James Garfield<\/a> in which a young boy named Jimmy is blinded by fireworks. In the book, Jimmy learns how to deal with his loss of sight, including learning Braille.<\/p>\n

As a little girl, I got a piece of cardboard and a punch from my dad\u2019s shop and I made dents in the cardboard to simulate the Braille dots of the alphabet on the flip side. I taught myself the alphabet sitting on the floor of my bedroom.<\/p>\n

When I was in high school, my mom began to lose her vision to macular degeneration. She faced it with courage and strength, and never once complained about it. The Podmom was amazing.<\/p>\n

When her vision was getting pretty bad, she had a salesman from VTech come to the house carrying a giant machine to demonstrate. The basic idea of the VTech device is in use today – it has a flat area where you place a piece of paper you want to read. Above that area is a large display (at that time it was a CRT) with a camera underneath that points down at the paper. The VTech had controls for zoom level, contrast, and colors.<\/p>\n

My mother was enchanted with the VTech and my father, who was devoted to her, wouldn\u2019t even let the salesman leave with the demo model, he bought it on the spot.<\/p>\n

This began my mother\u2019s love of assistive tech. She even did a review for the NosillaCast about a digital book reader that she was wild about. If you\u2019d like to hear her back in 2010 telling us about it, there\u2019s a link in the shownotes to NosillaCast #259 (her appearance is right near the beginning of the show)<\/a>. It’s an intelligent assessment of the book reader, and she even makes fun of me, so there\u2019s that.<\/p>\n

I enjoyed learning along with the Podmom about assistive tech for the blind. Eventually, I started getting interested in the built-in screen reader software on all Apple products called VoiceOver. I doodled around with it here and there, trying to figure out how it worked.<\/p>\n

I was starting to get the hang of it, and then I got a crazy idea. Maybe I could force myself to learn how to use VoiceOver if I committed to doing a Tech Talk at Macworld while blindfolded.<\/p>\n

It was just as nutty of an idea as it sounds, but I didn’t learn VoiceOver without help. A lot of blind folks love podcasts \u2026 because they like everything the sightlings like \u2026 so I started leaning on the blind friends I\u2019d made through the podcast to help me learn.<\/p>\n

Learning to use VoiceOver on the iPhone was pretty easy because everything is in a nice grid. Controls in applications are in predictable places, and most buttons are labeled. My understanding is that Apple provide very structured APIs that make it easier to automatically design applications for accessibility with little effort.<\/p>\n

VoiceOver on the Mac is a lot<\/em> harder to learn and use. Every app is completely different, and don\u2019t even get me started with the variability in website design! I was eventually able to come up with a very narrow set of tasks that I could (mostly) reliably perform with my eyes closed for my presentation. It went well, but definitely not flawlessly<\/a>.<\/p>\n

I\u2019m glad that I forced myself to learn VoiceOver in such a sink-or-swim way. I didn\u2019t get to a point where I would ever call myself proficient in VoiceOver, but I gained just enough skills that I can test apps on the Mac to figure out if they might<\/em> be accessible to the blind. I can definitely tell if an app is totally unusable with VoiceOver, but I wouldn’t be able to say that an app was completely accessible.<\/p>\n

I thought it might be interesting if I taught you a few of the things I use to test apps for accessibility. I would like to repeat that I am not an expert in VoiceOver. I’m maybe a high-level novice. If you\u2019re familiar with how ski slopes are rated, I\u2019m not a black diamond skier, but I can pretty much stay upright most of the time on the bunny slope.<\/p>\n

My goal here is to help you learn how to identify navigation problems, inaccessible fields, and unlabeled elements.<\/p>\n

VoiceOver Utility<\/h3>\n

When I first tried out VoiceOver, I couldn\u2019t understand how real VoiceOver users got anything done, because it was so inefficient to wait for the voice to speak everything out. My real VoiceOver users explained that they speed the voice way up. It\u2019s incredible<\/em> how fast they can listen and understand VoiceOver!<\/p>\n

But for those of us just learning, it might be helpful to look at the settings for VoiceOver to get a speed and voice you\u2019re comfortable with.<\/p>\n

In Applications > Utilities, there\u2019s an app called VoiceOver Utility. There are a ton of controls in here but I\u2019m just going to focus on a couple of them. On the General tab, you\u2019ll see keys to use as the VoiceOver modifier. The modifier is the key combo you will be using to trigger moving around on the screen. By the way, the blind folks I know refer to this key combination as the VO key. For example, rather than continually saying Control-Option Right Arrow, I\u2019ll say VO right arrow.<\/p>\n

The modifier can be set to Control-Option or Caps Lock or both. I use Caps lock as nature intended, so I choose Control-Option as my VO modifier key.<\/p>\n

\"VoiceOver
VoiceOver General Screen Highlighting Modifier Keys<\/figcaption><\/figure>\n

In the Verbosity tab, you can change the default of how detailed VoiceOver is in its descriptions. Another way those who are accomplished VoiceOver users become efficient is to set the verbosity to Low, but while learning, I suggest you set Verbosity to high.<\/p>\n

As much as I experiment with VoiceOver for evaluating the accessibility of apps, I still forget how to do things and appreciate VoiceOver telling me things like this: \u201cYou are currently on a table. To enter this table, press Control-Option-Shift-Down Arrow.\u201d I can imagine that level of explanation for a real VoiceOver user would be annoying as heck.<\/p>\n

The last thing to look at is the Speech tab. Here you get to choose the voice and language for VoiceOver. I\u2019m not sure if it\u2019s the default, but Samantha in American English is very clear and understandable.<\/p>\n

Next to the voice dropdown, you\u2019ll see a number. This is the rate of speech, i.e. how fast VoiceOver will speak to you. You can set it anywhere from 1 to 100; I\u2019ve got mine set at 45. Experiment with the speeds and the voice until you hear something that\u2019s easy for you to understand.<\/p>\n

Since this is a tutorial for sightlings, here\u2019s a little tip. Whatever VoiceOver says to you will also be typed out on the screen as well. Sometimes I mute VoiceOver and just read the text because it helps me concentrate better on learning how well an app is working.<\/p>\n

It\u2019s interesting to poke around in the VoiceOver Utility but those are the essential things I wanted you to know. Let\u2019s move on to actually using VoiceOver. Let\u2019s try to read the VoiceOver Utility itself using VoiceOver.<\/p>\n

How to Launch VoiceOver<\/h3>\n

On any Mac, you can launch VoiceOver by holding down \u2318-F5.<\/p>\n

\"Welcome
Welcome to VoiceOver<\/figcaption><\/figure>\n

Since it\u2019s for the blind, you’ll hear an explanation of what VoiceOver does. You get two buttons to choose from: Use VoiceOver and Turn Off VoiceOver. At any time, you\u2019ll be able to turn VoiceOver off by using the same keystroke, \u2318-F5. You can choose to not have this window shown in the future, but I keep it on as an indicator that I’ve remembered the right keystroke to launch VoiceOver.<\/p>\n

Remembering how to turn VoiceOver off is crucial to you enjoying this experiment because it can get pretty overwhelming to hear everything onscreen being read out loud. Since I’m not actually using VoiceOver to navigate my Mac, I toggle listening to it during my experiments by simply muting my Mac.<\/p>\n

With the VoiceOver Utility in focus, you should hear VoiceOver begin telling you about where you are in the app.<\/p>\n

Navigation<\/h3>\n

Most of the app interfaces seem to be considered \u201ctables\u201d, and knowing how to navigate around in a table will give you an indication of whether the app is well-designed.<\/p>\n

You should hear, \u201cYou are currently on a table. To enter this table, press Control-Option-Shift-Down Arrow\u201d, the verbose example I gave earlier. I think of this command as diving down into<\/em> a table. To get back out, you pop back up<\/em> by using VO-Shift-Up Arrow.<\/p>\n

You won\u2019t always hear the interface referred to as a table. Audio Hijack calls its table of available elements a \u201cgroup\u201d. TextExpander calls its main window \u201cweb content\u201d. Navigating both of these is identical to tables. Actual web content is also often navigated in the same way. For all of these, VoiceOver will tell you to use VO-Shift-Down Arrow to interact.<\/p>\n

The VoiceOver Utility will have the left column of tabs selected with a black border. The selected tab in the left column will still be highlighted in blue.<\/p>\n

In this case, we don\u2019t really need to go down into this column. We want to move up and down in the column and then move over to the right column to interact with the controls.<\/p>\n

Use the normal up\/down arrows until you get to the Speech tab. Now to navigate to the right side pane, you use the right arrow but you have to add the modifier keys – VO-Right Arrow.<\/p>\n

Focus will jump to the Voices tab at the top. VoiceOver will tell you the name of the tab (in this case it\u2019s Voices) and it will also tell you, \u201cYou are currently on a selected tab, 1 of 2.\u201d For obvious reasons, it\u2019s useful to know how many tabs there are.<\/p>\n

Using VO-Right Arrow will highlight the second tab, Pronunciation. But how do you select<\/em> the Pronunciation tab? In VoiceOver, you use the space bar with the VO modifier keys to select a button, tab, or menu item. So we\u2019ll use VO-Space to switch to Pronunciation. Since we set verbosity to high, you don\u2019t have to remember VO-Space because if you give VoiceOver a minute, it will remind you that\u2019s how to interact.<\/p>\n

Let\u2019s Left Arrow back to the Voices tab, and VO-Space to select it. Let\u2019s say we want to change the voice from Samantha to another voice.<\/p>\n

Use VO-Right Arrow repeatedly and it will go past Pronunciation, Mute Speech, and then you\u2019ll hear \u201cCustomized Language List Table\u201d. We know what to do with tables – VO-Shift-Down Arrow to dive in.<\/p>\n

Interestingly, Apple have chosen not to read out the column labels, so VO skips ahead and says \u201clanguage default\u201d. VO-Right Arrow will read out your default language, which in my case is English. Another VO-Right Arrow will take us to the chosen voice, in my case Samanta.<\/p>\n

VoiceOver tells you that you’re on a pop-up button. Just like selecting the tab earlier, we can use VO-Space to open the pop-up. We\u2019ll still be on the original selected voice, but we can use VO and the up\/down arrows to move up and down in the list of options. If we get to an option with submenus, we can use VO-Right Arrow to move into the submenu and continue our navigation. Once you land on an option you like, hit the space bar to select it and pop back into the table.<\/p>\n

Let\u2019s use VO-Right Arrow to move over to change the rate. You\u2019ll hear VoiceOver tell you the value for the rate and that you\u2019re on a stepper, which is the common name for those little up\/down arrows to change a value in small steps.<\/p>\n

This stepper is basically another table because it has two elements that are connected: a typed value and a set of up\/down arrows. Once on the rate stepper, we need to use VO-Shift-Down Arrow to dive into the table. This takes us to where we can type in a number.<\/p>\n

Use VO-Down Arrow to get to the stepper. We need to interact with this like another table. We\u2019ll dive down in with VO-Shift-Down Arrow. Only then can we use VO with up\/down arrows to change the value. If you’re given a choice of typing in a number, you’d surely pick that, but it’s good to know how to test steppers to see if they work with VoiceOver.<\/p>\n

We\u2019re now down a lot of layers deep into these so-called tables. We\u2019ll use VO-Shift-Up Arrow to get out of the stepper, up again to get out of the pair of stepper controls, and a final time to get out of the customized language list table.<\/p>\n

This sounds difficult, but it\u2019s really not that bad once you get used to this idea of diving down and popping back up out of tables.<\/p>\n

If we use VO-Right Arrow a couple more times, we\u2019ll hear the add or remove language buttons and finally the help button. If we hit VO-Right Arrow again, we\u2019ll hear a little bonk sound telling us that we\u2019ve reached the end. Recognizing this bonk sound is crucial to understanding if you’ve reached the limits of an app, or a table within an app.<\/p>\n

To get back to the left column to maybe explore another set of options in the VoiceOver utility, we have to VO-Left-Arrow repeatedly until we hear VoiceOver tell us we\u2019re back in the table with Speech selected.<\/p>\n

Before we move on, I want to add yet another disclaimer to what I just taught you. Sometimes when I say to use VO-Right Arrow or Left Arrow, you can actually use just the right or left arrow. And sometimes using VO with the arrow keys doesn\u2019t<\/em> work. I sort of just flail around trying both till it does what I want. I suspect that\u2019s not how people who are good with VoiceOver do it, and that there’s an actual pattern to recognize, but I haven’t yet found it.<\/p>\n

Testing an App<\/h3>\n

Armed with just this very basic understanding of how to navigate an app with VoiceOver, let\u2019s do a test run on an app to see if it\u2019s accessible. I wanted to come up with a third-party app that most people would have, or at least is useful and free for you to test along with me.<\/p>\n

I chose an app I love and have been using for ages \u2013 Mactracker from mactracker.ca<\/a>. This app will let you look up any Mac, iPhone, iPad, or other device Apple have ever sold. You can check to see what the maximum RAM it can take, the resolution of the screen, or when it went out of support. It\u2019s a really terrific resource for Apple folks. It runs on Mac and iOS and it is donationware. You can download it for free, but every year or two I send the developer $20 because I use it all the time.<\/p>\n

The design of Mactracker is a left column with little chevrons to open categories, such as desktops vs. notebooks. Within a category, you\u2019ll see the family of products, such as Mac mini. When selected, the right pane shows you all of the models of Mac mini with their dates of creation and below each one it shows the month and year they were created and discontinued.<\/p>\n

When you find a model of Mac mini you want to learn about, a double-click will open it in a new window. This window has a series of tabs across the top for General, Software, Memory & Graphics, and more. The top of the window has a picture of the device you\u2019ve selected.<\/p>\n

With VoiceOver turned on, the first thing we hear is it telling us we\u2019re in Mactracker and in a toolbar. We get the familiar by now suggestion to use VO-Shift-Down Arrow to interact with the toolbar.<\/p>\n

Fair enough, let\u2019s dive into the toolbar. We hear it say 4 items, add\/remove, group. Looks like we can dive down another level. Visually I can see that this group is a plus and minus button to add or remove items. There are only 2 things to choose from though, not four. When I move to the + button it keeps saying add\/remove, and when I go to the minus button, it says \u201cspacer dimmed button\u201d. Unlabled buttons are at the top of the list of the most annoying things for VoiceOver users.<\/p>\n

We\u2019ll Shift-VO-Up Arrow to get out of that group, and VO-Right Arrow to move to the second set of buttons. We learn that there are two radio buttons, Categories, and My Models. I can select My Models, and it’s suggesting I use the plus button above to add models I’ve owned.<\/p>\n

I can navigate back to the plus button in the toolbar and then VoiceOver-Space to press the button. This launches a window to add a model and information about it, which for the most part is accessible to VoiceOver. The window contains date fields which don’t allow data entry with VoiceOver. I give MacTracker a B- for this menu.<\/p>\n

If I close this window and continue navigating the toolbar, one more VO-Right Arrow and I\u2019m in the search field, but it\u2019s only called a text field. A minor problem I suppose but it could have told me it was a search field.<\/p>\n

I get a bonk if I try to go more to the right, so I\u2019ll pop back up out of the toolbar with Shift-VO-Up Arrow. VO-Right Arrow takes us to the heading for whatever happened to be selected in the left sidebar. In my case, I heard Mac mini. Ok, let\u2019s try another VO-Right Arrow. It reads out the number of models in the list, which happens to be 18 for the Mac mini.<\/p>\n

One more VO-Right Arrow and you\u2019ll hear the bonk meaning that we’re at the end of the road. But wait, what about the column of Mac mini models listed below? Nope, if you don\u2019t have functioning eyeballs, you don\u2019t get to know what those 18 models are. You also can\u2019t access the left column to change models or categories. There\u2019s literally nothing else available in Mactracker for the blind.<\/p>\n

I\u2019m afraid that my beloved Mactracker for the Mac is a 100% fail for accessibility. The good news is that the developer has an iOS version of Mactracker and it\u2019s 99% accessible in my testing. The only thing I could find with VoiceOver is that the little image of the device selected is unlabeled – it just says \u201cbutton\u201d when you slide your finger over it. Not a crucial part of using the tool, but realize the VoiceOver user can’t know that it’s a non-critical part of the tool. To be fair, while it is<\/em> a button, if you press it, nothing happens. I think it’s entirely mislabled.<\/p>\n

My understanding is that Apple has created really good APIs for iOS development that automatically make things accessible without much work, and that’s why Mactracker on iOS is so much more accessible than it is on the Mac. I very rarely find an app in iOS that isn\u2019t at least functional. And that\u2019s why I\u2019m not teaching you how to test in iOS!<\/p>\n

Tell the Developer<\/h3>\n

There\u2019s one more step in my process for testing apps: I write a politely worded email to the developer explaining my findings and suggesting that they could increase the reach of their app if they fixed the navigation problems for screen reader users.<\/p>\n

Not every developer reacts well to my emails. Some of them say, \u201cWe\u2019ll add it to our list of things to work on\u201d and don\u2019t indicate in any way that this would be a high-priority task. Some ignore me altogether. A very select few have even said \u201cThis app isn\u2019t for the blind\u201d. That last category gets a not-so-politely worded email in return.<\/p>\n

However, you\u2019d be surprised how often I get emails back saying, \u201cOh my gosh, I never thought to test for that – thank you, I\u2019ll look into improving it.\u201d Some have even asked whether I know people who could help test the app after they fix it.<\/p>\n

Here’s my favorite recent example of a response from a developer to one of my politely worded emails. Ian Sampson develops an amazing tool called Hush<\/a> which is an app to remove background noise in audio files. In order to add a file for Hush to process, you had to drag and drop the file onto the Hush window. That\u2019s not something that can be done easily or reliably if you\u2019re using a screen reader. I wrote to Ian on April 15 about it, and he responded back immediately that he would work on a better solution. On May 9th he apologized<\/em> for how long it took to fix it but announced to me that the new version was released with alternate methods. It had only been three and a half weeks and he was apologizing?<\/p>\n

After writing up this article, I shot off an email to Ian of Mactracker (not the same Ian) and hopefully he has a positive reaction to my suggestions for improvement. I did a ScreenCastsOnline video about Mactracker 8 years ago; maybe he remembers me and will be open-minded!<\/p>\n

Bottom Line<\/h3>\n

I hope you enjoyed what you learned about testing Mac apps for VoiceOver accessibility. I enjoy doing it and I hope I didn\u2019t muck up the instructions too<\/em> much. I suspect my blind friends will gently correct me if I did.<\/p>\n

If you’d like to test the gold standard for accessibility with VoiceOver, test any of the apps developed by Rogue Amoeba<\/a>, such as Audio Hijack, Loopback, and SoundSource. They built these apps from the ground up with accessibility in mind. Audio Hijack is especially amazing because it’s a very<\/em> visual tool with little blocks you move around on a canvas and connect lines between them to represent audio flow, and yet it’s fully accessible to VoiceOver. Whenever I hear whining by developers about how either it’s too hard, or no blind person would want to do it, I point them at Rogue Amoeba.<\/p>\n

If you\u2019d like to learn more about using VoiceOver on the Mac, I included a link to Apple\u2019s support article VoiceOver User Guide for Mac – Apple Support<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

Follow My Leader was a Big Influence I am not blind, but ever since I was 9 years old, I have been fascinated by assistive tech for the blind. When I was 9, I read a book called Follow My Leader by James Garfield in which a young boy named Jimmy is blinded by fireworks. […]<\/p>\n","protected":false},"author":1,"featured_media":28733,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[147],"tags":[717,165,84,5583,1893],"class_list":["post-28729","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-blog-posts","tag-a11y","tag-accessibility","tag-blind","tag-screen-reader","tag-voiceover"],"jetpack_featured_media_url":"https:\/\/www.podfeet.com\/blog\/wp-content\/uploads\/2023\/07\/VoiceOver-Logo-1040x520-1.png","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/posts\/28729","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/comments?post=28729"}],"version-history":[{"count":4,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/posts\/28729\/revisions"}],"predecessor-version":[{"id":28736,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/posts\/28729\/revisions\/28736"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/media\/28733"}],"wp:attachment":[{"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/media?parent=28729"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/categories?post=28729"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.podfeet.com\/blog\/wp-json\/wp\/v2\/tags?post=28729"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}