Difference between revisions of "TalkingArch"

From ArchWiki
Jump to: navigation, search
(Arch Linux. Two words.)
(Updated to reflect latest version on of ISO.)
Line 2: Line 2:
 
[[Category:HOWTOs (English)]]
 
[[Category:HOWTOs (English)]]
 
= Introduction =
 
= Introduction =
This page describes a modified Arch Linux install CD that includes spoken output for blind users. The modified version is mostly equivalent to the official "ftp CD", but the system should start speaking as soon as you boot with it. Speech is provided via the sound card, using the eSpeak software synthesizer and the Speakup screenreader.
+
This page describes a modified Arch Linux install CD that includes spoken output for blind users. The modified version is mostly equivalent to the official "netinstall CD", but the system should start speaking as soon as you boot with it. Speech is provided via the sound card, using the eSpeak software synthesizer and the Speakup screenreader.
It is only available for the i686 platform; x86-64 is not supported. There are two versions: an Isolinux version and a Grub version. One may obtain ".iso" images via HTTP.
+
It is only available for the i686 platform; x86-64 is not supported. One may obtain ".iso" images via HTTP.
  
Grub:
+
[http://cmb.tysdomain.com/TalkingArch-2009.09-netinstall-i686.iso download]
[http://cmb.tysdomain.com/TalkingArch-2009.03-ftp-i686.iso download]
+
[http://cmb.tysdomain.com/TalkingArch-2009.09-netinstall-i686.iso.sig detached signature]<br>
[http://cmb.tysdomain.com/TalkingArch-2009.03-ftp-i686.iso.sig detached signature]<br>
+
MD5 sum: fc241672b6e621f2b53e89c5e8cfbba9
MD5 sum: e0854e63d59cea73b94ba0d5b46206d0
+
  
Isolinux:
+
The detached signature was made using the gpg key associated with the address
[http://cmb.tysdomain.com/TalkingArch-2009.03-ftp-i686-isolinux.iso download]
+
[http://cmb.tysdomain.com/TalkingArch-2009.03-ftp-i686-isolinux.iso.sig detached signature]<br>
+
MD5 sum: 23a40cb13455a8580cc04730e741d6eb
+
 
+
The detached signatures were made using the gpg key associated with the address
+
 
cmbrannon79 at gmail dot com.  The key ID is CE8D2EE8.
 
cmbrannon79 at gmail dot com.  The key ID is CE8D2EE8.
 
The fingerprint is A2C6 0177 783D 222E 3677  E247 83A0 DB7D CE8D 2EE8
 
The fingerprint is A2C6 0177 783D 222E 3677  E247 83A0 DB7D CE8D 2EE8
 
This is release 3 of the ISO.  It fixes a major defect found in release 2.
 
The sound card initialization script shipped with release 2 only unmuted
 
the Master and PCM controls.  This is not sufficient for all sound cards.
 
The script included in release 3 should unmute all necessary controls.
 
  
 
== Credits ==
 
== Credits ==
 
This CD was produced by Chris Brannon, and the downloadable images are hosted by Tyler Littlefield.
 
This CD was produced by Chris Brannon, and the downloadable images are hosted by Tyler Littlefield.
Thanks to the following people for submitting valuable feedback regarding release 2: Chuck Hallenbeck, Julien Claassen, and Keith Hinton.
+
Thanks to the following people for submitting valuable feedback regarding this project: Chuck Hallenbeck, Julien Claassen, Alastair Irving,  and Keith Hinton.
  
 
= Installing from the CD =
 
= Installing from the CD =
Line 35: Line 24:
 
#When booting, Grub provides a very long timeout. Press enter once the drive stops spinning.
 
#When booting, Grub provides a very long timeout. Press enter once the drive stops spinning.
 
#Use the installer on the CD, as per the [[Beginners Guide]].
 
#Use the installer on the CD, as per the [[Beginners Guide]].
#Install the alsa-utils, speakup, and espeakup packages: <code>pacman --root=/mnt -Sy alsa-utils speakup espeakup</code>
+
#Install the alsa-utils, speakup, and espeakup packages: <code>pacman --root=/mnt --cachedir=/mnt/var/cache/pacman/pkg -Sy alsa-utils speakup espeakup</code>
 
#Customize <code>/mnt/etc/rc.conf</code>: Add speakup and speakup_soft to the MODULES array. Add alsa and espeakup to the DAEMONS array.
 
#Customize <code>/mnt/etc/rc.conf</code>: Add speakup and speakup_soft to the MODULES array. Add alsa and espeakup to the DAEMONS array.
 
#You also need to save the state of the sound card, so that it will be retrieved on reboot. Execute the command <code>alsactl store</code> and copy the file <code>/etc/asound.state</code> to <code>/mnt/etc/asound.state</code>. Alternatively, <code>alsactl -f /mnt/etc/asound.state store</code>
 
#You also need to save the state of the sound card, so that it will be retrieved on reboot. Execute the command <code>alsactl store</code> and copy the file <code>/etc/asound.state</code> to <code>/mnt/etc/asound.state</code>. Alternatively, <code>alsactl -f /mnt/etc/asound.state store</code>
Line 42: Line 31:
 
== Handling Dialogs with Speakup ==
 
== Handling Dialogs with Speakup ==
 
The Arch Linux installer, <code>/arch/setup</code>, makes extensive use of the '''dialog''' program. Users may experience some difficulties when navigating several of the menus and dialogs.  This is not specific to Arch Linux.  Other text-mode installers often have similar problems.
 
The Arch Linux installer, <code>/arch/setup</code>, makes extensive use of the '''dialog''' program. Users may experience some difficulties when navigating several of the menus and dialogs.  This is not specific to Arch Linux.  Other text-mode installers often have similar problems.
 +
The following discussion is a compilation of suggested solutions from members of the Speakup community.
  
The following discussion was compiled from suggestions on the Speakup list.
+
First, set the DIALOGOPTS environment variable to the value &quot;--visit-items&quot;, before starting the ArchLinux installer.
 +
At a shell prompt, type the following command:<br>
 +
<code>export DIALOGOPTS='--visit-items'</code>
  
First, enable highlight tracking.  Press the star key on the numeric keypad.
+
Enable ''highlight tracking''.  Press the star key on the numeric keypad.
 
If you use a laptop that lacks the numeric keypad, press the sequence
 
If you use a laptop that lacks the numeric keypad, press the sequence
 
capslock control 8.
 
capslock control 8.
Speakup will say "highlight tracking". This is sufficient to navigate
+
Speakup will say &quot;highlight tracking&quot;.
most of the menus with the arrow keys, but there are a few notable exceptions, described in the following paragraphs.
+
Setting DIALOGOPTS and enabling ''highlight tracking'' mode should be sufficient for navigating most menus.
 
+
=== Choosing a Filesystem ===
+
The "choose filesystem" menu doesn't cooperate with highlight tracking.
+
It is difficult to determine which of the entries is selected.
+
There are two solutions.
+
The first is suggested by Adam Myrow.
+
 
+
<blockquote>
+
You can also use insert+period on the numeric keypad to check out the
+
color of the text under the cursor.  By going from line to line, and
+
checking the color, it should become apparent which item is selected.  For
+
example, in Slackware, the highlighted option is bright red on blue, and
+
the others are red on cyan.  In this example, highlight tracking gives
+
improper feedback, listing the option above the one that is selected.
+
</blockquote>
+
 
+
Note for laptop users: the equivalent key sequence is capslock slash.
+
 
+
The second solution is even easier, assuming that you want ext2, ext3, or ext4
+
as your filesystem.  If you want ext2, just press enter after the menu
+
is displayed.  If you want ext3, press down-arrow once, followed by enter.
+
Two down-arrows from the top of the menu gives you ext4.
+
This is Chris Brannon's preferred method.  Just count menu entries, and
+
press down-arrow the requisite number of times.
+
  
 
=== Setting the Date and Time ===
 
=== Setting the Date and Time ===
Line 94: Line 62:
  
 
= Mastering Speech-enabled ISO Images =
 
= Mastering Speech-enabled ISO Images =
The Arch Linux developers build their CD images using a set of shell scripts and configuration files named archiso. I added a configuration to archiso that allows me to build accessible CDs. If someone wants to produce customized images containing Speakup, he can do the following.
+
The Arch Linux developers provide a set of shell scripts and configuration files named archiso. I added a configuration to archiso that allows me to build accessible CDs. If someone wants to produce customized images containing Speakup, he can do the following.
  
 
Grab sources using git:
 
Grab sources using git:
Line 108: Line 76:
 
Install the scripts contained in the archiso/ subdirectory of the sources.
 
Install the scripts contained in the archiso/ subdirectory of the sources.
  
Change to the configs/talking-inst directory, and type <code>make ftp-iso</code>.
+
Change to the configs/talking-inst directory, and type <code>make net-iso</code>.
 
Alternatively,
 
Alternatively,
 
<code>
 
<code>
make BOOTLOADER=syslinux ftp-iso
+
make BOOTLOADER=syslinux net-iso
 
</code>
 
</code>
yields an image having Isolinux as its bootloader. There are several more targets for "make". For instance, ftp-usb produces an image suitable for a flash drive.
+
yields an image having Isolinux as its bootloader. There are several more targets for "make". For instance, net-usb produces an image suitable for a flash drive.
  
 
= Additional Notes =
 
= Additional Notes =
 
Presently, this CD is only usable with English-language speech.
 
Presently, this CD is only usable with English-language speech.
 
= The Custom Package Repository =
 
Chris Brannon's custom repo is still available.  It contains a handful
 
of packages that Chris and others find useful,
 
such as the edbrowse web browser.
 
If you want to use it, add the following lines to <code>/etc/pacman.conf</code>:
 
 
<pre>
 
[blind]
 
Server = http://members.cox.net/cmbrannon/blind/i686
 
</pre>
 
 
Since speakup and related packages are now available in community, they are no
 
longer included in the custom repository.
 
  
 
= Disclaimer =
 
= Disclaimer =
 
This CD image is not an official release.  It is not endorsed by anyone other than Chris Brannon.  It is provided solely for the convenience of its creator and other blind users, and it comes with absolutely no warranty.
 
This CD image is not an official release.  It is not endorsed by anyone other than Chris Brannon.  It is provided solely for the convenience of its creator and other blind users, and it comes with absolutely no warranty.

Revision as of 18:34, 6 September 2009

Introduction

This page describes a modified Arch Linux install CD that includes spoken output for blind users. The modified version is mostly equivalent to the official "netinstall CD", but the system should start speaking as soon as you boot with it. Speech is provided via the sound card, using the eSpeak software synthesizer and the Speakup screenreader. It is only available for the i686 platform; x86-64 is not supported. One may obtain ".iso" images via HTTP.

download detached signature
MD5 sum: fc241672b6e621f2b53e89c5e8cfbba9

The detached signature was made using the gpg key associated with the address cmbrannon79 at gmail dot com. The key ID is CE8D2EE8. The fingerprint is A2C6 0177 783D 222E 3677 E247 83A0 DB7D CE8D 2EE8

Credits

This CD was produced by Chris Brannon, and the downloadable images are hosted by Tyler Littlefield. Thanks to the following people for submitting valuable feedback regarding this project: Chuck Hallenbeck, Julien Claassen, Alastair Irving, and Keith Hinton.

Installing from the CD

The following list of steps is a brief guide to installing Arch Linux using this CD. The instructions assume that your root partition will be mounted on /mnt.

  1. When booting, Grub provides a very long timeout. Press enter once the drive stops spinning.
  2. Use the installer on the CD, as per the Beginners Guide.
  3. Install the alsa-utils, speakup, and espeakup packages: pacman --root=/mnt --cachedir=/mnt/var/cache/pacman/pkg -Sy alsa-utils speakup espeakup
  4. Customize /mnt/etc/rc.conf: Add speakup and speakup_soft to the MODULES array. Add alsa and espeakup to the DAEMONS array.
  5. You also need to save the state of the sound card, so that it will be retrieved on reboot. Execute the command alsactl store and copy the file /etc/asound.state to /mnt/etc/asound.state. Alternatively, alsactl -f /mnt/etc/asound.state store
  6. When you boot the system from the hard disk, it should start speaking.

Handling Dialogs with Speakup

The Arch Linux installer, /arch/setup, makes extensive use of the dialog program. Users may experience some difficulties when navigating several of the menus and dialogs. This is not specific to Arch Linux. Other text-mode installers often have similar problems. The following discussion is a compilation of suggested solutions from members of the Speakup community.

First, set the DIALOGOPTS environment variable to the value "--visit-items", before starting the ArchLinux installer. At a shell prompt, type the following command:
export DIALOGOPTS='--visit-items'

Enable highlight tracking. Press the star key on the numeric keypad. If you use a laptop that lacks the numeric keypad, press the sequence capslock control 8. Speakup will say "highlight tracking". Setting DIALOGOPTS and enabling highlight tracking mode should be sufficient for navigating most menus.

Setting the Date and Time

The "set timezone" menus are a joy to navigate, because the entries are numbered. Just type the corresponding number and press enter.

The "set date and time" menus are problematic. Ignore them, because there is a better way to set your system's clock. Once you have booted Arch Linux from the hard drive, install the ntp package. Next, execute the command ntpdate rolex.usg.edu You need to be logged in as root to perform both steps. Your system's clock will be synchronized with a time server located in the US state of Georgia. You may wish to find a time server that is closer to you. Chris Brannon never manually sets a system's clock, since setting it with NTP is so much easier.

Maintaining Your Speech-enabled Arch Linux Installation

You shouldn't need to do anything extraordinary to maintain the installation. Everything should just seamlessly work.

Mastering Speech-enabled ISO Images

The Arch Linux developers provide a set of shell scripts and configuration files named archiso. I added a configuration to archiso that allows me to build accessible CDs. If someone wants to produce customized images containing Speakup, he can do the following.

Grab sources using git:

git clone http://members.cox.net/cmbrannon/archiso.git
cd archiso
git checkout --track -b talkinginst origin/talkinginst

All of my work is done on the "talkinginst" branch. The master branch mirrors the master branch from git://projects.archlinux.org/archiso.git

Install the scripts contained in the archiso/ subdirectory of the sources.

Change to the configs/talking-inst directory, and type make net-iso. Alternatively, make BOOTLOADER=syslinux net-iso yields an image having Isolinux as its bootloader. There are several more targets for "make". For instance, net-usb produces an image suitable for a flash drive.

Additional Notes

Presently, this CD is only usable with English-language speech.

Disclaimer

This CD image is not an official release. It is not endorsed by anyone other than Chris Brannon. It is provided solely for the convenience of its creator and other blind users, and it comes with absolutely no warranty.