Spacenav interactive configuration GUI

Go to file

John Tsiombikas 7aa100d778 nuklear UI layout is annoying		2022-03-18 17:38:02 +02:00
icons	device pictures	2022-03-17 05:58:37 +02:00
src	nuklear UI layout is annoying	2022-03-18 17:38:02 +02:00
.gitattributes	- added new interactive GUI config program for spacenavd	2008-04-07 08:37:52 +00:00
.gitignore	missed one file	2022-03-14 07:36:56 +02:00
COPYING	forgot to add the GPLv3 license text to spnavcfg	2008-04-09 09:05:24 +00:00
Makefile.in	device pictures	2022-03-17 05:58:37 +02:00
README.md	device pictures	2022-03-17 05:58:37 +02:00
configure	started converting GUI to use the new protocol	2022-02-15 20:45:18 +02:00

README.md

spnavcfg

About

Spacenav daemon interactive configuration program.

SECURITY NOTICE: spnavcfg, from version 0.4 and onwards, no longer needs to be installed setuid-root. Read the "Compatibility" section below for details.

Compatibility

The current version of spnavcfg works with spacenavd v0.9 or higher (requires a spacenavd which speaks the spnav protocol v1).

This break in compatibility is necessary because the new protocol allows spnavcfg to act as a regular libspnav client and send configuration commands through the spacenavd socket, instead of having to modify /etc/spnavrc and send SIGHUP to the daemon, as was the old mode of operation.

This is a huge security improvement, as it makes it no longer necessary to install spnavcfg as setuid-root, and frankly much less clunky and error-prone. Plus it opens the way for a new and improved GUI with much more functionality and user feedback.

Therefore, you are advised to update your spacenavd to the latest version if at all possible. If you can't update spacenavd, the last version of spnavcfg which will work with older versions of the daemon is 0.3.1.

Installation

First make sure to install all dependencies:

OpenGL
freeglut: http://freeglut.sourceforge.net
libspnav v0.4 or later: https://github.com/FreeSpacenav/libspnav
libimago v2 or later: https://github.com/jtsiomb/libimago

Your system's package manager will probably have most of these dependencies available, so look there first if you don't feel like building everything from source. For debian derived systems make sure to install the corresponding -dev packages.

To build just type ./configure, make, and make install as usual. The make install part will probably need to be executed as root, if you're installing system-wide.

For build options, see ./configure --help.

License

This program is free software. Feel free to use, modify, and/or redistribute it under the terms of the GNU General Public License version 3, or (at your option) any later version published by the Free Software Foundation. See COPYING for details.