OLD | NEW |
(Empty) | |
| 1 # ChromeVox on Desktop Linux |
| 2 |
| 3 ## Starting ChromeVox |
| 4 |
| 5 On Chrome OS, you can enable spoken feedback (ChromeVox) by pressing Ctrl+Alt+Z. |
| 6 |
| 7 If you have a Chromebook, this gives you speech support built-in. If you're |
| 8 building Chrome from source and running it on desktop Linux, speech and braille |
| 9 won't be included by default. Here's how to enable it. |
| 10 |
| 11 ## Compiling the Chrome OS version of Chrome |
| 12 |
| 13 First follow the public instructions for |
| 14 [Chrome checkout and build](https://www.chromium.org/developers/how-tos/get-the-
code). |
| 15 |
| 16 Create a GN configuration with "chromeos" as the target OS, for example: |
| 17 |
| 18 ```> gn args out/ChromeOSRelease``` |
| 19 |
| 20 ...in editor, add this line: |
| 21 |
| 22 ``` |
| 23 target_os = "chromeos" |
| 24 is_component_build = true |
| 25 is_debug = false |
| 26 ``` |
| 27 |
| 28 Note: Only ```target_os = "chromeos"``` is required, the others are recommended |
| 29 for a good experience but you can configure Chrome however you like otherwise. |
| 30 Note that Native Client is required, so do not put enable_nacl = false in |
| 31 your file anywhere! |
| 32 |
| 33 Now build Chrome as usual, e.g.: |
| 34 |
| 35 ```ninja -C out/cros chrome``` |
| 36 |
| 37 And run it as usual to see a mostly-complete Chrome OS desktop inside |
| 38 of a window: |
| 39 |
| 40 ```out/cros/chrome``` |
| 41 |
| 42 By default you'll be logged in as the default user. If you want to |
| 43 simulate the login manager too, run it like this: |
| 44 |
| 45 ```out/cros/chrome --login-manager``` |
| 46 |
| 47 You can run any of the above under it’s own X session (avoiding any |
| 48 window manager key combo conflicts) by doing something like |
| 49 |
| 50 ```startx out/cros/chrome``` |
| 51 |
| 52 ## Speech |
| 53 |
| 54 If you want speech, you just need to copy the speech synthesis data |
| 55 files to /usr/share like it would be on a Chrome OS device: |
| 56 |
| 57 ``` |
| 58 git clone https://chromium.googlesource.com/chromiumos/platform/assets |
| 59 sudo cp assets /usr/share/chromeos-assets |
| 60 ``` |
| 61 |
| 62 Next, move to that directory and unzip the NaCl executables. You only need |
| 63 to do the one for your host architecture: |
| 64 |
| 65 ``` |
| 66 cd /usr/share/chromeos-assets/speech_synthesis/patts |
| 67 unzip tts_service_x86-64.nexe.zip |
| 68 ``` |
| 69 |
| 70 Finally, fix the permissions: |
| 71 |
| 72 ``` |
| 73 sudo chmod oug+r -R /usr/share/chromeos-assets |
| 74 ``` |
| 75 |
| 76 **Be sure to check permissions of /usr/share/chromeos-assets, some |
| 77 users report they need to chmod or chown too, it really depends |
| 78 on your system.** |
| 79 |
| 80 After you do that, just run "chrome" as above |
| 81 (e.g. out/cros/chrome) and press Ctrl+Alt+Z, and you should hear it |
| 82 speak! If not, check the logs. |
| 83 |
| 84 ## Braille |
| 85 |
| 86 ChromeVox uses extension APIs to deliver braille to Brltty through |
| 87 libbrlapi and uses Liblouis to perform translation and |
| 88 backtranslation. |
| 89 |
| 90 Once built, Chrome and ChromeVox will use your machine’s running |
| 91 Brltty daemon to display braille if ChromeVox is running. Simply |
| 92 ensure you have a display connected before running Chrome and that |
| 93 Brltty is running. |
| 94 |
| 95 Testing against the latest releases of Brltty (e.g. 5.4 at time of |
| 96 writing) is encouraged. |
| 97 |
| 98 For more general information, see [ChromeVox](chromevox.md) |
| 99 |
| 100 # Using ChromeVox |
| 101 |
| 102 ChromeVox keyboard shortcuts use Search. On Linux that's usually your |
| 103 Windows key. If some shortcuts don't work, you may need to remove |
| 104 Gnome keyboard shortcut bindings, or use "startx", as suggested above, |
| 105 or remap it. |
| 106 |
| 107 * Search+Space: Click |
| 108 * Search+Left/Right: navigate linearly |
| 109 * Search+Period: Open ChromeVox menus |
| 110 * Search+H: jump to next heading on page |
OLD | NEW |