MORSEALL(15)

NAME
morseall - a morse code user interface for linux

SYNOPSIS
morseall [Options...]

DESCRIPTION

Morseall lets you use a computer by tapping out Morse code on the mouse buttons.

OPTIONS

-v --verbose
    Show debugging messages

-g --grab
    Grab the mouse on startup (can be turned on by default in morseall.conf)

FREQUENTLY ASKED QUESTIONS
Can I use Morseall with just one button?
    Yes! The left mouse button is able to perform all operations.

Can I use Morseall to control my mouse?
    And browse the web? And use an email program? Yes! Morseall has a mouse mode for moving the mouse. Support is included for single and double clicking of all three standard mouse buttons.

How do I move down to the next page while viewing this page?
    You can move forward in man with space "..--", and move backward with b "-..."

Can I type faster if I have control over two or three mouse buttons?
    Yes. The right mouse button is used to generate dashes without any delay. The middle mouse button will repeat the last code, alowing more convenience in scrolling or moving the cursor.

How do I switch between windows?
    Switch to mouse mode, then press a dash to select the window you want to select. In mouse mode, a dash causes the mouse to experience a single click of the left mouse button. You may have noticed that Alt Tab does not work. This is because Morseall has grabbed control of the pointer, even while keystrokes are issued.

How do I exit Morseall?
    Switch to mouse mode, then Click on the X to close the Morseall window.

Can I use morseall to read the names of each key?
    Yes! My young children love to pound on the keyboard. Start up morseall, then type "exit" to close the terminal window. As long as Morseall is the foreground application, keystrokes will be spoken aloud, just like key codes.

INPUT

Left Button - Dot
    Tap quickly on the left button for a dot. Hold it longer for a dash. Hold it for an extended time to repeat the previous code. For example to enter "eeeeee" tap once and then hold the left mouse button down until the repeating starts.

Middle Button - Repeat
    Repeat the previous Code, hold down to repeat continuously. For ultra-fast keying, the middle button terminates a character immediately without the usual delay after the last dot or dash.

Right Button - Dash
    Tap quickly to issue a dash. If you have two fingers, it is much easier to tap dashes quickly by using the right button.

CODES

Alt_L "-.-.-."
    Equivalent to pressing the Left ALT key. Repeat once to lock it down. When locked, you must type it a third time to unlock.

Control_L "-.-.-"
    Equivalent to pressing the Left Control key. Repeat once to lock it down. When locked, you must type it a third time to unlock. faster "......" Speed up the timing of dots and dashes.

grab (Punctuation Mode Only) "..--.-..--"
    Grab is enabled by default. In normal operation, Morseall takes control of the mouse and doesn't let go. This option allows you to temporarily turn off Grab while testing and debugging. Most users will always leave grab enabled.

help ".---."
    Advance to the next help page. After typing this code, use the middle button to repeat and you will skip quickly through the pages. Only codes for the current mode are shown. To see help for a different mode, you must switch modes.

mode ".---.."
    The mode command rotates betwee all three modes. There are three modes: Keyboard Mode, Punctuation Mode, and Mouse Mode.

    1. Keyboard Mode In this mode, Morseall complies with international standards for Morse Code keying. Codes in Keyboard mode are available in other modes unless overridden by mode-specific codes.

    2. Punctuation Mode Letters are re-mapped to punction symbols or commands. Codes in punctuation mode are preceded by a "2".

    3. Mouse Mode Letters are re-mapped to mouse movements and button events. In this mode you can push the mouse around the screen to control a browser or graphical application. Codes in punctuation mode are preceded by a "3".

reset "....-.-."
    You might occasionally get stuck and want an easy way to get back to a new termianl. The reset command starts a new, fresh terminal window, allowing you to recover after getting stuck with an unfamiliar applicaiton. If you use reset and your data has not been saved, that data will be lost.

Shift_L "..-.-"
    Equivalent to pressing the Left Shift key. Repeat once to lock it down. When locked, you must type it a third time to unlock.

slower "------"
    Slow down the timing of dots and dashes.

sound (Punctuation Mode Only) "--"
    Turn Sound on and off. By default, morseall plays dits and dahs and reads completed codes out loud. Brian Short, the first user of morseall, had considerable difficulty maintaining a constant focus on the screen. With the sound on, he could lean back and relax while typing.

NOTES

Quiting morseall when you have control of the keyboard
    The fastest way to quit morseall is to use the keyboard. Press alt-F4 to kill the terminal window. When morseall is in the active window, keystrokes are spoken aloud. Hit alt-F4 again to quit morseall.

How do I open and close other windows?
    If you launch a graphical application, you can usually close it by entering either alt-F4 or ctrl-c. Try it by running "xclock" and then typing ctrl-c.

How do I stop text that is scrolling too fast?
    If you type ctrl-s, it will freeze the console. To unfreeze the console, type ctrl-q. This behavior dates from the early days of UNIX.

Can I get multiple screens inside a terminal?"
    The "screen" command allows you to have more than one virtual terminal within a single window. Screen may be challening to master and is intended for advanced users. Type "man screen" to learn more.

Help! Pull-down menus do not work.
    Morseall cannot currently handle pulldown menus (File, Edit, View, etc.). To use pulldown menu features you will need to lookup the keyboard shortcuts for each feature. Morseall is not able to grab control of the mouse while a pulldown menu is active.

REPORTING BUGS
Report bugs to by sending mail to pehr@pehr.net. The more detail you can include in your message, the easier it will be to help!

SEE ALSO

http://morseall.org
    The main website has the latest versions for download as well as information on using morseall.

k  (keymap.py)
    The k program is an essential reference for all configured codes. At the terminal type "k" "-.-" and then Enter ".-.-" Inside the keymap program you can type space "..--" to step through the code screens.

/usr/share/morseall-data/morseall.conf
    morseall.conf is the Morseall configuration file. It defines all the keymappings used in morseall's modes.

    TERM (default value) - description

    dot_time_ms (200 ms) - minimimum number of milliseconds before a dot turns into a dash

    iambic_enable (0) - Iambic keyers stream dots and dashes if multiple keys are held down

    mouse_stepsize (8 pixels) - Number of pixels the mouse moves in each step

    repeate_enable (1) - Set to 0 to turn off if users have tremmors

    sound_enable (1) - Set to 0 to turn off sound if not needed (default 1)

    time_step_percent (20%)- faster/slower commands will change dot_time_ms by this percentage

/etc/morseall.conf
    You can create your own key map variaitons by creating this file. Codes defined here will override the factory defaults.

~/.gnome/morseall.conf
    Make personal changes in ~/.gnome/morseall.conf

When done viewing this man page, type q --.- to quit

COPYRIGHT
Copyright © 200l-2007 Free Software Foundation, Inc.
    This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.