Skip to content
krisjans edited this page May 8, 2012 · 17 revisions

Welcome to the LibreScribe wiki! LibreScribe is an effort to create an easy-to-use and feature complete LiveScribe desktop client replacement for the Linux operating system. A large portion of the code in LibreScribe is based off of libsmartpen (https://github.com/srwalter/libsmartpen), by Steven Walter. This project is licensed under version 2 of the GNU General Public License.

Development Environment Setup (Ubuntu Linux; Debian instructions should be similar)

In order to build LibreScribe, you will need several packages installed. At the moment, this list is somewhat overkill, in order to ensure that all of the necessary dependencies are installed. This list may be missing a few dependencies, or contain unnecessary dependencies. Feel free to improve it if you can.

To install the necessary software so that you can build and develop LibreScribe, open a terminal and enter

sudo apt-get install build-essential codeblocks codeblocks-contrib libwxbase2.8-dbg libwxbase2.8-dev libwxgtk2.8-dbg libwxgtk2.8-dev wx2.8-headers wx-common wxformbuilder libopenobex1-dev libglib2.0-0-dbg eglibc-source libudev-dev libusb-dev libusb++-dev libusb-1.0-0-dev libxml.* libgtk2.0-dev libgnome2-dev git libwxsmithlib0 libtool autogen python-dev automake

Once you install all of those files, you will want to create a symbolic link to set the default version of wxWidgets to 2.8.

cd /usr/include

sudo ln -sv wx-2.8/wx wx

You're almost ready to work! First, change back to the directory you want your project to be in, such as your home directory.

cd $HOME

Finally, once you are in the directory where you want to have your LibreScribe files, clone the git repository.

git clone git://github.com/aliendude5300/LibreScribe.git

You should be able to build and run the project using Code::Blocks.

Configure USB access

On most Linux systems non-standard USB devices are not accessible for regular user. Simple work around to this problem is to run Librescrive with sudo:

sudo ./Librescribe

But more elegant solution is available: write udev rule to change access rights for LiveScribe usb devices.

You can create generic udev rule file to match all LiveScribe products:

sudo gedit /lib/udev/rules.d/50-livescribe.rules

Copy following text into that file:

#LiveScribe usb pen
SUBSYSTEM=="usb", ATTR{idVendor}=="1cfb", MODE="0666", GROUP="plugdev"

Save the file. Some systems require reboot for the new rule to take effect.

Note: I tested this udev rule file on Ubuntu 12.04 LTS 64bit system.

p.s. For more "clean" udev rules file see https://github.com/srwalter/libsmartpen/blob/master/75-smartpen.rules . This file list exact product IDs instead of just vendor ID.