Install Arch Linux with accessibility options: Difference between revisions

From ArchWiki
No edit summary
m (add ru link)
 
(22 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[Category:Installation process]]
[[Category:Installation process]]
[[Category:Accessibility]]
[[Category:Accessibility]]
[[ca:Install Arch Linux with accessibility options]]
[[es:Install Arch Linux with accessibility options]]
[[es:Install Arch Linux with accessibility options]]
[[fr:Install Arch Linux with accessibility options]]
[[ja:アクセシビリティ機能を使って Arch Linux をインストール]]
[[ja:アクセシビリティ機能を使って Arch Linux をインストール]]
[[pt:Install Arch Linux with accessibility options]]
[[pt:Install Arch Linux with accessibility options]]
[[ru:Install Arch Linux with accessibility options]]
[[tr:Install Arch Linux with accessibility options]]
[[zh-hans:Install Arch Linux with accessibility options]]
[[zh-hans:Install Arch Linux with accessibility options]]
The official Arch Linux installation medium supports various [[Accessibility]] features:
The official Arch Linux installation medium supports various [[Accessibility]] features:
Line 30: Line 34:


When you hear a beep on the output that you would like to use, press {{ic|Enter}} to select the card.
When you hear a beep on the output that you would like to use, press {{ic|Enter}} to select the card.
=== Change speech language ===
To change the ''espeak-ng'' language/voice used by {{ic|espeakup.service}}, [[edit]] the unit so that the language code is appended to {{ic|1=default_voice=}} in the {{ic|1=Environment=}} directive.
You can also change the ''espeak-ng'' voice variant by appending {{ic|+''variant''}} to the language code. See {{man|8|espeakup}} and {{man|1|espeak-ng}} for more information.


== Installation ==
== Installation ==
Line 35: Line 45:
=== Install essential packages ===
=== Install essential packages ===


For speech support in the installed system you need {{Pkg|espeakup}} and {{Pkg|alsa-utils}}. If you use a braille display you need to [[install]] {{Pkg|brltty}}.
For speech support in the installed system, you need {{Pkg|espeakup}} and {{Pkg|alsa-utils}}. If you use a braille display, [[install]] the {{Pkg|brltty}} package.


Append the required packages to the {{man|8|pacstrap}} call when installing:
Append the required packages to the {{man|8|pacstrap}} call when installing:


  # pacstrap /mnt base linux linux-firmware espeakup alsa-utils
  # pacstrap -K /mnt base linux linux-firmware espeakup alsa-utils


== Configure the system ==
== Configure the system ==
Line 45: Line 55:
=== Sound card ===
=== Sound card ===


