333 Commits
Author SHA1 Message Date
Storm Dragon 81cc630319 Notification sound added. Docs updated. 2026-11-07 00:27:44 -05:00
Storm Dragon 4c9a267897 Dialogue fixes and tests. 2026-11-06 02:13:00 -05:00
Storm Dragon 702d9737bd Party popper emoji added. 2026-11-04 23:18:14 -05:00
Storm Dragon 69b94d14c6 More fixes for fenrir's self-voice and notification system. Make sure proper sockets can be accessed. 2026-11-04 22:51:18 -05:00
Storm Dragon c4e9cb4b75 New notification system added that can be used by scripts or programs that want to send notifications through Fenrir. Separate from self-voicing. 2026-11-04 22:12:47 -05:00
Storm Dragon 8eacae13c0 Version bump. 2026-11-03 13:25:01 -05:00
Storm Dragon dc945ff392 Attempt to make audio and speech discovery more robust. 2026-11-03 13:21:50 -05:00
Storm Dragon a27f274099 Sneaked in a few last minute bug fixes for table mode. 2026-10-30 18:56:58 -04:00
Storm Dragon 2c893dccb9 A little improvement for repeated character handling. 2026-10-30 12:25:31 -04:00
Storm Dragon 36736725ea Fixed bug where punctuation was skipped when occuring inside numbers. Also removed the end of sentence pause marker for punctuation inside words/numbers. 2026-10-30 11:54:15 -04:00
Storm Dragon 22f6df6af9 Attempt to make modifier key changes take affect when the dialogue closes. This means you don't have to restart Fenrir to apply them. 2026-10-29 18:27:20 -04:00
Storm Dragon 15e04aa8f8 Default laptop key set to capslock. Keys that can be set to fenrir key or script key selectable via checkbox. 2026-10-29 18:01:42 -04:00
Storm Dragon 47f18fdd28 More work on repeated string summarization. 2026-10-29 14:45:51 -04:00
Storm Dragon 3cf41e662c Attempt to improve the multicharacter detection code. 2026-10-29 14:01:30 -04:00
Storm Dragon 6fc3416a1b Preferences tab added for the internal UI. 2026-10-29 02:46:41 -04:00
Storm Dragon cf95b17e5d Build script added to help with packaging. 2026-10-29 00:59:20 -04:00
Storm Dragon 07354d6ede More emojis! Because why not? 2026-10-29 00:39:04 -04:00
Storm Dragon 21cecd1e71 Fixed a couple sneaky bugs with prompts. 2026-10-28 23:27:05 -04:00
Storm Dragon c842a1e3db Fixed a bug with shared sockets. 2026-10-28 23:19:01 -04:00
Storm Dragon 7d82105d1d Fenrir can now create aliases for application overrides and put them in your clipboard. 2026-10-28 22:59:13 -04:00
Storm Dragon 7df1fa3ecb Better handle punctuation inside words like email addresses, urls, file paths, etc. 2026-10-28 20:52:18 -04:00
Storm Dragon 7c53cb39d4 Codex application override added. 2026-10-28 20:46:12 -04:00
Storm Dragon b887f6ea95 Improve sound initialization. 2026-10-28 18:17:06 -04:00
Storm Dragon 46dc520854 Initial attempt at making rogue work with application overrides. 2026-10-28 16:24:44 -04:00
Storm Dragon 088f706cb4 For speech rate in settings up/down move by 10, left/right move by 1. Easier to get settings right without having to hold doown the arrow keys lol. 2026-10-28 15:44:41 -04:00
Storm Dragon ea5d26f56d Fixed a bug that didn't allow setting home in service files. 2026-10-28 15:24:19 -04:00
Storm Dragon 6be06d26af Default rate was a bit slow even for being slow. Fixed to a more sane starting point. 2026-10-28 15:10:32 -04:00
Storm Dragon 3b7a44c224 Adjusted starting speech rate for new users. Fixed error that could happen when figuring out where to write changes. 2026-10-28 15:04:41 -04:00
deedra f989628a5a fixing my commit
Merge branch 'testing' of https://git.stormux.org/storm/fenrir into testing
2026-10-28 10:45:43 -07:00
deedra 92bf3025c5 Fall back to the system Speech Dispatcher socket
When using the default Speech Dispatcher address, try the user's Unix
socket first and then /run/speech-dispatcher/speechd.sock if the user
socket is missing or refuses the connection. This allows Fenrir to use
an existing system service before attempting to autospawn a user daemon.

Keep explicit Options.Socket, SPEECHD_ADDRESS, and SPEECHD_SOCKET
settings authoritative. Do not fall back for permission errors, TCP
connections, or a canceled context. If both sockets fail, preserve the
user socket's error so autospawn continues to target the user's endpoint.

After opening the data connection, use its selected Unix socket for the
control connection and disable further fallback there. Both connections
must belong to the same Speech Dispatcher server.

Add tests for address overrides, user-first selection, missing and stale
user sockets, permission errors, and preservation of the original error
when neither socket is available.

Validation:
- go test ./internal/speech -count=1 (GOPROXY=off): passed
- git diff --check: passed
- gofmt -l on all five changed Go files: no output

Live audible speech and physical keyboard behavior were not verified
as part of this commit.
2026-10-28 10:44:54 -07:00
Storm Dragon 6433f212b3 Removed file that somehow sneaked into the code, harmless but unnecessary. 2026-10-28 12:05:48 -04:00
deedra 55d550583c i screwed upMerge branch 'testing' of https://git.stormux.org/storm/fenrir into testing 2026-10-28 08:58:20 -07:00
deedra db6955f5b7 Improve sound server fallback and speech acknowledgement handling
Try the invoking user session followed by /run/pulse/native for sound
cues, while preserving an explicit PULSE_SERVER override. Resolve the
user socket from SUDO_UID, XDG_RUNTIME_DIR, or the current UID, and
document the fallback and Speech Dispatcher audio configuration.

Allow five seconds for Speech Dispatcher command acknowledgements so
large voice catalog queries can finish without premature failures.
Add regression coverage for socket selection and delayed replies.

Include cpu-usage.patch as a standalone patch artifact containing Python
remote registry permission and registration failure handling changes.
The patch is stored without applying it to the Python sources.

Validation: go test ./internal/sound ./internal/speech -count=1 passed
with GOCACHE=/tmp/cthulhu-go-cache and GOPROXY=off outside the sandbox
to permit local Unix sockets. source diff whitespace checks passed.
The staged patch has whitespace warnings from preserved blank context
lines; its contents are retained unchanged.
Live audio and keyboard behavior were not tested.
2026-10-28 08:57:12 -07:00
Storm Dragon ec32c6e4c4 Speech-dispatcher handling improved. 2026-10-28 11:34:57 -04:00
Storm Dragon 60abcc37d9 Application specific preferences saving now enabled. 2026-10-28 04:51:39 -04:00
Storm Dragon f88e5b81a2 Type searching added to applications menu. 2026-10-28 04:04:55 -04:00
Storm Dragon d3bcbbeacf Fixed volume and panning for ninjam override. 2026-10-28 03:47:57 -04:00
Storm Dragon b45f800489 Initial support for application specific overrides. 2026-10-28 03:31:33 -04:00
Storm Dragon 901fd58ba8 Fixed deletion checking bug that could cause misreading of the control+r prompt. 2026-10-28 01:24:03 -04:00
Storm Dragon 57799cd2eb Restore reading backspace if typing with autoread disabled. 2026-10-28 01:14:09 -04:00
Storm Dragon eaf450587c Standard fenrir backgrounding and -d flags restored. 2026-10-28 00:58:49 -04:00
Storm Dragon 4f5a875d0e Updated some documentation. 2026-10-28 00:45:23 -04:00
Storm Dragon 0e50de4c76 After commit c018f5fd29 Fenrir is being switched over to go. If you do not want to be part of the testing process, please switch to master. 2026-10-27 20:30:55 -04:00
Storm Dragon c018f5fd29 Possible bug fix for clipboard sync and handling. 2026-10-10 18:08:50 -04:00
Storm Dragon 1638f66a93 Updated AGENTS.md for when AI is used to keep translation potential up to date. 2026-10-05 12:47:32 -04:00
Storm Dragon 694b7ecd7e Our translation setup was woefully out of date. Also, migrate some missed code to the settings api. 2026-10-05 12:42:08 -04:00
Storm Dragon cbe2abc7e3 Make generic driver tests pybuild-safe 2026-09-12 12:33:54 -04:00
Storm Dragon 9e6e806947 Latest Codex app exposed a bug where redrawing the screen could cause speech to slip through even when it's turned off. Hopefully fixed now. 2026-08-21 18:36:04 -04:00
Storm Dragon 45019091ab I think I fixed the import and export clipboard manual buttons. They work for me for now at least. 2026-08-17 03:25:57 -04:00
Storm Dragon 68462d00cb Fixed crash bug. Wide characters were sometimes causing an index out of range error. Now they are just treated as spaces. 2026-08-17 02:26:04 -04:00
Storm Dragon 93a2745065 Move auxiliary work off the main event loop
Run voice discovery, voice testing, clipboard I/O, and external scripts in isolated background worker lanes. Deliver results through Fenrir's event queue so manager state remains owned by the main loop.
2026-08-14 23:29:15 -04:00
Storm Dragon 4ed431640e Improve tutorial help navigation 2026-08-13 09:29:43 -04:00
Storm Dragon e7f69b2159 Fenrir should no longer fail to report its current speech-dispatcher module. 2026-08-13 08:32:47 -04:00
Storm Dragon a2e4a8a086 Improve review spelling shortcuts 2026-08-13 00:42:13 -04:00
Storm Dragon cca688328b Support modifier-first Fenrir shortcuts 2026-08-12 23:42:01 -04:00
Storm Dragon ee441c319a Improved progress bar detections. 2026-08-06 13:49:53 -04:00
Storm Dragon 7593c8d0b3 Fix to socket routing for self-voicing. 2026-07-30 04:52:52 -04:00
Storm Dragon 122a6a38b3 Fix Unix remote watchdog socket leak 2026-07-29 14:13:53 -04:00
Storm Dragon 76b8f2f2cf Very scary test here. Trying to see if we can boost speed on very large terminals. 2026-07-26 22:01:11 -04:00
Storm Dragon d81565fbf5 Still attempting to kill off this delay. 2026-07-26 21:49:20 -04:00
Storm Dragon 186512f79a Another try for lag. 2026-07-26 21:42:53 -04:00
Storm Dragon 17b6e6f909 Attempt to decrease dectalk lag. Hoping you don't have to send settings over every time you want it to say something. 2026-07-26 21:34:04 -04:00
Storm Dragon fac3065c6a More tweaks to dectalk driver. Think we're nearly there. Hopefully. 2026-07-26 21:24:28 -04:00
Storm Dragon e93aba109a Fixes with the dectalk driver with rate, etc. 2026-07-26 21:10:39 -04:00
Storm Dragon 11a4244cc3 Fixed some errors with my dectalk protocol implementation. Thanks Codex. :) 2026-07-26 20:59:14 -04:00
Storm Dragon 9ac2e9e844 Found and hopefullyfixed a bug with fenrir watchdog. 2026-07-26 20:44:50 -04:00
Storm Dragon c863245c24 More attempts at getting this usb dectalk working. 2026-07-26 20:18:17 -04:00
Storm Dragon 45bd33f756 Improvements to Dectalk driver. 2026-07-26 19:44:10 -04:00
Storm Dragon 6d9260e79b Fixed 2 speech-dispatcher bugs. First, multiword voice names were not available. Next, when the module changed the old voice name was carried in causing some modules to fail. 2026-07-25 04:36:39 -04:00
Storm Dragon 385356e745 Prevent incoming output from bypassing auto-read toggle 2026-07-19 15:59:51 -04:00
Storm Dragon 28e4f8ab0c Progress bar beeps now work on ffmpeg output. 2026-07-12 15:06:44 -04:00
lilmike 4d94b56ee9 Fix very high cpu usage when a console fenrir under root and an x fenrir under your user are running at the same time. 2026-07-01 23:44:12 -07:00
Storm Dragon eb93a8aa62 Fixed a typo in tests/unit/test_hardware_speech_drivers.py. It was reading 9 bytes while comparing against a 10-byte payload. Thanks Samuel Thibault for finding and pointing this out. 2026-06-27 16:59:05 -04:00
Storm Dragon ad863ad706 Add ability for X clibpard and Fenrir's clipboard to stay in sync. 2026-06-27 16:55:00 -04:00
Storm Dragon 447e2cc896 Missed one commented setting. 2026-06-18 10:51:44 -04:00
Storm Dragon 2b7d205f06 Fixed some half-completed work in generic drivers. Minor -x bug fixes. 2026-06-18 10:35:48 -04:00
Storm Dragon fd5fe5b328 More progressbar updates. Removed Claud specific progress bar detection, hopefully caught now by generic progress bar updates. They do change it all the time, so it may work, but shouldn't be expected to do so. 2026-06-01 03:04:47 -04:00
Storm Dragon 4ed3f4d6ab Fixed version. 2026-05-31 22:37:59 -04:00
Storm Dragon 2cb83632f9 Fixed keyboard handling regression. 2026-05-31 22:36:35 -04:00
Storm Dragon 0c4fe50606 Updated log names. Should be easier to find if you forget to delete old logs. Now just called fenrir.log, we don't tend to need to have multiple logs anyway. 2026-05-30 14:16:23 -04:00
Storm Dragon 15f2435749 Hopefully fix some weirdness on tab completeion where it would read the entire screen instead of suggested tab completions. 2026-05-30 13:56:25 -04:00
Storm Dragon 3897b63068 Iproved logging for startup flags. 2026-05-29 20:22:06 -04:00
Storm Dragon f1a8e6af21 Fixed long standing bug where bottom of screen played for both top and bottom, found a couple other things that were off in the process. 2026-05-29 19:50:38 -04:00
Storm Dragon bd54ec0edb Fixed version. 2026-05-24 17:14:58 -04:00
Storm Dragon b9518f52ec Vmenu fixed I think. Hopefully last thing before new version. 2026-05-24 17:13:38 -04:00
Storm Dragon c143c9a561 Found a vmenu bug in -x. I thought we were close to a new release... 2026-05-24 17:03:41 -04:00
Storm Dragon 7e2f927596 fixed version. 2026-05-24 14:15:02 -04:00
Storm Dragon 788e678ed6 Attempted fix for some progress bars that were being skipped by progress bar detection. 2026-05-24 14:13:29 -04:00
Storm Dragon ea89e90c2f Merge branch 'testing' Hopefully final release candidate for the new version. 2026-05-23 18:59:14 -04:00
Storm Dragon ce43d64e77 Removed auto as a hardware synth device option. It was too flakey. 2026-05-23 18:58:55 -04:00
Storm Dragon 618987546a Adjust timeout for auto detection. I forgot these devices would be slow because most of them are very old with much less speed than would be expected today. 2026-05-23 18:41:42 -04:00
Storm Dragon 604221a29d Attempt to make auto at least somewhat more reliable. Recommend that device be explicitly set if possible. 2026-05-23 18:23:58 -04:00
Storm Dragon 89b85c6f17 Hardware synth code now verified working. New release candidate. 2026-05-23 18:05:55 -04:00
Storm Dragon 6e3d7fee94 Parse the settings correctly lol. 2026-05-23 17:57:02 -04:00
Storm Dragon 089850ac18 More hw synth refinement. 2026-05-23 17:39:16 -04:00
Storm Dragon 5b7c08260a Another iteration based on feedback from hardware synth testing. 2026-05-23 17:23:52 -04:00
Storm Dragon d4b2fec1db speculative fixes for hardware speech. 2026-05-23 17:10:46 -04:00
Storm Dragon 1f7aa99cc0 Release candidate. 2026-05-23 16:13:51 -04:00
Storm Dragon d853e1b24d Fixed the -x keyboard problem for real this time I'm pretty sure. 2026-05-22 20:23:31 -04:00
Storm Dragon e8bc34eaf5 Merge bug fixes, fix version. 2026-05-21 01:08:27 -04:00
Storm Dragon f84167a7fb Of course, soon as I feel things are stable enough to merge to master bugs come crawling out of the woodwork. Fix for being sure Fenrir switches out of its modal mode completely when leaving speech history. 2026-05-21 01:07:01 -04:00
Storm Dragon 29a6c3eb42 A few teaks. Maybe close to actual release. 2026-05-21 00:50:20 -04:00
Storm Dragon ac7348895f Speech history added, bound to fenrir+control+h. 2026-05-20 21:02:56 -04:00
Storm Dragon 4caef89f6b More work on sockets attempt to get socket command to standard daemon.sock to a running instance. Also, fixed a long standing misspelling in daemon, was deamon, so if your scripts that self-voice or whatever with fenrir no longer work, this is why, please update scripts to the new, correct, daemon.sock. 2026-05-20 20:11:21 -04:00
Storm Dragon 8467bd74c3 New hardware synth support added. Untested, so consider this experimental. 2026-05-20 18:02:51 -04:00
Storm Dragon f09437ea60 Speculative fix for a sometimes speech crash bug. 2026-05-19 01:54:09 -04:00
Storm Dragon 19194e73fc Fenrir was not cleaning up after itself properly. Fixed several possible stale file bugs and hopefully this problem is now gone. 2026-05-18 17:59:47 -04:00
Storm Dragon 096919a2da Hopefully fixed bug where keys like super weren't being forwarded with bypass mode. 2026-05-14 21:45:30 -04:00
Storm Dragon a8e4d7bb2a Forward keypress bug fixed. 2026-05-14 20:10:11 -04:00
Storm Dragon 8966275071 Missed a couple of keys in translation for -x. 2026-05-13 23:39:15 -04:00
Storm Dragon c48a9a6731 Fixed a regression in reading dialog based TUI. 2026-05-13 18:31:11 -04:00
Storm Dragon 6876547590 Update documentation. 2026-05-12 22:34:30 -04:00
Storm Dragon 116f254e11 Fixed scripts with simlinks. 2026-05-12 20:01:46 -04:00
Storm Dragon 5dccdd27c4 Another shot at squishing this bug. 2026-05-12 18:30:23 -04:00
Storm Dragon fa63ecadbe The freeze bug reared its ugly head again. 2026-05-12 18:18:37 -04:00
Storm Dragon 96c5184450 Tab completion fixes. 2026-05-12 17:39:56 -04:00
Storm Dragon b599a25945 Add more local sourced directories for scripts and sounds meaning each user can have own scripts and sound themes when using -x. Hopefully fixed the remainder of the random freeze bug. 2026-05-12 17:23:50 -04:00
Storm Dragon 4022fc4006 Work on tightening up keyboard handling. 2026-05-12 16:06:31 -04:00
Storm Dragon ab7818fd4c Attempt to prevent thread lock that is causing freeze. 2026-05-12 12:42:57 -04:00
Storm Dragon 878eef5c5b Tests updated. Attempt to fix remaining problems with forward keypress and numlock reporting. 2026-05-12 02:32:26 -04:00
Storm Dragon 38ef1c2d72 Attempt to fix forward keypress and numpad state. 2026-05-12 02:26:02 -04:00
Storm Dragon 57980225ad Implemented local settings save in ~/.local/share/stormux. Also, I think I got interrupt on any keypress working better when using -x. 2026-05-12 02:06:07 -04:00
Storm Dragon 9e2d5a89b3 Fixed horrible crash bug with opening vim. 2026-05-10 22:31:17 -04:00
Storm Dragon c7d74726da Bump testing version for tab completion verification 2026-05-09 00:30:42 -04:00
Storm Dragon be78db0d58 Hopefully final touches on the new tab completion. 2026-05-09 00:14:36 -04:00
Storm Dragon 0af7d94014 That does it, I'm breaking out codex on this one. Take that tab completion! 2026-05-08 23:38:59 -04:00
Storm Dragon 42ba3fdad2 Another attempt at improving tab completion detection. 2026-05-08 21:50:27 -04:00
Storm Dragon 6fb8298b9f More trouble with pty vs console behavior. 2026-05-08 21:26:58 -04:00
Storm Dragon 114a7b0da7 Hopefully make pty more similar to tested console behavior. 2026-05-08 20:10:08 -04:00
Storm Dragon 90efad362b More fixes to pty reading. 2026-05-08 19:58:42 -04:00
Storm Dragon 3c61b6629a Possibly fixed a bug in the pty code used by -x flag. 2026-05-08 19:45:59 -04:00
Storm Dragon b6689d93bf Use single shared remote command lock 2026-05-08 00:48:11 -04:00
Storm Dragon a60efdbe07 Use shared locks for Fenrir instance coordination 2026-05-08 00:01:58 -04:00
Storm Dragon b38b0a2dab Fix cross-user Fenrir instance registry pruning 2026-05-07 23:51:07 -04:00
Storm Dragon 37e281a1f7 Fix Fenrir Unix socket ownership reporting 2026-05-07 23:43:11 -04:00
Storm Dragon 6d4f55ffe5 A couple of socket fixes so root fenrir and user fenrir do not battle. 2026-05-07 23:37:01 -04:00
Storm Dragon 8638bca1d5 Improve socket handling for -x spawned fenrir instances. 2026-05-07 23:24:54 -04:00
Storm Dragon 0273f9b956 Make x support optional. 2026-05-07 12:50:45 -04:00
Storm Dragon 1670c5711b Few fixes with the -x X driver code. 2026-05-07 02:03:36 -04:00
Storm Dragon fed8f24126 Add X11 terminal input mode 2026-05-07 01:45:00 -04:00
Storm Dragon 40120f825c 2026.04.04 merged 2026-04-04 10:08:46 -04:00
Storm Dragon 17dea6b026 Fix IRC incoming announcements and add focus.tui default 2026-03-25 03:24:29 -04:00
Storm Dragon 57c09e0db9 Guard evdev uinput setup 2026-03-04 04:01:19 -05:00
Storm Dragon 4050c32a16 Add speech-first diff review mode with navigation and tests 2026-02-15 15:55:46 -05:00
Storm Dragon 2e10c1c43b Version bump for new release. 2026-01-28 16:41:44 -05:00
Storm Dragon 1e67876883 RC1 for next release. 2026-01-11 23:19:12 -05:00
Storm Dragon 14cf6b6088 Clarify other OS than Linux support. 2026-01-11 23:15:28 -05:00
Storm Dragon 900a027643 Merge branch 'testing' 2026-01-10 23:12:13 -05:00
Storm Dragon 0e50175463 Removed sound for echo switching. 2026-01-10 23:11:53 -05:00
Storm Dragon 7283f04778 Merge branch 'testing' 2026-01-10 23:03:50 -05:00
Storm Dragon 8d3495f74f Character echo settings toggle key added. Keyboard files updated. 2026-01-10 23:03:22 -05:00
Storm Dragon a6cd47dafc latest code. 2026-01-10 21:55:25 -05:00
Storm Dragon 0bb2e52deb Fixed fluttery caps speech shifts. 2026-01-10 20:49:22 -05:00
Storm Dragon b8eb815a86 Merged latest from testing. 2026-01-08 16:16:20 -05:00
Storm Dragon beca468338 Finally! Fixed bug that was causing interruption when prompt comes back. 2026-01-08 12:37:55 -05:00
Storm Dragon a26fe26c8c Log level now set to 0 by default so there's no longer a ton of log files created that aren't normally needed. 2026-01-05 08:32:07 -05:00
Storm Dragon 508fd11610 Redesigned the flood protection for incoming text, should hopefully be much better. 2026-01-04 00:33:06 -05:00
Storm Dragon afe0e71a1d A tiny bug fix in prompt checker. 2026-01-04 00:05:52 -05:00
Storm Dragon 9e8d0b3869 Latest changes. 2025-12-30 04:10:52 -05:00
Storm Dragon d7f86ca0de Setting added to choose caps notification type, beep, pitch, both or none. 2025-12-30 04:09:25 -05:00
Storm Dragon 49a79d2722 Removed promoted text option. It wasn't all that useful, and the new speech restore performs the same thing more affectively. 2025-12-28 19:07:54 -05:00
Storm Dragon 4ab024d115 Mostly progress bar fixes. 2025-12-22 12:51:15 -05:00
Storm Dragon c4ae27a01b More progress bar tweaks. 2025-12-20 06:59:19 -05:00
Storm Dragon 668d39b444 Merged for wider testing. 2025-12-19 12:56:33 -05:00
Storm Dragon 8b25afbf5a More progress bar updates. 2025-12-19 12:55:17 -05:00
Storm Dragon efeb040f75 Spelling error and case fixes. Everything seems to work so far. 2025-12-19 03:46:18 -05:00
Storm Dragon 7a17b36d50 More update work on readme and settings. 2025-12-19 03:07:46 -05:00
Storm Dragon 047a31b4bf Latest changes. 2025-12-19 00:11:04 -05:00
Storm Dragon 096aef9f08 Progress bar detection updates. 2025-12-14 19:05:18 -05:00
Storm Dragon 76472b83b5 Fixed a comment in settings file. 2025-12-10 20:20:56 -05:00
Storm Dragon a52bf624ec Merged changes from testing. WARNING: breaking changes, you will need to update or regenerate your settings file. Use the example provided in config/settings/settings.conf or on arch use the .pacnew as a guide. 2025-12-10 20:12:07 -05:00
Storm Dragon f4e28a246f Second pass on updating settings, missed a few the first go round. 2025-12-10 20:08:01 -05:00
Storm Dragon 560ceb26c9 Major: Convert all settings from camelCase to snake_case for PEP8 compliance (WARNING! BREAKING CHANGES)
Breaking change for v3.0 - users must update their settings.conf file.

  - Converted 45 settings across all sections
  - Updated 524 Python files, tests, and documentation
  - All tests passing, zero regressions
  - Moving forward the philosophy is clean code over backward compatibility
  - Next stable release will be considered a major release
