52bb5e3781
The welcome and error screens both require a different "perspective" into Piper, while being in the same window. For this reason, we introduce a titlebar and a regular stack and the concept of a "perspective", which is defined as a certain view into Piper. A perspective needs to implement an interface of sorts of two methods: one to retrieve its string name, and another to retrieve its widget titlebar. Different scenarios can then show different perspectives, that have full control over the main widget and the titlebar displayed. This commit introduces the MousePerspective, which is a perspective showing the mouse configuration. Future commits will add an ErrorPerspective and a WelcomePerspective, and even further into the future we can add a KeyboardPerspective as well.
Piper 
Piper is a GTK+ application to configure gaming mice, using libratbag via ratbagd. For the design mockups, see the Redesign Wiki.
In order to run Piper, ratbagd has to be running (without it, you'll get to
see a pretty mouse trap). To see how, see its
README.
Installing Piper
Piper uses the meson build system which in turn uses ninja to build and install itself. Run the following commands to clone Piper and initialize the build:
$ git clone https://github.com/libratbag/piper.git
$ cd piper
$ meson builddir --prefix=/usr/
To build or re-build after code-changes, run:
$ ninja -C builddir
$ sudo ninja -C builddir install
Note: builddir is the build output directory and can be changed to any other
directory name.
Contributing
Yes please. It's best to contact us first to see what you could do. Note that the devices displayed by Piper come from libratbag.
Piper tries to conform to Python's PEP8 style guide. To verify your code before
opening a PR, please install flake8 and run the following commands to install
its pre-commit hook:
$ flake8 --install-hook git
$ git config --bool flake8.strict true
Source
git clone https://github.com/libratbag/piper.git
Bugs
Bugs can be reported in the issue tracker on our GitHub repo: https://github.com/libratbag/piper/issues
License
Licensed under the GPLv2. See the COPYING file for the full license information.