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
.
macOS, OS X¶
Cahute and its command-line utilities can be installed using 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, 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:
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>
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.