fenrir/README.md

52 lines
1.5 KiB
Markdown
Raw Normal View History

2017-01-24 17:37:49 -05:00
# fenrir
2016-10-02 02:36:53 -04:00
An TTY screenreader for Linux.
2017-01-24 17:37:49 -05:00
In theorie its not limited to linux. but i currently only provide drivers for that because I have no ohter system here. If you want to help or write drivers to make it work on other systems, just let me know.
2016-12-30 13:54:27 -05:00
This software is licensed under the LGPL v3 .
2016-07-05 05:16:34 -04:00
2016-11-16 06:00:21 -05:00
# requirements (core)
2016-09-16 04:31:26 -04:00
- linux
- python3
- python-evdev
- loaded uinput kernel module
2016-11-16 05:43:44 -05:00
- Read permission to the following files:
- /sys/devices/virtual/tty/tty0/active
- /dev/vcsa[1-64]
- ReadWrite permission
- /dev/input
- /dev/uinput
2016-11-16 06:00:21 -05:00
- speech, sound or braille drivers see "optional (features, drivers)".
2016-07-07 08:37:10 -04:00
2016-11-16 06:00:21 -05:00
# optional (features, drivers)
2016-11-16 05:59:16 -05:00
- "espeak" speech driver:
- python-espeak
- "speechd" speech driver:
- speech-dispatcher
- python-speechd
- brltty braille driver (not implemented yet, WIP):
- brltty (configured and running)
- python-brlapi
- "generic" sound driver:
- sox
- "gstreamer" sound driver
- gstreamer 1.x
- GLib
- spellchecker
- python-pyenchant
- aspell-YourLanguageCode (example aspell-en for us english)
- unix daemon:
- python-daemonize
2016-09-16 05:50:53 -04:00
2016-07-05 05:18:35 -04:00
# installation
2016-11-07 04:49:32 -05:00
- Archlinux: PKGBUILD in AUR
- install.sh (there is currently no uninstall)
- run from git:
You can just run the following as root:
2016-10-01 20:43:31 -04:00
cd src/fenrir-package/
2016-11-07 04:49:32 -05:00
sudo ./fenrir
2016-11-16 05:59:16 -05:00
Settings "settings.conf" is located in the "config" directory.
Take care that the used drivers in the config matching your installed drivers.
By default it uses:
- sound driver: generic (via sox, could configured in settings.conf)
- speech driver: speechd
- braille driver: brltty (WIP)