2025-12-10 19:39:45 -05:00
Storm Dragon 61868c94e5 Experimental fix to hopefully let users who rebind their capslock key keep those settings while using Fenrir. 2025-12-10 08:22:17 -05:00
Storm Dragon f462ca7990 Merge branch 'testing' minor settings file update. 2025-12-03 16:25:47 -05:00
Storm Dragon f0bbcb8a38 Updated settings file to document that capslock as fenrir key and echo mode 2 are incompatible. 2025-12-03 16:25:22 -05:00
Storm Dragon aed627ec2a Discovered through much pain that echo mode 2 and capslock as fenrir key are incompatible. Documented in settings file. 2025-12-03 16:18:02 -05:00
Storm Dragon e62b887e9c Some socket improvements for remote manager I thought should make it into this release. 2025-12-03 12:20:14 -05:00
Storm Dragon bf0d134187 Tests added, see the documentation in the tests directory for details. Improved the socket code. 2025-12-03 02:51:49 -05:00
Storm Dragon c66a9ba9c2 Problems with voice selection fixed.: 2025-12-02 18:38:06 -05:00
Storm Dragon 2092a3e257 Fixed voice selection. 2025-12-02 18:36:46 -05:00
Storm Dragon d46d8de3ee Updated sound driver to gstreamer by default. 2025-12-02 16:25:25 -05:00
Storm Dragon 75a8447759 One more feature addition before hopefully releasing the new version. 2025-12-02 16:13:15 -05:00
Storm Dragon 1650eec768 Add ability to switch speech-dispatcher module and voice to the speeach keys. 2025-12-02 16:11:47 -05:00
Storm Dragon 5bb786ef4c Bug fix in vmenu for keyboard layouts. 2025-11-27 22:44:51 -05:00
Storm Dragon 7f7faa17d3 keyboard layout fixed in vmenu. 2025-11-27 22:42:36 -05:00
Storm Dragon 2766f70c5d Some cleanup and minor fixes in docs. 2025-11-24 09:07:45 -05:00
Storm Dragon 8d781643bc Remove group and user comments from the Arch service file, not being used, so just extra stuff. 2025-11-24 08:49:31 -05:00
Storm Dragon c184cf023a Code cleanups, fixes to systemd files, url corrections. 2025-11-24 08:44:49 -05:00
Storm Dragon 841c221c7b Preparing for new tagged release. 2025-11-23 18:51:02 -05:00
Storm Dragon 87553bdc38 more fixes for the pickle error. 2025-11-23 18:37:21 -05:00
Storm Dragon 77a3aae5a4 Attempt to fix cannot pickle 'TextIOWrapper' instances error for some distros. 2025-11-23 18:29:38 -05:00
Storm Dragon aabc202d83 Latest version of configure_pipewire.sh tested and appears to work. 2025-10-17 22:19:58 -04:00
Storm Dragon 2f3a114790 Pipewire configuration tool updated. In a bout of pure insanity I tested this on my production system and it worked without a hitch, so should be good to go. 2025-10-17 22:19:30 -04:00
Storm Dragon c797974560 Pre tag release. If no problems reported this will become the new stable release. 2025-10-17 21:27:36 -04:00
Storm Dragon af4740d5ad Various minor fixes in preparation for new release. 2025-10-17 21:26:13 -04:00
Storm Dragon 5ef5faaebe Progressbar tweaks. 2025-10-17 21:03:12 -04:00
Storm Dragon 7041d2567a Progress bar updates. 2025-09-26 18:07:35 -04:00
Storm Dragon 2c38bcf5f4 Another attempt at fixing external numpad detection. I *think* some of them send numlock state with every event. If that's the case, this should fix it. 2025-09-13 14:11:27 -04:00
Storm Dragon 96cdda99c4 Separate menu entries for some settings, improves usability. Fixed device detection for devices that do not contain what they do in their name, e.g. numpads that are not listed as numpads. This hopefully fixes a bug with some external numpads. 2025-09-12 12:09:00 -04:00
Storm Dragon 0658d37ae8 I don't wanna say this too loud, but I think tab completion is much more reliable now. No more not reading when you press tab and something appears. 2025-08-31 20:45:32 -04:00
Storm Dragon a6bb3e1301 A bit of code cleanup. Nothing should be changed at all functionally. 2025-08-31 20:30:06 -04:00
Storm Dragon 5ff653bd00 Progress bar and commit validator updates. 2025-08-31 14:54:07 -04:00
Storm Dragon 356f4b01c1 Got the version file wrong again. Need to be more careful. 2025-08-31 14:44:46 -04:00
Storm Dragon c7ad4d9200 merged to master. 2025-08-31 14:39:26 -04:00
Storm Dragon d274fe78f3 Rebind the keyboard layout switcher to fenrir+control+f4. 2025-08-31 14:37:48 -04:00
Storm Dragon f5344a7227 removing keyboard layouts that are no longer used 2025-08-23 18:30:35 -04:00
Storm Dragon 90ffc2fc08 removing keyboard layouts that are no longer used 2025-08-23 18:29:42 -04:00
Storm Dragon b635f7538b Latest changes merged. Minor fixes to progress bar detection. Fixed my old habbit of camel case variable names. :) 2025-08-23 12:20:05 -04:00
Storm Dragon 7f473b72a7 Minor updates to progress bar detection. 2025-08-23 12:16:10 -04:00
Storm Dragon e255651c28 Merged testing. 2025-08-22 00:29:02 -04:00
Storm Dragon b3d73102fc Fenrir will now read dots in the middle of or at the beginning of words regardless of punctuation settings. 2025-08-21 23:29:45 -04:00
Storm Dragon 78c1cbbb6b Improved progress bar detection for curl. Experimental flood protection for updates. 2025-08-21 19:59:40 -04:00
Storm Dragon 8c26d93001 Progress bar monitoring updates. Hopefully fixed some false positives, and updated claude-code progress monitoring. 2025-08-20 14:33:22 -04:00
Storm Dragon 98b9c56af7 Read all code added. It's definiately a work in progress and does not function currently. 2025-08-04 14:41:14 -04:00
Storm Dragon 8bada48a09 Fixed errors in README. Moved the audio configuration script stuff nearer the top. 2025-08-04 14:36:43 -04:00
Storm Dragon 0a2c8472c0 Fixed errors in README. Moved the audio configuration script stuff nearer the top. 2025-08-04 14:36:06 -04:00
Storm Dragon e9a0101fe7 Merged README.md 2025-08-04 14:26:55 -04:00
Storm Dragon 69eade3327 Updated documentation for stand-alone pipewire or pulse configuration scripts. 2025-08-04 14:24:41 -04:00
Storm Dragon 73f67c2a04 Multiple fixes to indentation beep code, including volume for lower ranged beeps using the gstreamer driver. 2025-08-04 12:38:14 -04:00
Storm Dragon 9ef9d762f4 A few emoji updates. 2025-07-31 03:16:02 -04:00
Storm Dragon 84293db6dc Another shot at fixing multiple numpads. 2025-07-25 14:17:17 -04:00
Storm Dragon 914535d12b A few bug fixes, better checking in place to make sure syntax and other errors do not make it to commits. 2025-07-24 18:34:12 -04:00
Storm Dragon 94a1acbaca A few improvements to validation. 2025-07-24 14:05:51 -04:00
Storm Dragon 8c233e0385 Some syntax errors fixed. Syntax checking added. Release checklist created. 2025-07-24 13:52:10 -04:00
Storm Dragon b6a9e1a692 Hopefully fixed problems with connection external numpads. 2025-07-23 00:01:46 -04:00
Storm Dragon d41ea8388f Fixed url exclusion detection for progress bars. 2025-07-21 06:58:49 -04:00
Storm Dragon 2dd732dc9d Emojis added, improvements to pyt mode. 2025-07-19 16:50:53 -04:00
Storm Dragon b68a28e857 Added more emojis. 2025-07-17 11:11:35 -04:00
Storm Dragon 8c668cc0cc Final batch of pty driver fixes... For now. 2025-07-16 19:48:48 -04:00
Storm Dragon 579bf0f0f0 More work on the pty driver. 2025-07-16 19:43:07 -04:00
Storm Dragon d1bad818cd initial improvements to pty driver. Improved clipboard handling of multibyte characters. Added emoji menu to vmenu. It places the emoji to the clipboard to be used wherever. 2025-07-16 19:35:26 -04:00
Storm Dragon e177c7f486 Final merge for version 2025.07.16. If no problems will tag later today. 2025-07-16 12:33:21 -04:00
Storm Dragon ae4c418323 A few minor progress bar beep tweaks. 2025-07-15 23:13:40 -04:00
Storm Dragon b9abf02b12 A few minor tweaks in preparation for release. 2025-07-13 15:31:57 -04:00
Storm Dragon 0c116adaf2 Progress bar detection updates. 2025-07-13 11:18:51 -04:00
Storm Dragon fe5e2c065e Merge branch 'testing' moving closer to tagged release. 2025-07-09 18:32:15 -04:00
Storm Dragon 5a14804d11 Updates to documentation. A few tidying up changes. 2025-07-09 18:31:58 -04:00
Storm Dragon ef3ebee10c Preparing for new tagged version. Please watch for bugs. 2025-07-09 09:33:19 -04:00
Storm Dragon 6876995d4c New punctuation setting added. 2025-07-09 09:30:45 -04:00
Storm Dragon 01f4b64390 Replace skipped punctuation with space. There's a setting in general, on by default, that will revert to old behavior if you replace it with false. 2025-07-09 01:17:36 -04:00
Storm Dragon 5e858cfde1 Expirmental improvements to highlight tracking. 2025-07-09 01:06:54 -04:00
Storm Dragon 2ad754a372 Some fixes to pep8 stuff. 2025-07-08 18:35:12 -04:00
Storm Dragon 271c4fc18f Table mode fixes and improvements to application detection. 2025-07-08 14:41:43 -04:00
Storm Dragon bb6dbc7186 Fixed character navigation in table mode. 2025-07-07 22:58:14 -04:00
Storm Dragon c7cc9d039b Improved application detection, now works inside screen and tmux. Fixed incosistancies in prev/next word navigation. 2025-07-07 11:17:12 -04:00
Storm Dragon d1a42835e4 Initial table mode added. Probably bugs. 2025-07-07 09:46:12 -04:00
Storm Dragon 3390c25dfe More pep8 fixes. A tiny bit of refactoring. 2025-07-07 00:42:23 -04:00
Storm Dragon ea56b90b48 Oops, getting used to this pep8 thing myself. Fixed codeName to code_name. 2025-07-06 18:51:43 -04:00
Storm Dragon 1268d989b7 Merge after mostly converting to pep8 compliance. 2025-07-06 18:34:28 -04:00
Storm Dragon d28c18faed Found and sniped a couple more pep8 migration errors. 2025-07-05 09:29:32 -04:00
Storm Dragon c90c726899 Fixed a bug in the remote manager. 2025-07-05 09:15:40 -04:00
Storm Dragon bab7c1a552 Removed double keybinding from laptop layout. 2025-07-03 16:11:13 -04:00
Storm Dragon 848844aae4 Oops, forgot to delete my traceback notes. 2025-07-03 13:24:23 -04:00
Storm Dragon 4c1bddbbd3 Most of the pep8 changes finished. Be careful, things may be horribly broken. 2025-07-03 13:23:25 -04:00
Storm Dragon 21bb9c6083 Most of the pep8 changes finished. Be careful, things may be horribly broken. 2025-07-03 13:22:00 -04:00
Storm Dragon 7408951152 To make Fenrir easier to approach for new developer, start code migration to be pep8 compliant. 2025-07-01 22:23:50 -04:00
Storm Dragon 23c3ad20a1 More code optmizations. Removed fenrir+pk_plus. The functionality of bringing back speech has been added to the temperary speech interruption key kp_enter. 2025-06-30 22:25:01 -04:00
Storm Dragon 4bcf82178e Updated configure_pipewire script. A bit more code refactor. Preparing to start moving everything over to pep8 compliance. 2025-06-28 22:52:21 -04:00
Storm Dragon beae1866bb Moved restore speech on prompt to existing temp interrupt speech command, Fenrir+kp_plus unbound now. 2025-06-28 01:49:20 -04:00
Storm Dragon 8af1cca879 Latest changes and bug fixes. 2025-06-27 21:18:27 -04:00
Storm Dragon 40b88efa34 Fix up a few errors that sneaked in while updating vmenu code and a couple other things. Logs should be much nicer now. 2025-06-25 10:56:08 -04:00
Storm Dragon b1edc53362 Added missing dependency to requirements.txt. 2025-06-20 12:43:49 -04:00
Storm Dragon dda84b9905 Final batch of code stability updates before anouther bout of extended testing. Still plenty to go, but making progress. 2025-06-20 03:34:50 -04:00
Storm Dragon 64e79f6945 Code cleanup, make sure race conditions can't happen, at least in theory. 2025-06-20 03:10:07 -04:00
Storm Dragon f4ed8da4c3 Forgot one in last commit. 2025-06-20 03:04:25 -04:00
Storm Dragon a5ca1d28e8 Make sure all except statements are no longer empty, should help a lot with debugging. 2025-06-20 03:03:43 -04:00
Storm Dragon a394ea0222 Code cleanup and bug fixes. 2025-06-20 02:19:57 -04:00
Storm Dragon 4e193f133f Fixed an error that crept into log permissions during code restructuring. 2025-06-20 02:19:07 -04:00
Storm Dragon 27dcff23bb Code optimization and bug fixes. Removed the broken, partial atspi driver implementation. 2025-06-18 15:08:36 -04:00
Storm Dragon efb308ac72 latest testing code merged. Nothing major reported from testing branch, so if we get no reports, this will become the next stable release. I'm waiting a bit to tag because major new features introduced. 2025-06-17 00:53:28 -04:00
Storm Dragon d81d563bb6 Add page up and page down to move through the voice browser by 10%. 2025-06-16 01:08:05 -04:00
Storm Dragon 43871cea3c Fixes to the voice driver. It should actually work completely now. 2025-06-15 19:52:18 -04:00
Storm Dragon 72bd334d65 Very experimental attempt to move the configure_fenrir script into fenrir itself using the vmenu system. Lots of testing please. 2025-06-15 14:04:14 -04:00
Storm Dragon f6be6c54fb Bug fixes mostlry, tested and seems to be working better. 2025-06-13 23:21:46 -04:00
Storm Dragon e76b914d6e Ignore screen 7 by default in case auto ignore screen doesn't work. 2025-06-12 18:43:12 -04:00
Storm Dragon 83cb330d34 Potential fixes to progress bar. Better handling of punctuation while reading. 2025-06-10 18:10:08 -04:00
Storm Dragon b0ac6e1409 improved documentation for the diff generation. 2025-06-09 16:53:05 -04:00
Storm Dragon 6998706934 Testing fixes for security improvement, thread safety, and memory management. 2025-06-09 14:41:33 -04:00
Storm Dragon 62e1001679 Add keybinding for progress bar monitoring for laptop mode. Fenrir+Shift+P. 2025-06-09 13:11:51 -04:00
Storm Dragon d935ef2e3c The fix for hopefully not reading all spaces broke review by character. Hopefully fix that. 2025-06-09 12:48:02 -04:00
Storm Dragon e2fb28d92f Attempt to fix the bug where fenrir sometimes reads all the spaces in a message. 2025-06-09 02:33:36 -04:00
Storm Dragon 8a223282df Some modifications to progress bar detection, can revert if needed. 2025-06-09 02:19:39 -04:00
Storm Dragon 91c97dd1dd Fixed error in settings file, Time and date need %% instead of just a single %. 2025-06-08 18:04:06 -04:00
Storm Dragon 5cc719a6f3 Commit 2 of 2, code refactor and cleanup. 2025-06-08 14:26:24 -04:00
Storm Dragon ddc1b43304 Commit 1 of 2, code refactor and cleanup. 2025-06-08 13:49:22 -04:00
Storm Dragon 6ad11effc6 Enhanced prompt detection 2025-06-08 13:31:37 -04:00
Storm Dragon f18c31df6c Merge branch 'testing' bug fix for remoteDriver 2025-06-07 18:24:44 -04:00
Storm Dragon ca0e3b5987 Reverted changes to remot driver because some settings, e.g. highlight mode, stopped working. 2025-06-07 18:22:31 -04:00
Storm Dragon 0009d90a68 Updated .gitignore 2025-06-07 13:35:10 -04:00
Storm Dragon 2c2efc56f0 Progress beeps should now rok with dd's progress flag. 2025-06-07 13:23:45 -04:00
Storm Dragon 3dca3e5b23 Merged for new release. 2025-06-07 12:23:53 -04:00
Storm Dragon 27c35939b1 A few minor tweaks to progressbar beeps. 2025-06-07 11:13:15 -04:00
Storm Dragon 7e87ebf04b Attempt to improve how Fenrir reads multiple characters in a row, e.g. [------]. 2025-06-07 10:51:02 -04:00
Storm Dragon ec6c135581 Keybinding for silence until prompt returns added to laptop.conf. Fenrir+Shift+Enter 2025-06-07 10:20:09 -04:00
Storm Dragon 998c63cc71 Fixed a few typos in settings file, changed progressbars to true by default. 2025-06-07 01:48:58 -04:00
Storm Dragon 26c6e32c59 Add the ability to add custom prompts to the settings file, generic prompts are covered with the existing detection code. 2025-06-07 01:26:21 -04:00
Storm Dragon 97e2da614b 2 new features, silence speech until prompt returns and progress bar beeps. 2025-06-07 00:52:13 -04:00
Storm Dragon 0930a86ce7 --ignore-screen (-i) flag added. 2025-06-06 22:58:08 -04:00
Storm Dragon 1b9a9a90b1 Fixed version conflict. 2025-06-06 20:35:07 -04:00
Storm Dragon a742c12cd8 Remote driver now responds so you can know for sure the command worked. 2025-06-06 20:32:46 -04:00
Storm Dragon 8d50003730 Updated documentation. Attempted to track down a bug that causes disable speech sound to play with no interaction.? 2025-06-06 17:56:02 -04:00
Storm Dragon 4c8c8d896d Fixed version conflict. 2025-06-05 16:05:11 -04:00
Storm Dragon bd151c7cec Removed the speakup keyboard layout. It was never finished, and Fenrir has more functionality anyway and isn't that hard to learn. 2025-06-04 22:22:51 -04:00
Storm Dragon 6f4784daed Pty layouts skipped in keyboard layout cycling. 2025-06-04 22:14:49 -04:00
Storm Dragon 8c471adfa4 Keyboard layout shortcut changed to a single key, f4, because it multikey shortcuts require the fenrir key. 2025-06-04 20:37:21 -04:00
Storm Dragon 77065c55b4 Attempt to add keyboard shortcut to switch keyboard layout. 2025-06-04 20:17:06 -04:00
Storm Dragon 7f75c231e1 Removed _ from some punctuation, added it to most. 2025-06-04 19:34:15 -04:00
Storm Dragon 4672592dba Latest merge from testing. 2025-04-28 15:41:14 -04:00
Storm Dragon 6b84a8e9bc Rename suspendingScreen to ignoreScreen. Requires edit to your settings file, find suspending and change it to ignore. This may break stuff, please let me know. 2025-04-23 01:36:03 -04:00
Storm Dragon 3212962a5b Adjusted a few of the defaults in punctuation and in settings file. Logs are now in a more screen reader friendly format with timestamps and level coming after the actual information. 2025-04-21 14:04:57 -04:00
Storm Dragon 9e9cb883e7 Updated requirements.txt. 2025-04-17 01:04:38 -04:00
Storm Dragon 7a12992b88 latest release. 2025-04-17 00:36:26 -04:00
Storm Dragon 26a8c8cf86 Added setproctitle to dependencies. 2025-04-17 00:35:02 -04:00
Storm Dragon bbfd2790a9 Attempt to fix import/export GUI clipboard for some distros. 2025-04-16 21:50:37 -04:00
Storm Dragon 6edb743c23 Removed rapidfuzz from dependencies. 2025-04-16 12:14:30 -04:00
Storm Dragon a1fcee9a45 Removed the rapidfuzz dependency. There wasn't much of a gain in performance and it did not work on some distros. 2025-04-16 12:06:54 -04:00
Storm Dragon 4e6e6e2d17 Fixed a couple of bugs in setup.py. 2025-04-16 00:52:44 -04:00
Storm Dragon 7a87fb51bb Fixed version for master branch. 2025-04-14 20:04:14 -04:00
Storm Dragon 676c2b07a9 A couple of small improvements to install.sh. 2025-04-14 20:02:00 -04:00
Storm Dragon 2dda73ac87 Request to be able to use the numpad if numlock is on and only process fenrir commands if numlock is off. This should work, let me know if anything breaks. 2025-04-14 18:57:10 -04:00
Storm Dragon f68a1af223 Fixed a typo in requirements.txt. 2025-04-10 05:46:22 -04:00
Storm Dragon 5ab66f6978 Attempt to fix the bug where Fenrir freezes the computer solid if it manages to start before sound is ready. It shuld at least release the keyboard now. 2025-03-20 02:55:39 -04:00
Storm Dragon 2cc2fda28c Actually fix the version file this time. 2025-03-02 17:59:20 -05:00
Storm Dragon c99d0f6ee1 Fixed version.py. 2025-03-02 17:44:32 -05:00
Storm Dragon 1552b962a1 Updated dependencies. 2025-03-02 17:43:01 -05:00
Storm Dragon 09391bfe84 Experimental fix for evdev failures. 2025-03-02 17:24:45 -05:00
Storm Dragon e76ca9889a Same update for export to x clipboard. Now using pyperclip. 2025-03-02 16:04:38 -05:00
Storm Dragon 73206ce393 Switched from xclip to pyperclip for import from x. 2025-03-02 15:25:06 -05:00
Storm Dragon 4966b87ba1 pyttsx removed from setup file because it's no longer a speech option. 2025-02-26 17:38:22 -05:00
Storm Dragon 145cab6221 Updated dependencies to include rapidfuzz. 2025-02-26 17:08:50 -05:00
Storm Dragon e46926f145 Fixed a traceback on shutdown. Hopefully improved responsiveness with the diff. Trying rapidfuzz for smaller screen updates, add a catch to fall back to the original difflib if there are any problems. This is experimental, please watch for bugs. 2025-02-26 17:02:25 -05:00
Storm Dragon 8cd50c5070 Hopefully improve accuracy of blank line reporting. 2025-02-26 16:05:17 -05:00
890 changed files with 88831 additions and 33566 deletions

No files matched your search

