92 lines
2.9 KiB
Markdown
92 lines
2.9 KiB
Markdown
# Fenrir
|
|
A TTY screenreader for Linux.
|
|
In theory it's not just limited to Linux. but i currently only provide drivers for that since I do not have another system here. If you want to help, or write drivers to make it work on other systems, just let me know.
|
|
This software is licensed under the LGPL v3 .
|
|
|
|
# Requirements (core)
|
|
- Linux (currently only screen and input drivers available)
|
|
- python3 >= 3.3
|
|
- python-configargparse
|
|
- screen, input, speech, sound or braille drivers see "Features, Drivers, Extras".
|
|
|
|
# Features, Drivers, Extras, Dependencies
|
|
# Input Drivers:
|
|
1. "evdevDriver" input driver for linux evdev
|
|
- python-evdev >=0.6.3
|
|
- python-pyudev
|
|
- This is commonly referred to as python3-evdev by your distribution
|
|
- loaded uinput kernel module
|
|
- ReadWrite permission
|
|
- /dev/input
|
|
- /dev/uinput
|
|
- "ptyDriver" terminal emulation input driver
|
|
- python-pyte
|
|
|
|
# Screen Drivers:
|
|
1. "vcsaDriver" screen driver for linux VCSA devices
|
|
- python-dbus
|
|
- Read permission to the following files and services:
|
|
- /sys/devices/virtual/tty/tty0/active
|
|
- /dev/tty[1-64]
|
|
- /dev/vcsa[1-64]
|
|
- read logind DBUS
|
|
- "ptyDriver" terminal emulation driver
|
|
- python-pyte
|
|
- "dummyDriver" just a dummy
|
|
|
|
# Speech Drivers:
|
|
- "genericDriver" (default) sound driver for sound as subprocess:
|
|
- espeak or espeak-ng
|
|
- "espeakDriver" speech driver for Espeak or Espeak-NG:
|
|
- python-espeak
|
|
- "speechdDriver" speech driver for Speech-dispatcher:
|
|
- Speech-dispatcher
|
|
- python-speechd
|
|
- "dummyDriver" no speech
|
|
- "debugDriver" speech driver for debugging
|
|
|
|
# Braille Drivers:
|
|
- "BrlttyDriver" braille driver (WIP):
|
|
- brltty (configured and running)
|
|
- python-brlapi
|
|
- "dummyDriver" (default) no braille
|
|
- "debugDriver" Braille driver for debugging
|
|
|
|
# Sound Drivers:
|
|
- "genericDriver" (default) sound driver for sound as subprocess:
|
|
- Sox
|
|
2. "gstreamerDriver" sound driver for gstreamer
|
|
- gstreamer >=1.0
|
|
- GLib
|
|
- "dummyDriver" no sound
|
|
- "debugDriver" sound driver for debugging
|
|
|
|
# Extras:
|
|
1. spellchecker
|
|
- python-pyenchant
|
|
- aspell-YourLanguageCode (example aspell-en for us English)
|
|
2. Unix daemon (also needed for Systemd):
|
|
- python-daemonize
|
|
3. Modify system volume:
|
|
- pyalsaaudio (needs libasound2's headers).
|
|
|
|
# installation
|
|
- Archlinux: PKGBUILD in AUR
|
|
- Manual: run install.sh and uninstall.sh as root
|
|
- you also can just run it from Git without installing:
|
|
You can just run the following as root:
|
|
if you are in Fenrir Git rootfolder:
|
|
cd src/fenrir/
|
|
sudo ./fenrir
|
|
Settings "settings.conf" is located in the "config" directory or after installation in /etc/fenrir/settings.
|
|
Take care to use drivers from the config matching your installed drivers.
|
|
By default it uses:
|
|
- sound driver: genericDriver (via sox, could configured in settings.conf)
|
|
- speech driver: speechdDriver
|
|
- braille driver: brlttyDriver (WIP)
|
|
- input driver: evdevDriver
|
|
|
|
# Documentation
|
|
You can see all information on the Wiki:
|
|
https://wiki.linux-a11y.org/doku.php?id=fenrir_user_manual
|