linux Installing Cahute on Linux distributions

In order to install Cahute’s library and/or command-line utilities on your Linux distribution, the following methods are available.

archlinux Installing Cahute on Archlinux and derivatives for local use and development, using the AUR

The Cahute library and command-line utilities can be installed through the following packages on the Archlinux User Repository:

cahute (recommended)

Main package based on the latest release (0.6 at time of writing).

cahute-git

Alternative package based on the latest development version, i.e. latest commit on the develop branch of the Git repository.

In order to install any of them, you can pop up your favourite pacman frontend and install the package:

  • Using paru:

    paru -S cahute

  • Using pikaur:

    pikaur -S cahute

Once installed, it is recommended to add your user to the uucp group, for access to serial and USB devices, by running the following command as root:

usermod -a -G uucp <your-username>

Then, you must restart your session, either by logging off and on again, or by rebooting. You should then have access to the device!

archlinux Installing Cahute on Archlinux and derivatives for MinGW development, using the AUR

The Cahute library can be installed for MinGW development, i.e. cross-development for Win32/Win64 using the MinGW-w64 project, through the following packages on the Archlinux User Repository:

mingw-w64-cahute (recommended)

Main package based on the latest release (0.6 at time of writing).

mingw-w64-cahute-git

Alternative package based on the latest development version, i.e. latest commit on the develop branch of the Git repository.

In order to install any of them, you can pop up your favourite pacman frontend and install the package:

  • Using paru:

    paru -S mingw-w64-cahute

  • Using pikaur:

    pikaur -S mingw-w64-cahute

debian Installing Cahute on Debian and derivatives for local use and development, using APT

Warning

This method is not yet available; see #8 for more information.

In the mean time, you can use one of the following methods as an alternative:

redhat Installing Cahute on RHEL and derivatives for local use and development, using RPM

Warning

This method is not yet available; see #85 for more information.

In the mean time, you can use one of the following methods as an alternative:

void Installing Cahute on Voidlinux and derivatives for local use and development, using XBPS

Warning

This method is not yet available; see #72 for more information.

In the mean time, you can use one of the following methods as an alternative:

lephe Installing Cahute on any Linux distribution for local use and development, using GiteaPC

Cahute and its command-line utilities are installable through GiteaPC, by running the following command:

giteapc install cahute/cahute@0.6

Warning

Do not close the terminal window once the command has finished. You may need information displayed in the log to continue following this guide.

Note

By default, the logging level is set to warning, and the command-line utilities are stripped.

If you wish to set the default logging level to info and keep the debug symbols, you can set the debug configuration by using the following command instead of the previous one:

giteapc install cahute/cahute@0.6:debug

Within the installation guides, you may see a warning such as the following:

********************************************************************

The udev rules will be installed in the following directory:

    /home/your_user/.local/lib/udev/rules.d/

You will need to copy them using the following command:

    sudo cp /home/your_user/.local/lib/udev/rules.d/*.rules /etc/udev/rules.d/

Once installed, you will need to either reboot your computer,
or run the following command for the rules to be taken into
account:

    sudo udevadm control --reload-rules

Then, add your user to the 'uucp' group, by running
the following command:

    sudo usermod -a -G uucp your_user

Finally, either reboot your computer, or log off then onto the
computer for the new group to be taken into account.

********************************************************************

If this is the case, that means udev has been detected and support for it in Cahute has been enabled, thus, you must follow the instructions given in this block.

Warning

Depending on your Linux distribution, the group might not be uucp, but another value such as dialout. The safest option is to copy the command directly!

lephe Installing Cahute on any Linux distribution for gint development, using GiteaPC

Warning

This method is not yet available; see #113 for more information.

linux Installing Cahute on other distributions

Note

This guide may not be exhaustive, and a package may exist for your distribution. Please check with your distribution’s package registry and/or wiki before proceeding!

If no package exists for your distribution and/or use case, or you are to package Cahute for your distribution, you can build the project yourself.

See Building Cahute for Linux distributions for more information.