+6 -5
View File
@@ -1,8 +1,9 @@
__pycache__/
*\.pyc
fenrir.egg-info/
fenrir_screenreader.egg-info/
dist/
build/
*.pyc
.pytest_cache/
/fenrir
/fenrir.sh
/coverage.out
*.kate-swp
.directory
CLAUDE.md
+64
View File
@@ -0,0 +1,64 @@
# Repository Guidelines
## CRITICAL: Init-System Independence
Fenrir must never depend on a specific Linux init system or service manager.
This applies to the reader, helper processes, process supervision, installation,
packaging, and required tests. Do not require systemd, `systemd-run`, `systemctl`,
or a systemd user manager. Use init-independent Linux interfaces and detect the
capabilities actually available. Fenrir must work on non-systemd distributions,
including Artix.
## Project Structure & Module Organization
Fenrir is a Linux console screen reader with an X11 terminal mode. This checkout
is on the Go migration's `testing` branch; confirm the intended branch before
contributing. `cmd/fenrir/` contains the executable entry point. `internal/`
contains packages for input, screen review, speech, sound, configuration, and
remote control. Go tests live beside their packages as `*_test.go`.
`config/` holds TOML settings, keyboard layouts, punctuation profiles, and sound
assets. `internal/i18n/locale/` holds translations. `docs/` contains manuals;
`tools/` contains maintenance utilities. `src/fenrirscreenreader/` retains Python
sources, while `tests/` includes Python unit, integration, and native fixtures.
## Build, Test, and Development Commands
Use Linux, Go 1.27.2 or newer, a C compiler, and `pkg-config`, with development
libraries for libevdev, X11, libvterm, and ALSA. See `README.md` for runtime dependencies.
- `go build -o fenrir ./cmd/fenrir`: build the executable beside its resources.
- `./fenrir --config config/settings/settings.toml --check-config`: validate settings without opening devices.
- `./fenrir -x`: run in an X11 terminal with `DISPLAY` and `WINDOWID` available.
- `go test ./...`: run the Go test suite.
- `go test ./internal/reader`: run a focused package's tests.
- `go run ./tools/translations check`: validate extracted messages and catalogs; requires GNU gettext.
## Coding Style & Naming Conventions
Format Go changes with `gofmt` and preserve tab indentation. Follow neighboring
code: camelCase locals, snake_case helpers, and capitalized exported identifiers
where required by Go visibility. Preserve existing license headers. Keep changes
focused and use existing configuration and presentation APIs.
Keep interface messages translatable through `internal/i18n`; exclude screen
contents and protocol identifiers. After message changes, run
`go run ./tools/translations update`, review catalog changes, then run `check`.
Run `shellcheck` on edited shell scripts.
## Testing Guidelines
Use Go's `testing` package with `Test...` functions in `*_test.go`. Cover changed
behavior and plausible regressions; no numeric coverage threshold is documented.
Follow each native fixture's prerequisites. Automated checks do not establish
audible speech or physical keyboard behavior: verify affected console or X11
workflows, including navigation and settings persistence. Preserve the active reader.
## Commit & Pull Request Guidelines
History uses short descriptive subjects, without a consistent prefix convention.
Keep commits scoped. Describe the problem, resulting behavior, linked issues when
applicable, commands run, and pending live checks. Follow the README's
AI-assisted contribution policy: contributors must review the diff and test
intended behavior and likely regressions before submission. Leave submission to
the contributor after review.
+8 -12
View File
@@ -1,18 +1,14 @@
# Fenrir screen reader
# Fenrir Screen Reader Credits
## Developers
## Current Maintainer
* Storm Dragon: Project leader
* Jeremiah: Coder.
* **Storm Dragon** - Project leader and maintainer
## Previous Developers
## Special Thanks
* Chrys: coder.
## Special thanks to:
* F123 Consulting for suggestions, some funding, and endless testing.
* Stormux for continuation of the project.
Special thanks to **Chrys**, without whom this project would not exist in the
first place. He wrote Fenrir from scratch when I desperately needed a console
screen reader. His hard work and dedication to accessibility are always
appreciated.
-166
View File
@@ -1,166 +0,0 @@
GNU LESSER GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
This version of the GNU Lesser General Public License incorporates
the terms and conditions of version 3 of the GNU General Public
License, supplemented by the additional permissions listed below.
0. Additional Definitions.
As used herein, "this License" refers to version 3 of the GNU Lesser
General Public License, and the "GNU GPL" refers to version 3 of the GNU
General Public License.
"The Library" refers to a covered work governed by this License,
other than an Application or a Combined Work as defined below.
An "Application" is any work that makes use of an interface provided
by the Library, but which is not otherwise based on the Library.
Defining a subclass of a class defined by the Library is deemed a mode
of using an interface provided by the Library.
A "Combined Work" is a work produced by combining or linking an
Application with the Library. The particular version of the Library
with which the Combined Work was made is also called the "Linked
Version".
The "Minimal Corresponding Source" for a Combined Work means the
Corresponding Source for the Combined Work, excluding any source code
for portions of the Combined Work that, considered in isolation, are
based on the Application, and not on the Linked Version.
The "Corresponding Application Code" for a Combined Work means the
object code and/or source code for the Application, including any data
and utility programs needed for reproducing the Combined Work from the
Application, but excluding the System Libraries of the Combined Work.
1. Exception to Section 3 of the GNU GPL.
You may convey a covered work under sections 3 and 4 of this License
without being bound by section 3 of the GNU GPL.
2. Conveying Modified Versions.
If you modify a copy of the Library, and, in your modifications, a
facility refers to a function or data to be supplied by an Application
that uses the facility (other than as an argument passed when the
facility is invoked), then you may convey a copy of the modified
version:
a) under this License, provided that you make a good faith effort to
ensure that, in the event an Application does not supply the
function or data, the facility still operates, and performs
whatever part of its purpose remains meaningful, or
b) under the GNU GPL, with none of the additional permissions of
this License applicable to that copy.
3. Object Code Incorporating Material from Library Header Files.
The object code form of an Application may incorporate material from
a header file that is part of the Library. You may convey such object
code under terms of your choice, provided that, if the incorporated
material is not limited to numerical parameters, data structure
layouts and accessors, or small macros, inline functions and templates
(ten or fewer lines in length), you do both of the following:
a) Give prominent notice with each copy of the object code that the
Library is used in it and that the Library and its use are
covered by this License.
b) Accompany the object code with a copy of the GNU GPL and this license
document.
4. Combined Works.
You may convey a Combined Work under terms of your choice that,
taken together, effectively do not restrict modification of the
portions of the Library contained in the Combined Work and reverse
engineering for debugging such modifications, if you also do each of
the following:
a) Give prominent notice with each copy of the Combined Work that
the Library is used in it and that the Library and its use are
covered by this License.
b) Accompany the Combined Work with a copy of the GNU GPL and this license
document.
c) For a Combined Work that displays copyright notices during
execution, include the copyright notice for the Library among
these notices, as well as a reference directing the user to the
copies of the GNU GPL and this license document.
d) Do one of the following:
0) Convey the Minimal Corresponding Source under the terms of this
License, and the Corresponding Application Code in a form
suitable for, and under terms that permit, the user to
recombine or relink the Application with a modified version of
the Linked Version to produce a modified Combined Work, in the
manner specified by section 6 of the GNU GPL for conveying
Corresponding Source.
1) Use a suitable shared library mechanism for linking with the
Library. A suitable mechanism is one that (a) uses at run time
a copy of the Library already present on the user's computer
system, and (b) will operate properly with a modified version
of the Library that is interface-compatible with the Linked
Version.
e) Provide Installation Information, but only if you would otherwise
be required to provide such information under section 6 of the
GNU GPL, and only to the extent that such information is
necessary to install and execute a modified version of the
Combined Work produced by recombining or relinking the
Application with a modified version of the Linked Version. (If
you use option 4d0, the Installation Information must accompany
the Minimal Corresponding Source and Corresponding Application
Code. If you use option 4d1, you must provide the Installation
Information in the manner specified by section 6 of the GNU GPL
for conveying Corresponding Source.)
5. Combined Libraries.
You may place library facilities that are a work based on the
Library side by side in a single library together with other library
facilities that are not Applications and are not covered by this
License, and convey such a combined library under terms of your
choice, if you do both of the following:
a) Accompany the combined library with a copy of the same work based
on the Library, uncombined with any other library facilities,
conveyed under the terms of this License.
b) Give prominent notice with the combined library that part of it
is a work based on the Library, and explaining where to find the
accompanying uncombined form of the same work.
6. Revised Versions of the GNU Lesser General Public License.
The Free Software Foundation may publish revised and/or new versions
of the GNU Lesser General Public License from time to time. Such new
versions will be similar in spirit to the present version, but may
differ in detail to address new problems or concerns.
Each version is given a distinguishing version number. If the
Library as you received it specifies that a certain numbered version
of the GNU Lesser General Public License "or any later version"
applies to it, you have the option of following the terms and
conditions either of that published version or of any later version
published by the Free Software Foundation. If the Library as you
received it does not specify a version number of the GNU Lesser
General Public License, you may choose any version of the GNU Lesser
General Public License ever published by the Free Software Foundation.
If the Library as you received it specifies that a proxy can decide
whether future versions of the GNU Lesser General Public License shall
apply, that proxy's public statement of acceptance of any version is
permanent authorization for you to choose that version for the
Library.
+674
View File
@@ -0,0 +1,674 @@
GNU GENERAL PUBLIC LICENSE
Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The GNU General Public License is a free, copyleft license for
software and other kinds of works.
The licenses for most software and other practical works are designed
to take away your freedom to share and change the works. By contrast,
the GNU General Public License is intended to guarantee your freedom to
share and change all versions of a program--to make sure it remains free
software for all its users. We, the Free Software Foundation, use the
GNU General Public License for most of our software; it applies also to
any other work released this way by its authors. You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
them if you wish), that you receive source code or can get it if you
want it, that you can change the software or use pieces of it in new
free programs, and that you know you can do these things.
To protect your rights, we need to prevent others from denying you
these rights or asking you to surrender the rights. Therefore, you have
certain responsibilities if you distribute copies of the software, or if
you modify it: responsibilities to respect the freedom of others.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must pass on to the recipients the same
freedoms that you received. You must make sure that they, too, receive
or can get the source code. And you must show them these terms so they
know their rights.
Developers that use the GNU GPL protect your rights with two steps:
(1) assert copyright on the software, and (2) offer you this License
giving you legal permission to copy, distribute and/or modify it.
For the developers' and authors' protection, the GPL clearly explains
that there is no warranty for this free software. For both users' and
authors' sake, the GPL requires that modified versions be marked as
changed, so that their problems will not be attributed erroneously to
authors of previous versions.
Some devices are designed to deny users access to install or run
modified versions of the software inside them, although the manufacturer
can do so. This is fundamentally incompatible with the aim of
protecting users' freedom to change the software. The systematic
pattern of such abuse occurs in the area of products for individuals to
use, which is precisely where it is most unacceptable. Therefore, we
have designed this version of the GPL to prohibit the practice for those
products. If such problems arise substantially in other domains, we
stand ready to extend this provision to those domains in future versions
of the GPL, as needed to protect the freedom of users.
Finally, every program is threatened constantly by software patents.
States should not allow patents to restrict development and use of
software on general-purpose computers, but in those that do, we wish to
avoid the special danger that patents applied to a free program could
make it effectively proprietary. To prevent this, the GPL assures that
patents cannot be used to render the program non-free.
The precise terms and conditions for copying, distribution and
modification follow.
TERMS AND CONDITIONS
0. Definitions.
"This License" refers to version 3 of the GNU General Public License.
"Copyright" also means copyright-like laws that apply to other kinds of
works, such as semiconductor masks.
"The Program" refers to any copyrightable work licensed under this
License. Each licensee is addressed as "you". "Licensees" and
"recipients" may be individuals or organizations.
To "modify" a work means to copy from or adapt all or part of the work
in a fashion requiring copyright permission, other than the making of an
exact copy. The resulting work is called a "modified version" of the
earlier work or a work "based on" the earlier work.
A "covered work" means either the unmodified Program or a work based
on the Program.
To "propagate" a work means to do anything with it that, without
permission, would make you directly or secondarily liable for
infringement under applicable copyright law, except executing it on a
computer or modifying a private copy. Propagation includes copying,
distribution (with or without modification), making available to the
public, and in some countries other activities as well.
To "convey" a work means any kind of propagation that enables other
parties to make or receive copies. Mere interaction with a user through
a computer network, with no transfer of a copy, is not conveying.
An interactive user interface displays "Appropriate Legal Notices"
to the extent that it includes a convenient and prominently visible
feature that (1) displays an appropriate copyright notice, and (2)
tells the user that there is no warranty for the work (except to the
extent that warranties are provided), that licensees may convey the
work under this License, and how to view a copy of this License. If
the interface presents a list of user commands or options, such as a
menu, a prominent item in the list meets this criterion.
1. Source Code.
The "source code" for a work means the preferred form of the work
for making modifications to it. "Object code" means any non-source
form of a work.
A "Standard Interface" means an interface that either is an official
standard defined by a recognized standards body, or, in the case of
interfaces specified for a particular programming language, one that
is widely used among developers working in that language.
The "System Libraries" of an executable work include anything, other
than the work as a whole, that (a) is included in the normal form of
packaging a Major Component, but which is not part of that Major
Component, and (b) serves only to enable use of the work with that
Major Component, or to implement a Standard Interface for which an
implementation is available to the public in source code form. A
"Major Component", in this context, means a major essential component
(kernel, window system, and so on) of the specific operating system
(if any) on which the executable work runs, or a compiler used to
produce the work, or an object code interpreter used to run it.
The "Corresponding Source" for a work in object code form means all
the source code needed to generate, install, and (for an executable
work) run the object code and to modify the work, including scripts to
control those activities. However, it does not include the work's
System Libraries, or general-purpose tools or generally available free
programs which are used unmodified in performing those activities but
which are not part of the work. For example, Corresponding Source
includes interface definition files associated with source files for
the work, and the source code for shared libraries and dynamically
linked subprograms that the work is specifically designed to require,
such as by intimate data communication or control flow between those
subprograms and other parts of the work.
The Corresponding Source need not include anything that users
can regenerate automatically from other parts of the Corresponding
Source.
The Corresponding Source for a work in source code form is that
same work.
2. Basic Permissions.
All rights granted under this License are granted for the term of
copyright on the Program, and are irrevocable provided the stated
conditions are met. This License explicitly affirms your unlimited
permission to run the unmodified Program. The output from running a
covered work is covered by this License only if the output, given its
content, constitutes a covered work. This License acknowledges your
rights of fair use or other equivalent, as provided by copyright law.
You may make, run and propagate covered works that you do not
convey, without conditions so long as your license otherwise remains
in force. You may convey covered works to others for the sole purpose
of having them make modifications exclusively for you, or provide you
with facilities for running those works, provided that you comply with
the terms of this License in conveying all material for which you do
not control copyright. Those thus making or running the covered works
for you must do so exclusively on your behalf, under your direction
and control, on terms that prohibit them from making any copies of
your copyrighted material outside their relationship with you.
Conveying under any other circumstances is permitted solely under
the conditions stated below. Sublicensing is not allowed; section 10
makes it unnecessary.
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
No covered work shall be deemed part of an effective technological
measure under any applicable law fulfilling obligations under article
11 of the WIPO copyright treaty adopted on 20 December 1996, or
similar laws prohibiting or restricting circumvention of such
measures.
When you convey a covered work, you waive any legal power to forbid
circumvention of technological measures to the extent such circumvention
is effected by exercising rights under this License with respect to
the covered work, and you disclaim any intention to limit operation or
modification of the work as a means of enforcing, against the work's
users, your or third parties' legal rights to forbid circumvention of
technological measures.
4. Conveying Verbatim Copies.
You may convey verbatim copies of the Program's source code as you
receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice;
keep intact all notices stating that this License and any
non-permissive terms added in accord with section 7 apply to the code;
keep intact all notices of the absence of any warranty; and give all
recipients a copy of this License along with the Program.
You may charge any price or no price for each copy that you convey,
and you may offer support or warranty protection for a fee.
5. Conveying Modified Source Versions.
You may convey a work based on the Program, or the modifications to
produce it from the Program, in the form of source code under the
terms of section 4, provided that you also meet all of these conditions:
a) The work must carry prominent notices stating that you modified
it, and giving a relevant date.
b) The work must carry prominent notices stating that it is
released under this License and any conditions added under section
7. This requirement modifies the requirement in section 4 to
"keep intact all notices".
c) You must license the entire work, as a whole, under this
License to anyone who comes into possession of a copy. This
License will therefore apply, along with any applicable section 7
additional terms, to the whole of the work, and all its parts,
regardless of how they are packaged. This License gives no
permission to license the work in any other way, but it does not
invalidate such permission if you have separately received it.
d) If the work has interactive user interfaces, each must display
Appropriate Legal Notices; however, if the Program has interactive
interfaces that do not display Appropriate Legal Notices, your
work need not make them do so.
A compilation of a covered work with other separate and independent
works, which are not by their nature extensions of the covered work,
and which are not combined with it such as to form a larger program,
in or on a volume of a storage or distribution medium, is called an
"aggregate" if the compilation and its resulting copyright are not
used to limit the access or legal rights of the compilation's users
beyond what the individual works permit. Inclusion of a covered work
in an aggregate does not cause this License to apply to the other
parts of the aggregate.
6. Conveying Non-Source Forms.
You may convey a covered work in object code form under the terms
of sections 4 and 5, provided that you also convey the
machine-readable Corresponding Source under the terms of this License,
in one of these ways:
a) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by the
Corresponding Source fixed on a durable physical medium
customarily used for software interchange.
b) Convey the object code in, or embodied in, a physical product
(including a physical distribution medium), accompanied by a
written offer, valid for at least three years and valid for as
long as you offer spare parts or customer support for that product
model, to give anyone who possesses the object code either (1) a
copy of the Corresponding Source for all the software in the
product that is covered by this License, on a durable physical
medium customarily used for software interchange, for a price no
more than your reasonable cost of physically performing this
conveying of source, or (2) access to copy the
Corresponding Source from a network server at no charge.
c) Convey individual copies of the object code with a copy of the
written offer to provide the Corresponding Source. This
alternative is allowed only occasionally and noncommercially, and
only if you received the object code with such an offer, in accord
with subsection 6b.
d) Convey the object code by offering access from a designated
place (gratis or for a charge), and offer equivalent access to the
Corresponding Source in the same way through the same place at no
further charge. You need not require recipients to copy the
Corresponding Source along with the object code. If the place to
copy the object code is a network server, the Corresponding Source
may be on a different server (operated by you or a third party)
that supports equivalent copying facilities, provided you maintain
clear directions next to the object code saying where to find the
Corresponding Source. Regardless of what server hosts the
Corresponding Source, you remain obligated to ensure that it is
available for as long as needed to satisfy these requirements.
e) Convey the object code using peer-to-peer transmission, provided
you inform other peers where the object code and Corresponding
Source of the work are being offered to the general public at no
charge under subsection 6d.
A separable portion of the object code, whose source code is excluded
from the Corresponding Source as a System Library, need not be
included in conveying the object code work.
A "User Product" is either (1) a "consumer product", which means any
tangible personal property which is normally used for personal, family,
or household purposes, or (2) anything designed or sold for incorporation
into a dwelling. In determining whether a product is a consumer product,
doubtful cases shall be resolved in favor of coverage. For a particular
product received by a particular user, "normally used" refers to a
typical or common use of that class of product, regardless of the status
of the particular user or of the way in which the particular user
actually uses, or expects or is expected to use, the product. A product
is a consumer product regardless of whether the product has substantial
commercial, industrial or non-consumer uses, unless such uses represent
the only significant mode of use of the product.
"Installation Information" for a User Product means any methods,
procedures, authorization keys, or other information required to install
and execute modified versions of a covered work in that User Product from
a modified version of its Corresponding Source. The information must
suffice to ensure that the continued functioning of the modified object
code is in no case prevented or interfered with solely because
modification has been made.
If you convey an object code work under this section in, or with, or
specifically for use in, a User Product, and the conveying occurs as
part of a transaction in which the right of possession and use of the
User Product is transferred to the recipient in perpetuity or for a
fixed term (regardless of how the transaction is characterized), the
Corresponding Source conveyed under this section must be accompanied
by the Installation Information. But this requirement does not apply
if neither you nor any third party retains the ability to install
modified object code on the User Product (for example, the work has
been installed in ROM).
The requirement to provide Installation Information does not include a
requirement to continue to provide support service, warranty, or updates
for a work that has been modified or installed by the recipient, or for
the User Product in which it has been modified or installed. Access to a
network may be denied when the modification itself materially and
adversely affects the operation of the network or violates the rules and
protocols for communication across the network.
Corresponding Source conveyed, and Installation Information provided,
in accord with this section must be in a format that is publicly
documented (and with an implementation available to the public in
source code form), and must require no special password or key for
unpacking, reading or copying.
7. Additional Terms.
"Additional permissions" are terms that supplement the terms of this
License by making exceptions from one or more of its conditions.
Additional permissions that are applicable to the entire Program shall
be treated as though they were included in this License, to the extent
that they are valid under applicable law. If additional permissions
apply only to part of the Program, that part may be used separately
under those permissions, but the entire Program remains governed by
this License without regard to the additional permissions.
When you convey a copy of a covered work, you may at your option
remove any additional permissions from that copy, or from any part of
it. (Additional permissions may be written to require their own
removal in certain cases when you modify the work.) You may place
additional permissions on material, added by you to a covered work,
for which you have or can give appropriate copyright permission.
Notwithstanding any other provision of this License, for material you
add to a covered work, you may (if authorized by the copyright holders of
that material) supplement the terms of this License with terms:
a) Disclaiming warranty or limiting liability differently from the
terms of sections 15 and 16 of this License; or
b) Requiring preservation of specified reasonable legal notices or
author attributions in that material or in the Appropriate Legal
Notices displayed by works containing it; or
c) Prohibiting misrepresentation of the origin of that material, or
requiring that modified versions of such material be marked in
reasonable ways as different from the original version; or
d) Limiting the use for publicity purposes of names of licensors or
authors of the material; or
e) Declining to grant rights under trademark law for use of some
trade names, trademarks, or service marks; or
f) Requiring indemnification of licensors and authors of that
material by anyone who conveys the material (or modified versions of
it) with contractual assumptions of liability to the recipient, for
any liability that these contractual assumptions directly impose on
those licensors and authors.
All other non-permissive additional terms are considered "further
restrictions" within the meaning of section 10. If the Program as you
received it, or any part of it, contains a notice stating that it is
governed by this License along with a term that is a further
restriction, you may remove that term. If a license document contains
a further restriction but permits relicensing or conveying under this
License, you may add to a covered work material governed by the terms
of that license document, provided that the further restriction does
not survive such relicensing or conveying.
If you add terms to a covered work in accord with this section, you
must place, in the relevant source files, a statement of the
additional terms that apply to those files, or a notice indicating
where to find the applicable terms.
Additional terms, permissive or non-permissive, may be stated in the
form of a separately written license, or stated as exceptions;
the above requirements apply either way.
8. Termination.
You may not propagate or modify a covered work except as expressly
provided under this License. Any attempt otherwise to propagate or
modify it is void, and will automatically terminate your rights under
this License (including any patent licenses granted under the third
paragraph of section 11).
However, if you cease all violation of this License, then your
license from a particular copyright holder is reinstated (a)
provisionally, unless and until the copyright holder explicitly and
finally terminates your license, and (b) permanently, if the copyright
holder fails to notify you of the violation by some reasonable means
prior to 60 days after the cessation.
Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from that
copyright holder, and you cure the violation prior to 30 days after
your receipt of the notice.
Termination of your rights under this section does not terminate the
licenses of parties who have received copies or rights from you under
this License. If your rights have been terminated and not permanently
reinstated, you do not qualify to receive new licenses for the same
material under section 10.
9. Acceptance Not Required for Having Copies.
You are not required to accept this License in order to receive or
run a copy of the Program. Ancillary propagation of a covered work
occurring solely as a consequence of using peer-to-peer transmission
to receive a copy likewise does not require acceptance. However,
nothing other than this License grants you permission to propagate or
modify any covered work. These actions infringe copyright if you do
not accept this License. Therefore, by modifying or propagating a
covered work, you indicate your acceptance of this License to do so.
10. Automatic Licensing of Downstream Recipients.
Each time you convey a covered work, the recipient automatically
receives a license from the original licensors, to run, modify and
propagate that work, subject to this License. You are not responsible
for enforcing compliance by third parties with this License.
An "entity transaction" is a transaction transferring control of an
organization, or substantially all assets of one, or subdividing an
organization, or merging organizations. If propagation of a covered
work results from an entity transaction, each party to that
transaction who receives a copy of the work also receives whatever
licenses to the work the party's predecessor in interest had or could
give under the previous paragraph, plus a right to possession of the
Corresponding Source of the work from the predecessor in interest, if
the predecessor has it or can get it with reasonable efforts.
You may not impose any further restrictions on the exercise of the
rights granted or affirmed under this License. For example, you may
not impose a license fee, royalty, or other charge for exercise of
rights granted under this License, and you may not initiate litigation
(including a cross-claim or counterclaim in a lawsuit) alleging that
any patent claim is infringed by making, using, selling, offering for
sale, or importing the Program or any portion of it.
11. Patents.
A "contributor" is a copyright holder who authorizes use under this
License of the Program or a work on which the Program is based. The
work thus licensed is called the contributor's "contributor version".
A contributor's "essential patent claims" are all patent claims
owned or controlled by the contributor, whether already acquired or
hereafter acquired, that would be infringed by some manner, permitted
by this License, of making, using, or selling its contributor version,
but do not include claims that would be infringed only as a
consequence of further modification of the contributor version. For
purposes of this definition, "control" includes the right to grant
patent sublicenses in a manner consistent with the requirements of
this License.
Each contributor grants you a non-exclusive, worldwide, royalty-free
patent license under the contributor's essential patent claims, to
make, use, sell, offer for sale, import and otherwise run, modify and
propagate the contents of its contributor version.
In the following three paragraphs, a "patent license" is any express
agreement or commitment, however denominated, not to enforce a patent
(such as an express permission to practice a patent or covenant not to
sue for patent infringement). To "grant" such a patent license to a
party means to make such an agreement or commitment not to enforce a
patent against the party.
If you convey a covered work, knowingly relying on a patent license,
and the Corresponding Source of the work is not available for anyone
to copy, free of charge and under the terms of this License, through a
publicly available network server or other readily accessible means,
then you must either (1) cause the Corresponding Source to be so
available, or (2) arrange to deprive yourself of the benefit of the
patent license for this particular work, or (3) arrange, in a manner
consistent with the requirements of this License, to extend the patent
license to downstream recipients. "Knowingly relying" means you have
actual knowledge that, but for the patent license, your conveying the
covered work in a country, or your recipient's use of the covered work
in a country, would infringe one or more identifiable patents in that
country that you have reason to believe are valid.
If, pursuant to or in connection with a single transaction or
arrangement, you convey, or propagate by procuring conveyance of, a
covered work, and grant a patent license to some of the parties
receiving the covered work authorizing them to use, propagate, modify
or convey a specific copy of the covered work, then the patent license
you grant is automatically extended to all recipients of the covered
work and works based on it.
A patent license is "discriminatory" if it does not include within
the scope of its coverage, prohibits the exercise of, or is
conditioned on the non-exercise of one or more of the rights that are
specifically granted under this License. You may not convey a covered
work if you are a party to an arrangement with a third party that is
in the business of distributing software, under which you make payment
to the third party based on the extent of your activity of conveying
the work, and under which the third party grants, to any of the
parties who would receive the covered work from you, a discriminatory
patent license (a) in connection with copies of the covered work
conveyed by you (or copies made from those copies), or (b) primarily
for and in connection with specific products or compilations that
contain the covered work, unless you entered into that arrangement,
or that patent license was granted, prior to 28 March 2007.
Nothing in this License shall be construed as excluding or limiting
any implied license or other defenses to infringement that may
otherwise be available to you under applicable patent law.
12. No Surrender of Others' Freedom.
If conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot convey a
covered work so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you may
not convey it at all. For example, if you agree to terms that obligate you
to collect a royalty for further conveying from those to whom you convey
the Program, the only way you could satisfy both those terms and this
License would be to refrain entirely from conveying the Program.
13. Use with the GNU Affero General Public License.
Notwithstanding any other provision of this License, you have
permission to link or combine any covered work with a work licensed
under version 3 of the GNU Affero General Public License into a single
combined work, and to convey the resulting work. The terms of this
License will continue to apply to the part which is the covered work,
but the special requirements of the GNU Affero General Public License,
section 13, concerning interaction through a network will apply to the
combination as such.
14. Revised Versions of this License.
The Free Software Foundation may publish revised and/or new versions of
the GNU General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the
Program specifies that a certain numbered version of the GNU General
Public License "or any later version" applies to it, you have the
option of following the terms and conditions either of that numbered
version or of any later version published by the Free Software
Foundation. If the Program does not specify a version number of the
GNU General Public License, you may choose any version ever published
by the Free Software Foundation.
If the Program specifies that a proxy can decide which future
versions of the GNU General Public License can be used, that proxy's
public statement of acceptance of a version permanently authorizes you
to choose that version for the Program.
Later license versions may give you additional or different
permissions. However, no additional obligations are imposed on any
author or copyright holder as a result of your choosing to follow a
later version.
15. Disclaimer of Warranty.
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
16. Limitation of Liability.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
17. Interpretation of Sections 15 and 16.
If the disclaimer of warranty and limitation of liability provided
above cannot be given local legal effect according to their terms,
reviewing courts shall apply local law that most closely approximates
an absolute waiver of all civil liability in connection with the
Program, unless a warranty or assumption of liability accompanies a
copy of the Program in return for a fee.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
state the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
Also add information on how to contact you by electronic and paper mail.
If the program does terminal interaction, make it output a short
notice like this when it starts in an interactive mode:
<program> Copyright (C) <year> <name of author>
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, your program's commands
might be different; for a GUI interface, you would use an "about box".
You should also get your employer (if you work as a programmer) or school,
if any, to sign a "copyright disclaimer" for the program, if necessary.
For more information on this, and how to apply and follow the GNU GPL, see
<https://www.gnu.org/licenses/>.
The GNU General Public License does not permit incorporating your program
into proprietary programs. If your program is a subroutine library, you
may consider it more useful to permit linking proprietary applications with
the library. If this is what you want to do, use the GNU Lesser General
Public License instead of this License. But first, please read
<https://www.gnu.org/licenses/why-not-lgpl.html>.
+407 -94
View File
@@ -1,138 +1,451 @@
# Fenrir
A modern, modular, flexible and fast console screenreader.
It should run on any operating system. 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.
Fenrir is a console screen reader for Linux, written in Go. It reads the Linux
text console and can also run inside an X11 terminal without root privileges.
**Current maintainer:** Storm Dragon
**Original creator:** Chrys (see [CREDITS](CREDITS))
## OS Requirements
See the [user manual](docs/user.md) for detailed usage documentation.
- Linux (ptyDriver, vcsaDriver, evdevDriver)
- macOS (ptyDriver)
- BSD (ptyDriver)
- Windows (ptyDriver)
## Features
- Screen review by line, word, and character, including spelling and phonetic reading.
- Cursor, table, and highlight tracking.
- Desktop and laptop keyboard layouts, with an interactive tutorial.
- A keyboard-operated settings menu and quick settings shortcuts.
- Temporary built-in application overrides for Ninjam, NetworkManager's nmtui,
classic Rogue, and Codex CLI (with an optional event bridge).
- Speech Dispatcher and hardware speech synthesizer support.
- Sound icons, progress tones, and indentation and text attribute feedback.
- Multiple clipboards, optional persistent history, and X clipboard synchronization.
- Spell checking, spelling suggestions, and an emoji picker.
- Script shortcuts and Unix socket remote control.
- Translated announcements and help.
## Core Requirements
## Build and run
- python3 >= 3.3
- screen, input, speech, sound drivers dependencies see "Features, Drivers, Extras".
Build requirements:
- Linux. The build script obtains the Go version required by [go.mod](go.mod)
if a suitable version is not installed.
- A C compiler and `pkg-config`.
- Development headers and libraries for libevdev, X11, libvterm, and ALSA.
Their pkg-config names are `libevdev`, `x11`, `vterm`, and `alsa`.
## Features, Drivers, Extras, Dependencies
Runtime requirements depend on the features you use:
### Input Drivers:
1. "evdevDriver" input driver for linux evdev
- python-evdev >=0.6.3 (This is commonly referred to as python3-evdev by your distribution)
- python-pyudev
- loaded uinput kernel module
- ReadWrite permission
- /dev/input
- /dev/uinput
2. "ptyDriver" terminal emulation input driver
- python-pyte
- Speech Dispatcher with a configured synthesizer for the default speech driver.
- PulseAudio or PipeWire's PulseAudio service for the default sound driver;
ALSA output is also available.
- Enchant 2 and a dictionary for your language for spell checking.
- `xclip` for X clipboard synchronization.
- libusb 1.0 for native DECtalk USB speech, or access to the configured serial
device for a serial synthesizer.
From the checkout root:
### Screen Drivers:
```bash
./build-fenrir.sh
./fenrir --config config/settings/settings.toml --check-config
```
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
2. "ptyDriver" terminal emulation driver
- python-pyte
The script uses Go's automatic toolchain selection with an installed Go 1.21 or
newer. With older Go or no Go installed, it downloads the required official Go
archive using `curl` and `tar` and caches it under
`${XDG_CACHE_HOME:-$HOME/.cache}/fenrir/toolchains/`. Downloads require internet
access. It does not replace the system Go or install native dependencies.
By default, the resulting binary is `fenrir` in the checkout root, even when the
script is invoked from another directory. Use `--output PATH` (or `-o PATH`)
to select a different filename; relative paths are resolved from the caller's
working directory and missing parent directories are created. To build manually
with a suitable Go installation, use `go build -o fenrir ./cmd/fenrir`.
### Speech Drivers:
Keep the binary beside the `config/` directory when running from the checkout;
keyboard layouts, punctuation profiles, and sound themes are runtime resources.
1. "genericDriver" (default) speech driver for sound as subprocess:
- espeak or espeak-ng
2. "speechdDriver" speech driver for Speech-dispatcher:
- Speech-dispatcher
- python-speechd
3. "emacspeakDriver" speech driver for emacspeak
- emacspeak
### Building for packages
The script can help build on distributions with older system Go versions,
including Debian and Slint, provided the required Go toolchain supports the
system and compatible native development libraries are available. Build in the
target distribution's environment so the binary links against its libraries;
a binary built on a newer distribution may require newer libraries at runtime.
Compatibility with a particular distribution release still needs testing.
### Sound Drivers:
Choose an output file and pass Go build flags after `--`:
1. "genericDriver" (default) sound driver for sound as subprocess:
- Sox
2. "gstreamerDriver" sound driver for gstreamer
- gstreamer >=1.0
- GLib
```bash
./build-fenrir.sh --output build/fenrir -- -trimpath -mod=readonly
```
The script builds from its own checkout. It inherits `GOFLAGS`, `GOCACHE`,
`GOMODCACHE`, `GOTMPDIR`, and CGO compiler/linker settings. Output selection
controls the final binary; use those Go variables to relocate caches and
temporary compilation files. `GOTMPDIR` must already exist.
## Extras:
For example, an Arch recipe can build under `$srcdir` and stage the binary
under `$pkgdir` in its separate packaging step:
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).
```bash
# In build(), from the extracted source checkout:
GOMODCACHE="$srcdir/go-mod" GOCACHE="$srcdir/go-build" \
./build-fenrir.sh --output "$srcdir/build/fenrir" -- \
-trimpath -mod=readonly -modcacherw -buildmode=pie
# In package():
install -Dm755 "$srcdir/build/fenrir" "$pkgdir/usr/bin/fenrir"
```
## installation
For a Slint `SLKBUILD` using `$SRC` and `$PKG`, the corresponding binary steps
inside `build()` are:
If there is a package for your distrobution of choice, please let us know so we can add it here.
```bash
cd "$SRC/fenrir" || return 1
./build-fenrir.sh --output "$SRC/build/fenrir" -- -trimpath -mod=readonly
install -Dm755 "$SRC/build/fenrir" "$PKG/usr/bin/fenrir"
```
- Archlinux: PKGBUILD in AUR
- fenrir: stable release
- fenrir-git: Bleeding edge release
- Manual:
- install "espeak" and "sox" with your package manager
- sudo pip install -r requirements.txt
- run install.sh or uninstall.sh as root
- You can also just run it from Git without installing:
Requires root privileges
`-modcacherw` keeps the module cache writable for packaging cleanup. Other
packaging systems can use their own build and staging directories in the same
way. The recipe must also install the TOML configuration, keyboard layouts,
punctuation profiles, sounds, scripts, and appropriate service integration.
The build helper does not install or stage those resources.
cd src/fenrir/
sudo ./fenrir
The helper enables automatic Go toolchain downloads. Package builds that forbid
network access should provision a suitable Go toolchain and dependencies in
advance and invoke `GOTOOLCHAIN=local go build` directly with the recipe's flags
and output path. This also avoids the helper's bootstrap download path.
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: genericDriver (via espeak or espeak-ng, could configured in settings.conf)
- input driver: evdevDriver
### Linux console
From a Linux text console:
## Configure pulseaudio
```bash
sudo ./fenrir
```
Pulseaudio by default only plays sound for the user its currently running for. As fenrir is running as root, your local user does not hear the sound and speech produced by fenrir.
for this fenrir provides a script to configure pulseaudio to stream the sound played as root to your local user. This is not a issue of fenrir but this is how pulseaudio works.
Console mode starts in the background by default. Use `sudo ./fenrir -f` to
keep it in the foreground, including when running under a service manager.
The launcher waits for startup and reports initialization errors. Use
`--debug-file PATH` to keep diagnostics after it detaches.
just run the configuration script twice (once as user, once as root):
Console mode needs access to the console devices, keyboard event devices, and
`/dev/uinput`. Run only one reader on the same console. Fenrir releases keyboard
input on graphical virtual terminals and on text consoles listed in
`screen.ignored_vts`.
/usr/share/fenrirscreenreader/tools/configure_pulse.sh
sudo /usr/share/fenrirscreenreader/tools/configure_pulse.sh
When running as root, audio must be configured to reach the intended sound
server or ALSA device. The [PulseAudio](tools/configure_pulse.sh) and
[PipeWire](tools/configure_pipewire.sh) configuration scripts are included for
systems that need root audio access.
The script is also located in the tools directory in git
The default sound driver tries the user session first, then `/tmp/pulse.sock`
created by the PipeWire configuration script, then the system-wide
PulseAudio-compatible socket at `/run/pulse/native`. Set `PULSE_SERVER` to select
a different socket or server explicitly. The sound driver does not read
PulseAudio's `client.conf`.
Speech output uses Speech Dispatcher's own audio configuration.
Fenrir retries temporary speech initialization failures for up to 20 seconds
before acquiring keyboards. A lost Speech Dispatcher connection gets a separate
20-second recovery window in the speech worker; input remains responsive and
speech accumulated during the outage is discarded. If recovery fails, Fenrir
exits and releases its keyboards before waiting for other services to shut down.
Sound effects reconnect independently, without stopping working speech. Sound
startup calls have a three-second limit; an unresponsive attempt is abandoned
without starting overlapping attempts.
## Configure pipewire
These mechanisms do not require a particular init system. Boot services running
as root keep root-owned Speech Dispatcher startup. With `sudo fenrir`, a missing
local Speech Dispatcher can instead be started as the invoking user, identified
by `SUDO_UID`; only the daemon child drops privileges. Audio servers still need
appropriate startup configuration and device/socket permissions. See
[audio recovery and verification](docs/audio-recovery.md) for limitations and
test procedures.
Pipewire by default only plays sound for the user its currently running for. As fenrir is running as root, your local user does not hear the sound and speech produced by fenrir.
for this fenrir provides a script to configure pipewire to stream the sound played as root to your local user. This is not a issue of fenrir but this is how pipewire works.
### X11 terminal
just run the configuration script twice (once as user, once as root):
From an X11 terminal that supplies `WINDOWID`:
/usr/share/fenrirscreenreader/tools/configure_pipewire.sh
sudo /usr/share/fenrirscreenreader/tools/configure_pipewire.sh
```bash
./fenrir -x
```
The script is also located in the tools directory in git
This starts a shell in a new PTY inside the terminal. Fenrir's key bindings are
scoped to that terminal window, allowing a desktop screen reader to handle
other windows. Multiple terminal instances can run at once. Both `DISPLAY` and
a valid `WINDOWID` must be available.
## localization
copy fenrir.mo translations file from fenrir/locale/your_language/LC_MESSAGES/fenrir.mo to /usr/share/locale/your_language/LC_MESSAGES/fenrir.mo
Use `--keyboard-layout laptop` with either mode to select the laptop layout.
## Documentation and Support
## Basic controls
- Email list: [stormux+subscribe@groups.io](mailto:stormux+subscribe@groups.io?subject=subscribe) with the subject subscribe.
The Fenrir key is Insert, Super/Windows, or keypad 0 with NumLock off in the
desktop layout. The laptop layout uses Caps Lock instead of Super/Windows;
Insert and NumLock-off keypad 0 also work. Press Shift+Caps Lock on its own
to toggle capitalization in the laptop layout.
Hold it while pressing the other keys in a shortcut. Bare keypad review keys
also require NumLock off.
| Action | Desktop | Laptop |
| --- | --- | --- |
| Previous / current / next line | Keypad 7 / 8 / 9 | Fenrir+U / I / O |
| Previous / current / next word | Keypad 4 / 5 / 6 | Fenrir+J / K / L |
| Previous / current / next character | Keypad 1 / 2 / 3 | Fenrir+M / Comma / Period |
| Read screen | Fenrir+Keypad 5 | Fenrir+Shift+K |
| Follow application cursor | Fenrir+Keypad Period | Fenrir+Slash |
| Cycle tracking mode | Fenrir+Keypad Asterisk | Fenrir+Y |
| Toggle progress tones | Keypad Plus | Fenrir+Shift+P |
Shortcuts shared by both layouts:
- **Control**: interrupt speech.
- **Fenrir+F**: open the Fenrir Menu.
- **Fenrir+H** or **Fenrir+F1**: enter the tutorial. Press command shortcuts to
hear their descriptions, or browse with the arrow keys. Escape exits.
- **Fenrir+S**: open the spellcheck menu.
- **Fenrir+A**: select an application override; choose **Default** to clear it.
- **Fenrir+Control+E**: open the emoji picker.
- **Fenrir+T**: announce the time; press twice quickly for the date.
- **Fenrir+N**: repeat the most recent notification.
- **Fenrir+Control+N**: browse notification history, newest first, with received times.
- **Fenrir+F4**: toggle mute.
- **Fenrir+Backspace**: pass the next key through to the application.
- **Fenrir+Q**: quit Fenrir.
Press the current-line or current-word shortcut twice quickly to spell it, or
three times for phonetic reading. Press the current-character shortcut twice
for its phonetic name. The complete bindings are in
[desktop.toml](config/keyboard/desktop.toml) and
[laptop.toml](config/keyboard/laptop.toml).
Tracking cycles through **cursor**, **table**, and **highlight**. Cursor mode
follows application cursor movement. Table mode supports cell navigation in
delimited or aligned text. Highlight mode follows changes to highlighted text.
Screen review lets you explore text without moving the application cursor.
## Settings
Press **Fenrir+F** to open the Fenrir Menu. Use arrows to choose a settings tab,
then Tab or Shift+Tab to move between controls and back to the tab selector.
Space toggles checkboxes; arrows change selections and numeric values. Activate
**OK** to save, or **Cancel** or Escape to discard the form's changes.
The menu includes speech, sound, reading, keyboard, clipboard, and other
settings. Speech rate, pitch, and volume use a scale from -100 to 100.
For speech rate, Up and Down change the value by 10; Left and Right change it by 1.
The keyboard layout combo box offers Desktop and Laptop. The Keyboard tab also
has separate Fenrir-key and script-key checkboxes for keypad Insert, Insert,
Caps Lock, and Super, plus Compose for scripts. Uncheck a key in one group
before selecting it in the other. At least one Fenrir key must remain selected.
After **OK** saves the changes, modifier assignments apply when the menu closes
and all held keys are released. If X11 cannot acquire a new key, Fenrir reports
the failure and keeps the previous assignments active. The saved choices remain
available for retrying or editing in the menu.
Backend, device, keyboard layout, sound theme, and other launch-only changes
take effect the next time Fenrir starts.
Quick settings are available without opening the menu:
- **Fenrir+Space**: announce the current setting.
- **Fenrir+Left / Right**: select a setting.
- **Fenrir+Control+Left / Right**: select a category.
- **Fenrir+Up / Down**: change the value.
- **Fenrir+Control+S**: save settings.
Quick settings take effect during the session; save them to keep them for the
next launch.
Application overrides are selected manually and never selected automatically
at startup. While an application override is active, the settings menu and
save shortcut save its preferences to `applications/<name>.toml` inside the
ordinary settings save directory. For example, Ninjam uses
`applications/ninjam.toml`. Only customized values are stored; other values
inherit ordinary settings. Returning to a shell prompt or selecting Default
restores your ordinary settings, including previous unsaved adjustments.
See [application overrides](docs/user.md#application-overrides) for details and
Ninjam's temporary region shortcuts. In the laptop layout, reading the current
attributes now uses **Fenrir+Shift+A**.
### Configuration files
Fenrir uses TOML. The annotated [settings.toml](config/settings/settings.toml)
describes the available settings, including options edited only in the file.
Default settings locations:
- Regular user: `~/.local/share/stormux/fenrirscreenreader/settings/settings.toml`,
then `/etc/fenrirscreenreader/settings/settings.toml`.
- Root: `/etc/fenrirscreenreader/settings/settings.toml`.
Fenrir loads the first existing file, or built-in defaults if neither exists.
Python `settings.conf` files are ignored. Regular users save to their personal
TOML file even when startup loaded system defaults; root saves to the system
file. `--config PATH` explicitly selects both the load and save path.
To create a personal settings file without opening devices:
```bash
./fenrir --write-config ~/.local/share/stormux/fenrirscreenreader/settings/settings.toml
```
Validate an edited file with:
```bash
./fenrir --config ~/.local/share/stormux/fenrirscreenreader/settings/settings.toml --check-config
```
Keyboard layouts are separate TOML files. Named layouts are searched in the
user's `keyboard/` directory beside `settings/`, then
`/etc/fenrirscreenreader/keyboard/`, then the checkout's bundled layouts.
Root uses the system and bundled locations. `--keyboard-layout PATH.toml`
selects a file directly. Layout files can set `fenrir_keys` before their bindings;
the available names are `INSERT`, `SUPER`, `CAPSLOCK`, and `KP0`. The bundled
laptop layout uses `["CAPSLOCK", "INSERT", "KP0"]`. An explicit
`keyboard.fenrir_keys` setting overrides those defaults; its names use the
`KEY_` form shown in [settings.toml](config/settings/settings.toml). Existing
script-key assignments are excluded from implicit Fenrir-key defaults.
Speech drivers are `speech-dispatcher`, `dectalk`, `dectalk-usb`, `litetalk`,
`doubletalk`, and `tripletalk`. Serial drivers need a device path. The Speech
settings tab includes a **Test synthesizer** button for hardware drivers.
Speech Dispatcher connections support `SPEECHD_ADDRESS` (Unix socket or TCP),
`SPEECHD_SOCKET`, runtime/cache-directory defaults, and bounded daemon autostart.
See [speech synthesizers](docs/user.md#speech-synthesizers) for precedence and
sudo behavior.
Clipboard persistence is optional and off by default. It stores unencrypted
history separately for console and terminal sessions. X clipboard sync is
controlled by `clipboard.sync`.
## Remote control
Fenrir accepts remote commands through Unix sockets. The standard socket is
`/tmp/fenrirscreenreader-daemon.sock`; instances also have private sockets named
`/tmp/fenrirscreenreader-<pid>.sock`. Discover instances with:
```bash
echo "ls" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-daemon.sock
```
The standard socket routes reader descendants to their ancestor reader. For
GNU Screen sessions, it follows the server's current display terminals and
their reader ancestry, so reattachment does not depend on Screen's inherited
`WINDOWID`. Detached sessions and sessions attached to multiple readers return
a routing error. For other detached helpers, it matches the caller's `WINDOWID`
and `DISPLAY` to a unique terminal reader owned by the same user.
Requests from a Linux virtual console reach the console reader, subject to
its usual authorization. Missing or ambiguous identity produces a routing
error; a sole unrelated reader is never selected as a default. Instance
listing remains available even when routing is ambiguous.
Send commands to a private socket when targeting a particular reader. Examples
using the standard socket:
```bash
echo "command say Hello" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-daemon.sock
echo "command notify Hello world" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-daemon.sock
echo "command interrupt" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-daemon.sock
echo "command application ninjam" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-daemon.sock
echo "command application default" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-daemon.sock
echo "setting set reading#mode=highlight" | socat - UNIX-CLIENT:/tmp/fenrirscreenreader-daemon.sock
```
Set `remote.enabled = false` to disable remote control. Command and settings
requests can also be enabled separately in the `[remote]` section.
`command notify TEXT` plays `notification.wav` when sounds are enabled, waits
for the sound to finish, then speaks the notification. It retains the message
for **Fenrir+N** and **Fenrir+Control+N**. History holds the latest 100 notifications for this reader
session, including messages received while speech is muted or temporarily
silenced. `command say TEXT` remains self-voicing and does not add history.
Received times use the current time format in Presentation's Time and date
settings. In the history list, use Up/Down to browse, Enter to repeat an entry,
and Escape or the Close button to return to the application. Reopen the list
to include messages received while it was open.
Detached notifiers must identify the intended reader, using its private socket
when needed. Check socket replies for routing errors. GNU Screen callers use
their current attachment; other long-running notifiers must keep their terminal
identity current. Both `say` and `notify` use these routing rules.
`command application ID` selects an override for the reader's active terminal,
like Fenrir+A. IDs are `default`, `networkmanager`, `ninjam`, `rogue`, and `codex`.
In Fenrir+A, select an application and Tab to **Copy alias to clipboard** to
copy a Bash alias that selects its override before launching the program.
The program still launches if Fenrir or `socat` is unavailable.
## Command-line help
Run `./fenrir --help` for all options. Useful options include `--config`,
`--keyboard-layout`, `--punctuation-profile`, `--speech-driver`, `--speech-rate`,
`--speech-module`, `--input-device`, and `--debug-file`. `--version` prints the
version and release channel. Console mode runs in the background unless `-f`
is given; `-x` always runs in the foreground.
## Localization
Fenrir selects its interface language from `LANGUAGE`, `LC_ALL`, `LC_MESSAGES`,
or `LANG`. The speech language setting controls synthesis separately.
Translations are bundled from [internal/i18n/locale](internal/i18n/locale);
missing translations fall back to English.
The translation tool extracts Go messages and validates catalogs. With GNU
gettext installed, run this read-only check from the checkout root:
```bash
go run ./tools/translations check
```
## Development
Run the Go tests from the checkout root:
```bash
go test ./...
```
Device-free checks do not establish audible speech or real keyboard behavior.
Test changes affecting input, speech, or menus in the affected console or X11
workflow as well.
## AI-assisted contributions
AI-assisted contributions are welcome. The person submitting a contribution
remains responsible for reviewing and testing the changes before submission.
Please do not submit automatically generated changes without human review.
Before making changes:
- Read the contributing guide, if present, and this README.
- Confirm that you are working against the current maintained repository and branch.
- Check whether the issue still exists in the current code.
Before submitting:
- Review the generated diff.
- Test the changed behavior.
- Run the project's existing test suite where practical.
- Consider code paths affected indirectly and test those as well.
- Clearly describe what was changed and how it was tested.
AI coding assistants must call the contributor's attention to these requirements
and provide concrete testing steps for the intended change and plausible
regressions. Newly created tests alone are not sufficient. Leave submission to
the contributor after they have reviewed and tested the result.
For email patches, assistants should offer guidance with configuring
`git send-email`, creating a scoped commit or patch series, running
`git format-patch`, reviewing the generated patch, sending a test message when
appropriate, and sending the final patches to the contribution address.
## Support and license
- [Project repository and issue tracker](https://git.stormux.org/storm/fenrir)
- [Fenrir Wiki](https://git.stormux.org/storm/fenrir/wiki)
- IRC: irc.stormux.org #stormux
- Email list: [stormux+subscribe@groups.io](mailto:stormux+subscribe@groups.io?subject=subscribe)
with the subject `subscribe`.
- IRC: `irc.stormux.org`, channel `#stormux`.
The Go code is licensed under the GNU GPL, version 3 or later. See [LICENSE](LICENSE).
-3
View File
@@ -1,3 +0,0 @@
V2.0
Cleanup folders and config files.
-3
View File
@@ -1,3 +0,0 @@
#!/bin/sh
[ -r ./conf ] && . ./conf
exec fenrir -f
-15
View File
@@ -1,15 +0,0 @@
[Unit]
Description=Fenrir screenreader
Wants=systemd-udev-settle.service
After=systemd-udev-settle.service getty.target
[Service]
Type=forking
PIDFile=/var/run/fenrir.pid
ExecStart=/usr/bin/fenrir
ExecReload=/usr/bin/kill -HUP $MAINPID
Restart=always
#Group=fenrirscreenreader
#User=fenrirscreenreader
[Install]
WantedBy=getty.target
-18
View File
@@ -1,18 +0,0 @@
[Unit]
Description=Fenrir screenreader
Wants=systemd-udev-settle.service
After=systemd-udev-settle.service sound.target
[Service]
Type=forking
PIDFile=/var/run/fenrir.pid
ExecStart=/usr/local/bin/fenrir
ExecReload=/usr/bin/kill -HUP $MAINPID
Restart=always
#Group=fenrirscreenreader
#User=fenrirscreenreader
[Install]
# start as early as possible in boot process
#WantedBy=sound.target
# start as soon the login prompt is available
WantedBy=getty.target
-15
View File
@@ -1,15 +0,0 @@
Please report Bugs and feature requests to:
https://github.com/chrys87/fenrir/issues
For bugs, please provide a debug file that shows the issue.
How to create a debug file:
1. first delete old stuff:
sudo rm /var/log/fenrir.log
2. start fenrir in debug mode
sudo fenrir -d
<do your stuff>
3.
stop fenrir (fenrirKey + q)
the debug file is in /var/log/fenrir.log
please be as precise as possible to make it easy to solve the problem.
+122
View File
@@ -0,0 +1,122 @@
#!/usr/bin/env bash
# Build Fenrir with a suitable Go toolchain without changing the system Go.
set -euo pipefail
projectDir=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
fail() {
echo "Error: $*" >&2
exit 1
}
usage() {
cat <<'EOF'
Usage: build-fenrir.sh [-o PATH | --output PATH] [-- GO_BUILD_FLAGS...]
Build Fenrir, downloading a suitable Go toolchain when needed.
-o, --output PATH Write the binary to PATH (default: checkout/fenrir).
Relative paths are resolved from the caller's directory.
Missing parent directories are created.
-h, --help Show this help without checking build dependencies.
-- Pass remaining flags to go build, e.g. -- -trimpath.
Go environment variables such as GOFLAGS, GOCACHE, GOMODCACHE, GOTMPDIR,
and CGO_CFLAGS/CGO_LDFLAGS are inherited. This script only builds the binary;
package installation and resource staging belong in the packaging recipe.
EOF
}
outputPath="$projectDir/fenrir"
buildFlags=()
while (( $# )); do
case $1 in
-o|--output)
(( $# >= 2 )) || fail "$1 requires a path."
[[ -n $2 && $2 != -* ]] || fail "$1 requires a path (use ./ for a path starting with '-')."
outputPath=$2
shift 2
;;
-h|--help)
usage
exit 0
;;
--)
shift
buildFlags=("$@")
break
;;
*) fail "Unknown argument: $1. See --help." ;;
esac
done
if [[ $outputPath != /* ]]; then
outputPath="$PWD/$outputPath"
fi
[[ ! -d $outputPath ]] || fail "Output path is a directory; specify the binary filename."
cd -- "$projectDir"
[[ $(uname -s) == Linux ]] || fail "Fenrir requires Linux."
command -v pkg-config >/dev/null || fail "Install pkg-config and the native development libraries listed in README.md."
missingLibraries=()
for library in libevdev x11 vterm alsa; do
if ! pkg-config --exists "$library"; then
missingLibraries+=("$library")
fi
done
if (( ${#missingLibraries[@]} )); then
fail "Missing development libraries (pkg-config names): ${missingLibraries[*]}. See README.md."
fi
requiredVersion=$(awk '$1 == "go" { print $2; exit }' go.mod)
[[ $requiredVersion =~ ^1\.[0-9]+\.[0-9]+$ ]] || fail "Cannot read the required Go version from go.mod."
# Go 1.21+ downloads and verifies the toolchain selected by go.mod itself.
# Probe the bundled version so a user's GOTOOLCHAIN setting cannot affect this check.
unset GOROOT
goCommand=""
if command -v go >/dev/null; then
installedVersion=$(GOTOOLCHAIN=local go version 2>/dev/null || true)
if [[ $installedVersion =~ go1\.([0-9]+) ]] && (( 10#${BASH_REMATCH[1]} >= 21 )); then
goCommand=$(command -v go)
fi
fi
if [[ -z $goCommand ]]; then
case $(uname -m) in
x86_64) archiveArch=amd64 ;;
aarch64|arm64) archiveArch=arm64 ;;
armv6l|armv7l) archiveArch=armv6l ;;
i386|i486|i586|i686) archiveArch=386 ;;
ppc64le|riscv64|s390x|loong64) archiveArch=$(uname -m) ;;
loongarch64) archiveArch=loong64 ;;
*) fail "No Go bootstrap archive configured for $(uname -m). Install Go 1.21 or newer and rerun this script." ;;
esac
toolchainDir="${XDG_CACHE_HOME:-$HOME/.cache}/fenrir/toolchains/go${requiredVersion}.linux-${archiveArch}"
goCommand="$toolchainDir/go/bin/go"
if [[ ! -x $goCommand ]]; then
command -v curl >/dev/null || fail "Install curl to download Go, or install Go 1.21 or newer."
command -v tar >/dev/null || fail "Install tar to unpack Go."
mkdir -p -- "$(dirname -- "$toolchainDir")"
downloadDir=$(mktemp -d "${toolchainDir}.download.XXXXXX")
trap 'rm -rf -- "$downloadDir"' EXIT
echo "Downloading Go $requiredVersion for Linux/$archiveArch from go.dev..."
curl --fail --location --show-error --proto '=https' --proto-redir '=https' \
--output "$downloadDir/go.tar.gz" \
"https://go.dev/dl/go${requiredVersion}.linux-${archiveArch}.tar.gz"
tar -xzf "$downloadDir/go.tar.gz" -C "$downloadDir"
[[ -x $downloadDir/go/bin/go ]] || fail "The downloaded archive does not contain Go."
# Another build may have finished the same download while ours ran.
if [[ ! -x $goCommand ]]; then
mkdir -p -- "$toolchainDir"
mv -T -- "$downloadDir/go" "$toolchainDir/go" || [[ -x $goCommand ]]
fi
fi
fi
# Apply automatic selection only to this build, including when the caller has
# disabled it globally.
export GOTOOLCHAIN=auto
echo "Using $("$goCommand" version)"
mkdir -p -- "$(dirname -- "$outputPath")"
"$goCommand" build "${buildFlags[@]}" -o "$outputPath" ./cmd/fenrir
echo "Fenrir has been built: $outputPath"
-134
View File
@@ -1,134 +0,0 @@
#!/usr/bin/env python3
import os
import sys
from dataclasses import dataclass
from typing import List, Optional
@dataclass
class Dependency:
name: str
depType: str # screen, input, sound, speech, core
moduleName: str
checkCommands: Optional[List[str]] = None # Command-line tools to check
pythonImports: Optional[List[str]] = None # Python packages to check
devicePaths: Optional[List[str]] = None # Device files to check
def check_dependency(dep: Dependency) -> bool:
"""Check if a single dependency is satisfied."""
isAvailable = True
if dep.pythonImports:
for package in dep.pythonImports:
try:
moduleName = package.split('.')[0]
__import__(moduleName)
print(f'{package}: OK')
except ImportError:
print(f'{package}: FAIL')
isAvailable = False
if dep.checkCommands:
for cmd in dep.checkCommands:
if os.path.exists(f'/usr/bin/{cmd}') or os.path.exists(f'/bin/{cmd}'):
print(f'{cmd}: OK')
else:
print(f'{cmd}: FAIL')
isAvailable = False
if dep.devicePaths:
for path in dep.devicePaths:
if os.path.exists(path):
print(f'{path}: OK')
else:
print(f'{path}: FAIL')
isAvailable = False
return isAvailable
# Define all dependencies
dependencyList = [
# Core dependencies
Dependency('FenrirCore', 'core', 'core',
pythonImports=['daemonize', 'enchant']),
# Screen drivers
Dependency('DummyScreen', 'screen', 'dummyDriver'),
Dependency('VCSA', 'screen', 'vcsaDriver',
pythonImports=['dbus'],
devicePaths=['/dev/vcsa']),
Dependency('PTY', 'screen', 'ptyDriver',
pythonImports=['pyte']),
# Input drivers
Dependency('DummyInput', 'input', 'dummyDriver'),
Dependency('DebugInput', 'input', 'debugDriver'),
Dependency('Evdev', 'input', 'evdevDriver',
pythonImports=['evdev', 'evdev.InputDevice', 'evdev.UInput', 'pyudev']),
Dependency('PTYInput', 'input', 'ptyDriver',
pythonImports=['pyte']),
# Sound drivers
Dependency('DummySound', 'sound', 'dummyDriver'),
Dependency('DebugSound', 'sound', 'debugDriver'),
Dependency('GenericSound', 'sound', 'genericDriver',
checkCommands=['play', 'sox']),
Dependency('GStreamer', 'sound', 'gstreamerDriver',
pythonImports=['gi', 'gi.repository.GLib', 'gi.repository.Gst']),
# Speech drivers
Dependency('DummySpeech', 'speech', 'dummyDriver'),
Dependency('DebugSpeech', 'speech', 'debugDriver'),
Dependency('Speechd', 'speech', 'speechdDriver',
pythonImports=['speechd']),
Dependency('GenericSpeech', 'speech', 'genericDriver',
checkCommands=['espeak-ng'])
]
defaultModules = {
'FenrirCore',
'VCSA',
'Evdev',
'GenericSpeech',
'GenericSound'
}
def check_all_dependencies():
print('Checking dependencies...\n')
availableModules = []
# Group dependencies by type for organized output
for depType in ['core', 'screen', 'input', 'sound', 'speech']:
print(f'{depType.upper()} DRIVERS')
print('-' * 20)
depsOfType = [d for d in dependencyList if d.depType == depType]
for dep in depsOfType:
print(f'\nChecking {dep.name}:')
if check_dependency(dep):
availableModules.append(dep.name)
print('')
print_summary(availableModules)
def print_summary(availableModules: List[str]):
print('=' * 20)
print('SUMMARY')
print('=' * 20)
missingModules = defaultModules - set(availableModules)
if missingModules:
print('Default Setup: FAIL')
print('\nUnavailable Default Modules:')
for module in missingModules:
print(f'- {module}')
print('\nYou may need to install the missing dependencies for the modules above or reconfigure fenrir to not use them.')
else:
print('Default Setup: OK')
print('\nAvailable Modules:')
for module in availableModules:
print(f'- {module}')
if __name__ == '__main__':
check_all_dependencies()
+98
View File
@@ -0,0 +1,98 @@
// Fenrir console screen reader.
// Copyright (c) 2026 Storm Dragon
// SPDX-License-Identifier: GPL-3.0-or-later
//
// This program is free software: you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation, either version 3 of the License, or (at your option)
// any later version.
//
// This program is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
// more details.
//
// You should have received a copy of the GNU General Public License along with
// this program. If not, see <https://www.gnu.org/licenses/gpl-3.0.html>.
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"os"
"os/exec"
"syscall"
)
const daemonStatusEnv = "FENRIR_DAEMON_STATUS_FD"
type daemonStatus struct {
Code int
Error string
}
// Re-exec rather than forking a running Go runtime. Keep the working directory
// and environment so relative configuration paths and audio access still work.
func start_daemon(args []string, stderr io.Writer) int {
executable, err := os.Executable()
if err != nil {
fmt.Fprintln(stderr, "fenrir: daemon executable:", err)
return 1
}
child := exec.Command(executable, append(append([]string{}, args...), "-f")...)
return launch_daemon(child, stderr)
}
func launch_daemon(child *exec.Cmd, stderr io.Writer) int {
reader, writer, err := os.Pipe()
if err != nil {
fmt.Fprintln(stderr, "fenrir: daemon startup pipe:", err)
return 1
}
defer reader.Close()
defer writer.Close()
child.Env = append(os.Environ(), daemonStatusEnv+"=3")
child.ExtraFiles = []*os.File{writer}
child.SysProcAttr = &syscall.SysProcAttr{Setsid: true}
// Nil standard streams connect to /dev/null, releasing the launching TTY.
if err := child.Start(); err != nil {
fmt.Fprintln(stderr, "fenrir: start daemon:", err)
return 1
}
writer.Close()
var status daemonStatus
if err := json.NewDecoder(reader).Decode(&status); err != nil {
// A child that cannot report readiness must not keep input grabbed.
child.Process.Kill()
child.Wait()
fmt.Fprintln(stderr, "fenrir: daemon startup:", err)
return 1
}
if status.Code != 0 {
child.Wait()
fmt.Fprint(stderr, status.Error)
return status.Code
}
child.Process.Release()
return 0
}
func run_daemon_child(args []string, stdout io.Writer, statusFile *os.File) int {
defer statusFile.Close()
var diagnostics bytes.Buffer
reported := false
code := run_with_ready(args, stdout, &diagnostics, func() error {
if err := json.NewEncoder(statusFile).Encode(daemonStatus{}); err != nil {
return fmt.Errorf("report daemon readiness: %w", err)
}
reported = true
return statusFile.Close()
})
if !reported {
json.NewEncoder(statusFile).Encode(daemonStatus{Code: code, Error: diagnostics.String()})
}
return code
}
+148
View File
@@ -0,0 +1,148 @@
// Fenrir console screen reader.
// Copyright (c) 2026 Storm Dragon
// SPDX-License-Identifier: GPL-3.0-or-later
//
// This program is free software: you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation, either version 3 of the License, or (at your option)
// any later version.
//
// This program is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
// more details.
//
// You should have received a copy of the GNU General Public License along with
// this program. If not, see <https://www.gnu.org/licenses/gpl-3.0.html>.
package main
import (
"bytes"
"encoding/json"
"fmt"
"os"
"os/exec"
"path/filepath"
"strings"
"syscall"
"testing"
"time"
)
// Runs only in private subprocesses: no console, speech or keyboard devices.
func TestDaemonProcess(t *testing.T) {
if os.Getenv(daemonStatusEnv) != "3" {
return
}
os.Unsetenv(daemonStatusEnv)
statusFile := os.NewFile(3, "daemon startup")
mode := os.Args[len(os.Args)-2]
recordPath := os.Args[len(os.Args)-1]
switch mode {
case "failure":
os.Exit(run_daemon_child([]string{"--unknown"}, os.Stdout, statusFile))
case "crash":
os.Exit(17)
case "ready":
ctx, stop := termination_context()
defer stop()
sessionID, _, err := syscall.Syscall(syscall.SYS_GETSID, 0, 0, 0)
if err != 0 || int(sessionID) != os.Getpid() || syscall.Getpgrp() != os.Getpid() {
os.Exit(18)
}
if tty, err := os.Open("/dev/tty"); err == nil {
tty.Close()
os.Exit(19)
}
for _, fd := range []string{"0", "1", "2"} {
target, err := os.Readlink("/proc/self/fd/" + fd)
if err != nil || target != os.DevNull {
os.Exit(20)
}
}
cwd, _ := os.Getwd()
record := fmt.Sprintf("%d\n%s\n%s", os.Getpid(), cwd, os.Getenv("FENRIR_DAEMON_TEST_VALUE"))
if err := os.WriteFile(recordPath, []byte(record), 0600); err != nil {
os.Exit(21)
}
json.NewEncoder(statusFile).Encode(daemonStatus{})
statusFile.Close()
select {
case <-ctx.Done():
case <-time.After(10 * time.Second):
}
os.Exit(0)
}
os.Exit(22)
}
func TestDaemonDetachesAndReportsReadiness(t *testing.T) {
root := t.TempDir()
t.Setenv("FENRIR_DAEMON_TEST_VALUE", "preserved")
recordPath := filepath.Join(root, "child")
child := exec.Command(os.Args[0], "-test.run=^TestDaemonProcess$", "--", "ready", recordPath)
child.Dir = root
var stderr bytes.Buffer
if status := launch_daemon(child, &stderr); status != 0 {
t.Fatal(status, stderr.String())
}
record, err := os.ReadFile(recordPath)
if err != nil {
t.Fatal(err)
}
// Release invalidates child.Process.Pid. Read the child's own recorded PID
// and reject process-group/broadcast values before any signal or wait.
var pid int
if _, err := fmt.Sscanf(string(record), "%d", &pid); err != nil || pid <= 1 {
t.Fatal("invalid private child PID", pid, err)
}
privateChild, err := os.FindProcess(pid)
if err != nil {
t.Fatal(err)
}
defer privateChild.Release()
reaped := false
defer func() {
if !reaped {
privateChild.Kill()
syscall.Wait4(pid, nil, 0, nil)
}
}()
if string(record) != fmt.Sprintf("%d\n%s\npreserved", pid, root) {
t.Fatal("detached child lost working directory or environment", string(record))
}
if err := privateChild.Signal(syscall.Signal(0)); err != nil {
t.Fatal("launcher did not return while child was running", err)
}
// The existing termination handler must still shut down a detached reader.
if err := privateChild.Signal(syscall.SIGTERM); err != nil {
t.Fatal(err)
}
var status syscall.WaitStatus
waited, err := syscall.Wait4(pid, &status, 0, nil)
reaped = waited == pid
if err != nil || !status.Exited() || status.ExitStatus() != 0 {
t.Fatal("detached child did not handle SIGTERM", status, err)
}
}
func TestDaemonStartupFailuresReturnToLauncher(t *testing.T) {
for _, mode := range []string{"failure", "crash", "missing-executable"} {
t.Run(mode, func(t *testing.T) {
child := exec.Command(os.Args[0], "-test.run=^TestDaemonProcess$", "--", mode, "unused")
wantCode, wantText := 1, "daemon startup:"
if mode == "failure" {
wantCode, wantText = 2, "flag provided but not defined"
}
if mode == "missing-executable" {
child = exec.Command(filepath.Join(t.TempDir(), "missing"))
wantText = "start daemon:"
}
var stderr bytes.Buffer
if code := launch_daemon(child, &stderr); code != wantCode || !strings.Contains(stderr.String(), wantText) {
t.Fatal(code, stderr.String())
}
})
}
}
+274
View File
@@ -0,0 +1,274 @@
// Fenrir console screen reader.
// Copyright (c) 2026 Storm Dragon
// SPDX-License-Identifier: GPL-3.0-or-later
//
// This program is free software: you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation, either version 3 of the License, or (at your option)
// any later version.
//
// This program is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
// more details.
//
// You should have received a copy of the GNU General Public License along with
// this program. If not, see <https://www.gnu.org/licenses/gpl-3.0.html>.
package main
import (
"context"
"flag"
"fmt"
"io"
"log/slog"
"os"
"os/signal"
"os/user"
"path/filepath"
"strconv"
"syscall"
"time"
"git.stormux.org/storm/fenrir/internal/app"
"git.stormux.org/storm/fenrir/internal/config"
"git.stormux.org/storm/fenrir/internal/i18n"
"git.stormux.org/storm/fenrir/internal/input"
"git.stormux.org/storm/fenrir/internal/punctuation"
"git.stormux.org/storm/fenrir/internal/version"
)
func main() {
i18n.Use(i18n.New(i18n.LocaleDir, i18n.Language()))
if os.Getenv(daemonStatusEnv) == "3" {
// Do not pass the private startup channel to scripts or synthesizers.
os.Unsetenv(daemonStatusEnv)
syscall.CloseOnExec(3)
statusFile := os.NewFile(3, "daemon startup")
os.Exit(run_daemon_child(os.Args[1:], os.Stdout, statusFile))
}
os.Exit(run(os.Args[1:], os.Stdout, os.Stderr))
}
func run(args []string, stdout, stderr io.Writer) int {
return run_with_ready(args, stdout, stderr, nil)
}
func run_with_ready(args []string, stdout, stderr io.Writer, ready func() error) int {
flags := flag.NewFlagSet("fenrir", flag.ContinueOnError)
flags.SetOutput(stderr)
showVersion := flags.Bool("version", false, "print the version and release channel")
terminalMode := flags.Bool("x", false, "run an unprivileged shell in this X11 terminal")
foreground := flags.Bool("f", false, "stay in the foreground (always enabled with -x)")
configPath := flags.String("config", "", "settings.toml path (default: Fenrir user/system settings directories)")
keyboardLayout := flags.String("keyboard-layout", "", "keyboard layout name or TOML path (overrides keyboard.layout)")
punctuationProfile := flags.String("punctuation-profile", "", "punctuation profile name or TOML path (overrides reading.punctuation_profile)")
checkConfig := flags.Bool("check-config", false, "validate settings and exit without opening devices")
writeConfig := flags.String("write-config", "", "atomically write effective settings to PATH and exit")
driver := flags.String("speech-driver", "speech-dispatcher", "speech driver ID (overrides presentation.speech.driver)")
rate := flags.Int("speech-rate", config.Defaults().Presentation.Speech.Rate, "Speech Dispatcher rate (-100 to 100)")
module := flags.String("speech-module", "", "Speech Dispatcher output module (empty uses server default)")
debugFile := flags.String("debug-file", "", "append timing and reader-decision diagnostics without text or key values")
var devices []string
flags.Func("input-device", "keyboard event path; repeat to select devices (default: discover keyboards)", func(value string) error {
if value == "" {
return fmt.Errorf("input device path cannot be empty")
}
devices = append(devices, value)
return nil
})
flags.Usage = func() {
fmt.Fprintln(flags.Output(), "Usage: fenrir [options]")
fmt.Fprintln(flags.Output(), "\nFenrir is a Linux console screen reader.")
fmt.Fprintln(flags.Output(), "TTY mode requires console, evdev and uinput access. Use -x in an X11 terminal without sudo.")
fmt.Fprintln(flags.Output(), "NumLock off: keypad 7/8/9 lines, 4/5/6 words, 1/2/3 characters.")
fmt.Fprintln(flags.Output(), "Insert or keypad 0 is the Fenrir key. Fenrir+F menu; Fenrir+H help; Fenrir+Q quit.")
fmt.Fprintln(flags.Output(), "\nOptions:")
flags.PrintDefaults()
}
if err := flags.Parse(args); err != nil {
if err == flag.ErrHelp {
return 0
}
return 2
}
if flags.NArg() != 0 {
fmt.Fprintln(stderr, "fenrir: unexpected positional arguments")
return 2
}
if *showVersion {
fmt.Fprintln(stdout, "fenrir", version.Label())
return 0
}
if err := initialize_home(); err != nil {
fmt.Fprintln(stderr, "fenrir: settings:", err)
return 2
}
settings, path, err := load_settings(flags, *configPath, *rate, *module, devices, *keyboardLayout, *driver, *punctuationProfile)
if err != nil {
fmt.Fprintln(stderr, "fenrir: settings:", path, err)
return 2
}
if *writeConfig != "" {
if err := config.Save(*writeConfig, settings); err != nil {
fmt.Fprintln(stderr, "fenrir: save settings:", err)
return 1
}
fmt.Fprintln(stdout, "Settings written to", *writeConfig)
return 0
}
if !*checkConfig && *terminalMode && len(settings.Keyboard.Devices) != 0 {
fmt.Fprintln(stderr, "fenrir: -x does not use keyboard.devices or --input-device")
return 2
}
bindings, bindingPath, err := load_keyboard(settings.Keyboard.Layout)
if err != nil {
fmt.Fprintln(stderr, "fenrir: keyboard layout:", bindingPath, err)
return 2
}
modifierRouter, modifierErr := input.New_router(bindings)
if modifierErr == nil {
modifierErr = modifierRouter.Configure_modifiers(settings.Keyboard.FenrirKeys, settings.General.ScriptKeys)
}
if modifierErr != nil {
fmt.Fprintln(stderr, "fenrir: keyboard modifiers:", modifierErr)
return 2
}
if *checkConfig {
if _, profilePath, err := punctuation.Open(settings.Reading.PunctuationProfile); err != nil {
fmt.Fprintln(stderr, "fenrir: punctuation profile:", profilePath, err)
return 2
}
fmt.Fprintln(stdout, "Settings valid. Keyboard layout:", bindingPath)
return 0
}
logOutput, logLevel := stderr, slog.LevelInfo
if *debugFile != "" {
file, err := os.OpenFile(*debugFile, os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0600)
if err != nil {
fmt.Fprintln(stderr, "fenrir: open debug file:", err)
return 1
}
defer file.Close()
logOutput, logLevel = file, slog.LevelDebug
}
if !*foreground && !*terminalMode && ready == nil {
return start_daemon(args, stderr)
}
if ready != nil && *debugFile == "" {
logOutput = io.Discard
}
previousLogger := slog.Default()
defer slog.SetDefault(previousLogger)
slog.SetDefault(slog.New(slog.NewTextHandler(logOutput, &slog.HandlerOptions{
Level: logLevel,
ReplaceAttr: func(groups []string, attribute slog.Attr) slog.Attr {
// Warnings and timing records put timestamps after the message.
if attribute.Key == slog.TimeKey {
return slog.Attr{}
}
return attribute
},
})))
slog.Info("reader starting", "pid", os.Getpid(), "terminal_mode", *terminalMode, "at", time.Now())
ctx, stop := termination_context()
defer stop()
if *terminalMode {
err = app.Start_terminal(ctx, settings, path, bindings)
} else {
err = app.Start_with_ready(ctx, settings, path, bindings, ready)
}
if err != nil {
if *debugFile != "" {
slog.Error("reader stopped", "pid", os.Getpid(), "error", err, "at", time.Now())
}
fmt.Fprintln(stderr, "fenrir:", err)
return 1
}
slog.Info("reader stopped", "pid", os.Getpid(), "at", time.Now())
return 0
}
func termination_context() (context.Context, func()) {
ctx, cancel := context.WithCancel(context.Background())
signals := make(chan os.Signal, 1)
signal.Notify(signals, os.Interrupt, syscall.SIGTERM, syscall.SIGHUP, syscall.SIGQUIT, syscall.SIGTSTP)
done := make(chan struct{})
go func() {
defer close(done)
select {
case received := <-signals:
slog.Info("reader received signal", "signal", received.String(), "pid", os.Getpid(), "at", time.Now())
cancel()
case <-ctx.Done():
}
}()
return ctx, func() {
signal.Stop(signals)
cancel()
<-done
}
}
func load_keyboard(layout string) (input.Layout, string, error) {
home, err := os.UserHomeDir()
if err != nil {
return input.Layout{}, "", err
}
executable, err := os.Executable()
if err != nil {
return input.Layout{}, "", err
}
bundledDirectory := filepath.Join(filepath.Dir(executable), "config", "keyboard")
paths, err := input.Layout_paths(layout, home, os.Geteuid(), bundledDirectory)
if err != nil {
return input.Layout{}, "", err
}
return input.Load_bindings(paths)
}
func load_settings(flags *flag.FlagSet, requested string, rate int, module string, devices []string, keyboardLayout string, driver string, punctuationProfile string) (config.Settings, string, error) {
home, err := os.UserHomeDir()
if err != nil {
return config.Settings{}, "", err
}
settings, path, err := config.Load_startup(requested, config.Paths(home, os.Geteuid()))
if err != nil {
return config.Settings{}, path, err
}
flags.Visit(func(option *flag.Flag) {
switch option.Name {
case "punctuation-profile":
settings.Reading.PunctuationProfile = punctuationProfile
case "speech-driver":
settings.Presentation.Speech.Driver = driver
case "speech-rate":
settings.Presentation.Speech.Rate = rate
case "speech-module":
settings.Presentation.Speech.Module = module
case "keyboard-layout":
settings.Keyboard.Layout = keyboardLayout
case "input-device":
settings.Keyboard.Devices = devices
}
})
return settings, path, settings.Validate()
}
// Service managers need not export HOME. Resolve it once before configuration
// discovery so all resources and child processes use the effective account's
// home, while preserving explicitly supplied environments (including sudo).
func initialize_home() error {
if os.Getenv("HOME") != "" {
return nil
}
account, err := user.LookupId(strconv.Itoa(os.Geteuid()))
if err != nil {
return fmt.Errorf("look up effective user home: %w", err)
}
if !filepath.IsAbs(account.HomeDir) {
return fmt.Errorf("effective user home is not an absolute path: %q", account.HomeDir)
}
return os.Setenv("HOME", account.HomeDir)
}
+235
View File
@@ -0,0 +1,235 @@
// Fenrir console screen reader.
// Copyright (c) 2026 Storm Dragon
// SPDX-License-Identifier: GPL-3.0-or-later
//
// This program is free software: you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation, either version 3 of the License, or (at your option)
// any later version.
//
// This program is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
// more details.
//
// You should have received a copy of the GNU General Public License along with
// this program. If not, see <https://www.gnu.org/licenses/gpl-3.0.html>.
package main
import (
"bytes"
"flag"
"os"
"os/user"
"path/filepath"
"strconv"
"strings"
"testing"
"git.stormux.org/storm/fenrir/internal/config"
"git.stormux.org/storm/fenrir/internal/version"
)
func TestStartupUsesAccountSaveDestination(t *testing.T) {
home := t.TempDir()
t.Setenv("HOME", home)
flags := flag.NewFlagSet("fenrir", flag.ContinueOnError)
_, path, err := load_settings(flags, "", config.Defaults().Presentation.Speech.Rate, "", nil, "", "speech-dispatcher", "")
if expected := config.Paths(home, os.Geteuid())[0]; err != nil || path != expected {
t.Fatalf("save destination=%q, want %q: %v", path, expected, err)
}
}
func TestCLIWithoutOpeningDevices(t *testing.T) {
for _, testCase := range []struct {
args []string
status int
text string
}{
{[]string{"--help"}, 0, "keypad 7/8/9"},
{[]string{"--help"}, 0, "Speech Dispatcher rate (-100 to 100)"},
{[]string{"-f", "--help"}, 0, "stay in the foreground"},
{[]string{"-f", "--version"}, 0, "fenrir " + version.Label()},
{[]string{"--version"}, 0, "fenrir " + version.Label()},
{[]string{"--unknown"}, 2, "flag provided but not defined"},
{[]string{"--speech-socket=/tmp/unused.sock"}, 2, "flag provided but not defined"},
{[]string{"unexpected"}, 2, "unexpected positional arguments"},
{[]string{"--speech-rate=101"}, 2, "presentation.speech.rate must be"},
{[]string{"-f", "--keyboard-layout", "../../config/keyboard/desktop.toml", "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, 0, "Settings valid"},
{[]string{"-x", "--keyboard-layout", "../../config/keyboard/desktop.toml", "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, 0, "Settings valid"},
{[]string{"-x", "--input-device=/dev/input/event1"}, 2, "-x does not use"},
} {
var stdout, stderr bytes.Buffer
if got := run(testCase.args, &stdout, &stderr); got != testCase.status {
t.Fatalf("%v: exit %d, output %s%s", testCase.args, got, &stdout, &stderr)
}
if !strings.Contains(stdout.String()+stderr.String(), testCase.text) {
t.Fatalf("%v: missing %q", testCase.args, testCase.text)
}
}
}
func TestSettingsCommandsAndExplicitCLIOverrides(t *testing.T) {
root := t.TempDir()
path := filepath.Join(root, "settings.toml")
if err := os.WriteFile(path, []byte("version=1\n[sound]\nenabled=false\n[speech]\nrate=25\nmodule='example'\n[keyboard]\ndevices=['/dev/input/event1']\n"), 0600); err != nil {
t.Fatal(err)
}
var stdout, stderr bytes.Buffer
if status := run([]string{"--config", path, "--keyboard-layout", "../../config/keyboard/desktop.toml", "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, &stdout, &stderr); status != 0 {
t.Fatal(status, stderr.String())
}
output := filepath.Join(root, "saved.toml")
if status := run([]string{"--config", path, "--speech-rate=80", "--speech-module=", "--input-device=/dev/input/event2", "--write-config", output}, &stdout, &stderr); status != 0 {
t.Fatal(status, stderr.String())
}
settings, _, err := config.Load(output, nil)
if err != nil || settings.Presentation.Speech.Rate != 80 || settings.Presentation.Speech.Module != "" || settings.Presentation.Sound.Enabled || len(settings.Keyboard.Devices) != 1 || settings.Keyboard.Devices[0] != "/dev/input/event2" {
t.Fatalf("explicit overrides: %+v %v", settings, err)
}
if status := run([]string{"--config", filepath.Join(root, "missing.toml"), "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, &stdout, &stderr); status != 2 {
t.Fatal("ignored missing explicit config", status)
}
}
func TestDebugFileErrorPrecedesReaderStartup(t *testing.T) {
var stdout, stderr bytes.Buffer
path := filepath.Join(t.TempDir(), "missing", "timing.log")
if status := run([]string{"--keyboard-layout", "../../config/keyboard/desktop.toml", "--debug-file", path}, &stdout, &stderr); status != 1 {
t.Fatal("wrong exit status", status)
}
if !strings.Contains(stderr.String(), "open debug file:") {
t.Fatal("debug-file error was not reported before reader startup", stderr.String())
}
}
func TestKeyboardLayoutSelectionAndValidationBeforeStartup(t *testing.T) {
root := t.TempDir()
settingsPath := filepath.Join(root, "settings.toml")
layoutPath := filepath.Join(root, "custom.toml")
data, err := os.ReadFile("../../config/keyboard/desktop.toml")
if err != nil {
t.Fatal(err)
}
if err := os.WriteFile(layoutPath, data, 0600); err != nil {
t.Fatal(err)
}
settings := config.Defaults()
settings.Keyboard.Layout = layoutPath
if err := config.Save(settingsPath, settings); err != nil {
t.Fatal(err)
}
var stdout, stderr bytes.Buffer
if status := run([]string{"--config", settingsPath, "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, &stdout, &stderr); status != 0 || !strings.Contains(stdout.String(), layoutPath) {
t.Fatal(status, stdout.String(), stderr.String())
}
for _, layout := range []string{"", filepath.Join(root, "missing.toml"), filepath.Join(root, "old.conf")} {
stderr.Reset()
if status := run([]string{"--config", settingsPath, "--keyboard-layout", layout}, &stdout, &stderr); status != 2 {
t.Fatal("layout error reached startup", layout, status, stderr.String())
}
}
if err := os.WriteFile(layoutPath, []byte("version=1\n"), 0600); err != nil {
t.Fatal(err)
}
if status := run([]string{"--config", settingsPath, "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, &stdout, &stderr); status != 2 {
t.Fatal("malformed layout accepted", status)
}
if status := run([]string{"--config", settingsPath, "--keyboard-layout", "../../config/keyboard/laptop.toml", "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, &stdout, &stderr); status != 0 {
t.Fatal("CLI override ignored", status, stderr.String())
}
}
func TestDriverChoiceUsesSameValidationForFileAndCLI(t *testing.T) {
root := t.TempDir()
path := filepath.Join(root, "settings.toml")
if err := config.Save(path, config.Defaults()); err != nil {
t.Fatal(err)
}
var stdout, stderr bytes.Buffer
output := filepath.Join(root, "saved.toml")
if got := run([]string{"--config", path, "--speech-driver=speech-dispatcher", "--write-config", output}, &stdout, &stderr); got != 0 {
t.Fatal(got, stderr.String())
}
loaded, _, err := config.Load(output, nil)
if err != nil || loaded.Presentation.Speech.Driver != "speech-dispatcher" {
t.Fatal(loaded, err)
}
for _, driver := range []string{"invented", "", "speech-dispatcher,other"} {
stderr.Reset()
if got := run([]string{"--config", path, "--speech-driver=" + driver, "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, &stdout, &stderr); got != 2 || !strings.Contains(stderr.String(), "unknown speech driver") {
t.Fatal(got, stderr.String())
}
}
}
func TestStartupWithoutHome(t *testing.T) {
account, err := user.LookupId(strconv.Itoa(os.Geteuid()))
if err != nil {
t.Fatal(err)
}
settingsPath := filepath.Join(t.TempDir(), "settings.toml")
if err := config.Save(settingsPath, config.Defaults()); err != nil {
t.Fatal(err)
}
for _, unset := range []bool{false, true} {
name := "empty"
if unset {
name = "unset"
}
t.Run(name, func(t *testing.T) {
t.Setenv("HOME", "")
if unset {
if err := os.Unsetenv("HOME"); err != nil {
t.Fatal(err)
}
}
var stdout, stderr bytes.Buffer
args := []string{"-f", "--config", settingsPath, "--keyboard-layout", "../../config/keyboard/desktop.toml", "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}
if status := run(args, &stdout, &stderr); status != 0 {
t.Fatalf("exit %d: %s%s", status, &stdout, &stderr)
}
if home := os.Getenv("HOME"); home != account.HomeDir {
t.Fatalf("HOME=%q, want effective account home %q", home, account.HomeDir)
}
// Later startup code and child processes must see the same home.
if cache, err := os.UserCacheDir(); err != nil || !filepath.IsAbs(cache) {
t.Fatalf("cache directory=%q: %v", cache, err)
}
})
}
}
func TestStartupPreservesExplicitHome(t *testing.T) {
home := t.TempDir()
t.Setenv("HOME", home)
output := filepath.Join(t.TempDir(), "settings.toml")
var stdout, stderr bytes.Buffer
if status := run([]string{"--write-config", output}, &stdout, &stderr); status != 0 {
t.Fatalf("exit %d: %s%s", status, &stdout, &stderr)
}
if got := os.Getenv("HOME"); got != home {
t.Fatalf("HOME=%q, want explicit home %q", got, home)
}
}
func TestCheckConfigValidatesEffectiveModifierRoles(t *testing.T) {
path := filepath.Join(t.TempDir(), "settings.toml")
for _, trial := range []struct {
reader string
want int
}{
{"", 0}, {"fenrir_keys=['KEY_INSERT']", 0}, {"fenrir_keys=['KEY_META']", 2},
} {
data := "version=3\n[keyboard]\n" + trial.reader + "\n[general]\nscript_keys=['KEY_RIGHTMETA']\n"
if err := os.WriteFile(path, []byte(data), 0600); err != nil {
t.Fatal(err)
}
var stdout, stderr bytes.Buffer
status := run([]string{"--config", path, "--keyboard-layout", "../../config/keyboard/desktop.toml", "--punctuation-profile", "../../config/punctuation/default.toml", "--check-config"}, &stdout, &stderr)
if status != trial.want {
t.Fatal(trial, status, stdout.String(), stderr.String())
}
}
}
+86 -541
View File
@@ -1,543 +1,88 @@
# Fenrir keyboard layouts
Keymap for Fenrir
KEY_RESERVED
KEY_ESC
KEY_1
KEY_2
KEY_3
KEY_4
KEY_5
KEY_6
KEY_7
KEY_8
KEY_9
KEY_0
KEY_MINUS
KEY_EQUAL
KEY_BACKSPACE
KEY_TAB
KEY_Q
KEY_W
KEY_E
KEY_R
KEY_T
KEY_Y
KEY_U
KEY_I
KEY_O
KEY_P
KEY_LEFTBRACE
KEY_RIGHTBRACE
KEY_ENTER
KEY_LEFTCTRL
KEY_A
KEY_S
KEY_D
KEY_F
KEY_G
KEY_H
KEY_J
KEY_K
KEY_L
KEY_SEMICOLON
KEY_APOSTROPHE
KEY_GRAVE
KEY_LEFTSHIFT
KEY_BACKSLASH
KEY_Z
KEY_X
KEY_C
KEY_V
KEY_B
KEY_N
KEY_M
KEY_COMMA
KEY_DOT
KEY_SLASH
KEY_RIGHTSHIFT
KEY_KPASTERISK
KEY_LEFTALT
KEY_SPACE
KEY_CAPSLOCK
KEY_F1
KEY_F2
KEY_F3
KEY_F4
KEY_F5
KEY_F6
KEY_F7
KEY_F8
KEY_F9
KEY_F10
KEY_NUMLOCK
KEY_SCROLLLOCK
KEY_KP7
KEY_KP8
KEY_KP9
KEY_KPMINUS
KEY_KP4
KEY_KP5
KEY_KP6
KEY_KPPLUS
KEY_KP1
KEY_KP2
KEY_KP3
KEY_KP0
KEY_KPDOT
KEY_ZENKAKUHANKAKU
KEY_102ND
KEY_F11
KEY_F12
KEY_RO
KEY_KATAKANA
KEY_HIRAGANA
KEY_HENKAN
KEY_KATAKANAHIRAGANA
KEY_MUHENKAN
KEY_KPJPCOMMA
KEY_KPENTER
KEY_RIGHTCTRL
KEY_KPSLASH
KEY_SYSRQ
KEY_RIGHTALT
KEY_LINEFEED
KEY_HOME
KEY_UP
KEY_PAGEUP
KEY_LEFT
KEY_RIGHT
KEY_END
KEY_DOWN
KEY_PAGEDOWN
KEY_INSERT
KEY_DELETE
KEY_MACRO
['KEY_MIN_INTERESTING', 'KEY_MUTE']
KEY_VOLUMEDOWN
KEY_VOLUMEUP
KEY_POWER
KEY_KPEQUAL
KEY_KPPLUSMINUS
KEY_PAUSE
KEY_SCALE
KEY_KPCOMMA
['KEY_HANGEUL', 'KEY_HANGUEL']
KEY_HANJA
KEY_YEN
KEY_LEFTMETA
KEY_RIGHTMETA
KEY_COMPOSE
KEY_STOP
KEY_AGAIN
KEY_PROPS
KEY_UNDO
KEY_FRONT
KEY_COPY
KEY_OPEN
KEY_PASTE
KEY_FIND
KEY_CUT
KEY_HELP
KEY_MENU
KEY_CALC
KEY_SETUP
KEY_SLEEP
KEY_WAKEUP
KEY_FILE
KEY_SENDFILE
KEY_DELETEFILE
KEY_XFER
KEY_PROG1
KEY_PROG2
KEY_WWW
KEY_MSDOS
['KEY_COFFEE', 'KEY_SCREENLOCK']
['KEY_DIRECTION', 'KEY_ROTATE_DISPLAY']
KEY_CYCLEWINDOWS
KEY_MAIL
KEY_BOOKMARKS
KEY_COMPUTER
KEY_BACK
KEY_FORWARD
KEY_CLOSECD
KEY_EJECTCD
KEY_EJECTCLOSECD
KEY_NEXTSONG
KEY_PLAYPAUSE
KEY_PREVIOUSSONG
KEY_STOPCD
KEY_RECORD
KEY_REWIND
KEY_PHONE
KEY_ISO
KEY_CONFIG
KEY_HOMEPAGE
KEY_REFRESH
KEY_EXIT
KEY_MOVE
KEY_EDIT
KEY_SCROLLUP
KEY_SCROLLDOWN
KEY_KPLEFTPAREN
KEY_KPRIGHTPAREN
KEY_NEW
KEY_REDO
KEY_F13
KEY_F14
KEY_F15
KEY_F16
KEY_F17
KEY_F18
KEY_F19
KEY_F20
KEY_F21
KEY_F22
KEY_F23
KEY_F24
KEY_PLAYCD
KEY_PAUSECD
KEY_PROG3
KEY_PROG4
KEY_DASHBOARD
KEY_SUSPEND
KEY_CLOSE
KEY_PLAY
KEY_FASTFORWARD
KEY_BASSBOOST
KEY_PRINT
KEY_HP
KEY_CAMERA
KEY_SOUND
KEY_QUESTION
KEY_EMAIL
KEY_CHAT
KEY_SEARCH
KEY_CONNECT
KEY_FINANCE
KEY_SPORT
KEY_SHOP
KEY_ALTERASE
KEY_CANCEL
KEY_BRIGHTNESSDOWN
KEY_BRIGHTNESSUP
KEY_MEDIA
KEY_SWITCHVIDEOMODE
KEY_KBDILLUMTOGGLE
KEY_KBDILLUMDOWN
KEY_KBDILLUMUP
KEY_SEND
KEY_REPLY
KEY_FORWARDMAIL
KEY_SAVE
KEY_DOCUMENTS
KEY_BATTERY
KEY_BLUETOOTH
KEY_WLAN
KEY_UWB
KEY_UNKNOWN
KEY_VIDEO_NEXT
KEY_VIDEO_PREV
KEY_BRIGHTNESS_CYCLE
['KEY_BRIGHTNESS_AUTO', 'KEY_BRIGHTNESS_ZERO']
KEY_DISPLAY_OFF
['KEY_WIMAX', 'KEY_WWAN']
KEY_RFKILL
KEY_MICMUTE
['BTN_0', 'BTN_MISC']
BTN_1
BTN_2
BTN_3
BTN_4
BTN_5
BTN_6
BTN_7
BTN_8
BTN_9
['BTN_LEFT', 'BTN_MOUSE']
BTN_RIGHT
BTN_MIDDLE
BTN_SIDE
BTN_EXTRA
BTN_FORWARD
BTN_BACK
BTN_TASK
['BTN_JOYSTICK', 'BTN_TRIGGER']
BTN_THUMB
BTN_THUMB2
BTN_TOP
BTN_TOP2
BTN_PINKIE
BTN_BASE
BTN_BASE2
BTN_BASE3
BTN_BASE4
BTN_BASE5
BTN_BASE6
BTN_DEAD
['BTN_A', 'BTN_GAMEPAD', 'BTN_SOUTH']
['BTN_B', 'BTN_EAST']
BTN_C
['BTN_NORTH', 'BTN_X']
['BTN_WEST', 'BTN_Y']
BTN_Z
BTN_TL
BTN_TR
BTN_TL2
BTN_TR2
BTN_SELECT
BTN_START
BTN_MODE
BTN_THUMBL
BTN_THUMBR
['BTN_DIGI', 'BTN_TOOL_PEN']
BTN_TOOL_RUBBER
BTN_TOOL_BRUSH
BTN_TOOL_PENCIL
BTN_TOOL_AIRBRUSH
BTN_TOOL_FINGER
BTN_TOOL_MOUSE
BTN_TOOL_LENS
BTN_TOOL_QUINTTAP
BTN_TOUCH
BTN_STYLUS
BTN_STYLUS2
BTN_TOOL_DOUBLETAP
BTN_TOOL_TRIPLETAP
BTN_TOOL_QUADTAP
['BTN_GEAR_DOWN', 'BTN_WHEEL']
BTN_GEAR_UP
KEY_OK
KEY_SELECT
KEY_GOTO
KEY_CLEAR
KEY_POWER2
KEY_OPTION
KEY_INFO
KEY_TIME
KEY_VENDOR
KEY_ARCHIVE
KEY_PROGRAM
KEY_CHANNEL
KEY_FAVORITES
KEY_EPG
KEY_PVR
KEY_MHP
KEY_LANGUAGE
KEY_TITLE
KEY_SUBTITLE
KEY_ANGLE
KEY_ZOOM
KEY_MODE
KEY_KEYBOARD
KEY_SCREEN
KEY_PC
KEY_TV
KEY_TV2
KEY_VCR
KEY_VCR2
KEY_SAT
KEY_SAT2
KEY_CD
KEY_TAPE
KEY_RADIO
KEY_TUNER
KEY_PLAYER
KEY_TEXT
KEY_DVD
KEY_AUX
KEY_MP3
KEY_AUDIO
KEY_VIDEO
KEY_DIRECTORY
KEY_LIST
KEY_MEMO
KEY_CALENDAR
KEY_RED
KEY_GREEN
KEY_YELLOW
KEY_BLUE
KEY_CHANNELUP
KEY_CHANNELDOWN
KEY_FIRST
KEY_LAST
KEY_AB
KEY_NEXT
KEY_RESTART
KEY_SLOW
KEY_SHUFFLE
KEY_BREAK
KEY_PREVIOUS
KEY_DIGITS
KEY_TEEN
KEY_TWEN
KEY_VIDEOPHONE
KEY_GAMES
KEY_ZOOMIN
KEY_ZOOMOUT
KEY_ZOOMRESET
KEY_WORDPROCESSOR
KEY_EDITOR
KEY_SPREADSHEET
KEY_GRAPHICSEDITOR
KEY_PRESENTATION
KEY_DATABASE
KEY_NEWS
KEY_VOICEMAIL
KEY_ADDRESSBOOK
KEY_MESSENGER
['KEY_BRIGHTNESS_TOGGLE', 'KEY_DISPLAYTOGGLE']
KEY_SPELLCHECK
KEY_LOGOFF
KEY_DOLLAR
KEY_EURO
KEY_FRAMEBACK
KEY_FRAMEFORWARD
KEY_CONTEXT_MENU
KEY_MEDIA_REPEAT
KEY_10CHANNELSUP
KEY_10CHANNELSDOWN
KEY_IMAGES
KEY_DEL_EOL
KEY_DEL_EOS
KEY_INS_LINE
KEY_DEL_LINE
KEY_FN
KEY_FN_ESC
KEY_FN_F1
KEY_FN_F2
KEY_FN_F3
KEY_FN_F4
KEY_FN_F5
KEY_FN_F6
KEY_FN_F7
KEY_FN_F8
KEY_FN_F9
KEY_FN_F10
KEY_FN_F11
KEY_FN_F12
KEY_FN_1
KEY_FN_2
KEY_FN_D
KEY_FN_E
KEY_FN_F
KEY_FN_S
KEY_FN_B
KEY_BRL_DOT1
KEY_BRL_DOT2
KEY_BRL_DOT3
KEY_BRL_DOT4
KEY_BRL_DOT5
KEY_BRL_DOT6
KEY_BRL_DOT7
KEY_BRL_DOT8
KEY_BRL_DOT9
KEY_BRL_DOT10
KEY_NUMERIC_0
KEY_NUMERIC_1
KEY_NUMERIC_2
KEY_NUMERIC_3
KEY_NUMERIC_4
KEY_NUMERIC_5
KEY_NUMERIC_6
KEY_NUMERIC_7
KEY_NUMERIC_8
KEY_NUMERIC_9
KEY_NUMERIC_STAR
KEY_NUMERIC_POUND
KEY_NUMERIC_A
KEY_NUMERIC_B
KEY_NUMERIC_C
KEY_NUMERIC_D
KEY_CAMERA_FOCUS
KEY_WPS_BUTTON
KEY_TOUCHPAD_TOGGLE
KEY_TOUCHPAD_ON
KEY_TOUCHPAD_OFF
KEY_CAMERA_ZOOMIN
KEY_CAMERA_ZOOMOUT
KEY_CAMERA_UP
KEY_CAMERA_DOWN
KEY_CAMERA_LEFT
KEY_CAMERA_RIGHT
KEY_ATTENDANT_ON
KEY_ATTENDANT_OFF
KEY_ATTENDANT_TOGGLE
KEY_LIGHTS_TOGGLE
BTN_DPAD_UP
BTN_DPAD_DOWN
BTN_DPAD_LEFT
BTN_DPAD_RIGHT
KEY_ALS_TOGGLE
KEY_BUTTONCONFIG
KEY_TASKMANAGER
KEY_JOURNAL
KEY_CONTROLPANEL
KEY_APPSELECT
KEY_SCREENSAVER
KEY_VOICECOMMAND
KEY_BRIGHTNESS_MIN
KEY_BRIGHTNESS_MAX
KEY_KBDINPUTASSIST_PREV
KEY_KBDINPUTASSIST_NEXT
KEY_KBDINPUTASSIST_PREVGROUP
KEY_KBDINPUTASSIST_NEXTGROUP
KEY_KBDINPUTASSIST_ACCEPT
KEY_KBDINPUTASSIST_CANCEL
KEY_RIGHT_UP
KEY_RIGHT_DOWN
KEY_LEFT_UP
KEY_LEFT_DOWN
KEY_ROOT_MENU
KEY_MEDIA_TOP_MENU
KEY_NUMERIC_11
KEY_NUMERIC_12
KEY_AUDIO_DESC
KEY_3D_MODE
KEY_NEXT_FAVORITE
KEY_STOP_RECORD
KEY_PAUSE_RECORD
KEY_VOD
KEY_UNMUTE
['KEY_DATA', 'KEY_FASTREVERSE']
KEY_SLOWREVERSE
['BTN_TRIGGER_HAPPY', 'BTN_TRIGGER_HAPPY1']
BTN_TRIGGER_HAPPY2
BTN_TRIGGER_HAPPY3
BTN_TRIGGER_HAPPY4
BTN_TRIGGER_HAPPY5
BTN_TRIGGER_HAPPY6
BTN_TRIGGER_HAPPY7
BTN_TRIGGER_HAPPY8
BTN_TRIGGER_HAPPY9
BTN_TRIGGER_HAPPY10
BTN_TRIGGER_HAPPY11
BTN_TRIGGER_HAPPY12
BTN_TRIGGER_HAPPY13
BTN_TRIGGER_HAPPY14
BTN_TRIGGER_HAPPY15
BTN_TRIGGER_HAPPY16
BTN_TRIGGER_HAPPY17
BTN_TRIGGER_HAPPY18
BTN_TRIGGER_HAPPY19
BTN_TRIGGER_HAPPY20
BTN_TRIGGER_HAPPY21
BTN_TRIGGER_HAPPY22
BTN_TRIGGER_HAPPY23
BTN_TRIGGER_HAPPY24
BTN_TRIGGER_HAPPY25
BTN_TRIGGER_HAPPY26
BTN_TRIGGER_HAPPY27
BTN_TRIGGER_HAPPY28
BTN_TRIGGER_HAPPY29
BTN_TRIGGER_HAPPY30
BTN_TRIGGER_HAPPY31
BTN_TRIGGER_HAPPY32
BTN_TRIGGER_HAPPY33
BTN_TRIGGER_HAPPY34
BTN_TRIGGER_HAPPY35
BTN_TRIGGER_HAPPY36
BTN_TRIGGER_HAPPY37
BTN_TRIGGER_HAPPY38
BTN_TRIGGER_HAPPY39
BTN_TRIGGER_HAPPY40
Both Linux console and X11 terminal modes use the TOML layouts in this directory:
- [desktop.toml](desktop.toml): numeric keypad review, with NumLock off.
- [laptop.toml](laptop.toml): review chords on the main keyboard.
The Fenrir key is Insert, Super/Windows, or keypad 0 with NumLock off.
## Selecting and customizing a layout
Select a layout at launch:
```bash
./fenrir --keyboard-layout laptop
./fenrir -x --keyboard-layout /path/to/custom.toml
```
Or set the startup choice in `settings.toml`:
```toml
[keyboard]
layout = "laptop"
```
For a named layout, Fenrir searches the regular user's
`~/.local/share/stormux/fenrirscreenreader/keyboard/`, then
`/etc/fenrirscreenreader/keyboard/`, then `config/keyboard/` beside the binary.
Root searches the system and bundled locations. The first existing layout is
loaded as a complete file; layouts are not merged. Copy a bundled layout as the
starting point for customization. Layout changes apply on the next launch.
Each binding has a label, a key chord, and a command ID:
```toml
version = 1
[[bindings]]
name = "Current word"
keys = ["FENRIR", "K"]
command = "current_word"
double_command = "spell_word"
triple_command = "phonetic_word"
```
This is a minimal example, not a complete replacement layout. Optional double
and triple commands run on successive quick presses of the same chord; a
triple command requires a double command. The default multi-press interval is
200 ms, configured by `keyboard.multi_press_timeout_ms`.
Put modifiers (`FENRIR`, `CTRL`, `SHIFT`, `ALT`) before the final key.
Use key names from the bundled layouts, such as `SPACE`, `RIGHT`, `KP8`, and
`KPASTERISK`. Chords outside the bare review keypad keys require `FENRIR`.
Unsupported keys, unknown commands, and duplicate chords are rejected.
Validate a custom layout without opening devices:
```bash
./fenrir --keyboard-layout /path/to/custom.toml --check-config
```
## Common shortcuts
| Action | Desktop | Laptop |
| --- | --- | --- |
| Previous / current / next line | Keypad 7 / 8 / 9 | Fenrir+U / I / O |
| Previous / current / next word | Keypad 4 / 5 / 6 | Fenrir+J / K / L |
| Previous / current / next character | Keypad 1 / 2 / 3 | Fenrir+M / Comma / Period |
| Read screen | Fenrir+Keypad 5 | Fenrir+Shift+K |
| Follow cursor | Fenrir+Keypad Period | Fenrir+Slash |
| Cycle cursor / table / highlight tracking | Fenrir+Keypad Asterisk | Fenrir+Y |
| Toggle progress tones | Keypad Plus | Fenrir+Shift+P |
| Set reading window; double press to clear | Fenrir+Keypad Slash | Fenrir+Control+8 |
Both layouts use **Fenrir+F** for settings, **Fenrir+H** or **Fenrir+F1** for
the tutorial, and **Fenrir+Control+S** to save settings. The tutorial describes
loaded shortcuts and lets you browse unbound commands.
In table mode, word navigation moves between cells. Numeric tables can use
visible headers automatically. Review starts at the first data cell when a
recognized table is at or immediately above the application cursor.
**Fenrir+X** selects the current row as headers,
overriding automatic selection. **Fenrir+Control+Shift+X** clears headers and
disables automatic selection until table mode is re-entered or the screen
session changes. Outside table mode, Fenrir+X places a text-selection mark.
See the [user manual](../../docs/user.md) for clipboard, reading-region,
spellcheck, and menu workflows.
-128
View File
@@ -1,128 +0,0 @@
KEY_FENRIR,KEY_H=toggle_tutorial_mode
KEY_CTRL=shut_up
KEY_FENRIR,KEY_KP9=review_bottom
KEY_FENRIR,KEY_KP7=review_top
KEY_KP8=review_curr_line
KEY_KP7=review_prev_line
KEY_KP9=review_next_line
KEY_FENRIR,KEY_KP4=review_line_begin
KEY_FENRIR,KEY_KP6=review_line_end
KEY_FENRIR,KEY_KP1=review_line_first_char
KEY_FENRIR,KEY_KP3=review_line_last_char
KEY_FENRIR,KEY_ALT,KEY_1=present_first_line
KEY_FENRIR,KEY_ALT,KEY_2=present_last_line
KEY_KP5=review_curr_word
KEY_KP4=review_prev_word
KEY_KP6=review_next_word
KEY_FENRIR,KEY_SHIFT,KEY_KP5=review_curr_word_phonetic
KEY_FENRIR,KEY_SHIFT,KEY_KP4=review_prev_word_phonetic
KEY_FENRIR,KEY_SHIFT,KEY_KP6=review_next_word_phonetic
KEY_KP2=review_curr_char
KEY_KP1=review_prev_char
KEY_KP3=review_next_char
KEY_FENRIR,KEY_SHIFT,KEY_KP2=review_curr_char_phonetic
KEY_FENRIR,KEY_SHIFT,KEY_KP1=review_prev_char_phonetic
KEY_FENRIR,KEY_SHIFT,KEY_KP3=review_next_char_phonetic
KEY_FENRIR,KEY_CTRL,KEY_KP8=review_up
KEY_FENRIR,KEY_CTRL,KEY_KP2=review_down
KEY_FENRIR,KEY_KPDOT=exit_review
KEY_KPDOT=cursor_position
KEY_FENRIR,KEY_I=indent_curr_line
KEY_FENRIR,KEY_KP5=curr_screen
KEY_FENRIR,KEY_KP8=curr_screen_before_cursor
KEY_FENRIR,KEY_KP2=curr_screen_after_cursor
#=cursor_read_to_end_of_line
#=review_screen_last_char
#=review_screen_first_char
#=cursor_column
#=cursor_lineno
#=braille_flush
#=braille_return_to_cursor
#=braille_pan_left
#=braille_pan_right
#=cursor_read_line_to_cursor
KEY_FENRIR,KEY_CTRL,KEY_1=clear_bookmark_1
KEY_FENRIR,KEY_SHIFT,KEY_1=set_bookmark_1
KEY_FENRIR,KEY_1=bookmark_1
KEY_FENRIR,KEY_CTRL,KEY_2=clear_bookmark_2
KEY_FENRIR,KEY_SHIFT,KEY_2=set_bookmark_2
KEY_FENRIR,KEY_2=bookmark_2
KEY_FENRIR,KEY_CTRL,KEY_3=clear_bookmark_3
KEY_FENRIR,KEY_SHIFT,KEY_3=set_bookmark_3
KEY_FENRIR,KEY_3=bookmark_3
KEY_FENRIR,KEY_CTRL,KEY_4=clear_bookmark_4
KEY_FENRIR,KEY_SHIFT,KEY_4=set_bookmark_4
KEY_FENRIR,KEY_4=bookmark_4
KEY_FENRIR,KEY_CTRL,KEY_5=clear_bookmark_5
KEY_FENRIR,KEY_SHIFT,KEY_5=set_bookmark_5
KEY_FENRIR,KEY_5=bookmark_5
KEY_FENRIR,KEY_CTRL,KEY_6=clear_bookmark_6
KEY_FENRIR,KEY_SHIFT,KEY_6=set_bookmark_6
KEY_FENRIR,KEY_6=bookmark_6
KEY_FENRIR,KEY_CTRL,KEY_7=clear_bookmark_7
KEY_FENRIR,KEY_SHIFT,KEY_7=set_bookmark_7
KEY_FENRIR,KEY_7=bookmark_7
KEY_FENRIR,KEY_CTRL,KEY_8=clear_bookmark_8
KEY_FENRIR,KEY_SHIFT,KEY_8=set_bookmark_8
KEY_FENRIR,KEY_8=bookmark_8
KEY_FENRIR,KEY_CTRL,KEY_9=clear_bookmark_9
KEY_FENRIR,KEY_SHIFT,KEY_9=set_bookmark_9
KEY_FENRIR,KEY_9=bookmark_9
KEY_FENRIR,KEY_CTRL,KEY_0=clear_bookmark_10
KEY_FENRIR,KEY_SHIFT,KEY_0=set_bookmark_10
KEY_FENRIR,KEY_0=bookmark_10
KEY_FENRIR,KEY_KPSLASH=set_window_application
2,KEY_FENRIR,KEY_KPSLASH=clear_window_application
KEY_KPPLUS=last_incoming
KEY_FENRIR,KEY_F2=toggle_braille
KEY_FENRIR,KEY_F3=toggle_sound
KEY_FENRIR,KEY_F4=toggle_speech
KEY_KPENTER=temp_disable_speech
KEY_FENRIR,KEY_CTRL,KEY_P=toggle_punctuation_level
KEY_FENRIR,KEY_RIGHTBRACE=toggle_auto_spell_check
KEY_FENRIR,KEY_BACKSLASH=toggle_output
KEY_FENRIR,KEY_CTRL,KEY_E=toggle_emoticons
key_FENRIR,KEY_KPENTER=toggle_auto_read
KEY_FENRIR,KEY_CTRL,KEY_T=toggle_auto_time
KEY_FENRIR,KEY_KPASTERISK=toggle_highlight_tracking
KEY_FENRIR,KEY_KPMINUS=toggle_barrier
KEY_FENRIR,KEY_Q=quit_fenrir
KEY_FENRIR,KEY_T=time
2,KEY_FENRIR,KEY_T=date
KEY_KPSLASH=toggle_auto_indent
KEY_KPMINUS=attribute_cursor
#=toggle_has_attribute
KEY_FENRIR,KEY_S=spell_check
2,KEY_FENRIR,KEY_S=add_word_to_spell_check
KEY_FENRIR,KEY_SHIFT,KEY_S=remove_word_from_spell_check
KEY_FENRIR,KEY_BACKSPACE=forward_keypress
KEY_FENRIR,KEY_ALT,KEY_UP=inc_sound_volume
KEY_FENRIR,KEY_ALT,KEY_DOWN=dec_sound_volume
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_C=clear_clipboard
KEY_FENRIR,KEY_HOME=first_clipboard
KEY_FENRIR,KEY_END=last_clipboard
KEY_FENRIR,KEY_PAGEUP=prev_clipboard
KEY_FENRIR,KEY_PAGEDOWN=next_clipboard
KEY_FENRIR,KEY_SHIFT,KEY_C=curr_clipboard
KEY_FENRIR,KEY_C=copy_marked_to_clipboard
KEY_FENRIR,KEY_CTRL,KEY_C=copy_last_echo_to_clipboard
KEY_FENRIR,KEY_V=paste_clipboard
KEY_FENRIR,KEY_F5=import_clipboard_from_file
KEY_FENRIR,KEY_F6=export_clipboard_to_file
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_X=remove_marks
KEY_FENRIR,KEY_X=set_mark
KEY_FENRIR,KEY_SHIFT,KEY_X=marked_text
KEY_FENRIR,KEY_F10=toggle_vmenu_mode
KEY_FENRIR,KEY_SPACE=current_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_SPACE=current_quick_menu_value
KEY_FENRIR,KEY_RIGHT=next_quick_menu_entry
KEY_FENRIR,KEY_UP=next_quick_menu_value
KEY_FENRIR,KEY_LEFT=prev_quick_menu_entry
KEY_FENRIR,KEY_DOWN=prev_quick_menu_value
KEY_FENRIR,KEY_CTRL,KEY_S=save_settings
# linux specific
KEY_FENRIR,KEY_F7=import_clipboard_from_x
KEY_FENRIR,KEY_F8=export_clipboard_to_x
KEY_FENRIR,KEY_CTRL,KEY_UP=inc_alsa_volume
KEY_FENRIR,KEY_CTRL,KEY_DOWN=dec_alsa_volume
KEY_FENRIR,KEY_SHIFT,KEY_V=announce_fenrir_version
+495
View File
@@ -0,0 +1,495 @@
# Shared desktop layout for evdev and X11 terminal input.
# FENRIR is Insert, Super, or NumLock-off keypad 0.
# Bare keypad review bindings apply with NumLock off.
version = 1
[[bindings]]
name = "Last notification"
keys = ["FENRIR", "N"]
command = "last_notification"
[[bindings]]
name = "Notification history"
keys = ["FENRIR", "CTRL", "N"]
command = "notification_history"
[[bindings]]
name = "Tracking mode"
keys = ["FENRIR", "KPASTERISK"]
command = "toggle_highlight_tracking"
[[bindings]]
name = "Fenrir Menu"
keys = ["FENRIR", "F"]
command = "fenrir_menu"
[[bindings]]
name = "Emoji Menu"
keys = ["FENRIR", "CTRL", "E"]
command = "emoji_menu"
[[bindings]]
name = "Top"
keys = ["FENRIR", "KP7"]
command = "top"
[[bindings]]
name = "Bottom"
keys = ["FENRIR", "KP9"]
command = "bottom"
[[bindings]]
name = "Line start"
keys = ["FENRIR", "KP4"]
command = "line_start"
[[bindings]]
name = "Line end"
keys = ["FENRIR", "KP6"]
command = "line_end"
[[bindings]]
name = "First text"
keys = ["FENRIR", "KP1"]
command = "first_text"
[[bindings]]
name = "Last text"
keys = ["FENRIR", "KP3"]
command = "last_text"
[[bindings]]
name = "Read screen"
keys = ["FENRIR", "KP5"]
command = "read_screen"
[[bindings]]
name = "Screen before cursor"
keys = ["FENRIR", "KP8"]
command = "curr_screen_before_cursor"
[[bindings]]
name = "Screen after cursor"
keys = ["FENRIR", "KP2"]
command = "curr_screen_after_cursor"
[[bindings]]
name = "Character above"
keys = ["FENRIR", "CTRL", "KP8"]
command = "review_up"
[[bindings]]
name = "Character below"
keys = ["FENRIR", "CTRL", "KP2"]
command = "review_down"
[[bindings]]
name = "Follow cursor"
keys = ["FENRIR", "KPDOT"]
command = "follow_cursor"
[[bindings]]
name = "Help"
keys = ["FENRIR", "H"]
command = "help"
[[bindings]]
name = "Tutorial"
keys = ["FENRIR", "F1"]
command = "help"
[[bindings]]
name = "Mute"
keys = ["FENRIR", "F4"]
command = "mute"
[[bindings]]
name = "Temporary speech silence"
keys = ["KPENTER"]
command = "temp_disable_speech"
[[bindings]]
name = "Automatic reading"
keys = ["FENRIR", "KPENTER"]
command = "auto_read"
[[bindings]]
name = "Forward next key"
keys = ["FENRIR", "BACKSPACE"]
command = "pass_next"
[[bindings]]
name = "Quit"
keys = ["FENRIR", "Q"]
command = "quit"
[[bindings]]
name = "Previous line"
keys = ["KP7"]
command = "previous_line"
[[bindings]]
name = "Current line"
keys = ["KP8"]
command = "current_line"
double_command = "spell_line"
triple_command = "phonetic_line"
[[bindings]]
name = "Next line"
keys = ["KP9"]
command = "next_line"
[[bindings]]
name = "Previous word"
keys = ["KP4"]
command = "previous_word"
[[bindings]]
name = "Current word"
keys = ["KP5"]
command = "current_word"
double_command = "spell_word"
triple_command = "phonetic_word"
[[bindings]]
name = "Next word"
keys = ["KP6"]
command = "next_word"
[[bindings]]
name = "Previous character"
keys = ["KP1"]
command = "previous_character"
[[bindings]]
name = "Current character"
keys = ["KP2"]
command = "current_character"
double_command = "phonetic_character"
[[bindings]]
name = "Next character"
keys = ["KP3"]
command = "next_character"
[[bindings]]
name = "Position"
keys = ["KPDOT"]
command = "position"
# Clipboard commands match Python Fenrir.
[[bindings]]
name = "Set mark"
keys = ["FENRIR", "X"]
command = "set_mark"
[[bindings]]
name = "Remove marks"
keys = ["FENRIR", "CTRL", "SHIFT", "X"]
command = "remove_marks"
[[bindings]]
name = "Marked text"
keys = ["FENRIR", "SHIFT", "X"]
command = "marked_text"
[[bindings]]
name = "Copy marked text"
keys = ["FENRIR", "C"]
command = "copy_marked_to_clipboard"
[[bindings]]
name = "Current clipboard"
keys = ["FENRIR", "SHIFT", "C"]
command = "curr_clipboard"
[[bindings]]
name = "Clear clipboard"
keys = ["FENRIR", "CTRL", "SHIFT", "C"]
command = "clear_clipboard"
[[bindings]]
name = "First clipboard"
keys = ["FENRIR", "HOME"]
command = "first_clipboard"
[[bindings]]
name = "Last clipboard"
keys = ["FENRIR", "END"]
command = "last_clipboard"
[[bindings]]
name = "Previous clipboard"
keys = ["FENRIR", "PAGEUP"]
command = "prev_clipboard"
[[bindings]]
name = "Next clipboard"
keys = ["FENRIR", "PAGEDOWN"]
command = "next_clipboard"
[[bindings]]
name = "Paste clipboard"
keys = ["FENRIR", "V"]
command = "paste_clipboard"
[[bindings]]
name = "Import clipboard from file"
keys = ["FENRIR", "F5"]
command = "import_clipboard_from_file"
[[bindings]]
name = "Export clipboard to file"
keys = ["FENRIR", "F6"]
command = "export_clipboard_to_file"
[[bindings]]
name = "Import clipboard from X"
keys = ["FENRIR", "F7"]
command = "import_clipboard_from_x"
[[bindings]]
name = "Export clipboard to X"
keys = ["FENRIR", "F8"]
command = "export_clipboard_to_x"
[[bindings]]
name = "Copy last echo"
keys = ["FENRIR", "CTRL", "C"]
command = "copy_last_echo_to_clipboard"
[[bindings]]
name = "Current quick menu entry"
keys = ["FENRIR", "SPACE"]
command = "current_quick_menu_entry"
[[bindings]]
name = "Next quick menu category"
keys = ["FENRIR", "CTRL", "RIGHT"]
command = "next_quick_menu_category"
[[bindings]]
name = "Previous quick menu category"
keys = ["FENRIR", "CTRL", "LEFT"]
command = "prev_quick_menu_category"
[[bindings]]
name = "Next quick menu entry"
keys = ["FENRIR", "RIGHT"]
command = "next_quick_menu_entry"
[[bindings]]
name = "Previous quick menu entry"
keys = ["FENRIR", "LEFT"]
command = "prev_quick_menu_entry"
[[bindings]]
name = "Increase quick menu value"
keys = ["FENRIR", "UP"]
command = "next_quick_menu_value"
[[bindings]]
name = "Decrease quick menu value"
keys = ["FENRIR", "DOWN"]
command = "prev_quick_menu_value"
[[bindings]]
name = "Save settings"
keys = ["FENRIR", "CTRL", "S"]
command = "save_settings"
[[bindings]]
name = "Progress monitoring"
keys = ["KPPLUS"]
command = "progress_bar_monitor"
[[bindings]]
name = "Time and date"
keys = ["FENRIR", "T"]
command = "time"
double_command = "date"
[[bindings]]
name = "Fenrir version"
keys = ["FENRIR", "SHIFT", "V"]
command = "announce_fenrir_version"
[[bindings]]
name = "Row number"
keys = ["FENRIR", "CTRL", "KP7"]
command = "cursor_lineno"
[[bindings]]
name = "Column number"
keys = ["FENRIR", "CTRL", "KP9"]
command = "cursor_column"
[[bindings]]
name = "Line to cursor"
keys = ["FENRIR", "CTRL", "KP4"]
command = "cursor_read_line_to_cursor"
[[bindings]]
name = "Line from cursor"
keys = ["FENRIR", "CTRL", "KP6"]
command = "cursor_read_to_end_of_line"
[[bindings]]
name = "First screen character"
keys = ["FENRIR", "CTRL", "KP1"]
command = "review_screen_first_char"
[[bindings]]
name = "Last screen character"
keys = ["FENRIR", "CTRL", "KP3"]
command = "review_screen_last_char"
[[bindings]]
name = "Attributes"
keys = ["KPMINUS"]
command = "attribute_cursor"
[[bindings]]
name = "Toggle attribute feedback"
keys = ["FENRIR", "KPMINUS"]
command = "toggle_has_attribute"
[[bindings]]
name = "Spellcheck Menu"
keys = ["FENRIR", "S"]
command = "spellcheck_menu"
# Reading regions last for this reader session; marks use Fenrir+X.
[[bindings]]
name = "Reading window"
keys = ["FENRIR", "KPSLASH"]
command = "set_window_application"
double_command = "clear_window_application"
[[bindings]]
name = "Set live region"
keys = ["FENRIR", "B"]
command = "set_live_region"
[[bindings]]
name = "List reading regions"
keys = ["FENRIR", "SHIFT", "B"]
command = "list_reading_regions"
[[bindings]]
name = "Clear live regions"
keys = ["FENRIR", "CTRL", "B"]
command = "clear_live_regions"
[[bindings]]
name = "Clear all reading regions"
keys = ["FENRIR", "CTRL", "SHIFT", "B"]
command = "clear_reading_regions"
[[bindings]]
name = "Read live region 1"
keys = ["FENRIR", "1"]
command = "read_live_region_1"
[[bindings]]
name = "Clear live region 1"
keys = ["FENRIR", "SHIFT", "1"]
command = "clear_live_region_1"
[[bindings]]
name = "Read live region 2"
keys = ["FENRIR", "2"]
command = "read_live_region_2"
[[bindings]]
name = "Clear live region 2"
keys = ["FENRIR", "SHIFT", "2"]
command = "clear_live_region_2"
[[bindings]]
name = "Read live region 3"
keys = ["FENRIR", "3"]
command = "read_live_region_3"
[[bindings]]
name = "Clear live region 3"
keys = ["FENRIR", "SHIFT", "3"]
command = "clear_live_region_3"
[[bindings]]
name = "Read live region 4"
keys = ["FENRIR", "4"]
command = "read_live_region_4"
[[bindings]]
name = "Clear live region 4"
keys = ["FENRIR", "SHIFT", "4"]
command = "clear_live_region_4"
[[bindings]]
name = "Read live region 5"
keys = ["FENRIR", "5"]
command = "read_live_region_5"
[[bindings]]
name = "Clear live region 5"
keys = ["FENRIR", "SHIFT", "5"]
command = "clear_live_region_5"
[[bindings]]
name = "Read live region 6"
keys = ["FENRIR", "6"]
command = "read_live_region_6"
[[bindings]]
name = "Clear live region 6"
keys = ["FENRIR", "SHIFT", "6"]
command = "clear_live_region_6"
[[bindings]]
name = "Read live region 7"
keys = ["FENRIR", "7"]
command = "read_live_region_7"
[[bindings]]
name = "Clear live region 7"
keys = ["FENRIR", "SHIFT", "7"]
command = "clear_live_region_7"
[[bindings]]
name = "Read live region 8"
keys = ["FENRIR", "8"]
command = "read_live_region_8"
[[bindings]]
name = "Clear live region 8"
keys = ["FENRIR", "SHIFT", "8"]
command = "clear_live_region_8"
[[bindings]]
name = "Read live region 9"
keys = ["FENRIR", "9"]
command = "read_live_region_9"
[[bindings]]
name = "Clear live region 9"
keys = ["FENRIR", "SHIFT", "9"]
command = "clear_live_region_9"
[[bindings]]
name = "Read live region 10"
keys = ["FENRIR", "0"]
command = "read_live_region_10"
[[bindings]]
name = "Clear live region 10"
keys = ["FENRIR", "SHIFT", "0"]
command = "clear_live_region_10"
[[bindings]]
name = "Applications"
keys = ["FENRIR", "A"]
command = "applications_menu"
-128
View File
@@ -1,128 +0,0 @@
KEY_FENRIR,KEY_H=toggle_tutorial_mode
KEY_CTRL=shut_up
KEY_FENRIR,KEY_SHIFT,KEY_O=review_bottom
KEY_FENRIR,KEY_SHIFT,KEY_U=review_top
KEY_FENRIR,KEY_I=review_curr_line
KEY_FENRIR,KEY_U=review_prev_line
KEY_FENRIR,KEY_O=review_next_line
KEY_FENRIR,KEY_SHIFT,KEY_J=review_line_begin
KEY_FENRIR,KEY_SHIFT,KEY_L=review_line_end
KEY_FENRIR,KEY_CTRL,KEY_J=review_line_first_char
KEY_FENRIR,KEY_CTRL,KEY_L=review_line_last_char
KEY_FENRIR,KEY_ALT,KEY_1=present_first_line
KEY_FENRIR,KEY_ALT,KEY_2=present_last_line
KEY_FENRIR,KEY_K=review_curr_word
KEY_FENRIR,KEY_J=review_prev_word
KEY_FENRIR,KEY_L=review_next_word
KEY_FENRIR,KEY_ALT,KEY_K=review_curr_word_phonetic
KEY_FENRIR,KEY_ALT,KEY_J=review_prev_word_phonetic
KEY_FENRIR,KEY_ALT,KEY_L=review_next_word_phonetic
KEY_FENRIR,KEY_COMMA=review_curr_char
KEY_FENRIR,KEY_M=review_prev_char
KEY_FENRIR,KEY_DOT=review_next_char
KEY_FENRIR,KEY_ALT,KEY_COMMA=curr_char_phonetic
KEY_FENRIR,KEY_ALT,KEY_M=prev_char_phonetic
KEY_FENRIR,KEY_ALT,KEY_DOT=next_char_phonetic
KEY_FENRIR,KEY_CTRL,KEY_I=review_up
KEY_FENRIR,KEY_CTRL,KEY_COMMA=review_down
KEY_FENRIR,KEY_SLASH=exit_review
KEY_FENRIR,KEY_SHIFT,KEY_DOT=cursor_position
2,KEY_FENRIR,KEY_I=indent_curr_line
KEY_FENRIR,KEY_SHIFT,KEY_K=curr_screen
KEY_FENRIR,KEY_SHIFT,KEY_I=curr_screen_before_cursor
KEY_FENRIR,KEY_SHIFT,KEY_COMMA=curr_screen_after_cursor
#=cursor_read_to_end_of_line
#=cursor_column
#=cursor_lineno
#=braille_flush
#=braille_return_to_cursor
#=braille_pan_left
#=braille_pan_right
KEY_FENRIR,KEY_CTRL,KEY_1=clear_bookmark_1
KEY_FENRIR,KEY_SHIFT,KEY_1=set_bookmark_1
KEY_FENRIR,KEY_1=bookmark_1
KEY_FENRIR,KEY_CTRL,KEY_2=clear_bookmark_2
KEY_FENRIR,KEY_SHIFT,KEY_2=set_bookmark_2
KEY_FENRIR,KEY_2=bookmark_2
KEY_FENRIR,KEY_CTRL,KEY_3=clear_bookmark_3
KEY_FENRIR,KEY_SHIFT,KEY_3=set_bookmark_3
KEY_FENRIR,KEY_3=bookmark_3
KEY_FENRIR,KEY_CTRL,KEY_4=clear_bookmark_4
KEY_FENRIR,KEY_SHIFT,KEY_4=set_bookmark_4
KEY_FENRIR,KEY_4=bookmark_4
KEY_FENRIR,KEY_CTRL,KEY_5=clear_bookmark_5
KEY_FENRIR,KEY_SHIFT,KEY_5=set_bookmark_5
KEY_FENRIR,KEY_5=bookmark_5
KEY_FENRIR,KEY_CTRL,KEY_6=clear_bookmark_6
KEY_FENRIR,KEY_SHIFT,KEY_6=set_bookmark_6
KEY_FENRIR,KEY_6=bookmark_6
KEY_FENRIR,KEY_CTRL,KEY_7=clear_bookmark_7
KEY_FENRIR,KEY_SHIFT,KEY_7=set_bookmark_7
KEY_FENRIR,KEY_7=bookmark_7
KEY_FENRIR,KEY_CTRL,KEY_8=clear_bookmark_8
KEY_FENRIR,KEY_SHIFT,KEY_8=set_bookmark_8
KEY_FENRIR,KEY_8=bookmark_8
KEY_FENRIR,KEY_CTRL,KEY_9=clear_bookmark_9
KEY_FENRIR,KEY_SHIFT,KEY_9=set_bookmark_9
KEY_FENRIR,KEY_9=bookmark_9
KEY_FENRIR,KEY_CTRL,KEY_0=clear_bookmark_10
KEY_FENRIR,KEY_SHIFT,KEY_0=set_bookmark_10
KEY_FENRIR,KEY_0=bookmark_10
KEY_FENRIR,KEY_CTRL,KEY_8=set_window_application
2,KEY_FENRIR,KEY_CTRL,KEY_8=clear_window_application
KEY_FENRIR,KEY_SEMICOLON=last_incoming
KEY_FENRIR,KEY_F2=toggle_braille
KEY_FENRIR,KEY_F3=toggle_sound
KEY_FENRIR,KEY_F4=toggle_speech
KEY_FENRIR,KEY_ENTER=temp_disable_speech
KEY_FENRIR,KEY_SHIFT,KEY_CTRL,KEY_P=toggle_punctuation_level
KEY_FENRIR,KEY_RIGHTBRACE=toggle_auto_spell_check
KEY_FENRIR,KEY_SHIFT,KEY_ENTER=toggle_output
KEY_FENRIR,KEY_SHIFT,KEY_E=toggle_emoticons
KEY_FENRIR,KEY_ENTER=toggle_auto_read
KEY_FENRIR,KEY_CTRL,KEY_T=toggle_auto_time
KEY_FENRIR,KEY_Y=toggle_highlight_tracking
#=toggle_barrier
#=cursor_read_line_to_cursor
KEY_FENRIR,KEY_Q=quit_fenrir
KEY_FENRIR,KEY_T=time
2,KEY_FENRIR,KEY_T=date
KEY_FENRIR,KEY_BACKSLASH=toggle_auto_indent
KEY_FENRIR,KEY_MINUS=attribute_cursor
#=toggle_has_attribute
KEY_FENRIR,KEY_S=spell_check
2,KEY_FENRIR,KEY_S=add_word_to_spell_check
KEY_FENRIR,KEY_SHIFT,KEY_S=remove_word_from_spell_check
KEY_FENRIR,KEY_BACKSPACE=forward_keypress
KEY_FENRIR,KEY_ALT,KEY_UP=inc_sound_volume
KEY_FENRIR,KEY_ALT,KEY_DOWN=dec_sound_volume
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_C=clear_clipboard
KEY_FENRIR,KEY_HOME=first_clipboard
KEY_FENRIR,KEY_END=last_clipboard
KEY_FENRIR,KEY_PAGEUP=prev_clipboard
KEY_FENRIR,KEY_PAGEDOWN=next_clipboard
KEY_FENRIR,KEY_SHIFT,KEY_C=curr_clipboard
KEY_FENRIR,KEY_C=copy_marked_to_clipboard
KEY_FENRIR,KEY_CTRL,KEY_U=copy_last_echo_to_clipboard
KEY_FENRIR,KEY_V=paste_clipboard
KEY_FENRIR,KEY_F5=import_clipboard_from_file
KEY_FENRIR,KEY_F6=export_clipboard_to_file
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_X=remove_marks
KEY_FENRIR,KEY_X=set_mark
KEY_FENRIR,KEY_SHIFT,KEY_X=marked_text
KEY_FENRIR,KEY_F10=toggle_vmenu_mode
KEY_FENRIR,KEY_SPACE=current_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_SPACE=current_quick_menu_value
KEY_FENRIR,KEY_RIGHT=next_quick_menu_entry
KEY_FENRIR,KEY_UP=next_quick_menu_value
KEY_FENRIR,KEY_LEFT=prev_quick_menu_entry
KEY_FENRIR,KEY_DOWN=prev_quick_menu_value
KEY_FENRIR,KEY_ALT,KEY_RIGHT=inc_speech_pitch
KEY_FENRIR,KEY_ALT,KEY_LEFT=dec_speech_pitch
KEY_FENRIR,KEY_CTRL,KEY_S=save_settings
# linux specific
KEY_FENRIR,KEY_F7=import_clipboard_from_x
KEY_FENRIR,KEY_F8=export_clipboard_to_x
KEY_FENRIR,KEY_CTRL,KEY_UP=inc_alsa_volume
KEY_FENRIR,KEY_CTRL,KEY_DOWN=dec_alsa_volume
KEY_FENRIR,KEY_SHIFT,KEY_V=announce_fenrir_version
+491
View File
@@ -0,0 +1,491 @@
# Laptop layout for currently implemented reader commands.
# FENRIR is Caps Lock, Insert, or NumLock-off keypad 0.
# Shift+Caps Lock toggles capitalization.
version = 1
fenrir_keys = ["CAPSLOCK", "INSERT", "KP0"]
[[bindings]]
name = "Last notification"
keys = ["FENRIR", "N"]
command = "last_notification"
[[bindings]]
name = "Notification history"
keys = ["FENRIR", "CTRL", "N"]
command = "notification_history"
[[bindings]]
name = "Tracking mode"
keys = ["FENRIR", "Y"]
command = "toggle_highlight_tracking"
[[bindings]]
name = "Fenrir Menu"
keys = ["FENRIR", "F"]
command = "fenrir_menu"
[[bindings]]
name = "Emoji Menu"
keys = ["FENRIR", "CTRL", "E"]
command = "emoji_menu"
[[bindings]]
name = "Top"
keys = ["FENRIR", "SHIFT", "U"]
command = "top"
[[bindings]]
name = "Bottom"
keys = ["FENRIR", "SHIFT", "O"]
command = "bottom"
[[bindings]]
name = "Line start"
keys = ["FENRIR", "SHIFT", "J"]
command = "line_start"
[[bindings]]
name = "Line end"
keys = ["FENRIR", "SHIFT", "L"]
command = "line_end"
[[bindings]]
name = "First text"
keys = ["FENRIR", "CTRL", "J"]
command = "first_text"
[[bindings]]
name = "Last text"
keys = ["FENRIR", "CTRL", "L"]
command = "last_text"
[[bindings]]
name = "Read screen"
keys = ["FENRIR", "SHIFT", "K"]
command = "read_screen"
[[bindings]]
name = "Screen before cursor"
keys = ["FENRIR", "SHIFT", "I"]
command = "curr_screen_before_cursor"
[[bindings]]
name = "Screen after cursor"
keys = ["FENRIR", "SHIFT", "COMMA"]
command = "curr_screen_after_cursor"
[[bindings]]
name = "Character above"
keys = ["FENRIR", "CTRL", "I"]
command = "review_up"
[[bindings]]
name = "Character below"
keys = ["FENRIR", "CTRL", "COMMA"]
command = "review_down"
[[bindings]]
name = "Follow cursor"
keys = ["FENRIR", "SLASH"]
command = "follow_cursor"
[[bindings]]
name = "Help"
keys = ["FENRIR", "H"]
command = "help"
[[bindings]]
name = "Tutorial"
keys = ["FENRIR", "F1"]
command = "help"
[[bindings]]
name = "Mute"
keys = ["FENRIR", "F4"]
command = "mute"
[[bindings]]
name = "Automatic reading"
keys = ["FENRIR", "ENTER"]
command = "auto_read"
[[bindings]]
name = "Forward next key"
keys = ["FENRIR", "BACKSPACE"]
command = "pass_next"
[[bindings]]
name = "Quit"
keys = ["FENRIR", "Q"]
command = "quit"
[[bindings]]
name = "Previous line"
keys = ["FENRIR", "U"]
command = "previous_line"
[[bindings]]
name = "Current line"
keys = ["FENRIR", "I"]
command = "current_line"
double_command = "spell_line"
triple_command = "phonetic_line"
[[bindings]]
name = "Next line"
keys = ["FENRIR", "O"]
command = "next_line"
[[bindings]]
name = "Previous word"
keys = ["FENRIR", "J"]
command = "previous_word"
[[bindings]]
name = "Current word"
keys = ["FENRIR", "K"]
command = "current_word"
double_command = "spell_word"
triple_command = "phonetic_word"
[[bindings]]
name = "Next word"
keys = ["FENRIR", "L"]
command = "next_word"
[[bindings]]
name = "Previous character"
keys = ["FENRIR", "M"]
command = "previous_character"
[[bindings]]
name = "Current character"
keys = ["FENRIR", "COMMA"]
command = "current_character"
double_command = "phonetic_character"
[[bindings]]
name = "Next character"
keys = ["FENRIR", "DOT"]
command = "next_character"
[[bindings]]
name = "Position"
keys = ["FENRIR", "SHIFT", "DOT"]
command = "position"
# Clipboard commands match Python Fenrir.
[[bindings]]
name = "Set mark"
keys = ["FENRIR", "X"]
command = "set_mark"
[[bindings]]
name = "Remove marks"
keys = ["FENRIR", "CTRL", "SHIFT", "X"]
command = "remove_marks"
[[bindings]]
name = "Marked text"
keys = ["FENRIR", "SHIFT", "X"]
command = "marked_text"
[[bindings]]
name = "Copy marked text"
keys = ["FENRIR", "C"]
command = "copy_marked_to_clipboard"
[[bindings]]
name = "Current clipboard"
keys = ["FENRIR", "SHIFT", "C"]
command = "curr_clipboard"
[[bindings]]
name = "Clear clipboard"
keys = ["FENRIR", "CTRL", "SHIFT", "C"]
command = "clear_clipboard"
[[bindings]]
name = "First clipboard"
keys = ["FENRIR", "HOME"]
command = "first_clipboard"
[[bindings]]
name = "Last clipboard"
keys = ["FENRIR", "END"]
command = "last_clipboard"
[[bindings]]
name = "Previous clipboard"
keys = ["FENRIR", "PAGEUP"]
command = "prev_clipboard"
[[bindings]]
name = "Next clipboard"
keys = ["FENRIR", "PAGEDOWN"]
command = "next_clipboard"
[[bindings]]
name = "Paste clipboard"
keys = ["FENRIR", "V"]
command = "paste_clipboard"
[[bindings]]
name = "Import clipboard from file"
keys = ["FENRIR", "F5"]
command = "import_clipboard_from_file"
[[bindings]]
name = "Export clipboard to file"
keys = ["FENRIR", "F6"]
command = "export_clipboard_to_file"
[[bindings]]
name = "Import clipboard from X"
keys = ["FENRIR", "F7"]
command = "import_clipboard_from_x"
[[bindings]]
name = "Export clipboard to X"
keys = ["FENRIR", "F8"]
command = "export_clipboard_to_x"
[[bindings]]
name = "Copy last echo"
keys = ["FENRIR", "CTRL", "U"]
command = "copy_last_echo_to_clipboard"
[[bindings]]
name = "Current quick menu entry"
keys = ["FENRIR", "SPACE"]
command = "current_quick_menu_entry"
[[bindings]]
name = "Next quick menu category"
keys = ["FENRIR", "CTRL", "RIGHT"]
command = "next_quick_menu_category"
[[bindings]]
name = "Previous quick menu category"
keys = ["FENRIR", "CTRL", "LEFT"]
command = "prev_quick_menu_category"
[[bindings]]
name = "Next quick menu entry"
keys = ["FENRIR", "RIGHT"]
command = "next_quick_menu_entry"
[[bindings]]
name = "Previous quick menu entry"
keys = ["FENRIR", "LEFT"]
command = "prev_quick_menu_entry"
[[bindings]]
name = "Increase quick menu value"
keys = ["FENRIR", "UP"]
command = "next_quick_menu_value"
[[bindings]]
name = "Decrease quick menu value"
keys = ["FENRIR", "DOWN"]
command = "prev_quick_menu_value"
[[bindings]]
name = "Save settings"
keys = ["FENRIR", "CTRL", "S"]
command = "save_settings"
[[bindings]]
name = "Progress monitoring"
keys = ["FENRIR", "SHIFT", "P"]
command = "progress_bar_monitor"
[[bindings]]
name = "Time and date"
keys = ["FENRIR", "T"]
command = "time"
double_command = "date"
[[bindings]]
name = "Fenrir version"
keys = ["FENRIR", "SHIFT", "V"]
command = "announce_fenrir_version"
[[bindings]]
name = "Row number"
keys = ["FENRIR", "CTRL", "SHIFT", "U"]
command = "cursor_lineno"
[[bindings]]
name = "Column number"
keys = ["FENRIR", "CTRL", "SHIFT", "O"]
command = "cursor_column"
[[bindings]]
name = "Line to cursor"
keys = ["FENRIR", "CTRL", "SHIFT", "J"]
command = "cursor_read_line_to_cursor"
[[bindings]]
name = "Line from cursor"
keys = ["FENRIR", "CTRL", "SHIFT", "L"]
command = "cursor_read_to_end_of_line"
[[bindings]]
name = "First screen character"
keys = ["FENRIR", "CTRL", "M"]
command = "review_screen_first_char"
[[bindings]]
name = "Last screen character"
keys = ["FENRIR", "CTRL", "DOT"]
command = "review_screen_last_char"
[[bindings]]
name = "Attributes"
keys = ["FENRIR", "SHIFT", "A"]
command = "attribute_cursor"
[[bindings]]
name = "Toggle attribute feedback"
keys = ["FENRIR", "KPMINUS"]
command = "toggle_has_attribute"
[[bindings]]
name = "Spellcheck Menu"
keys = ["FENRIR", "S"]
command = "spellcheck_menu"
# Reading regions last for this reader session; marks use Fenrir+X.
[[bindings]]
name = "Reading window"
keys = ["FENRIR", "CTRL", "8"]
command = "set_window_application"
double_command = "clear_window_application"
[[bindings]]
name = "Set live region"
keys = ["FENRIR", "B"]
command = "set_live_region"
[[bindings]]
name = "List reading regions"
keys = ["FENRIR", "SHIFT", "B"]
command = "list_reading_regions"
[[bindings]]
name = "Clear live regions"
keys = ["FENRIR", "CTRL", "B"]
command = "clear_live_regions"
[[bindings]]
name = "Clear all reading regions"
keys = ["FENRIR", "CTRL", "SHIFT", "B"]
command = "clear_reading_regions"
[[bindings]]
name = "Read live region 1"
keys = ["FENRIR", "1"]
command = "read_live_region_1"
[[bindings]]
name = "Clear live region 1"
keys = ["FENRIR", "SHIFT", "1"]
command = "clear_live_region_1"
[[bindings]]
name = "Read live region 2"
keys = ["FENRIR", "2"]
command = "read_live_region_2"
[[bindings]]
name = "Clear live region 2"
keys = ["FENRIR", "SHIFT", "2"]
command = "clear_live_region_2"
[[bindings]]
name = "Read live region 3"
keys = ["FENRIR", "3"]
command = "read_live_region_3"
[[bindings]]
name = "Clear live region 3"
keys = ["FENRIR", "SHIFT", "3"]
command = "clear_live_region_3"
[[bindings]]
name = "Read live region 4"
keys = ["FENRIR", "4"]
command = "read_live_region_4"
[[bindings]]
name = "Clear live region 4"
keys = ["FENRIR", "SHIFT", "4"]
command = "clear_live_region_4"
[[bindings]]
name = "Read live region 5"
keys = ["FENRIR", "5"]
command = "read_live_region_5"
[[bindings]]
name = "Clear live region 5"
keys = ["FENRIR", "SHIFT", "5"]
command = "clear_live_region_5"
[[bindings]]
name = "Read live region 6"
keys = ["FENRIR", "6"]
command = "read_live_region_6"
[[bindings]]
name = "Clear live region 6"
keys = ["FENRIR", "SHIFT", "6"]
command = "clear_live_region_6"
[[bindings]]
name = "Read live region 7"
keys = ["FENRIR", "7"]
command = "read_live_region_7"
[[bindings]]
name = "Clear live region 7"
keys = ["FENRIR", "SHIFT", "7"]
command = "clear_live_region_7"
[[bindings]]
name = "Read live region 8"
keys = ["FENRIR", "8"]
command = "read_live_region_8"
[[bindings]]
name = "Clear live region 8"
keys = ["FENRIR", "SHIFT", "8"]
command = "clear_live_region_8"
[[bindings]]
name = "Read live region 9"
keys = ["FENRIR", "9"]
command = "read_live_region_9"
[[bindings]]
name = "Clear live region 9"
keys = ["FENRIR", "SHIFT", "9"]
command = "clear_live_region_9"
[[bindings]]
name = "Read live region 10"
keys = ["FENRIR", "0"]
command = "read_live_region_10"
[[bindings]]
name = "Clear live region 10"
keys = ["FENRIR", "SHIFT", "0"]
command = "clear_live_region_10"
[[bindings]]
name = "Applications"
keys = ["FENRIR", "A"]
command = "applications_menu"
-128
View File
@@ -1,128 +0,0 @@
KEY_FENRIR,KEY_F1=toggle_tutorial_mode
KEY_FENRIR,KEY_H=toggle_tutorial_mode
KEY_CTRL=shut_up
KEY_SHIFT,KEY_KP9=review_bottom
KEY_SHIFT,KEY_KP7=review_top
KEY_KP8=review_curr_line
KEY_KP7=review_prev_line
KEY_KP9=review_next_line
KEY_SHIFT,KEY_KP1=review_line_begin
KEY_SHIFT,KEY_KP3=review_line_end
KEY_FENRIR,KEY_KP1=review_line_first_char
KEY_FENRIR,KEY_KP3=review_line_last_char
KEY_FENRIR,KEY_ALT,KEY_1=present_first_line
KEY_FENRIR,KEY_ALT,KEY_2=present_last_line
KEY_KP5=review_curr_word
KEY_KP4=review_prev_word
KEY_KP6=review_next_word
2,KEY_KP5=review_curr_word_phonetic
2,KEY_KP4=review_prev_word_phonetic
2,KEY_KP6=review_next_word_phonetic
KEY_KP2=review_curr_char
KEY_KP1=review_prev_char
KEY_KP3=review_next_char
2,KEY_KP2=review_curr_char_phonetic
2,KEY_KP1=review_prev_char_phonetic
2,KEY_KP3=review_next_char_phonetic
KEY_FENRIR,KEY_CTRL,KEY_KP8=review_up
KEY_FENRIR,KEY_CTRL,KEY_KP2=review_down
KEY_FENRIR,KEY_KPDOT=exit_review
KEY_KPDOT=cursor_position
KEY_FENRIR,KEY_I=indent_curr_line
KEY_FENRIR,KEY_B=curr_screen
KEY_FENRIR,KEY_KP8=curr_screen_before_cursor
KEY_FENRIR,KEY_KP2=curr_screen_after_cursor
KEY_FENRIR,KEY_SHIFT,KEY_PAGEDOWN=cursor_read_to_end_of_line
#=cursor_column
#=cursor_lineno
#=braille_flush
KEY_FENRIR,KEY_CTRL,KEY_T=braille_return_to_cursor
#=braille_pan_left
#=braille_pan_right
KEY_FENRIR,KEY_CTRL,KEY_1=clear_bookmark_1
KEY_FENRIR,KEY_SHIFT,KEY_1=set_bookmark_1
KEY_FENRIR,KEY_1=bookmark_1
KEY_FENRIR,KEY_K=bookmark_1
KEY_FENRIR,KEY_CTRL,KEY_2=clear_bookmark_2
KEY_FENRIR,KEY_SHIFT,KEY_2=set_bookmark_2
KEY_FENRIR,KEY_2=bookmark_2
KEY_FENRIR,KEY_CTRL,KEY_3=clear_bookmark_3
KEY_FENRIR,KEY_SHIFT,KEY_3=set_bookmark_3
KEY_FENRIR,KEY_3=bookmark_3
KEY_FENRIR,KEY_CTRL,KEY_4=clear_bookmark_4
KEY_FENRIR,KEY_SHIFT,KEY_4=set_bookmark_4
KEY_FENRIR,KEY_4=bookmark_4
KEY_FENRIR,KEY_CTRL,KEY_5=clear_bookmark_5
KEY_FENRIR,KEY_SHIFT,KEY_5=set_bookmark_5
KEY_FENRIR,KEY_5=bookmark_5
KEY_FENRIR,KEY_CTRL,KEY_6=clear_bookmark_6
KEY_FENRIR,KEY_SHIFT,KEY_6=set_bookmark_6
KEY_FENRIR,KEY_6=bookmark_6
KEY_FENRIR,KEY_CTRL,KEY_7=clear_bookmark_7
KEY_FENRIR,KEY_SHIFT,KEY_7=set_bookmark_7
KEY_FENRIR,KEY_7=bookmark_7
KEY_FENRIR,KEY_CTRL,KEY_8=clear_bookmark_8
KEY_FENRIR,KEY_SHIFT,KEY_8=set_bookmark_8
KEY_FENRIR,KEY_8=bookmark_8
KEY_FENRIR,KEY_CTRL,KEY_9=clear_bookmark_9
KEY_FENRIR,KEY_SHIFT,KEY_9=set_bookmark_9
KEY_FENRIR,KEY_9=bookmark_9
KEY_FENRIR,KEY_CTRL,KEY_0=clear_bookmark_10
KEY_FENRIR,KEY_SHIFT,KEY_0=set_bookmark_10
KEY_FENRIR,KEY_0=bookmark_10
KEY_FENRIR,KEY_KPSLASH=set_window_application
2,KEY_FENRIR,KEY_KPSLASH=clear_window_application
KEY_KPPLUS=last_incoming
#=toggle_braille
KEY_FENRIR,KEY_F3=toggle_sound
KEY_FENRIR,KEY_F4=toggle_speech
KEY_KPENTER=temp_disable_speech
KEY_FENRIR,KEY_P=toggle_punctuation_level
KEY_FENRIR,KEY_RIGHTBRACE=toggle_auto_spell_check
KEY_FENRIR,KEY_S=toggle_output
KEY_FENRIR,KEY_CTRL,KEY_E=toggle_emoticons
key_FENRIR,KEY_5=toggle_auto_read
KEY_FENRIR,KEY_CTRL,KEY_T=toggle_auto_time
KEY_FENRIR,KEY_KPASTERISK=toggle_highlight_tracking
KEY_FENRIR,KEY_KPMINUS=toggle_barrier
KEY_FENRIR,KEY_Q=quit_fenrir
KEY_FENRIR,KEY_T=time
KEY_FENRIR,KEY_F12=time
2,KEY_FENRIR,KEY_T=date
2,KEY_FENRIR,KEY_F12=date
KEY_KPSLASH=toggle_auto_indent
KEY_FENRIR,KEY_F=attribute_cursor
#=toggle_has_attribute
KEY_FENRIR,KEY_F7=spell_check
2,KEY_FENRIR,KEY_S=add_word_to_spell_check
KEY_FENRIR,KEY_SHIFT,KEY_S=remove_word_from_spell_check
KEY_FENRIR,KEY_F2=forward_keypress
KEY_FENRIR,KEY_ALT,KEY_UP=inc_sound_volume
KEY_FENRIR,KEY_ALT,KEY_DOWN=dec_sound_volume
#=clear_clipboard
KEY_FENRIR,KEY_HOME=first_clipboard
KEY_FENRIR,KEY_END=last_clipboard
KEY_FENRIR,KEY_PAGEUP=prev_clipboard
KEY_FENRIR,KEY_PAGEDOWN=next_clipboard
KEY_FENRIR,KEY_SHIFT,KEY_C=curr_clipboard
KEY_FENRIR,KEY_C=copy_marked_to_clipboard
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_C=copy_last_echo_to_clipboard
KEY_FENRIR,KEY_V=paste_clipboard
KEY_FENRIR,KEY_F5=import_clipboard_from_file
KEY_FENRIR,KEY_F6=export_clipboard_to_file
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_X=remove_marks
KEY_FENRIR,KEY_F9=set_mark
KEY_FENRIR,KEY_F10=marked_text
KEY_FENRIR,KEY_F10=toggle_vmenu_mode
KEY_FENRIR,KEY_SPACE=current_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_SPACE=current_quick_menu_value
KEY_FENRIR,KEY_CTRL,KEY_RIGHT=next_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_UP=next_quick_menu_value
KEY_FENRIR,KEY_CTRL,KEY_LEFT=prev_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_DOWN=prev_quick_menu_value
KEY_FENRIR,KEY_CTRL,KEY_C=save_settings
# linux specific
#=import_clipboard_from_x
KEY_FENRIR,KEY_F8=export_clipboard_to_x
KEY_FENRIR,KEY_ALT,KEY_UP=inc_alsa_volume
KEY_FENRIR,KEY_ALT,KEY_DOWN=dec_alsa_volume
-128
View File
@@ -1,128 +0,0 @@
KEY_FENRIR,KEY_F1=toggle_tutorial_mode
KEY_FENRIR,KEY_H=toggle_tutorial_mode
KEY_CTRL=shut_up
KEY_FENRIR,KEY_CTRL,KEY_END=review_bottom
KEY_FENRIR,KEY_CTRL,KEY_HOME=review_top
KEY_FENRIR,KEY_SHIFT,KEY_DOT=review_curr_line
KEY_FENRIR,KEY_U=review_prev_line
KEY_FENRIR,KEY_O=review_next_line
KEY_FENRIR,KEY_HOME=review_line_begin
KEY_FENRIR,KEY_END=review_line_end
KEY_FENRIR,KEY_CTRL,KEY_J=review_line_first_char
KEY_FENRIR,KEY_CTRL,KEY_L=review_line_last_char
KEY_FENRIR,KEY_ALT,KEY_1=present_first_line
KEY_FENRIR,KEY_ALT,KEY_2=present_last_line
KEY_FENRIR,KEY_CTRL,KEY_DOT=review_curr_word
KEY_FENRIR,KEY_J=review_prev_word
KEY_FENRIR,KEY_L=review_next_word
2,KEY_FENRIR,KEY_CTRL,KEY_DOT=review_curr_word_phonetic
2,KEY_FENRIR,KEY_J=review_prev_word_phonetic
2,KEY_FENRIR,KEY_L=review_next_word_phonetic
KEY_FENRIR,KEY_COMMA=review_curr_char
KEY_FENRIR,KEY_M=review_prev_char
KEY_FENRIR,KEY_DOT=review_next_char
2,KEY_FENRIR,KEY_COMMA=curr_char_phonetic
2,KEY_FENRIR,KEY_M=prev_char_phonetic
2,KEY_FENRIR,KEY_DOT=next_char_phonetic
KEY_FENRIR,KEY_CTRL,KEY_I=review_up
KEY_FENRIR,KEY_CTRL,KEY_COMMA=review_down
KEY_FENRIR,KEY_SLASH=exit_review
KEY_FENRIR,KEY_SHIFT,KEY_DOT=cursor_position
2,KEY_FENRIR,KEY_I=indent_curr_line
KEY_FENRIR,KEY_B=curr_screen
KEY_FENRIR,KEY_SHIFT,KEY_I=curr_screen_before_cursor
KEY_FENRIR,KEY_SHIFT,KEY_COMMA=curr_screen_after_cursor
KEY_FENRIR,KEY_SHIFT,KEY_PAGEDOWN=cursor_read_to_end_of_line
#=cursor_column
#=cursor_lineno
#=braille_flush
KEY_FENRIR,KEY_CTRL,KEY_T=braille_return_to_cursor
#=braille_pan_left
#=braille_pan_right
KEY_FENRIR,KEY_CTRL,KEY_1=clear_bookmark_1
KEY_FENRIR,KEY_SHIFT,KEY_1=set_bookmark_1
KEY_FENRIR,KEY_1=bookmark_1
KEY_FENRIR,KEY_K=bookmark_1
KEY_FENRIR,KEY_CTRL,KEY_2=clear_bookmark_2
KEY_FENRIR,KEY_SHIFT,KEY_2=set_bookmark_2
KEY_FENRIR,KEY_2=bookmark_2
KEY_FENRIR,KEY_CTRL,KEY_3=clear_bookmark_3
KEY_FENRIR,KEY_SHIFT,KEY_3=set_bookmark_3
KEY_FENRIR,KEY_3=bookmark_3
KEY_FENRIR,KEY_CTRL,KEY_4=clear_bookmark_4
KEY_FENRIR,KEY_SHIFT,KEY_4=set_bookmark_4
KEY_FENRIR,KEY_4=bookmark_4
KEY_FENRIR,KEY_CTRL,KEY_5=clear_bookmark_5
KEY_FENRIR,KEY_SHIFT,KEY_5=set_bookmark_5
KEY_FENRIR,KEY_5=bookmark_5
KEY_FENRIR,KEY_CTRL,KEY_6=clear_bookmark_6
KEY_FENRIR,KEY_SHIFT,KEY_6=set_bookmark_6
KEY_FENRIR,KEY_6=bookmark_6
KEY_FENRIR,KEY_CTRL,KEY_7=clear_bookmark_7
KEY_FENRIR,KEY_SHIFT,KEY_7=set_bookmark_7
KEY_FENRIR,KEY_7=bookmark_7
KEY_FENRIR,KEY_CTRL,KEY_8=clear_bookmark_8
KEY_FENRIR,KEY_SHIFT,KEY_8=set_bookmark_8
KEY_FENRIR,KEY_8=bookmark_8
KEY_FENRIR,KEY_CTRL,KEY_9=clear_bookmark_9
KEY_FENRIR,KEY_SHIFT,KEY_9=set_bookmark_9
KEY_FENRIR,KEY_9=bookmark_9
KEY_FENRIR,KEY_CTRL,KEY_0=clear_bookmark_10
KEY_FENRIR,KEY_SHIFT,KEY_0=set_bookmark_10
KEY_FENRIR,KEY_0=bookmark_10
KEY_FENRIR,KEY_CTRL,KEY_8=set_window_application
2,KEY_FENRIR,KEY_CTRL,KEY_8=clear_window_application
KEY_FENRIR,KEY_SEMICOLON=last_incoming
#=toggle_braille
KEY_FENRIR,KEY_F3=toggle_sound
KEY_FENRIR,KEY_F4=toggle_speech
KEY_FENRIR,KEY_ENTER=temp_disable_speech
KEY_FENRIR,KEY_P=toggle_punctuation_level
KEY_FENRIR,KEY_RIGHTBRACE=toggle_auto_spell_check
KEY_FENRIR,KEY_S=toggle_output
KEY_FENRIR,KEY_SHIFT,KEY_E=toggle_emoticons
KEY_FENRIR,KEY_5=toggle_auto_read
KEY_FENRIR,KEY_CTRL,KEY_T=toggle_auto_time
KEY_FENRIR,KEY_Y=toggle_highlight_tracking
#=toggle_barrier
KEY_FENRIR,KEY_Q=quit_fenrir
KEY_FENRIR,KEY_T=time
KEY_FENRIR,KEY_F12=time
2,KEY_FENRIR,KEY_T=date
2,KEY_FENRIR,KEY_F12=date
KEY_FENRIR,KEY_BACKSLASH=toggle_auto_indent
KEY_FENRIR,KEY_F=attribute_cursor
#=toggle_has_attribute
KEY_FENRIR,KEY_F7=spell_check
2,KEY_FENRIR,KEY_S=add_word_to_spell_check
KEY_FENRIR,KEY_SHIFT,KEY_S=remove_word_from_spell_check
KEY_FENRIR,KEY_F2=forward_keypress
KEY_FENRIR,KEY_ALT,KEY_UP=inc_sound_volume
KEY_FENRIR,KEY_ALT,KEY_DOWN=dec_sound_volume
#=clear_clipboard
#=first_clipboard
#=last_clipboard
KEY_FENRIR,KEY_PAGEUP=prev_clipboard
KEY_FENRIR,KEY_PAGEDOWN=next_clipboard
KEY_FENRIR,KEY_SHIFT,KEY_C=curr_clipboard
KEY_FENRIR,KEY_C=copy_marked_to_clipboard
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_C=copy_last_echo_to_clipboard
KEY_FENRIR,KEY_V=paste_clipboard
KEY_FENRIR,KEY_F5=import_clipboard_from_file
KEY_FENRIR,KEY_F6=export_clipboard_to_file
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_X=remove_marks
KEY_FENRIR,KEY_F9=set_mark
KEY_FENRIR,KEY_F10=marked_text
KEY_FENRIR,KEY_SHIFT,KEY_F10=toggle_vmenu_mode
KEY_FENRIR,KEY_SPACE=current_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_SPACE=current_quick_menu_value
KEY_FENRIR,KEY_CTRL,KEY_RIGHT=next_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_UP=next_quick_menu_value
KEY_FENRIR,KEY_CTRL,KEY_LEFT=prev_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_DOWN=prev_quick_menu_value
KEY_FENRIR,KEY_CTRL,KEY_C=save_settings
# linux specific
#=import_clipboard_from_x
KEY_FENRIR,KEY_F8=export_clipboard_to_x
KEY_FENRIR,KEY_ALT,KEY_UP=inc_alsa_volume
KEY_FENRIR,KEY_ALT,KEY_DOWN=dec_alsa_volume
-87
View File
@@ -1,87 +0,0 @@
# This file contains terminal escape sequences as shortcut
# It is used for PTY screen / Input driver (Terminal emulation)
# ^[ is used as escape
# f1 - fenrir help
^[OP=toggle_tutorial_mode
# double tap control+end read attributes
2,^[[1;5F=attribute_cursor
#=toggle_has_attribute
# escape - stop speech
^[=shut_up
# context menu key - stop speech
^[[29~=shut_up
# alt+shift+down - review to bottom
^[[1;4B=review_bottom
# alt+shift_up - review to top
^[[1;4A=review_top
# alt+down - review current line
^[[1;3B=review_curr_line
# alt+left - review previous line
^[[1;3D=review_prev_line
# alt+right - review next line
^[[1;3C=review_next_line
# alt+shift+left - beginning of line
^[[1;4D=review_line_begin
# alt+shift+right - end of line
^[[1;4C=review_line_end
# control+down - review current word
^[[1;5B=review_curr_word
# control+left - review previous word
^[[1;5D=review_prev_word
# control+right - review next word
^[[1;5C=review_next_word
# shift+down - review current character
^[[1;2B=review_curr_char
# shift+left - review previous character
^[[1;2D=review_prev_char
# shift+right - review next character
^[[1;2C=review_next_char
# control+shift+down - current character phonetic
^[[1;6B=curr_char_phonetic
# control+shift+left - previous character phonetic
^[[1;6D=prev_char_phonetic
# control+shift+right - next character phonetic
^[[1;6C=next_char_phonetic
# f2 - toggle sound
^[OQ=toggle_sound
# f3 - toggle highlight tracking
^[OR=toggle_highlight_tracking
alt+f12 - quit fenrir
^[[24;3~=quit_fenrir
# alt+f12 - time
^[[24;3~=time
# 2,alt+f12 - date
2,^[[24;3~=date
# alt+[ - previous clipboard
^[[=prev_clipboard
# alt+] - next clipboard
^[]=next_clipboard
# control+f6 - Read current clipboard
^[[17;5~=curr_clipboard
# f6 - copy to clipboard
^[[17~=copy_marked_to_clipboard
# shift+f6 - clear clipboard
^[[17;2~=clear_clipboard
# f7 - paste clipboard
^[[18~=paste_clipboard
# alt+f8 - export clipboard to X
^[[19;3~=export_clipboard_to_x
# control+f8 - import clipboard from X
^[[19;5~=import_clipboard_from_x
# alt+f9 - export clipboard to file
^[[20;3~=export_clipboard_to_file
# control+f9 - import clipboard from file
^[[20;5~=import_clipboard_from_file
# shift+f5 - remove marks
^[[15;2~=remove_marks
# f5 - set mark
^[[15~=set_mark
# f8 - Last utterance to clipboard
^[[19~=copy_last_echo_to_clipboard
# lat+\ Toggle auto announcement of indentation
^[\=toggle_auto_indent
# alt+end - temperarily disable speech
^[[1;3F=temp_disable_speech
# control+end - toggle auto read
^[[1;5F=toggle_auto_read
-46
View File
@@ -1,46 +0,0 @@
# This file contains terminal escape sequences as shortcut
# It is used for PTY screen / Input driver (Terminal emulation)
# ^[ is used as escape
^[h=toggle_tutorial_mode
^[/=shut_up
^[[D=shut_up
^[O=review_bottom
^[U=review_top
#^[[1;3B=review_curr_line
^[i=review_curr_line
^[u=review_prev_line
^[o=review_next_line
^[J=review_line_begin
^[L=review_line_end
^[j=review_line_first_char
^[L=review_line_last_char
^[k=review_curr_word
^[j=review_prev_word
^[l=review_next_word
^[,=review_curr_char
^[m=review_prev_char
^[.=review_next_char
^[<=curr_char_phonetic
^[M=prev_char_phonetic
^[>=next_char_phonetic
^[OR=toggle_sound
^[OS=toggle_speech
^[8=toggle_highlight_tracking
^[Q=quit_fenrir
^[t=time
^[T=date
^[[5~=prev_clipboard
^[[6~=next_clipboard
^[C=curr_clipboard
^[c=copy_marked_to_clipboard
^[v=paste_clipboard
^[[15~=import_clipboard_from_file
^[X=remove_marks
^[x=set_mark
^[\=toggle_auto_indent
^[B=copy_last_echo_to_clipboard
# alt+f8 - export clipboard to X
# ^[[19;3~=export_clipboard_to_x
# # control+f8 - import clipboard from X
# ^[[19;5~=import_clipboard_from_x
-218
View File
@@ -1,218 +0,0 @@
# Fenrir comment: copy of speakup DefaultKeyAssignments converted to fenrir syntax
# Fenrir comment: https://android.googlesource.com/kernel/msm/+/android-7.1.0_r0.2/drivers/staging/speakup/DefaultKeyAssignments
# Fenrir comment: The insert or shift key named below is the fenrir key
# This file is intended to give you an overview of the default keys used
# by speakup for it's review functions. You may change them to be
# anything you want but that will take some familiarity with key
# mapping.
# We have remapped the insert or zero key on the keypad to act as a
# shift key. Well, actually as an altgr key. So in the following list
# InsKeyPad-period means hold down the insert key like a shift key and
# hit the keypad period.
# KeyPad-8 Say current Line
KEY_KP8=review_curr_line
# InsKeyPad-8 say from top of screen to reading cursor.
KEY_FENRIR,KEY_KP8=curr_screen_before_cursor
# KeyPad-7 Say Previous Line (UP one line)
KEY_KP7=review_prev_line
# KeyPad-9 Say Next Line (down one line)
KEY_KP9=review_next_line
# KeyPad-5 Say Current Word
KEY_KP5=review_curr_word
# InsKeyPad-5 Spell Current Word
KEY_FENRIR,KEY_KP5=review_curr_word_phonetic
# KeyPad-4 Say Previous Word (left one word)
KEY_KP4=review_prev_word
# InsKeyPad-4 say from left edge of line to reading cursor.
KEY_FENRIR,KEY_KP4=cursor_read_line_to_cursor
# KeyPad-6 Say Next Word (right one word)
KEY_KP6=review_next_word
# InsKeyPad-6 Say from reading cursor to right edge of line.
KEY_FENRIR,KEY_KP6=cursor_read_to_end_of_line
# KeyPad-2 Say Current Letter
KEY_KP2=review_curr_char
# InsKeyPad-2 say current letter phonetically
KEY_FENRIR,KEY_KP2=review_curr_char_phonetic
# KeyPad-1 Say Previous Character (left one letter)
KEY_KP1=review_prev_char
# KeyPad-3 Say Next Character (right one letter)
KEY_KP3=review_next_char
# KeyPad-plus Say Entire Screen
KEY_KPPLUS=curr_screen
# InsKeyPad-plus Say from reading cursor line to bottom of screen.
KEY_FENRIR,KEY_KPPLUS=curr_screen_after_cursor
# KeyPad-Minus Park reading cursor (toggle)
# TODO
# InsKeyPad-minus Say character hex and decimal value.
# TODO
# KeyPad-period Say Position (current line, position and console)
KEY_KPDOT=cursor_position
# InsKeyPad-period say colour attributes of current position.
KEY_FENRIR,KEY_KPDOT=attribute_cursor
# InsKeyPad-9 Move reading cursor to top of screen (insert pgup)
KEY_FENRIR,KEY_KP9=review_bottom
# InsKeyPad-3 Move reading cursor to bottom of screen (insert pgdn)
KEY_FENRIR,KEY_KP3=review_top
# InsKeyPad-7 Move reading cursor to left edge of screen (insert home)
KEY_FENRIR,KEY_KP7=review_screen_first_char
# InsKeyPad-1 Move reading cursor to right edge of screen (insert end)
KEY_FENRIR,KEY_KP1=review_screen_last_char
# ControlKeyPad-1 Move reading cursor to last character on current line.
KEY_CTRL,KEY_KP1=review_line_end
# KeyPad-Enter Shut Up (until another key is hit) and sync reading cursor
KEY_KPENTER=temp_disable_speech
# InsKeyPad-Enter Shut Up (until toggled back on).
KEY_FENRIR,KEY_KPENTER=toggle_speech
# InsKeyPad-star n<x|y> go to line (y) or column (x). Where 'n' is any
# allowed value for the row or column for your current screen.
# TODO
# KeyPad-/ Mark and Cut screen region.
KEY_KPSLASH=copy_marked_to_clipboard
# InsKeyPad-/ Paste screen region into any console.
KEY_FENRIR,KEY_KPSLASH=paste_clipboard
# Hitting any key while speakup is outputting speech will quiet the
# synth until it has caught up with what is being printed on the
# console.
# following by other fenrir commands
KEY_FENRIR,KEY_H=toggle_tutorial_mode
KEY_CTRL=shut_up
KEY_FENRIR,KEY_KP4=review_line_begin
#=review_line_end
#=review_line_first_char
#=review_line_last_char
KEY_FENRIR,KEY_ALT,KEY_1=present_first_line
KEY_FENRIR,KEY_ALT,KEY_2=present_last_line
KEY_FENRIR,KEY_SHIFT,KEY_KP4=review_prev_word_phonetic
KEY_FENRIR,KEY_SHIFT,KEY_KP6=review_next_word_phonetic
KEY_FENRIR,KEY_SHIFT,KEY_KP1=review_prev_char_phonetic
KEY_FENRIR,KEY_SHIFT,KEY_KP3=review_next_char_phonetic
KEY_FENRIR,KEY_CTRL,KEY_KP8=review_up
KEY_FENRIR,KEY_CTRL,KEY_KP2=review_down
#=exit_review
KEY_FENRIR,KEY_I=indent_curr_line
KEY_KPPLUS=curr_screen
#=cursor_column
#=cursor_lineno
#=braille_flush
#=braille_return_to_cursor
#=braille_pan_left
#=braille_pan_right
KEY_FENRIR,KEY_CTRL,KEY_1=clear_bookmark_1
KEY_FENRIR,KEY_SHIFT,KEY_1=set_bookmark_1
KEY_FENRIR,KEY_1=bookmark_1
KEY_FENRIR,KEY_CTRL,KEY_2=clear_bookmark_2
KEY_FENRIR,KEY_SHIFT,KEY_2=set_bookmark_2
KEY_FENRIR,KEY_2=bookmark_2
KEY_FENRIR,KEY_CTRL,KEY_3=clear_bookmark_3
KEY_FENRIR,KEY_SHIFT,KEY_3=set_bookmark_3
KEY_FENRIR,KEY_3=bookmark_3
KEY_FENRIR,KEY_CTRL,KEY_4=clear_bookmark_4
KEY_FENRIR,KEY_SHIFT,KEY_4=set_bookmark_4
KEY_FENRIR,KEY_4=bookmark_4
KEY_FENRIR,KEY_CTRL,KEY_5=clear_bookmark_5
KEY_FENRIR,KEY_SHIFT,KEY_5=set_bookmark_5
KEY_FENRIR,KEY_5=bookmark_5
KEY_FENRIR,KEY_CTRL,KEY_6=clear_bookmark_6
KEY_FENRIR,KEY_SHIFT,KEY_6=set_bookmark_6
KEY_FENRIR,KEY_6=bookmark_6
KEY_FENRIR,KEY_CTRL,KEY_7=clear_bookmark_7
KEY_FENRIR,KEY_SHIFT,KEY_7=set_bookmark_7
KEY_FENRIR,KEY_7=bookmark_7
KEY_FENRIR,KEY_CTRL,KEY_8=clear_bookmark_8
KEY_FENRIR,KEY_SHIFT,KEY_8=set_bookmark_8
KEY_FENRIR,KEY_8=bookmark_8
KEY_FENRIR,KEY_CTRL,KEY_9=clear_bookmark_9
KEY_FENRIR,KEY_SHIFT,KEY_9=set_bookmark_9
KEY_FENRIR,KEY_9=bookmark_9
KEY_FENRIR,KEY_CTRL,KEY_0=clear_bookmark_10
KEY_FENRIR,KEY_SHIFT,KEY_0=set_bookmark_10
KEY_FENRIR,KEY_0=bookmark_10
KEY_FENRIR,KEY_KPSLASH=set_window_application
2,KEY_FENRIR,KEY_KPSLASH=clear_window_application
#=last_incoming
KEY_FENRIR,KEY_F2=toggle_braille
KEY_FENRIR,KEY_F3=toggle_sound
KEY_FENRIR,KEY_F9=toggle_punctuation_level
KEY_FENRIR,KEY_RIGHTBRACE=toggle_auto_spell_check
KEY_FENRIR,KEY_BACKSLASH=toggle_output
KEY_FENRIR,KEY_CTRL,KEY_E=toggle_emoticons
key_FENRIR,KEY_KPENTER=toggle_auto_read
KEY_FENRIR,KEY_CTRL,KEY_T=toggle_auto_time
KEY_FENRIR,KEY_KPASTERISK=toggle_highlight_tracking
KEY_FENRIR,KEY_KPMINUS=toggle_barrier
KEY_FENRIR,KEY_Q=quit_fenrir
KEY_FENRIR,KEY_T=time
2,KEY_FENRIR,KEY_T=date
KEY_KPSLASH=toggle_auto_indent
#=toggle_has_attribute
KEY_FENRIR,KEY_S=spell_check
2,KEY_FENRIR,KEY_S=add_word_to_spell_check
KEY_FENRIR,KEY_SHIFT,KEY_S=remove_word_from_spell_check
KEY_FENRIR,KEY_BACKSPACE=forward_keypress
KEY_FENRIR,KEY_ALT,KEY_UP=inc_sound_volume
KEY_FENRIR,KEY_ALT,KEY_DOWN=dec_sound_volume
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_C=clear_clipboard
KEY_FENRIR,KEY_HOME=first_clipboard
KEY_FENRIR,KEY_END=last_clipboard
KEY_FENRIR,KEY_PAGEUP=prev_clipboard
KEY_FENRIR,KEY_PAGEDOWN=next_clipboard
KEY_FENRIR,KEY_SHIFT,KEY_C=curr_clipboard
KEY_FENRIR,KEY_CTRL,KEY_C=copy_last_echo_to_clipboard
KEY_FENRIR,KEY_F5=import_clipboard_from_file
KEY_FENRIR,KEY_F6=export_clipboard_to_file
KEY_FENRIR,KEY_CTRL,KEY_SHIFT,KEY_X=remove_marks
KEY_FENRIR,KEY_X=set_mark
KEY_FENRIR,KEY_SHIFT,KEY_X=marked_text
KEY_FENRIR,KEY_F10=toggle_vmenu_mode
KEY_FENRIR,KEY_SPACE=current_quick_menu_entry
KEY_FENRIR,KEY_CTRL,KEY_SPACE=current_quick_menu_value
KEY_FENRIR,KEY_RIGHT=next_quick_menu_entry
KEY_FENRIR,KEY_UP=next_quick_menu_value
KEY_FENRIR,KEY_LEFT=prev_quick_menu_entry
KEY_FENRIR,KEY_DOWN=prev_quick_menu_value
KEY_FENRIR,KEY_CTRL,KEY_S=save_settings
# linux specific
KEY_FENRIR,KEY_F7=import_clipboard_from_x
KEY_FENRIR,KEY_F8=export_clipboard_to_x
KEY_FENRIR,KEY_CTRL,KEY_UP=inc_alsa_volume
KEY_FENRIR,KEY_CTRL,KEY_DOWN=dec_alsa_volume
-78
View File
@@ -1,78 +0,0 @@
# how to use this file?
# the # on the beginning of the line is a comment
# the different sections are seperated by [<name>Dict] <name> is the section name. Dict is a keyword
# the entrys are seperated with :===: in words colon tripple equal colon ( to not collide with substitutions)
[levelDict]
none:===:
some:===:.-$~+*-/\@
most:===:.,:-$~+*-/\@!#%^&*()[]}{<>;
all:===:!"#$%& \'()*+,-./:;<=>?@[\\]^_`{|}~
[punctDict]
:===:Leer
&:===:Und
':===:Apostroph
@:===:At
\:===:Backslash
|:===:Pipe
!:===:Ausrufezeichen
^:===:Hoch
::===:Doppelpunkt
,:===:Komma
-:===:Minus
$:===:Dollar
.:===:Punkt
>:===:Größer als
`:===:Grave
#:===:Hash
{:===:Geschweifte Klammer auf
[:===:eckige Klammer auf
(:===:Klammer auf
<:===:Kleiner als
%:===:Prozent
+:===:Plus
?:===:Fragezeichen?
":===:Gänsefüßchen
):===:Klammer zu
}:===:Geschweifte Klammer zu
]:===:Eckige Klammer zu
;:===:Semikolon
/:===:Geteilt durch
*:===:Mal
~:===:Tilde
_:===:Lienie unten
=:===:Istgleich
[customDict]
[emoticonDict]
regex;(?:^|\s)(?::-\)|:\))(?:\s|$):===:smile
regex;(?:^|\s)(?::-\(|:\()(?:\s|$):===:frown
regex;(?:^|\s)(?::-D|:D)(?:\s|$):===:big grin
regex;(?:^|\s)(?:;-\)|;\))(?:\s|$):===:wink
regex;(?:^|\s)(?::-P|:P)(?:\s|$):===:tongue out
regex;(?:^|\s)(?::-O|:O)(?:\s|$):===:surprised
regex;(?:^|\s)(?::-/|:/)(?:\s|$):===:skeptical
regex;(?:^|\s)(?:>:-\(|>:\()(?:\s|$):===:angry
regex;(?:^|\s)(?::'\(|:'-\()(?:\s|$):===:crying
regex;(?:^|\s)(?::-\||:\|)(?:\s|$):===:neutral
regex;(?:^|\s)(?:8-\)|B-\))(?:\s|$):===:cool
regex;(?:^|\s)8-X(?:\s|$):===:skull and crossbones
regex;(?:^|\s)(?:X-X|x-x)(?:\s|$):===:knocked out
regex;(?:^|\s)(?::-X|:-x|:X|:x)(?:\s|$):===:lips sealed
regex;(?:^|\s)XD(?:\s|$):===:laughing hard
regex;(?:^|\s)\^_\^(?:\s|$):===:happy
regex;(?:^|\s)-_-(?:\s|$):===:annoyed
regex;(?:^|\s)o_O(?:\s|$):===:confused
regex;(?:^|\s)>_<(?:\s|$):===:frustrated
regex;(?:^|\s)\\o/(?:\s|$):===:hurray
regex;(?:^|\s)<3(?:\s|$):===:heart
regex;(?:^|\s)</3(?:\s|$):===:broken heart
regex;(?:^|\s)(?:Oo|oO)(?:\s|$):===:WTF?
regex;(?:^|\s)<{-.-}>(?:\s|$):===:Raves
regex;(?:^|\s)-\.-(?:\s|$):===:bugged
regex;(?:^|\s)>\.<(?:\s|$):===:laughing
regex;(?:^|\s)(?:>:\)|>:-\))(?:\s|$):===:evil smile
regex;(?:^|\s)\^\^(?:\s|$):===:enjoy smile
regex;(?:^|\s)->(?:\s|$):===:arrow right
regex;(?:^|\s)<-(?:\s|$):===:arrow left
+45
View File
@@ -0,0 +1,45 @@
# Punctuation names and levels from Python Fenrir (LGPL-3.0-or-later).
# Pronunciation dictionaries and emoticons are separate from punctuation.
version = 1
translate = false
[levels]
"none" = ""
"some" = ".-$~+*-/\\@"
"most" = ".,:-$~+*-/\\@!#%^&*()[]}{<>;"
"all" = "!\"#$%& \\'()*+,-./:;<=>?@[\\\\]^_`{|}~"
[symbols]
" " = "Leer"
"&" = "Und"
"'" = "Apostroph"
"@" = "At"
"\\" = "Backslash"
"|" = "Pipe"
"!" = "Ausrufezeichen"
"^" = "Hoch"
":" = "Doppelpunkt"
"," = "Komma"
"-" = "Minus"
"$" = "Dollar"
"." = "Punkt"
">" = "Größer als"
"`" = "Grave"
"#" = "Hash"
"{" = "Geschweifte Klammer auf"
"[" = "eckige Klammer auf"
"(" = "Klammer auf"
"<" = "Kleiner als"
"%" = "Prozent"
"+" = "Plus"
"?" = "Fragezeichen?"
"\"" = "Gänsefüßchen"
")" = "Klammer zu"
"}" = "Geschweifte Klammer zu"
"]" = "Eckige Klammer zu"
";" = "Semikolon"
"/" = "Geteilt durch"
"*" = "Mal"
"~" = "Tilde"
"_" = "Lienie unten"
"=" = "Istgleich"
-78
View File
@@ -1,78 +0,0 @@
# how to use this file?
# the # on the beginning of the line is a comment
# the different sections are seperated by [<name>Dict] <name> is the section name. Dict is a keyword
# the entrys are seperated with :===: in words colon tripple equal colon ( to not collide with substitutions)
[levelDict]
none:===:
some:===:-$~+*-/\@#
most:===:.,:-$~+*-/\@!#%^&*()[]}{<>;
all:===:!"#$%& \'()*+,-./:;<=>?@[\\]^_`{|}~
[punctDict]
:===:space
&:===:and
':===:apostrophe
@:===:at
\:===:backslash
|:===:bar
!:===:bang
^:===:carrot
::===:colon
,:===:comma
-:===:dash
$:===:dollar
.:===:dot
>:===:greater
`:===:grave
#:===:hash
{:===:left brace
[:===:left bracket
(:===:left paren
<:===:less
%:===:percent
+:===:plus
?:===:question?
":===:quote
):===:right paren
}:===:right brace
]:===:right bracket
;:===:semicolon
/:===:slash
*:===:star
~:===:tilde
_:===:line
=:===:equals
[customDict]
[emoticonDict]
regex;(?:^|\s)(?::-\)|:\))(?:\s|$):===:smile
regex;(?:^|\s)(?::-\(|:\()(?:\s|$):===:frown
regex;(?:^|\s)(?::-D|:D)(?:\s|$):===:big grin
regex;(?:^|\s)(?:;-\)|;\))(?:\s|$):===:wink
regex;(?:^|\s)(?::-P|:P)(?:\s|$):===:tongue out
regex;(?:^|\s)(?::-O|:O)(?:\s|$):===:surprised
regex;(?:^|\s)(?::-/|:/)(?:\s|$):===:skeptical
regex;(?:^|\s)(?:>:-\(|>:\()(?:\s|$):===:angry
regex;(?:^|\s)(?::'\(|:'-\()(?:\s|$):===:crying
regex;(?:^|\s)(?::-\||:\|)(?:\s|$):===:neutral
regex;(?:^|\s)(?:8-\)|B-\))(?:\s|$):===:cool
regex;(?:^|\s)8-X(?:\s|$):===:skull and crossbones
regex;(?:^|\s)(?:X-X|x-x)(?:\s|$):===:knocked out
regex;(?:^|\s)(?::-X|:-x|:X|:x)(?:\s|$):===:lips sealed
regex;(?:^|\s)XD(?:\s|$):===:laughing hard
regex;(?:^|\s)\^_\^(?:\s|$):===:happy
regex;(?:^|\s)-_-(?:\s|$):===:annoyed
regex;(?:^|\s)o_O(?:\s|$):===:confused
regex;(?:^|\s)>_<(?:\s|$):===:frustrated
regex;(?:^|\s)\\o/(?:\s|$):===:hurray
regex;(?:^|\s)<3(?:\s|$):===:heart
regex;(?:^|\s)</3(?:\s|$):===:broken heart
regex;(?:^|\s)(?:Oo|oO)(?:\s|$):===:WTF?
regex;(?:^|\s)<{-.-}>(?:\s|$):===:Raves
regex;(?:^|\s)-\.-(?:\s|$):===:bugged
regex;(?:^|\s)>\.<(?:\s|$):===:laughing
regex;(?:^|\s)(?:>:\)|>:-\))(?:\s|$):===:evil smile
regex;(?:^|\s)\^\^(?:\s|$):===:enjoy smile
regex;(?:^|\s)->(?:\s|$):===:arrow right
regex;(?:^|\s)<-(?:\s|$):===:arrow left
+45
View File
@@ -0,0 +1,45 @@
# Punctuation names and levels from Python Fenrir (LGPL-3.0-or-later).
# Pronunciation dictionaries and emoticons are separate from punctuation.
version = 1
translate = true
[levels]
"none" = ""
"some" = "-$~+*-/\\@#"
"most" = ".,:-_$~+*-/\\@!#%^&*()[]}{<>;"
"all" = "!\"#$%& \\'()*+,-./:;<=>?@[\\\\]^_`{|}~"
[symbols]
" " = "space"
"&" = "and"
"'" = "apostrophe"
"@" = "at"
"\\" = "backslash"
"|" = "bar"
"!" = "bang"
"^" = "carrot"
":" = "colon"
"," = "comma"
"-" = "dash"
"$" = "dollar"
"." = "dot"
">" = "greater"
"`" = "grave"
"#" = "hash"
"{" = "left brace"
"[" = "left bracket"
"(" = "left paren"
"<" = "less"
"%" = "percent"
"+" = "plus"
"?" = "question?"
"\"" = "quote"
")" = "right paren"
"}" = "right brace"
"]" = "right bracket"
";" = "semicolon"
"/" = "slash"
"*" = "star"
"~" = "tilde"
"_" = "line"
"=" = "equals"
-78
View File
@@ -1,78 +0,0 @@
# how to use this file?
# the # on the beginning of the line is a comment
# the different sections are seperated by [<name>Dict] <name> is the section name. Dict is a keyword
# the entrys are seperated with :===: in words colon tripple equal colon ( to not collide with substitutions)
[levelDict]
none:===:
some:===:-$~+*-/\@
most:===:.,:-$~+*-/\@!#%^&*()[]}{<>;
all:===:!"#$%& \'()*+,-./:;<=>?@[\\]^_`{|}~
[punctDict]
:===:space
&:===:and
':===:apostrophe
@:===:at
\:===:backslash
|:===:bar
!:===:bang
^:===:carrot
::===:colon
,:===:comma
-:===:dash
$:===:dollar
.:===:dot
>:===:greater
`:===:grave
#:===:hash
{:===:left brace
[:===:left bracket
(:===:left paren
<:===:less
%:===:percent
+:===:plus
?:===:question?
":===:quote
):===:right paren
}:===:right brace
]:===:right bracket
;:===:semicolon
/:===:slash
*:===:star
~:===:tilde
_:===:line
=:===:equals
[customDict]
[emoticonDict]
regex;(?:^|\s)(?::-\)|:\))(?:\s|$):===:smile
regex;(?:^|\s)(?::-\(|:\()(?:\s|$):===:frown
regex;(?:^|\s)(?::-D|:D)(?:\s|$):===:big grin
regex;(?:^|\s)(?:;-\)|;\))(?:\s|$):===:wink
regex;(?:^|\s)(?::-P|:P)(?:\s|$):===:tongue out
regex;(?:^|\s)(?::-O|:O)(?:\s|$):===:surprised
regex;(?:^|\s)(?::-/|:/)(?:\s|$):===:skeptical
regex;(?:^|\s)(?:>:-\(|>:\()(?:\s|$):===:angry
regex;(?:^|\s)(?::'\(|:'-\()(?:\s|$):===:crying
regex;(?:^|\s)(?::-\||:\|)(?:\s|$):===:neutral
regex;(?:^|\s)(?:8-\)|B-\))(?:\s|$):===:cool
regex;(?:^|\s)8-X(?:\s|$):===:skull and crossbones
regex;(?:^|\s)(?:X-X|x-x)(?:\s|$):===:knocked out
regex;(?:^|\s)(?::-X|:-x|:X|:x)(?:\s|$):===:lips sealed
regex;(?:^|\s)XD(?:\s|$):===:laughing hard
regex;(?:^|\s)\^_\^(?:\s|$):===:happy
regex;(?:^|\s)-_-(?:\s|$):===:annoyed
regex;(?:^|\s)o_O(?:\s|$):===:confused
regex;(?:^|\s)>_<(?:\s|$):===:frustrated
regex;(?:^|\s)\\o/(?:\s|$):===:hurray
regex;(?:^|\s)<3(?:\s|$):===:heart
regex;(?:^|\s)</3(?:\s|$):===:broken heart
regex;(?:^|\s)(?:Oo|oO)(?:\s|$):===:WTF?
regex;(?:^|\s)<{-.-}>(?:\s|$):===:Raves
regex;(?:^|\s)-\.-(?:\s|$):===:bugged
regex;(?:^|\s)>\.<(?:\s|$):===:laughing
regex;(?:^|\s)(?:>:\)|>:-\))(?:\s|$):===:evil smile
regex;(?:^|\s)\^\^(?:\s|$):===:enjoy smile
regex;(?:^|\s)->(?:\s|$):===:arrow right
regex;(?:^|\s)<-(?:\s|$):===:arrow left
+45
View File
@@ -0,0 +1,45 @@
# Punctuation names and levels from Python Fenrir (LGPL-3.0-or-later).
# Pronunciation dictionaries and emoticons are separate from punctuation.
version = 1
translate = true
[levels]
"none" = ""
"some" = "-$~+*-/\\@"
"most" = ".,:-$~+*-_/\\@!#%^&*()[]}{<>;"
"all" = "!\"#$%& \\'()*+,-./:;<=>?@[\\\\]^_`{|}~"
[symbols]
" " = "space"
"&" = "and"
"'" = "apostrophe"
"@" = "at"
"\\" = "backslash"
"|" = "bar"
"!" = "bang"
"^" = "carrot"
":" = "colon"
"," = "comma"
"-" = "dash"
"$" = "dollar"
"." = "dot"
">" = "greater"
"`" = "grave"
"#" = "hash"
"{" = "left brace"
"[" = "left bracket"
"(" = "left paren"
"<" = "less"
"%" = "percent"
"+" = "plus"
"?" = "question?"
"\"" = "quote"
")" = "right paren"
"}" = "right brace"
"]" = "right bracket"
";" = "semicolon"
"/" = "slash"
"*" = "star"
"~" = "tilde"
"_" = "line"
"=" = "equals"
-78
View File
@@ -1,78 +0,0 @@
# how to use this file?
# the # on the beginning of the line is a comment
# the different sections are seperated by [<name>Dict] <name> is the section name. Dict is a keyword
# the entrys are seperated with :===: in words colon tripple equal colon ( to not collide with substitutions)
[levelDict]
none:===:
some:===:.-$~+*-/\@
most:===:.,:-$~+*-/\@!#%^&*()[]}{<>;
all:===:!"#$%& \'()*+,-./:;<=>?@[\\]^_`{|}~
[punctDict]
:===:espacio
&:===:et
':===:apóstrofo
@:===:arroba
\:===:barra inversa
|:===:barra vertical
!:===:Cerrar exclamación
^:===:circumplejo
::===:dos puntos
,:===:coma
-:===:guion
$:===:dólar
.:===:punto
>:===:mayor que
`:===:grave
#:===:signo de número
{:===:abrir yave
[:===:abrir corchete
(:===:abrir paréntesis
<:===:menor que
%:===:porciento
+:===:más
?:===:cerrar interrogación?
":===:comillas
):===:cerrar paréntesis
}:===:cerrar yave
]:===:cerrar corchete
;:===:punto y coma
/:===:barra
*:===:asterisco
~:===:tilde
_:===:subrayado
=:===:igual
[customDict]
[emoticonDict]
regex;(?:^|\s)(?::-\)|:\))(?:\s|$):===:smile
regex;(?:^|\s)(?::-\(|:\()(?:\s|$):===:frown
regex;(?:^|\s)(?::-D|:D)(?:\s|$):===:big grin
regex;(?:^|\s)(?:;-\)|;\))(?:\s|$):===:wink
regex;(?:^|\s)(?::-P|:P)(?:\s|$):===:tongue out
regex;(?:^|\s)(?::-O|:O)(?:\s|$):===:surprised
regex;(?:^|\s)(?::-/|:/)(?:\s|$):===:skeptical
regex;(?:^|\s)(?:>:-\(|>:\()(?:\s|$):===:angry
regex;(?:^|\s)(?::'\(|:'-\()(?:\s|$):===:crying
regex;(?:^|\s)(?::-\||:\|)(?:\s|$):===:neutral
regex;(?:^|\s)(?:8-\)|B-\))(?:\s|$):===:cool
regex;(?:^|\s)8-X(?:\s|$):===:skull and crossbones
regex;(?:^|\s)(?:X-X|x-x)(?:\s|$):===:knocked out
regex;(?:^|\s)(?::-X|:-x|:X|:x)(?:\s|$):===:lips sealed
regex;(?:^|\s)XD(?:\s|$):===:laughing hard
regex;(?:^|\s)\^_\^(?:\s|$):===:happy
regex;(?:^|\s)-_-(?:\s|$):===:annoyed
regex;(?:^|\s)o_O(?:\s|$):===:confused
regex;(?:^|\s)>_<(?:\s|$):===:frustrated
regex;(?:^|\s)\\o/(?:\s|$):===:hurray
regex;(?:^|\s)<3(?:\s|$):===:heart
regex;(?:^|\s)</3(?:\s|$):===:broken heart
regex;(?:^|\s)(?:Oo|oO)(?:\s|$):===:WTF?
regex;(?:^|\s)<{-.-}>(?:\s|$):===:Raves
regex;(?:^|\s)-\.-(?:\s|$):===:bugged
regex;(?:^|\s)>\.<(?:\s|$):===:laughing
regex;(?:^|\s)(?:>:\)|>:-\))(?:\s|$):===:evil smile
regex;(?:^|\s)\^\^(?:\s|$):===:enjoy smile
regex;(?:^|\s)->(?:\s|$):===:arrow right
regex;(?:^|\s)<-(?:\s|$):===:arrow left
+45
View File
@@ -0,0 +1,45 @@
# Punctuation names and levels from Python Fenrir (LGPL-3.0-or-later).
# Pronunciation dictionaries and emoticons are separate from punctuation.
version = 1
translate = false
[levels]
"none" = ""
"some" = ".-$~+*-/\\@"
"most" = ".,:-$~+*-/\\@!#%^&*()[]}{<>;"
"all" = "!\"#$%& \\'()*+,-./:;<=>?@[\\\\]^_`{|}~"
[symbols]
" " = "espacio"
"&" = "et"
"'" = "apóstrofo"
"@" = "arroba"
"\\" = "barra inversa"
"|" = "barra vertical"
"!" = "Cerrar exclamación"
"^" = "circumplejo"
":" = "dos puntos"
"," = "coma"
"-" = "guion"
"$" = "dólar"
"." = "punto"
">" = "mayor que"
"`" = "grave"
"#" = "signo de número"
"{" = "abrir yave"
"[" = "abrir corchete"
"(" = "abrir paréntesis"
"<" = "menor que"
"%" = "porciento"
"+" = "más"
"?" = "cerrar interrogación?"
"\"" = "comillas"
")" = "cerrar paréntesis"
"}" = "cerrar yave"
"]" = "cerrar corchete"
";" = "punto y coma"
"/" = "barra"
"*" = "asterisco"
"~" = "tilde"
"_" = "subrayado"
"=" = "igual"
-78
View File
@@ -1,78 +0,0 @@
# how to use this file?
# the # on the beginning of the line is a comment
# the different sections are seperated by [<name>Dict] <name> is the section name. Dict is a keyword
# the entrys are seperated with :===: in words colon tripple equal colon ( to not collide with substitutions)
[levelDict]
none:===:
some:===:.-$~+*-/\@
most:===:.,:-$~+*-/\@!#%^&*()[]}{<>;
all:===:!"#$%& \'()*+,-./:;<=>?@[\\]^_`{|}~
[punctDict]
:===:espace
&:===:et
':===:apostrophe
@:===:arobase
\:===:barre oblique inversée
|:===:barre verticale
!:===:point d'exclamation
^:===:accent circonflexe
::===:deux points
,:===:virgule
-:===:tiret
$:===:dollar
.:===:point
>:===:suppérieur à
`:===:accent grave
#:===:dièse
{:===:accolade ouvrante
[:===:crochet ouvrant
(:===:parenthèse ouvrante
<:===:inférieur à
%:===:pourcent
+:===:plus
?:===:point d'interrogation
":===:guillemet
):===:parenthèse fermante
}:===:accolade fermante
]:===:crochet fermant
;:===:point virgule
/:===:barre oblique
*:===:astérisque
~:===:tildé
_:===:souligné
=:===:égale à
[customDict]
[emoticonDict]
regex;(?:^|\s)(?::-\)|:\))(?:\s|$):===:smile
regex;(?:^|\s)(?::-\(|:\()(?:\s|$):===:frown
regex;(?:^|\s)(?::-D|:D)(?:\s|$):===:big grin
regex;(?:^|\s)(?:;-\)|;\))(?:\s|$):===:wink
regex;(?:^|\s)(?::-P|:P)(?:\s|$):===:tongue out
regex;(?:^|\s)(?::-O|:O)(?:\s|$):===:surprised
regex;(?:^|\s)(?::-/|:/)(?:\s|$):===:skeptical
regex;(?:^|\s)(?:>:-\(|>:\()(?:\s|$):===:angry
regex;(?:^|\s)(?::'\(|:'-\()(?:\s|$):===:crying
regex;(?:^|\s)(?::-\||:\|)(?:\s|$):===:neutral
regex;(?:^|\s)(?:8-\)|B-\))(?:\s|$):===:cool
regex;(?:^|\s)8-X(?:\s|$):===:skull and crossbones
regex;(?:^|\s)(?:X-X|x-x)(?:\s|$):===:knocked out
regex;(?:^|\s)(?::-X|:-x|:X|:x)(?:\s|$):===:lips sealed
regex;(?:^|\s)XD(?:\s|$):===:laughing hard
regex;(?:^|\s)\^_\^(?:\s|$):===:happy
regex;(?:^|\s)-_-(?:\s|$):===:annoyed
regex;(?:^|\s)o_O(?:\s|$):===:confused
regex;(?:^|\s)>_<(?:\s|$):===:frustrated
regex;(?:^|\s)\\o/(?:\s|$):===:hurray
regex;(?:^|\s)<3(?:\s|$):===:heart
regex;(?:^|\s)</3(?:\s|$):===:broken heart
regex;(?:^|\s)(?:Oo|oO)(?:\s|$):===:WTF?
regex;(?:^|\s)<{-.-}>(?:\s|$):===:Raves
regex;(?:^|\s)-\.-(?:\s|$):===:bugged
regex;(?:^|\s)>\.<(?:\s|$):===:laughing
regex;(?:^|\s)(?:>:\)|>:-\))(?:\s|$):===:evil smile
regex;(?:^|\s)\^\^(?:\s|$):===:enjoy smile
regex;(?:^|\s)->(?:\s|$):===:arrow right
regex;(?:^|\s)<-(?:\s|$):===:arrow left
+45
View File
@@ -0,0 +1,45 @@
# Punctuation names and levels from Python Fenrir (LGPL-3.0-or-later).
# Pronunciation dictionaries and emoticons are separate from punctuation.
version = 1
translate = false
[levels]
"none" = ""
"some" = ".-$~+*-/\\@"
"most" = ".,:-$~+*-/\\@!#%^&*()[]}{<>;"
"all" = "!\"#$%& \\'()*+,-./:;<=>?@[\\\\]^_`{|}~"
[symbols]
" " = "espace"
"&" = "et"
"'" = "apostrophe"
"@" = "arobase"
"\\" = "barre oblique inversée"
"|" = "barre verticale"
"!" = "point d'exclamation"
"^" = "accent circonflexe"
":" = "deux points"
"," = "virgule"
"-" = "tiret"
"$" = "dollar"
"." = "point"
">" = "suppérieur à"
"`" = "accent grave"
"#" = "dièse"
"{" = "accolade ouvrante"
"[" = "crochet ouvrant"
"(" = "parenthèse ouvrante"
"<" = "inférieur à"
"%" = "pourcent"
"+" = "plus"
"?" = "point d'interrogation"
"\"" = "guillemet"
")" = "parenthèse fermante"
"}" = "accolade fermante"
"]" = "crochet fermant"
";" = "point virgule"
"/" = "barre oblique"
"*" = "astérisque"
"~" = "tildé"
"_" = "souligné"
"=" = "égale à"
-78
View File
@@ -1,78 +0,0 @@
# how to use this file?
# the # on the beginning of the line is a comment
# the different sections are seperated by [<name>Dict] <name> is the section name. Dict is a keyword
# the entrys are seperated with :===: in words colon tripple equal colon ( to not collide with substitutions)
[levelDict]
none:===:
some:===:.-$~+*-/\@
most:===:.,:-$~+*-/\@!#%^&*()[]}{<>;
all:===:!"#$%& \'()*+,-./:;<=>?@[\\]^_`{|}~
[punctDict]
:===:spacja
&:===:ampersant
':===:apostrof
@:===:małpa
\:===:bekslesz
|:===:pionowa kreska
!:===:wykrzyknik
^:===:daszek
::===:dwukropek
,:===:przecinek
-:===:myślnik
$:===:dolar
.:===:kropka
>:===:większe
`:===:akcent
#:===:hasz
{:===:lewa klamra
[:===:lewy nawias kwadratowy
(:===:lewy nawias
<:===:mniejsze
%:===:procent
+:===:plus
?:===:pytajnik
":===:cudzysłów
):===:prawy nawias
}:===:prawa klamra
]:===:prawy nawias kwadratowy
;:===:średnik
/:===:slesz
*:===:gwiazdka
~:===:tylda
_:===:podkreślnik
=:===:równa się
[customDict]
[emoticonDict]
regex;(?:^|\s)(?::-\)|:\))(?:\s|$):===:smile
regex;(?:^|\s)(?::-\(|:\()(?:\s|$):===:frown
regex;(?:^|\s)(?::-D|:D)(?:\s|$):===:big grin
regex;(?:^|\s)(?:;-\)|;\))(?:\s|$):===:wink
regex;(?:^|\s)(?::-P|:P)(?:\s|$):===:tongue out
regex;(?:^|\s)(?::-O|:O)(?:\s|$):===:surprised
regex;(?:^|\s)(?::-/|:/)(?:\s|$):===:skeptical
regex;(?:^|\s)(?:>:-\(|>:\()(?:\s|$):===:angry
regex;(?:^|\s)(?::'\(|:'-\()(?:\s|$):===:crying
regex;(?:^|\s)(?::-\||:\|)(?:\s|$):===:neutral
regex;(?:^|\s)(?:8-\)|B-\))(?:\s|$):===:cool
regex;(?:^|\s)8-X(?:\s|$):===:skull and crossbones
regex;(?:^|\s)(?:X-X|x-x)(?:\s|$):===:knocked out
regex;(?:^|\s)(?::-X|:-x|:X|:x)(?:\s|$):===:lips sealed
regex;(?:^|\s)XD(?:\s|$):===:laughing hard
regex;(?:^|\s)\^_\^(?:\s|$):===:happy
regex;(?:^|\s)-_-(?:\s|$):===:annoyed
regex;(?:^|\s)o_O(?:\s|$):===:confused
regex;(?:^|\s)>_<(?:\s|$):===:frustrated
regex;(?:^|\s)\\o/(?:\s|$):===:hurray
regex;(?:^|\s)<3(?:\s|$):===:heart
regex;(?:^|\s)</3(?:\s|$):===:broken heart
regex;(?:^|\s)(?:Oo|oO)(?:\s|$):===:WTF?
regex;(?:^|\s)<{-.-}>(?:\s|$):===:Raves
regex;(?:^|\s)-\.-(?:\s|$):===:bugged
regex;(?:^|\s)>\.<(?:\s|$):===:laughing
regex;(?:^|\s)(?:>:\)|>:-\))(?:\s|$):===:evil smile
regex;(?:^|\s)\^\^(?:\s|$):===:enjoy smile
regex;(?:^|\s)->(?:\s|$):===:arrow right
regex;(?:^|\s)<-(?:\s|$):===:arrow left
+45
View File
@@ -0,0 +1,45 @@
# Punctuation names and levels from Python Fenrir (LGPL-3.0-or-later).
# Pronunciation dictionaries and emoticons are separate from punctuation.
version = 1
translate = false
[levels]
"none" = ""
"some" = ".-$~+*-/\\@"
"most" = ".,:-$~+*-/\\@!#%^&*()[]}{<>;"
"all" = "!\"#$%& \\'()*+,-./:;<=>?@[\\\\]^_`{|}~"
[symbols]
" " = "spacja"
"&" = "ampersant"
"'" = "apostrof"
"@" = "małpa"
"\\" = "bekslesz"
"|" = "pionowa kreska"
"!" = "wykrzyknik"
"^" = "daszek"
":" = "dwukropek"
"," = "przecinek"
"-" = "myślnik"
"$" = "dolar"
"." = "kropka"
">" = "większe"
"`" = "akcent"
"#" = "hasz"
"{" = "lewa klamra"
"[" = "lewy nawias kwadratowy"
"(" = "lewy nawias"
"<" = "mniejsze"
"%" = "procent"
"+" = "plus"
"?" = "pytajnik"
"\"" = "cudzysłów"
")" = "prawy nawias"
"}" = "prawa klamra"
"]" = "prawy nawias kwadratowy"
";" = "średnik"
"/" = "slesz"
"*" = "gwiazdka"
"~" = "tylda"
"_" = "podkreślnik"
"=" = "równa się"
-84
View File
@@ -1,84 +0,0 @@
# how to use this file?
# the # on the beginning of the line is a comment
# the different sections are seperated by [<name>Dict] <name> is the section name. Dict is a keyword
# the entrys are seperated with :===: in words colon tripple equal colon ( to not collide with substitutions)
[levelDict]
none:===:
some:===:-$~+*-/\@
most:===:.,:-$~+*-/\@!#%^&*()[]}{<>;
all:===:!"#$%& \'()*+,-./:;<=>?@[\\]^_`{|}~
[punctDict]
:===:space
&:===:and
':===:apostrophe
@:===:at
\:===:backslash
|:===:bar
!:===:bang
^:===:carrot
::===:colon
,:===:comma
-:===:dash
$:===:dollar
.:===:dot
>:===:greater
`:===:grave
#:===:hash
{:===:left brace
[:===:left bracket
(:===:left paren
<:===:less
%:===:percent
+:===:plus
?:===:question?
":===:quote
):===:right paren
}:===:right brace
]:===:right bracket
;:===:semicolon
/:===:slash
*:===:star
~:===:tilde
_:===:line
=:===:equals
[customDict]
regex;(?i)certificates:===:certiffikets
regex;(?i)certificate:===:certifficate
regex;(?i)lowblow:===:LowBlow
regex;(?i)nginx:===:EngineX
regex;(?i)shit:===:shitt
regex;(?i)slither:===:slitther
[emoticonDict]
regex;(?:^|\s)(?::-\)|:\))(?:\s|$):===:smile
regex;(?:^|\s)(?::-\(|:\()(?:\s|$):===:frown
regex;(?:^|\s)(?::-D|:D)(?:\s|$):===:big grin
regex;(?:^|\s)(?:;-\)|;\))(?:\s|$):===:wink
regex;(?:^|\s)(?::-P|:P)(?:\s|$):===:tongue out
regex;(?:^|\s)(?::-O|:O)(?:\s|$):===:surprised
regex;(?:^|\s)(?::-/|:/)(?:\s|$):===:skeptical
regex;(?:^|\s)(?:>:-\(|>:\()(?:\s|$):===:angry
regex;(?:^|\s)(?::'\(|:'-\()(?:\s|$):===:crying
regex;(?:^|\s)(?::-\||:\|)(?:\s|$):===:neutral
regex;(?:^|\s)(?:8-\)|B-\))(?:\s|$):===:cool
regex;(?:^|\s)8-X(?:\s|$):===:skull and crossbones
regex;(?:^|\s)(?:X-X|x-x)(?:\s|$):===:knocked out
regex;(?:^|\s)(?::-X|:-x|:X|:x)(?:\s|$):===:lips sealed
regex;(?:^|\s)XD(?:\s|$):===:laughing hard
regex;(?:^|\s)\^_\^(?:\s|$):===:happy
regex;(?:^|\s)-_-(?:\s|$):===:annoyed
regex;(?:^|\s)o_O(?:\s|$):===:confused
regex;(?:^|\s)>_<(?:\s|$):===:frustrated
regex;(?:^|\s)\\o/(?:\s|$):===:hurray
regex;(?:^|\s)<3(?:\s|$):===:heart
regex;(?:^|\s)</3(?:\s|$):===:broken heart
regex;(?:^|\s)(?:Oo|oO)(?:\s|$):===:WTF?
regex;(?:^|\s)<{-.-}>(?:\s|$):===:Raves
regex;(?:^|\s)-\.-(?:\s|$):===:bugged
regex;(?:^|\s)>\.<(?:\s|$):===:laughing
regex;(?:^|\s)(?:>:\)|>:-\))(?:\s|$):===:evil smile
regex;(?:^|\s)\^\^(?:\s|$):===:enjoy smile
regex;(?:^|\s)->(?:\s|$):===:arrow right
regex;(?:^|\s)<-(?:\s|$):===:arrow left