Update the changelog

Changes-By: lintian-brush
Fixes: lintian: installable-field-mirrors-source
See-also: https://lintian.debian.org/tags/installable-field-mirrors-source.html

Documentation/g15daemon_client_devel.3

@@ -55,7 +55,7 @@ Example:
 int retval = 0;
 int screen_fd = new_g15_screen( G15_WBMPBUF );
 
- ... do processing and display here ...
+... do processing and display here ...
 
 retval = g15_close_screen( screen_fd );
 

debian/NEWS.Debian

@@ -0,0 +1,8 @@
+g15daemon (1.9.5.3-3) unstable; urgency=low
+
+  * The default key to switch application is changes:
+    now we use L1 (round small key near the display, instead of MR key.
+    This will allow other application to use MR (i.e. g15macro).
+
+ -- Giacomo Catenazzi <cate@debian.org>  Mon, 28 Apr 2008 08:36:27 +0200
+

debian/README.Debian

@@ -4,7 +4,7 @@ g15daemon for Debian
 
 Debian 'xkeyboard-config' package already have support for g15
 keyboards, so you don't need to exec 'xmodmap' as described on
-original documentations.  Anywaym you should configure your
+original documentations.  Anyway you should configure your
 xorg.conf file, so that xorg will understand the extra keys.
 
 To have the full support of the extra keys, you should edit the

debian/changelog

@@ -1,3 +1,153 @@
+g15daemon (1.9.5.3-13) unstable; urgency=medium
+
+  * Move binaries to /usr.
+  * Trim trailing whitespace.
+  * Update standards version to 4.6.1, no changes needed.
+  * Remove field Section on binary package g15daemon that duplicates source.
+
+ -- Andrej Shadura <andrewsh@debian.org>  Sun, 26 Nov 2023 14:15:41 +0000
+
+g15daemon (1.9.5.3-12) unstable; urgency=medium
+
+  * Add -fcommon compiler flag for compatibility with GCC 10.
+    (Closes: bug#957243)
+  * Compliant to policy 4.5.0
+
+ -- Alexander Ponyatykh <lazyranma@gmail.com>  Tue, 28 Jul 2020 23:37:13 +0300
+
+g15daemon (1.9.5.3-11) unstable; urgency=medium
+
+  * Reinitialize on eny error code, not only on a negative one.
+  * Remove unused variables. (Closes: bug#688465)
+  * Compliant to policy 4.4.1
+
+ -- Alexander Ponyatykh <lazyranma@gmail.com>  Tue, 19 Nov 2019 00:50:44 +0300
+
+g15daemon (1.9.5.3-10) unstable; urgency=medium
+
+  * Rebuild (no source changes).
+
+ -- Andrej Shadura <andrewsh@debian.org>  Sat, 16 Nov 2019 19:25:13 +0100
+
+g15daemon (1.9.5.3-9) unstable; urgency=medium
+
+  [ Alexander Ponyatykh ]
+  * Reintroduce package. (Closes: bug#928158)
+  * Convert source to 3.0 (quilt) format.
+  * Migrate from cdbs to debhelper.
+  * Merge from Ubuntu:
+    - libg15daemon_client/g15daemon_net.c: Fix a potential buffer overflow.
+  * debian/patches/07-reinit-on-any-error.diff: reinitialize on any error
+    returned by libusb to correctly recover after suspend/resume. (LP: #1357556)
+  * /etc/init.d/g15daemon: overhaul.
+    - Replace /dev/input/uinput with /dev/uinput. (Closes: bug#687663).
+    - Use "udevadm settle" instead of polling /dev/uinput.
+    - Use log_*_msg functions instead of echo.
+    - Add dependency on $remote_fs.
+    - Remove bashism. (Closes: bug#772244)
+    - Return 0 exit code if the daemon fails to start.
+      (LP: #617101, LP: #1103275)
+    - Don't stop or restart on udev events, because g15daemon now properly
+      handles replugging.
+  * Remove build dependency on libusb.
+  * Remove dependency on libg15daemon-client1 for g15daemon.
+  * Add dependency on udev for g15daemon.
+  * Change priority of packages to optional.
+  * Add native systemd service. (LP: #1441365)
+  * /etc/default/g15daemon: remove SWITCH_KEY option to keep systemd service
+    file simple.
+  * Add subsystem check to udev matching rules.
+  * Multiarchify the library packages. (Closes: bug#812952)
+  * Do not install *.la files.
+  * Change package description. (Closes: bug#802652)
+
+  [ Andrej Shadura ]
+  * Wrap and sort.
+  * Use debhelper-compat instead of debian/compat.
+  * d/changelog: Remove trailing whitespaces.
+  * d/control: Add Vcs-* field.
+  * d/watch: Use https protocol.
+
+ -- Andrej Shadura <andrewsh@debian.org>  Sat, 19 Oct 2019 21:15:39 +0200
+
+g15daemon (1.9.5.3-8.3) unstable; urgency=medium
+
+  * Non-maintainer upload.
+  * debian/control: Drop unnecessary automake1.9 build deps. (Closes:
+    #724371)
+
+ -- Eric Dorland <eric@debian.org>  Tue, 04 Mar 2014 23:50:12 -0500
+
+g15daemon (1.9.5.3-8.2) unstable; urgency=low
+
+  * Non-maintainer upload.
+  * Use ATTR instead of SYSFS in udev rules (closes: #573434).
+  * Remove references to other libraries from dependency_libs field
+    (closes: #629592).
+
+ -- Luk Claes <luk@debian.org>  Tue, 31 May 2011 07:33:52 +0200
+
+g15daemon (1.9.5.3-8.1) unstable; urgency=low
+
+  * Non-maintainer upload.
+  * Send a sync event after key up/down (closes: #567213).
+
+ -- Julien Cristau <jcristau@debian.org>  Sun, 25 Jul 2010 11:39:22 +0200
+
+g15daemon (1.9.5.3-8) unstable; urgency=low
+
+  * Put the third argument (modes) on open with O_CREAT (Closes: #559649)
+  * remove rpath
+
+ -- Giacomo Catenazzi <cate@debian.org>  Fri, 18 Dec 2009 07:52:26 +0100
+
+g15daemon (1.9.5.3-7) unstable; urgency=low
+
+  * Change priority of libg15daemon-client1 from extra to optional
+    (mumble package needs it)
+
+ -- Giacomo Catenazzi <cate@debian.org>  Tue, 01 Sep 2009 19:50:38 +0200
+
+g15daemon (1.9.5.3-6) unstable; urgency=low
+
+  * Shared devices (lcd dispaly + audio) are not good handled
+    by udev script. Adding workaround until improving
+    programs to handle disconnections (Closes: #541780)
+  * Add debugging flag (and code) for init.d and udev scripts
+  * Change syslog facility: from user to daemon
+  * better (and more secure) screenshort creation in /tmp
+
+ -- Giacomo Catenazzi <cate@debian.org>  Wed, 19 Aug 2009 07:33:22 +0200
+
+g15daemon (1.9.5.3-5) unstable; urgency=low
+
+  * Handle keyboard device with udev, so detecting detachement
+    and attachment of keyboarda (Closes: #489978).
+  * init.d LSB header: try to start before xorg, to be able
+    to have full access to all extra keys.
+  * Recent libg15 corrected strange behaviour in new G15 keyboard
+    (Closes: #494180)
+
+ -- Giacomo Catenazzi <cate@debian.org>  Thu, 13 Aug 2009 08:20:02 +0200
+
+g15daemon (1.9.5.3-4) unstable; urgency=low
+
+  * Try to load uinput module, in order to have Gx key working
+    (Closes: #475000).
+  * Usual updates
+
+ -- Giacomo Catenazzi <cate@debian.org>  Thu, 06 Aug 2009 08:32:33 +0200
+
+g15daemon (1.9.5.3-3) unstable; urgency=low
+
+  * Changing default in /etc/default/g15daemon: Use L1 key instead of MR
+    as actual upstream default and allowing to use g15macro
+    (Closes: #478069)
+  * Removed the X11 setup on man page, because it is not relevant
+    to recent distributions and could confuse our users (Closes: #463078)
+
+ -- Giacomo Catenazzi <cate@debian.org>  Mon, 28 Apr 2008 08:47:07 +0200
+
 g15daemon (1.9.5.3-2) unstable; urgency=low
 
   * Recommend xkb-data instead of keyboard-config. Adapted patch from
@@ -6,7 +156,7 @@ g15daemon (1.9.5.3-2) unstable; urgency=low
  -- Giacomo Catenazzi <cate@debian.org>  Mon, 07 Apr 2008 19:56:34 +0200
 
 g15daemon (1.9.5.3-1) unstable; urgency=low
-  
+
   * New upstream version
 
  -- Giacomo Catenazzi <cate@debian.org>  Thu, 14 Feb 2008 08:08:03 +0100
@@ -49,7 +199,7 @@ g15daemon (1.9.0-wip.20070910-3) unstable; urgency=low
   * first try to make a debian/rules full working for
     svn and released version
   * fix directory fixes (closes: #442296)
-  
+
  -- Giacomo Catenazzi <cate@debian.org>  Fri, 14 Sep 2007 20:59:27 +0200
 
 g15daemon (1.9.0-wip.20070910-2) unstable; urgency=low
@@ -83,4 +233,3 @@ g15daemon (1.2.7-1) unstable; urgency=low
   * Initial release
 
  -- Giacomo Catenazzi <cate@debian.org>  Mon, 27 Aug 2007 20:00:20 +0200
-

debian/compat

@@ -1 +0,0 @@
-5

debian/control

@@ -1,35 +1,62 @@
 Source: g15daemon
 Section: utils
-Priority: extra
+Priority: optional
-Maintainer: Giacomo Catenazzi <cate@debian.org>
+Maintainer: Alexander Ponyatykh <lazyranma@gmail.com>
-Build-Depends: cdbs, debhelper (>= 5), autotools-dev, automake1.9, libtool,
+Uploaders:
- libg15-dev, libg15render-dev (>=1.2.0.svn250-2), libusb-dev, libfreetype6-dev
+ Andrej Shadura <andrewsh@debian.org>
-Standards-Version: 3.7.3
+Build-Depends:
-Homepage: http://www.g15tools.com/
+ debhelper-compat (= 12),
+ dh-sequence-movetousr,
+ libfreetype6-dev,
+ libg15-dev (>= 1.2.7-3),
+ libg15render-dev (>= 1.2.0.svn250-2),
+ libtool
+Standards-Version: 4.6.1
+Homepage: https://sourceforge.net/projects/g15daemon/
+Vcs-Browser: https://salsa.debian.org/debian/g15daemon
+Vcs-Git: https://salsa.debian.org/debian/g15daemon.git
 
 Package: g15daemon
-Section: utils
 Architecture: any
-Depends: ${shlibs:Depends}, libg15daemon-client1 (=${binary:Version})
+Pre-Depends:
-Recommends: xkb-data ( >= 0.9+cvs.20070428-1)
+ ${misc:Pre-Depends}
-Description:  Screen multiplexer for Logitech G15 Keyboard
+Depends:
+ libg15-1 (>= 1.2.7-3),
+ lsb-base (>= 4.1+Debian3),
+ udev,
+ ${misc:Depends},
+ ${shlibs:Depends}
+Recommends:
+ xkb-data (>=0.9+cvs.20070428-1)
+Description: LCD multiplexer for Logitech G15 Keyboard
  G15daemon provides multiple virtual screens for the LCD on the Logitech
- G11 and G15 keyboards.
+ G15 keyboard and Z10 speakers. It also allows the use of all additional
- .
+ keys of G11 and G15 keyboards, even if the kernel does not support them.
- This package contain the daemon and a generic client to talk to the
- daemon.
-
-Package: libg15daemon-client1
-Section: libs
-Architecture: any
-Depends: ${shlibs:Depends}
-Description: Development packages for libg15daemon-client
- Includes the files needed for developing g15daemon clients
 
 Package: libg15daemon-client-dev
 Section: libdevel
 Architecture: any
-Depends: libg15daemon-client1 (= ${binary:Version})
+Multi-Arch: same
-Description: Development packages for libg15daemon-client
+Depends:
- Includes the files needed for developing g15daemon clients
+ libg15daemon-client1 (= ${binary:Version}),
+ ${misc:Depends}
+Description: Development files for libg15daemon-client
+ The g15daemon client library allows applications to use LCD of the Logitech G15
+ keyboard or Z10 speakers under control of g15daemon.
+ .
+ This package provides the development files and static libraries.
 
+Package: libg15daemon-client1
+Section: libs
+Architecture: any
+Multi-Arch: same
+Pre-Depends:
+ ${misc:Pre-Depends}
+Depends:
+ ${misc:Depends},
+ ${shlibs:Depends}
+Description: Client library for communicating with g15daemon
+ The g15daemon client library allows applications to use LCD of the Logitech G15
+ keyboard or Z10 speakers under control of g15daemon.
+ .
+ This package provides the runtime files.

debian/copyright

@@ -3,7 +3,7 @@ Mon, 27 Aug 2007 20:00:20 +0200.
 
 It was downloaded from http://g15daemon.sourceforge.net/
 
-Upstream Authors: 
+Upstream Authors:
 
     Mike Lampard <mlampard@users.sf.net>
     Sven Ludwig
@@ -23,6 +23,6 @@ License:
 
 License can be found in the file `/usr/share/common-licenses/GPL-2'.
 
-The Debian packaging is (C) 2007, Giacomo Catenazzi <cate@debian.org> and
+The Debian packaging is (C) 2007, Giacomo Catenazzi <cate@debian.org>,
-is licensed under the GPL v2 (or later), see `/usr/share/common-licenses/GPL-2'.
+(C) 2019 Alexander Ponyatykh <lazyranma@gmail.com> and is licensed under
-
+the GPL v2 (or later), see `/usr/share/common-licenses/GPL-2'.

debian/g15daemon.default

@@ -1,12 +1,9 @@
 # Defaults for g15daemon initscript
 
-# SWITCH_KEY selects  the key used to switch between client screens
+# SWITCH_KEY option was removed. Use DAEMON_OPTS="-s" instead.
-#
-# SWITCH_KEY="MR"   to use the MR key (on top left)
-# SWITCH_KEY="L1    to use the L1 key: the small round key below the LCD
 
-
+# Turn on debugging of g15 init.d and udev scripts
-SWITCH_KEY="MR"
+#G15DEBUG="on"
 
 # Additional options that are passed to the Daemon.
 DAEMON_OPTS=""

debian/g15daemon.init

@@ -2,10 +2,11 @@
 
 ### BEGIN INIT INFO
 # Provides:          g15daemon
-# Required-Start:    $local_fs
+# Required-Start:    $syslog $local_fs $remote_fs
-# Required-Stop:     $local_fs
+# Required-Stop:     $syslog $local_fs $remote_fs
 # Should-Start:      $remote_fs
 # Should-Stop:       $remote_fs
+# X-Start-Before:    xdm kdm gdm ldm sdm
 # Default-Start:     2 3 4 5
 # Default-Stop:      0 1 6
 # Short-Description: load deamon for Logitech G15 keyboard lcd display
@@ -16,74 +17,109 @@
 PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
 DAEMON=/usr/sbin/g15daemon
 NAME=g15daemon
-DESC=g15daemon
+DESC="Logitech G15 keyboard LCD multiplexer"
 
-test -x $DAEMON || exit 0
+[ -x "$DAEMON" ] || exit 0
+
+. /lib/lsb/init-functions
 
 # Include g15daemon defaults if available
 if [ -f /etc/default/g15daemon ] ; then
-	. /etc/default/g15daemon
+    . /etc/default/g15daemon
 fi
 
-if [ "$SWITCH_KEY" = "MR" ]; then
+if [ "$G15DEBUG" = "on" ]; then
-	DAEMON_OPTS="-s $DAEMON_OPTS"
+
+log() {
+    logger -p daemon.debug -t g15 -- "$*"
+}
+else
+
+log() {
+    true
+}
+
 fi
 
-set -e
+check_new_init() {
+    if [ -d /run/systemd/system ] ; then
+        exit $1
+    fi
+}
+
+load_uinput() {
+    if [ ! -e /dev/uinput ] ; then
+        modprobe -q uinput
+        udevadm settle -t 5 -E /dev/uinput
+        [ -e /dev/uinput 3 ] || return 1
+    fi
+}
+
+is_running() {
+   start-stop-daemon --stop --test --quiet --pidfile \
+        /var/run/$NAME.pid --exec $DAEMON
+}
+
+do_start() {
+    start-stop-daemon --start --quiet --pidfile /var/run/$NAME.pid \
+        --exec $DAEMON -- $DAEMON_OPTS
+}
+
+do_stop() {
+    start-stop-daemon --stop --quiet --pidfile /var/run/$NAME.pid \
+        --oknodo --retry 5 --exec $DAEMON
+}
 
 case "$1" in
-  start)
+    start)
-	echo -n "Starting $DESC: "
+        log_daemon_msg "Starting $DESC" $NAME
-	start-stop-daemon --start --quiet --pidfile /var/run/$NAME.pid \
+        load_uinput || log_warning_msg "/dev/uinput not found"
-		--exec $DAEMON -- $DAEMON_OPTS
+        do_start
-	echo "$NAME."
+        log_end_msg $?
-	;;
+        ;;
-  stop)
+    stop)
-	echo -n "Stopping $DESC: "
+        log_daemon_msg "Stopping $DESC" $NAME
-	$DAEMON -k
+        if do_stop ; then
-	start-stop-daemon --stop --quiet --pidfile /var/run/$NAME.pid \
+            log_end_msg 0
-		--oknodo --retry 5 --exec $DAEMON
+        else
-	echo "$NAME."
+            log_end_msg 1
-	;;
+            exit 1
-  #reload)
+        fi
-	#
+        ;;
-	#	If the daemon can reload its config files on the fly
+    force-reload)
-	#	for example by sending it SIGHUP, do it here.
+        is_running && $0 restart || exit 0
-	#
+        ;;
-	#	If the daemon responds to changes in its config file
+    restart)
-	#	directly anyway, make this a do-nothing entry.
+        log_daemon_msg "Restarting $DESC" $NAME
-	#
+        if ! do_stop ; then
-	# echo "Reloading $DESC configuration files."
+            log_end_msg 1
-	# start-stop-daemon --stop --signal 1 --quiet --pidfile \
+            exit 1
-	#	/var/run/$NAME.pid --exec $DAEMON
+        fi
-  #;;
+        # the device is slow to shut-down
-  force-reload)
+        sleep 1
-	#
+        load_uinput || log_warning_msg "/dev/uinput not found"
-	#	If the "reload" option is implemented, move the "force-reload"
+        do_start
-	#	option to the "reload" entry above. If not, "force-reload" is
+        log_end_msg $?
-	#	just the same as "restart" except that it does nothing if the
+        ;;
-	#   daemon isn't already running.
+    status)
-	# check wether $DAEMON is running. If so, restart
+        is_running
-	start-stop-daemon --stop --test --quiet --pidfile \
+        exit $?
-		/var/run/$NAME.pid --exec $DAEMON \
+        ;;
-	&& $0 restart \
+    udev)
-	|| exit 0
+        check_new_init 0
-	;;
+        log "calling g15 udev; action: $ACTION, product $PRODUCT"
-  restart)
+        if [ "x$ACTION" = "xadd" ] ; then
-    echo -n "Restarting $DESC: "
+            # If g15daemon is running, it will handle replugging.
-	start-stop-daemon --stop --quiet --pidfile \
+            is_running && exit 0
-		/var/run/$NAME.pid --exec $DAEMON
+            load_uinput
-	sleep 1
+            do_start
-	start-stop-daemon --start --quiet --pidfile \
+        fi
-		/var/run/$NAME.pid --exec $DAEMON -- $DAEMON_OPTS
+        ;;
-	echo "$NAME."
+    *)
-	;;
+        N=/etc/init.d/$NAME
-  *)
+        log_action_msg "Usage: $N {start|stop|restart|force-reload|status}"
-	N=/etc/init.d/$NAME
+        exit 1
-	# echo "Usage: $N {start|stop|restart|reload|force-reload}" >&2
+        ;;
-	echo "Usage: $N {start|stop|restart|force-reload}" >&2
-	exit 1
-	;;
 esac
 
 exit 0

debian/g15daemon.install

@@ -1,4 +1,3 @@
-debian/tmp/usr/sbin/g15daemon usr/sbin
+debian/tmp/usr/lib/*/g15daemon/*/plugins/*.so
-debian/tmp/usr/lib/g15daemon/1.9.5.3/plugins/*.so	usr/lib/g15daemon/1.9.5.3/plugins/
+debian/tmp/usr/sbin/g15daemon
-debian/tmp/usr/share/g15daemon/splash/g15logo2.wbmp	usr/share/g15daemon/splash/
+debian/tmp/usr/share/g15daemon/splash/g15logo2.wbmp
-

debian/g15daemon.service

@@ -0,0 +1,12 @@
+[Unit]
+Description=Logitech G15 keyboard LCD multiplexer
+Documentation=man:g15daemon(1)
+Wants=remote-fs.target
+After=remote-fs.target
+
+[Service]
+Type=forking
+EnvironmentFile=-/etc/default/g15daemon
+ExecStartPre=-/sbin/modprobe -q uinput
+ExecStartPre=-/sbin/udevadm settle -t 5 -E /dev/uinput
+ExecStart=/usr/sbin/g15daemon $DAEMON_OPTS

debian/g15daemon.udev

@@ -0,0 +1,19 @@
+# udev rule to start g15daemon when logitech g15 keyboards are attached
+#
+# Recognized devices from libg15-1.2.7/libg15.c
+#
+
+# Logitech g11 -- extra keys, no LCD
+SUBSYSTEM=="usb", ATTR{idVendor}=="046d", ATTR{idProduct}=="c225", RUN+="/etc/init.d/g15daemon udev", TAG+="systemd",ENV{SYSTEMD_WANTS}+="g15daemon.service"
+
+# Logitech G15 (blue) -- extra keys and LCD
+SUBSYSTEM=="usb", ATTR{idVendor}=="046d", ATTR{idProduct}=="c222", RUN+="/etc/init.d/g15daemon udev", TAG+="systemd", ENV{SYSTEMD_WANTS}+="g15daemon.service"
+
+# Logitech G15 v2 (orange) -- extra keys and LCD
+SUBSYSTEM=="usb", ATTR{idVendor}=="046d", ATTR{idProduct}=="c227", RUN+="/etc/init.d/g15daemon udev", TAG+="systemd", ENV{SYSTEMD_WANTS}+="g15daemon.service"
+
+# Logitech Z10 -- extra keys and LCD
+SUBSYSTEM=="usb", ATTR{idVendor}=="046d", ATTR{idProduct}=="0a07", RUN+="/etc/init.d/g15daemon udev", TAG+="systemd", ENV{SYSTEMD_WANTS}+="g15daemon.service"
+
+# Logitech G15 Gamepanel -- extra keys and LCD
+SUBSYSTEM=="usb", ATTR{idVendor}=="046d", ATTR{idProduct}=="c251", RUN+="/etc/init.d/g15daemon udev", TAG+="systemd", ENV{SYSTEMD_WANTS}+="g15daemon.service"

debian/libg15daemon-client-dev.install

@@ -1,5 +1,3 @@
-debian/tmp/usr/include/* usr/include/
+debian/tmp/usr/include/*
-debian/tmp/usr/lib/lib*.a usr/lib/
+debian/tmp/usr/lib/*/lib*.a
-debian/tmp/usr/lib/lib*.so usr/lib/
+debian/tmp/usr/lib/*/lib*.so
-debian/tmp/usr/lib/*.la usr/lib/
-

debian/libg15daemon-client.install

@@ -1 +1 @@
-usr/lib/lib*.so.*
+usr/lib/*/lib*.so.*

debian/libg15daemon-client1.install

@@ -1 +1 @@
-debian/tmp/usr/lib/lib*.so.* usr/lib/
+debian/tmp/usr/lib/*/lib*.so.*

debian/patches/01-remove-x11-setup-from-man.diff

@@ -0,0 +1,127 @@
+--- a/Documentation/g15daemon.1
++++ b/Documentation/g15daemon.1
+@@ -37,113 +37,6 @@
+ If all required libraries are installed and in locations known to your operating system, the daemon will slip quietly into the background and a clock will appear on the LCD.  
+ Congratulations!  The linux kernel will now output keycodes for all your extra keys.
+ 
+-.SH "Using the keys in X11"
+-Current versions of the Xorg Xserver dont have support for the extra keys that g15daemon provides.  This support will be available in the next release of Xorg (7.2).
+-
+-For now, if you want access to the extra keys for hotkey support in X11, you need to run the xmodmaprc script on each start of X.  This script is available in the contrib folder (if g15daemon is installed in the default location, the contrib folder is in /usr/share/doc/g15daemon\-${VERSION}/contrib 
+-
+-Depending on your linux distribution, copying the xmodmaprc file (or pasting the text below) into ~/.Xmodmap may be all that's required.
+-
+-.SH "Xmodmaprc file"
+-Copy the following into ~/.Xmodmap (depending on your distribution) for X11 to recognise all extra G15 keys:
+-
+-\-\- cut here \-\-
+-.br
+-keycode  93 = XF86Launch1
+-.br
+-keycode 129 = XF86Launch8
+-.br
+-keycode 130 = XF86Launch9
+-.br
+-keycode 131 = XF86Launch2
+-.br
+-keycode 132 = XF86Phone
+-.br
+-keycode 133 = XF86Messenger
+-.br
+-keycode 136 = XF86LaunchD
+-.br
+-keycode 137 = XF86Support
+-.br
+-keycode 138 = XF86Word
+-.br
+-keycode 143 = XF86LaunchF
+-.br
+-keycode 144 = XF86AudioPrev
+-.br
+-keycode 150 = XF86LogOff
+-.br
+-keycode 152 = XF86Launch5
+-.br
+-keycode 153 = XF86AudioNext
+-.br
+-keycode 160 = XF86AudioMute
+-.br
+-keycode 161 = XF86Travel
+-.br
+-keycode 162 = XF86AudioPlay
+-.br
+-keycode 163 = XF86Spell
+-.br
+-keycode 164 = XF86AudioStop
+-.br
+-keycode 170 = XF86VendorHome
+-.br
+-keycode 174 = XF86AudioLowerVolume
+-.br
+-keycode 176 = XF86AudioRaiseVolume
+-.br
+-keycode 177 = XF86Launch4
+-.br
+-keycode 178 = XF86HomePage
+-.br
+-keycode 182 = XF86Away
+-.br
+-keycode 183 = XF86WebCam
+-.br
+-keycode 184 = XF86Launch0
+-.br
+-keycode 188 = XF86Music
+-.br
+-keycode 190 = XF86Launch6
+-.br
+-keycode 194 = XF86Forward
+-.br
+-keycode 195 = XF86Send
+-.br
+-keycode 205 = XF86Calendar
+-.br
+-keycode 208 = XF86Launch7
+-.br
+-keycode 209 = XF86LaunchB
+-.br
+-keycode 210 = XF86LaunchC
+-.br
+-keycode 215 = XF86Save
+-.br
+-keycode 219 = XF86WWW
+-.br
+-keycode 220 = XF86LaunchE
+-.br
+-keycode 223 = XF86Sleep
+-.br
+-keycode 228 = XF86Pictures
+-.br
+-keycode 231 = XF86LaunchA
+-.br
+-keycode 236 = XF86Mail
+-.br
+-keycode 237 = XF86AudioMedia
+-.br
+-keycode 246 = XF86iTouch
+-.br
+-keycode 247 = XF86Launch3
+-.br
+-keycode 249 = XF86ToDoList
+-.br
+-keycode 251 = XF86Calculater
+-.br
+-\-\- end cutting \-\-
+ .SH "AUTHORS"
+ The latest release of g15daemon is available at
+ .P
+--- a/Documentation/g15daemon_client_devel.3
++++ b/Documentation/g15daemon_client_devel.3
+@@ -55,7 +55,7 @@
+ int retval = 0;
+ int screen_fd = new_g15_screen( G15_WBMPBUF );
+ 
+-... do processing and display here ...
++ ... do processing and display here ...
+ 
+ retval = g15_close_screen( screen_fd );
+ 

debian/patches/02-better-screenshort-creation.diff

@@ -0,0 +1,39 @@
+--- a/g15daemon/utility_funcs.c
++++ b/g15daemon/utility_funcs.c
+@@ -666,12 +666,24 @@
+ }
+ 
+ int uf_screendump_pbm(unsigned char *buffer,char *filename) {
++    int fd;
+     FILE *f;
+     int x,y;
+     #define WIDTH 40
+     g15canvas *canvas=g15daemon_xmalloc(sizeof(g15canvas));
+     memcpy(canvas->buffer,buffer,LCD_BUFSIZE);
+-    f = fopen(filename,"w+");
++    fd = open(filename, O_CREAT|O_EXCL|O_WRONLY, S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH);
++    if(fd == -1) {
++       g15daemon_log(LOG_WARNING, "uf_screendump_pbm failed: open, %s.\n", strerror(errno));
++       return -1;
++    }
++    f = fdopen(fd,"w");
++    if(f==NULL) {
++       close(fd);
++        g15daemon_log(LOG_WARNING, "uf_screendump_pbm failed: fdopen, %s.\n", strerror(errno));
++        return -1;
++    }
++
+     fprintf(f,"P1\n160 43\n");
+     fprintf(f,"# G15 screendump - %s\n\n",filename);
+     for(y=0;y<43;y++)
+@@ -681,7 +693,9 @@
+               fprintf(f,"\n");
+         }
+ 
+-        fclose(f);
++    fclose(f);
++    fsync(fd);
++    close(fd);
+     free(canvas);
+     return 0;
+ }

debian/patches/03-change-syslog-facility.diff

@@ -0,0 +1,11 @@
+--- a/g15daemon/main.c
++++ b/g15daemon/main.c
+@@ -456,7 +456,7 @@
+         struct passwd *nobody;
+         unsigned char location[1024];
+ 
+-        openlog("g15daemon", LOG_PID, LOG_USER);
++        openlog("g15daemon", LOG_PID, LOG_DAEMON);
+         if(strlen((char*)user)==0){
+             nobody = getpwnam("nobody");
+         }else {

debian/patches/04-open-needs-mode.diff

@@ -0,0 +1,11 @@
+--- a/g15daemon/utility_funcs.c
++++ b/g15daemon/utility_funcs.c
+@@ -356,7 +356,7 @@
+     config_items_t * item=NULL;
+     char line[1024];
+     
+-    config_fd = open(filename,O_CREAT|O_RDWR|O_TRUNC);
++    config_fd = open(filename,O_CREAT|O_RDWR|O_TRUNC, 0644);
+     if(config_fd){
+     snprintf(line,1024,"# G15Daemon Configuration File\n# any items entered before a [section] header\n# will be in the Global config space\n# comments you wish to keep should start with a semicolon';'\n");
+     write(config_fd,line,strlen(line));

debian/patches/05-send-a-sync-event-after-key-up-down.diff

@@ -0,0 +1,30 @@
+--- a/plugins/g15_plugin_uinput.c
++++ b/plugins/g15_plugin_uinput.c
+@@ -125,6 +125,13 @@
+     event.value = G15KEY_DOWN;
+     
+     write (uinp_fd, &event, sizeof(event));
++
++    memset(&event, 0, sizeof(event));
++
++    event.type = EV_SYN;
++    event.code = SYN_REPORT;
++
++    write (uinp_fd, &event, sizeof(event));
+ }
+ 
+ static void g15_uinput_keyup(unsigned char code)
+@@ -137,6 +144,13 @@
+     event.value = G15KEY_UP;
+     
+     write (uinp_fd, &event, sizeof(event));
++
++    memset(&event, 0, sizeof(event));
++
++    event.type = EV_SYN;
++    event.code = SYN_REPORT;
++
++    write (uinp_fd, &event, sizeof(event));
+ }
+ 
+     void (*keyup)(unsigned char code) = &g15_uinput_keyup;

debian/patches/06-fix-buffer-overflow.diff

@@ -0,0 +1,11 @@
+--- a/libg15daemon_client/g15daemon_net.c
++++ b/libg15daemon_client/g15daemon_net.c
+@@ -217,7 +217,7 @@
+     if(poll(pfd,1,100)>0){
+        if(pfd[0].revents & POLLPRI && !(pfd[0].revents & POLLERR || pfd[0].revents & POLLHUP || pfd[0].revents & POLLNVAL)) { 
+              memset(packet,0,sizeof(packet));
+-             msgret = recv(sock, packet, 10 , MSG_OOB);
++             msgret = recv(sock, packet, sizeof(packet) , MSG_OOB);
+              if (msgret < 1) {
+                   return -1;
+               }

debian/patches/07-reinit-on-any-error.diff

@@ -0,0 +1,23 @@
+Description: Reinitialize on any libusb error.
+ This allows g15daemon to correctly recover after suspend/resume.
+Author: Alexander Ponyatykh <lazyranma@gmail.com>
+Bug-Ubuntu: https://bugs.launchpad.net/ubuntu/+source/libusb/+bug/1357556
+Forwarded: no
+Last-Update: 2019-11-17
+===================================================================
+--- a/g15daemon/main.c
++++ b/g15daemon/main.c
+@@ -203,11 +203,10 @@
+             g15daemon_send_event(masterlist->current->lcd, 
+                                  G15_EVENT_KEYPRESS, keypresses);
+             lastkeys = keypresses;
+-
+-        }else if(retval == -ENODEV && LIBG15_VERSION>=1200) {
++        }else if(retval != G15_NO_ERROR && retval != G15_ERROR_TIMEOUT && LIBG15_VERSION>=1200) {
++          g15daemon_log(LOG_WARNING,"Keyboard error (%d).. Reinitializing\n", retval);
+           pthread_mutex_lock(&g15lib_mutex);
+           while((retval=re_initLibG15() != G15_NO_ERROR) && !leaving){
+-             g15daemon_log(LOG_WARNING,"Keyboard has gone.. Retrying\n");
+              sleep(1);
+           }
+           if(!leaving) { 

debian/patches/08-remove-unused-variables.diff

@@ -0,0 +1,44 @@
+Description: Remove unused variables
+ Global variable keyhandler is declared as pointer to incomplete struct type.
+ Upon closer inspection, it turned out that this variable and
+ client_handles_keys are unused.
+Author: Alexander Ponyatykh <lazyranma@gmail.com>
+Bug-Debian: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=688465
+Last-Update: 2019-11-18
+===================================================================
+--- a/g15daemon/linked_lists.c
++++ b/g15daemon/linked_lists.c
+@@ -30,8 +30,6 @@
+ #include <g15daemon.h>
+ #include <libg15.h>
+ 
+-extern lcd_t *keyhandler;
+-extern unsigned int client_handles_keys;
+ extern plugin_info_t *generic_info;
+ 
+ lcd_t static * ll_create_lcd () {
+@@ -175,12 +173,6 @@
+         (*masterlist)->current->lcd->state_changed = 1;
+     }
+     
+-    if(&oldnode->lcd == (void*)keyhandler) {
+-        client_handles_keys = 0;
+-        keyhandler = NULL;
+-        g15daemon_log(LOG_WARNING,"Client key handler quit, going back to defaults");
+-    }
+-    
+     if((*masterlist)->head!=oldnode){
+         (*next)->prev = oldnode->prev;
+         (*prev)->next = oldnode->next;
+--- a/g15daemon/main.c
++++ b/g15daemon/main.c
+@@ -53,9 +53,7 @@
+ int keyboard_backlight_off_onexit = 0;
+ unsigned int g15daemon_debug = 0;
+ unsigned int cycle_key;
+-unsigned int client_handles_keys = 0;
+ static unsigned int set_backlight = 0;
+-struct lcd_t *keyhandler = NULL;
+ 
+ static int loaded_plugins = 0;
+ 

debian/patches/series

@@ -0,0 +1,8 @@
+01-remove-x11-setup-from-man.diff
+02-better-screenshort-creation.diff
+03-change-syslog-facility.diff
+04-open-needs-mode.diff
+05-send-a-sync-event-after-key-up-down.diff
+06-fix-buffer-overflow.diff
+07-reinit-on-any-error.diff
+08-remove-unused-variables.diff

debian/postinst

@@ -0,0 +1,14 @@
+#!/bin/sh
+set -e
+
+#DEBHELPER#
+
+#g15daemon.service is normally pulled by udev events at boot time or after
+#plugging in a device, and deb-systemd-invoke refuses to start a static service,
+#so force it to start using invoke-rc.d
+
+if [ -d /run/systemd/system ] && [ -z "$2" ] && ( [ "$1" = "configure" ] \
+		|| [ "$1" = "abort-remove" ] ) ; then
+	invoke-rc.d g15daemon start >/dev/null || true
+fi
+

debian/rules

@@ -1,28 +1,10 @@
 #!/usr/bin/make -f
 
-# for SVN versions
+DH_VERBOSE = 1
-AUTOMAKE_REMOVE := Makefile Makefile.in */Makefile */Makefile.in configure aclocal.m4
+export DEB_CFLAGS_MAINT_APPEND = -fcommon
-AUTOMAKE_REMOVE += *.lo *.o *.la */*.lo */*.o */*.la
-AUTOMAKE_REMOVE += g15daemon/g15daemon g15daemon/g15daemontest
-AUTOMAKE_REMOVE += config.status config.log config.h config.h.in config/* libtool stamp-h1
-AUTOMAKE_REMOVE += */.libs/
 
-#clean::
+%:
-#	-rm -Rf $(AUTOMAKE_REMOVE)
+	dh $@
-
-#makebuilddir:: Makefile
-
-
-#Makefile:: Makefile.am autogen.sh
-#	[ -d config ] || mkdir config
-#	aclocal -I config
-#	libtoolize --automake --force --copy
-#	autoheader
-#	automake --add-missing --copy
-#	autoconf
-
-include /usr/share/cdbs/1/rules/debhelper.mk
-include /usr/share/cdbs/1/class/autotools.mk
-
-DEB_CONFIGURE_EXTRA_FLAGS = --quiet
 
+override_dh_installsystemd:
+	dh_installsystemd --no-start

debian/source/format

@@ -0,0 +1 @@
+3.0 (quilt)

debian/watch

@@ -3,5 +3,5 @@
 # Compulsory line, this is a version 3 file
 version=3
 
-http://sf.net/g15daemon/g15daemon-([1-9].*)\.tar\.gz
+https://sf.net/g15daemon/g15daemon-([1-9].*)\.tar\.gz