Skip to content

Home

Jump to bottom
myxi edited this page Oct 29, 2023 · 22 revisions

Installation

Linux

Crucial Steps

This app depends on keyboard scancodes. By default you need to be root to access the scancodes as they are on driver level on Linux. What you can do is having read access to the files that offer the scancodes; for this you need to see the file permissions of /dev/input stuff:

ls -la /dev/input
total 0
drwxr-xr-x  4 root root     400 Oct 29 14:47 .
drwxr-xr-x 20 root root    3920 Oct 29 14:47 ..
drwxr-xr-x  2 root root      80 Oct 29 14:47 by-id
drwxr-xr-x  2 root root     200 Oct 29 14:47 by-path
crw-rw----  1 root input 13, 64 Oct 29 14:47 event0
crw-rw----  1 root input 13, 65 Oct 29 14:47 event1
crw-rw----  1 root input 13, 74 Oct 29 14:47 event10
crw-rw----  1 root input 13, 75 Oct 29 14:47 event11
crw-rw----  1 root input 13, 76 Oct 29 14:47 event12
...

So, as you can see the files are owned by root and the group is input. You simply have to add your user to the input group:

# usermod -a -G input eeriemyxi

Here eeriemyxi is the username.

Note

This will give write access to /dev/input stuff. If you are not okay with this, consider adding a new user with a distinct password just to run the project. You would add this user to the input group, but not your primary user.

Manual Installation

Same as Windows' Manual Installation guide. Follow the steps given for manual installation on Windows once you have access to /dev/input.

Windows

Manual Installation

Dependencies

Steps

Clone the main branch:

git clone https://github.com/eeriemyxi/mechvibes-lite

Change the current working directory to the repository:

cd mechvibes-lite

Install the dependencies of the project and the project itself:

poetry install

Done! Now you should be able do use the app (try mvibes run).

Others

Other operating systems are not supported. I'd have added support for Darwin, but I can't afford the environment to test it out on. I will gladly accept contributions though.

Clone this wiki locally