I am a Gentoo user with a Logitech G19 keyboard, and I have created a personal overlay containing ebuilds for the Gnome15 packages. After a while I thought others might benefit from the same set of ebuilds, so here they are.
Since I am only using a limited set of features, I expect others will get into some problems. Please report such problems in the Issues section of the Github project. Contributions are also welcome.
You will need to install layman according to the Gentoo Overlay Guide
http://www.gentoo.org/proj/en/overlays/userguide.xml
After having layman installed edit its configuration in /etc/layman/layman.cfg to add this overlay to it's list of known overlays.
overlays : http://www.gentoo.org/proj/en/overlays/repositories.xml
https://github.com/CMoH/gnome15-overlay/raw/master/overlay.xml
Next sync layman and add the gnome15 overlay
layman -S
layman -a gnome15
For systems following the Gentoo stable branch you'll need to accept the gnome15 package and some of its depdendencies. For convenience, the overlay contains a list of needed packages:
mkdir -p /etc/portage/package.keywords
cd /etc/portage/package.keywords
ln -s /var/lib/layman/gnome15/Documentation/package.keywords/gnome15-stable .
The packages are designed for arches amd64 and x86. If you find they work on other arches as well, please submit an issue.
The ebuild you are interested in is app-misc/gnome15. Upgrades from <gnome15-0.9.6 should work seamlessly, and portage should properly replace virtual/gnome15 with app-misc/gnome15. If not, please report the problems.
The following use-flags affect the installed drivers:
When using the kernel module, udev should assign the input devices to the plugdev group, and the framebuffers to the video group. Without the kernel module only the input devices will be visible in /dev, within the plugdev group.
Other use-flags used by the package are system use-flags, with the following notes:
Note: gnome15-0.9.6 was moved to the unstable branch (~amd64 and ~x86), since portage requires that stable packages should not DEPEND/RDEPEND on unstable packages. Some of the dependencies needed by gnome15 are marked as unstable in the official Gentoo portage tree, thus propagating up to app-misc/gnome15.
Before gnome15-0.9.6, the application was split into multiple packages. Those ebuilds will be present on the gnome15-0.9.5 branch, and they will be removed from the master branch shortly.
The core of gnome15 is in the gnome15-core ebuild, while other packages depend on it. You can also install packages by hand, or use the virtual/gnome15 ebuild.
Here are the use-flags and their relevance for virtual/gnome15:
Notes: the ayatana use flag is masked by gentoo. Also, there are no packages for the indicator framework, so currently this flag is not properly implemented in my ebuilds either.
I am unsure if the necessary modules are auto-loaded by the kernel, so for safety you should add the appropriate hid-gXX
module to your /etc/conf.d/modules
as instructed by the Gentoo Handbook.
By default, the kernel has a catch-all hid driver, named generic-usb in kernels before 3.5.0, and lately it seems to be called hid-generic. The rebind
script from the lg4l-kernel-module ebuild unbinds the default driver and binds the appropriate driver.
The latest version automatically installs the rebind
script into /etc/local.d/
. Make sure you have the local
initscript enabled in your preferred soft runlevel(s).