guile-clipboard-speaker

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs | LICENSE

README.org (1750B)

      1 # -*- mode: org; coding: utf-8; -*-
      2 #+AUTHOR:
      3 
      4 #+TITLE: README for Clipboard-Speaker
      5 
      6 * Clipboard Speaker (in GNU Guile this time).
      7 
      8     Want your computer
      9     to speak a bit?
     10     Mark some text
     11     and let it rip.
     12 
     13 Not a fancy curiosity but an accessibility tool for people with
     14 reading disabilities. I use it every day to read.
     15 
     16 It basically reads whatever you mark with your mouse cursor.
     17 
     18 ** "Community":
     19 
     20 <irc://libera.chat/clipboard-speaker> (on the web:
     21 <https://web.libera.chat/#clipboard-speaker>).
     22 
     23 ** Code repositories:
     24 
     25 Main development repository is on <https://sr.ht/>:
     26 
     27 <https://codeberg.org/kakafarm/guile-clipboard-speaker/>
     28 
     29 Mirrors:
     30 
     31 - <https://git.sr.ht/~kakafarm/guile-clipboard-speaker/>
     32 - <https://gitlab.com/yuvallangerontheroad/guile-clipboard-speaker/>
     33 - <https://gitlab.com/yuvallanger/guile-clipboard-speaker/>
     34 
     35 ** Map your keybindings:
     36 
     37 *** On Gnome:
     38 
     39 Add the key bindings in (if you use Gnome. If you don't, look up how
     40 to assign scripts to keybindings in your own window manager):
     41 
     42 #+begin_example
     43 Gnome Settings
     44     → Keyboard Shortcuts
     45     → All the way down and press the + button
     46 #+end_example
     47 
     48 ** Usage:
     49 
     50 1. Select some text. While the text is highlighted,
     51 2. press the keybinding assigned to the `clipboard-reader` executable
     52    to start the reading of the highlighted text.
     53 3. (optional, while `clipboard-speaker` is reading the text) Select
     54    some more text and press the keybinding that starts
     55    `clipboard-reader`. The selected text will be added to the text
     56    buffer and will be read right after the last bunch of text.
     57 4. (optional) GOTO 3.
     58 5. (optional) Press the other keybinding assigned to the
     59    `clipboard-reader --kill` script to make your computer stop
     60    speaking and clear the text buffer.