1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200
|
Onboard 1.4.1
-------------
Description:
Onboard is an onscreen keyboard useful for everybody that cannot use a
hardware keyboard; for example TabletPC users, mobility impaired users,...
It has been designed with simplicity in mind and can be used right away
without the need of any configuration, as it can read the keyboard layout
from the X server.
Among its features are:
- Support of custom layouts through the use of xml and svg files.
- Support of custom themes for the appearance through the use of xml files.
- Support of macros to automatically type custom defined texts.
- Support of <modifier>+<mouseclick> combination.
- Toggling mouse buttons to perform right clicks with the left mouse button.
- Control of the hover click feature provided by the system.
- Minimizing the keyboard to the panel, a trayicon, or a floating icon.
- Docking
- XEmbedding
- Support for scanning.
D-Bus Service:
Once running, Onboard provides a D-Bus service at the bus name
'org.onboard.Onboard', that allows other processes to control
the keyboard window.
Interface 'org.onboard.Onboard.Keyboard':
Show(), method
Show the keyboard window.
Return value: None
If auto-show is enabled, the window is locked visible, i.e.
auto-hiding is suspended until Onboard is hidden either manually
or by calling the D-Bus method "Hide". This is the same bahavior as if
Onboard was shown by user action, e.g. by status menu, floating icon
or by starting a second instance.
Example:
dbus-send --type=method_call --print-reply --dest=org.onboard.Onboard
/org/onboard/Onboard/Keyboard org.onboard.Onboard.Keyboard.Show
Hide(), method
Hide the keyboard window.
Return value: None
Example:
dbus-send --type=method_call --print-reply --dest=org.onboard.Onboard
/org/onboard/Onboard/Keyboard org.onboard.Onboard.Keyboard.Hide
ToggleVisible(), method
Show the keyboard window if it was hidden, else hide it.
Return value: None
Example:
dbus-send --type=method_call --print-reply --dest=org.onboard.Onboard
/org/onboard/Onboard/Keyboard
org.onboard.Onboard.Keyboard.ToggleVisible
Visible, Boolean property, read-only
True if the window is currently visible, False otherwise.
Signal: org.freedesktop.DBus.Properties.PropertiesChanged
Example:
dbus-send --type=method_call --print-reply --dest=org.onboard.Onboard
/org/onboard/Onboard/Keyboard org.freedesktop.DBus.Properties.Get
string:"org.onboard.Onboard.Keyboard" string:"Visible"
AutoShowPaused, Boolean property, read-write
True pauses auto-show and hides the keyboard.
False resumes auto-show.
You are free to write to this property, e.g. when entering/leaving
tablet mode of a convertible device (and Onboard's built-in detection
isn't sufficient).
This property is not persistent. It will be reset to 'false' each time
Onboard is restarted.
Signal: org.freedesktop.DBus.Properties.PropertiesChanged
Example, reading:
dbus-send --type=method_call --print-reply --dest=org.onboard.Onboard
/org/onboard/Onboard/Keyboard org.freedesktop.DBus.Properties.Get
string:"org.onboard.Onboard.Keyboard" string:"AutoShowPaused"
Example, writing:
dbus-send --type=method_call --print-reply --dest=org.onboard.Onboard
/org/onboard/Onboard/Keyboard org.freedesktop.DBus.Properties.Set
string:"org.onboard.Onboard.Keyboard" string:"AutoShowPaused"
variant:boolean:"true"
Getting Onboard:
A PPA with downloads for various old and new Ubuntu-releases
can be found here:
https://launchpad.net/~onboard/+archive/ubuntu/stable
Tar-balls of the latest releases are available on our Launchpad homepage.
https://launchpad.net/onboard
Source code is maintained in a bazaar repository at the same site.
bzr branch lp:onboard
Building from Source:
Find below short instructions on how to build Onboard straight from the
bazaar repository. If you have improvements to share, get errors or run
into other problems, please let us know. Build instructions for
new distributions are always welcome too.
Arch Linux:
pacman -S base-devel bzr python-distutils-extra dconf gtk3 \
libcanberra hunspell python-gobject gsettings-desktop-schemas \
iso-codes python-cairo librsvg python-dbus dbus-glib
bzr branch lp:onboard
cd onboard
./setup.py build
tools/install_gsettings_schema
# At this point you should be able to start Onboard
# from the project directory with
./onboard
# If everything works as expected, install with
sudo ./setup.py install
# And if necessary, uninstall with
sudo ./setup.py install --record files.txt
sudo xargs -a files.txt --delimiter='\n' rm -v
sudo rm -rf /usr/local/share/onboard
Mageia 4:
urpmi bzr gcc-c++ lib64zlib-devel python3-distutils-extra \
libgtk+3.0-devel libxtst-devel libxkbfile-devel libdconf-devel \
libhunspell-devel libcanberra-devel libpython3-devel intltool
# more or less optional, but recommended for full functionality
urpmi mousetweaks lib64atspi-gir2.0 at-spi2-core-qt \
python3-dbus qtatspi-plugin
bzr branch lp:onboard
cd onboard
./setup.py build
tools/install_gsettings_schema
# At this point you should be able to start Onboard
# from the project directory with
./onboard
# If everything works as expected, install with
su
./setup.py install
# And if necessary, uninstall with
su
./setup.py install --record files.txt
sudo xargs -a files.txt --delimiter='\n' rm -v
sudo rm -rf /usr/local/share/onboard
Ubuntu 14.04:
sudo apt-get build-dep onboard
sudo apt-get install devscripts
bzr branch lp:onboard
cd onboard
# build packages
debuild binary
# install packages
sudo dpkg -i ../onboard*.deb
Homepage:
https://launchpad.net/onboard
Reporting Bugs:
https://bugs.launchpad.net/onboard
License:
This program is released under the terms of the GNU General
Public License. Please see the file COPYING for details.
|