Skip to content

Installing XLibre (WIP)

RotaryBoot58 edited this page Aug 16, 2025 · 10 revisions

This page will describe how to install, configure and use XLibre on your machine.

Please bear with us that the content here is a work in progress (WIP). If you have any suggestion, advice or want to update something in this page just talk about it.

Installation

Check if your distribution provides the xlibre packages by visiting Are We XLibre Yet?.

If your distribution is in the First-party support list all you have to do is install through your package manager and head to Configuration

In case it is on the Third-party support list, special configuration will be needed depending on your distribution. Visit the repository by clicking in the link aside your Linux distribution and follow the steps to install in your system easily.

My Linux distro is not in any of those lists. What do I do?

Then you will need to build it from source, installing the dependencies manually and following this guide on Building XLibre from source.

Configuration

After installing or building XLibre you will need to configure it.

Please check the Arch Wiki page for a more detailed configuration.

After installing XLibre, you will need to install the modules to use your keyboard and mouse. There are three packages for it.

  • xlibre-input-libinput
  • xlibre-input-evdev

libinput is the recommended module to be able to use your keyboard and mouse, everything should run fine after installing it.
evdev is the generic module, it should work and behave in the same way as the libinput module.

There is also the input-mouse and input-keyboard modules, they are usually not required and are recommended to use in systems other than Linux.

Note: Modules without the xlibre prefix should be avoided since they belong to the original X server and might not work with XLibre

Usage

Troubleshooting

Conclusion

Clone this wiki locally