If [[#Multiple sound cards]] were detected you need to copy the {{ic|/etc/asound.conf}}
If [[#Multiple sound cards]] were detected, copy the {{ic|/etc/asound.conf}} file, which has been generated in the installation medium:
file, which has been generated in the installation medium.


  # cp /etc/asound.conf /mnt/etc/
  # cp /etc/asound.conf /mnt/etc/
Line 52: Line 61:
=== Enable the services ===
=== Enable the services ===


To have speech support after booting into the installed system you need to [[enable]] {{ic|espeakup.service}}.
To have speech support after booting into the installed system you need to [[enable]] {{ic|espeakup.service}}. See also [[#Change speech language]].


== Reboot ==
== Reboot ==


After booting into the newly installed system it should start speaking automatically.
After booting into the newly installed system it should start speaking automatically.
== Troubleshooting ==
{{Merge|Accessibility|The listed issues are out of scope of the Arch installation process.}}
Most graphical applications should work out of the box, such as Gtk-, Qt- or Gecko-based ones. You can verify the functionality by running {{Pkg|accerciser}}. The application of choice should appear and have a deeply nested tree structure of children. Issues may arise if:
* You haven't enabled the assistive technologies setting for your distribution. There's usually a single checkbox somewhere to be found to enable it. After enabling, you need to reboot.
* The application is [[Chromium]]- or [[Electron]]-based. These programs typically need both the [[Environment variable]] {{ic|1=ACCESSIBILITY_ENABLED=1}}, and an additional argument {{ic|--force-renderer-accessibility}} when launching. For Chrome you can replace the latter step with enabling the accessibility options inside {{ic|chrome://accessibility}}, however this seems to not persist after restart.
* The application is [[Java]]-based. In this case, you need to install the ATK bridge {{Pkg|java-atk-wrapper-openjdk8}} (depending on your Java version)
* In the rare case that the application is an exotic, old application built with Qt4, such as some programs that haven't been maintained since 2015, you need to install {{ic|qt-at-spi}}
* As a last resort, any of these other environment variables may help: {{ic|1=GTK_MODULES=gail:atk-bridge}}, {{ic|1=OOO_FORCE_DESKTOP=gnome}}, {{ic|1=GNOME_ACCESSIBILITY=1}}, {{ic|1=QT_ACCESSIBILITY=1}}, {{ic|1=QT_LINUX_ACCESSIBILITY_ALWAYS_ON=1}}

Latest revision as of 13:43, 14 May 2023

The official Arch Linux installation medium supports various Accessibility features:

This document describes how to install Arch Linux using these features.

Note: This page describes only steps which are different from the Installation guide.

Pre-installation

Boot the live environment

Note: The bootloaders on the installation medium have a timeout of 15 seconds before they start the default menu item.

When the installation medium starts booting, press Down followed by Enter to boot with speech enabled.

USB braille displays should be detected automatically via udev.

Multiple sound cards

If your computer has several sound cards, you will hear the following message: Please select your sound card for speech output.

When you hear a beep on the output that you would like to use, press Enter to select the card.

Change speech language

To change the espeak-ng language/voice used by espeakup.service, edit the unit so that the language code is appended to default_voice= in the Environment= directive.

You can also change the espeak-ng voice variant by appending +variant to the language code. See espeakup(8) and espeak-ng(1) for more information.

Installation

Install essential packages

For speech support in the installed system, you need espeakup and alsa-utils. If you use a braille display, install the brltty package.

Append the required packages to the pacstrap(8) call when installing:

# pacstrap -K /mnt base linux linux-firmware espeakup alsa-utils

Configure the system

Sound card

If #Multiple sound cards were detected, copy the /etc/asound.conf file, which has been generated in the installation medium:

# cp /etc/asound.conf /mnt/etc/

Enable the services

To have speech support after booting into the installed system you need to enable espeakup.service. See also #Change speech language.

Reboot

After booting into the newly installed system it should start speaking automatically.

Troubleshooting

This article or section is a candidate for merging with Accessibility.

Notes: The listed issues are out of scope of the Arch installation process. (Discuss in Talk:Install Arch Linux with accessibility options)

Most graphical applications should work out of the box, such as Gtk-, Qt- or Gecko-based ones. You can verify the functionality by running accerciser. The application of choice should appear and have a deeply nested tree structure of children. Issues may arise if:

  • You haven't enabled the assistive technologies setting for your distribution. There's usually a single checkbox somewhere to be found to enable it. After enabling, you need to reboot.
  • The application is Chromium- or Electron-based. These programs typically need both the Environment variable ACCESSIBILITY_ENABLED=1, and an additional argument --force-renderer-accessibility when launching. For Chrome you can replace the latter step with enabling the accessibility options inside chrome://accessibility, however this seems to not persist after restart.
  • The application is Java-based. In this case, you need to install the ATK bridge java-atk-wrapper-openjdk8 (depending on your Java version)
  • In the rare case that the application is an exotic, old application built with Qt4, such as some programs that haven't been maintained since 2015, you need to install qt-at-spi
  • As a last resort, any of these other environment variables may help: GTK_MODULES=gail:atk-bridge, OOO_FORCE_DESKTOP=gnome, GNOME_ACCESSIBILITY=1, QT_ACCESSIBILITY=1, QT_LINUX_ACCESSIBILITY_ALWAYS_ON=1