Installing Cahute

In order to install Cahute’s library and command-line utilities, the instructions depends on the system you want to install it on.

Note

The guides expect p7 and p7screen to be directly usable in your command-line shell at the end of the installation process, i.e. that:

  • Either both executables are placed in a directory already referenced by your $PATH;

  • Or the directory in which both executables are placed is added to your $PATH, and your shell has been updated to take the change into account.

If neither of these is the case for your system, you will need to tweak the commands to point to the right executable in an absolute or relative fashion, e.g. /opt/cahute/bin/p7 info.

apple macOS, OS X

Cahute and its command-line utilities can be installed using homebrew Homebrew.

Once Homebrew is installed, disconnect all calculators from your computer and install the cahute formula with the following command:

brew install cahute

Warning

The installation requires that no calculator is currently connected to your computer through USB; having one currently in receive mode may result in the installation failing.

archlinux Archlinux, manjaro Manjaro Linux

Cahute and its command-line utilities are present on the Archlinux User Repository, you can pop up your favourite pacman frontend and install the cahute 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 then restarting your session:

usermod -a -G uucp <your-username>

lephe GiteaPC

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

giteapc install cake/cahute@0.5

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 contributor configuration by using the following command instead of the previous one:

giteapc install cake/cahute@0.5:contributor

Warning

If you are using GiteaPC on Linux, it is likely that your system is using udev. If this is the case, you must move the udev rule from the user install directory to the system directory, by running the following command:

sudo mv ~/.local/lib/udev/rules.d/*.rules /etc/udev/rules.d/

From there, you must reload the rules to make sure they apply by running the following command:

sudo udevadm control --reload-rules

If your user isn’t already in the uucp group, you must also make that the case by running the following command:

sudo usermod -a -G uucp <your_username>

Then restart the login session or host to ensure that the new group applies to your new session.

Other systems

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, or you are to package Cahute for your distribution, you can build the command-line utilities yourself.

See Building Cahute from source for more information.