Crates.io | reset |
lib.rs | reset |
version | 2.0.0 |
source | src |
created_at | 2023-12-12 19:53:57.439269 |
updated_at | 2024-06-13 12:38:53.989882 |
description | A wip universal Linux settings application. |
homepage | |
repository | https://github.com/Xetibo/ReSet |
max_upload_size | |
id | 1066861 |
size | 1,217,114 |
A window manager/compositor agnostic settings application for Linux written in rust and gtk4.
ReSet features a plugin system by loading dynamic libraries for both the daemon and the ReSet graphical user interface. A list of official plugins, installation guides and their documentation can be found at ReSet-Plugins.
Plugins are loaded either from /usr/lib/reset
or ~/.config/reset/plugins
. In order to install the plugin, either install a distribution specific package that places the library into the specified system folder, or place the library in the plugins folder in your config directory.
Note, after installation, please move to confirmation.
In order for your plugins to load, you have to define them in .config/reset/ReSet.toml
.
This is done to avoid loading of arbitrary plugins that might be placed within this folder by accident.
plugins = ["libreset_monitors.so", "libreset_keyboard_plugin.so"]
ReSet is available with the following packaging solutions:
We are currently not published on flatpak due to issues with permissions. This is being worked on...
Installation: Download the flatpak package (reset.flatpak) from the release and install with the terminal.
flatpak install --user reset.flatpak
Manually: Download the package (ReSet-version-x86_64.pkg.tar.zst) from the releases tab and install it with pacman.
sudo pacman -U /path/to/reset
Download the package (ReSet.deb) from the releases tab and install it with apt.
sudo apt install ./path/to/reset
ReSet offers a flake with a home-manager module which you can use to declaratively install ReSet and plugins. Here is an example configuration:
#inputs
reset.url = "github:Xetibo/ReSet";
reset-plugins.url = "github:Xetibo/ReSet-Plugins";
#installation and configuration
programs.ReSet.enable = true;
programs.ReSet.config.plugins = [
inputs.reset-plugins.packages."x86_64-linux".monitor
inputs.reset-plugins.packages."x86_64-linux".keyboard
];
programs.ReSet.config.plugin_config = {
#custom toml config
Keyboard = {
path = "/home/user/.config/reset/keyboard.conf";
};
};
cargo install reset
The compiled binary is provided in the releases.
Besides starting the application itself, a standalone daemon version (ReSet-Daemon) also exists, which is what provides the functionality for ReSet.
It is therefore possible to use a different application as well for interacting with the daemon.
By default, the daemon is integrated into ReSet and is started automatically if no other daemon is found.
This application was developed as a semester project/bachelor thesis for the Eastern Switzerland University of Applied Sciences.