Free user-space driver for 6-dof space-mice.

Go to file

David Lister 812f15e823 LSBized the init script to prevent a possible error by leaving it at default		2018-11-08 16:58:50 -05:00
contrib	added contrib directory for unmaintained 3rd party contributions, starting with	2012-11-05 12:08:01 +00:00
doc	- Better example-spnavrc descriptions	2015-02-12 16:07:47 +00:00
src	- fixed github issue #4 : added a blacklist for USB device matching, and	2018-10-28 02:42:46 +03:00
.gitignore	.gitignore	2018-08-21 05:36:46 +03:00
AUTHORS	minor cleanup	2018-08-20 23:45:19 +00:00
COPYING	initial import of the daemon	2007-07-02 22:03:28 +00:00
Makefile.in	Applied Wiedemann's patch (sf#6) to link object files in alphabetical order	2017-05-27 06:50:36 +00:00
README.md	updated readme file	2018-08-22 11:42:58 +03:00
configure	replaced the svn $rev$ substitution with git describe falling back to git rev-parse HEAD	2018-08-21 05:46:28 +03:00
init_script	LSBized the init script to prevent a possible error by leaving it at default	2018-11-08 16:58:50 -05:00
setup_init	- Applied G.Dimitropoulos' fix for setup_init, which would fail to detect the	2011-03-07 03:13:02 +00:00
spacenavd.sln	adding initial win32 build files and service test. will have a long way to go before a completed win32 release is ready	2013-07-11 17:59:25 +00:00
spacenavd.vcproj	adding initial win32 build files and service test. will have a long way to go before a completed win32 release is ready	2013-07-11 17:59:25 +00:00
spnavd_ctl	- forgot to update the spnavd_ctl script to use the new pid location, this will	2009-02-02 02:11:10 +00:00

README.md

spacenavd

About

Spacenavd is a free software user-space driver (daemon), for 6-dof input devices, like 3Dconnexion's space-mice. It's compatible with the original 3dxsrv proprietary daemon provided by 3Dconnexion, and works as a drop-in replacement with any program that was written for the 3Dconnexion driver, but also provides an improved communication mechanism for programs designed specifically to work with spacenavd.

For more info on the spacenav project, visit: http://spacenav.sourceforge.net

License

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

Dependencies

In order to compile the spacenavd daemon, you'll need the following:

GNU C Compiler
GNU make
Xlib headers (optional)

You can compile the daemon without Xlib, but it won't be compatible with applications that where written for the original proprietary 3Dconnexion driver (e.g. maya, houdini, etc). The 3dxsrv compatibility interface needs to communicate with clients through the X window system. Programs designed to work with the alternative spacenavd-specific interface however (e.g. blender) will work fine even when spacenavd is built without X11 support.

Installation

If you have the dependencies installed, just run ./configure and then make to compile the daemon, and then make install, to install it.The default installation prefix is /usr/local. If you wish to install somewhere else, you may pass --prefix=/whatever to the configure script.

Running spacenavd

Spacenavd is designed to run during startup as a system daemon.

If your system uses SysV init, then you may run setup_init as root, to install the spacenavd init script, and have spacenavd start automatically during startup. To start the daemon right after installing it, without having to reboot your system, just type /etc/init.d/spacenavd start as root.

If your system uses BSD init or some other init system, then you'll have to follow your init documentation to set this up yourself. You may be able to use the provided init_script file as a starting point.

For systems running systemd, there is a spacenavd.service file under contrib/systemd. Follow your system documentation for how to use it.

Configuration

The spacenavd daemon reads a number of options from /etc/spnavrc. If that file doesn't exist, then it will use default values for everything. An example configuration file is included in the doc subdirectory, which you may copy to /etc and tweak.

You may use the graphical spnavcfg program to interactively set any of these options, which will create the spnavrc file for you, and automatically notify the daemon to re-read it.

Troubleshooting

If you're having trouble running spacenavd, read the up to date FAQ on the spacenav website: http://spacenav.sourceforge.net/faq.html

If you're still having trouble, send a description of your problem to the spacenav-users mailing list: spacenav-users@lists.sourceforge.net along with a copy of your /var/log/spnavd.log and any other relevant information.

If you have encountered a bug, please file a bug report in our bug tracking system: https://sourceforge.net/p/spacenav/bugs/