A GNU/Linux-friendly version of the Wacom Inkling SketchManager.
C Python Other
Latest commit f1c04c4 May 9, 2016 @roelj Properly handle the return value of libusb_claim_interface.
This bug was found by the user and contributor known as pi.
Permalink
Failed to load latest commit information.
doc Version bump in the Doxygen file. Oct 2, 2014
res Inkscape extension: refactor import options dialog. Dec 7, 2014
src
.gitignore Keep the Git project directory clean by excluding image file types. Aug 24, 2015
AUTHORS Updated AUTHORS and ChangeLog files. Apr 29, 2014
COPYING Autoconf/Automake support. A few things have changed: Apr 23, 2014
ChangeLog Updated ChangeLog. Apr 29, 2014
INSTALL
Makefile.am
NEWS
README
README.md
TODO.org
configure.ac Added the beginnings for "online-mode". Nov 9, 2014

README.md

GNU InklingReader

This GNU project is an attempt to create a GNU/Linux-friendly version of the Wacom Inkling SketchManager. Instead of integrating with proprietary programs, this program aims to be compatible with free software alternatives like Inkscape.

The program can:

  • Display WPI files
  • Merge WPI files (command-line only)
  • Export to Inkscape SVG (preserving layers), PDF, PNG and JSON
  • Convert all WPI files in a directory to SVG
  • Automatically assign colors upon pressing the "new layer" multiple times
  • Give control over stroke pressure
  • Export timing information in JSON
  • Interact with the timeline of your drawing
  • Use the Wacom Inkling as a mouse device

Integration with Inkscape

There's an Inkscape extension available that allows you to open WPI files with Inkscape "directly". The extension uses InklingReader to convert the WPI format to SVG in the background.

Installing the extension is quite easy. Copy the files in res/inkscape-extension to your Inkscape extension directory. On GNU/Linux that is:

~/.config/inkscape/extensions/

Online-mode

The online-mode feature (use the Wacom Inkling as a mouse device) is in a rough shape at the moment. It only works for GNU/Linux because it uses the uinput kernel module. To enable it, you need super user rights (root) to be able to activate the online-mode of the device and to create a virtual mouse device.

Enabling it can be done with the following commands:

su -                # Become a super user
modprobe uinput     # Make sure the uinput kernel module is loaded.
./inklingreader -j  # Start the program with the option to enable online-mode.

Screenshot

InklingReader screenshot

Dependencies

Make sure you have the following libraries, development packages and build tools installed:

  • GCC or CLANG
  • Automake
  • Autoconf
  • Make
  • GTK+ (3.10 or later)
  • librsvg-2.0
  • libusb 1.0

Build instructions

When you have resolved the dependencies listed above you can build the program by running:

autoreconf -i
./configure
make

To compile with CLANG:

autoreconf -i
./configure CC=clang
make

Additionally you can add compiler flags:

autoreconf -i
./configure CFLAGS="-Wall -O2 -march=native"
make

Optionally you can generate developer documentation using Doxygen.

cd doc/
doxygen

Tested distributions

The software is known to run on:

  • Debian 7.x
  • CrunchBang Linux 11
  • Fedora 20 or later
  • Mageia 4
  • Ubuntu 14.04 or later
  • Mac OS X 10.7.5, clang (based on LLVM 3.1svn)
  • Windows 8.1 (with MinGW and GTK 32-bit all-in-one bundle)

Since the program uses only widely available libraries it should run OK on almost every GNU/Linux distribution. If you have problems getting it to work on yours, let us know.

Contributing

InklingReader can use help! If you're interested in helping, here's a list of things you could do:

  • Package InklingReader for any distribution
  • Request and/or implement features

Contact

You can join the bug-inklingreader -at- gnu.org mailing list to report bugs.

For general discussion, use the inklingreader-discuss -at- gnu.org mailing list.

License

This project's code and the graphics in the "res/" folder are licensed under the GPLv3 or any later version.