Installation
Quick Install (Linux)
Requires glibc 2.34+. See Linux (Portable) for supported distributions.
Installs into your home directory. No sudo required.
curl -fsSL https://franklyn.htl-leonding.ac.at/scripts/sentinel-install.sh | bashRun the same command again to update.
To uninstall run:
curl -fsSL https://franklyn.htl-leonding.ac.at/scripts/sentinel-install.sh | bash -s -- --uninstallLinux (Portable)
Minimum requirements (glibc 2.34+): Ubuntu 22.04 (Jammy Jellyfish), Debian 12 (Bookworm), Fedora 35, RHEL / Rocky / AlmaLinux 9, openSUSE Leap 15.6 / Tumbleweed, Arch Linux. Wayland screen capture additionally requires PipeWire installed on the host.
Download the portable bundle for your architecture from Releases. The archive bundles all runtime libraries — no system dependencies required beyond glibc.
Extract and run:
tar --zstd -xf franklyn-sentinel-[VERSION]-[ARCH]-portable.tar.zst
cd franklyn-sentinel-[VERSION]-[ARCH]-portable
./bin/franklynUbuntu (22.04+) / Debian (12+)
Add the Franklyn APT repository to install Franklyn Sentinel.
curl -fsSL https://franklyn.htl-leonding.ac.at/repo/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/franklyn.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/franklyn.gpg] https://franklyn.htl-leonding.ac.at/repo stable main" | sudo tee /etc/apt/sources.list.d/franklyn.list
sudo apt updateThen you can install franklyn-sentinel.
sudo apt install franklyn-sentinelDevelopment version
To install the development version instead:
curl -fsSL https://franklyn.htl-leonding.ac.at/repo/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/franklyn.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/franklyn.gpg] https://franklyn.htl-leonding.ac.at/repo dev main" | sudo tee /etc/apt/sources.list.d/franklyn.list
sudo apt update
sudo apt install franklyn-sentinelArch Linux (AUR)
Franklyn Sentinel is available in the AUR as franklyn-bin. Install it with an AUR helper such as yay or paru:
yay -S franklyn-binopenSUSE Tumbleweed
openSUSE Leap is not supported via this method.
Install Franklyn Sentinel via the openSUSE Open Build Service.
Add the repository and install the package:
sudo zypper addrepo https://download.opensuse.org/repositories/home:franklyn/openSUSE_Tumbleweed/home:franklyn.repo
sudo zypper refresh
sudo zypper install franklynFedora (43+)
Install Franklyn Sentinel from the Franklyn repository on the openSUSE Open Build Service.
Add the repository and install the package:
sudo dnf config-manager addrepo --from-repofile=https://franklyn.htl-leonding.ac.at/fedora/franklyn.repo
sudo dnf install franklynNix
Franklyn Sentinel is available as a Nix flake package (franklyn-sentinel).
Binary Cache (Cachix)
Add the Franklyn Cachix cache to avoid rebuilding from source.
NixOS — add to your configuration:
nix.settings = {
substituters = [ "https://franklyn.cachix.org" ];
trusted-public-keys = [
"franklyn.cachix.org-1:rvchIepdAmB8uOOc1dA7rxhncnDB0LfrFrYb+BhiA4M="
];
};Non-NixOS — add to /etc/nix/nix.conf or ~/.config/nix/nix.conf:
substituters = https://cache.nixos.org https://franklyn.cachix.org
trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= franklyn.cachix.org-1:rvchIepdAmB8uOOc1dA7rxhncnDB0LfrFrYb+BhiA4M=Or install cachix and run:
cachix use franklynNixOS (flakes)
Add the Franklyn flake input to your flake.nix:
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
franklyn = {
url = "github:2526-4ahitm-itp/2526-4ahitm-franklyn";
inputs.nixpkgs.follows = "nixpkgs";
};
# ...
};
outputs = { nixpkgs, franklyn, ... }: {
nixosConfigurations.your-host = nixpkgs.lib.nixosSystem {
modules = [
{
environment.systemPackages = [
franklyn.packages.${system}.franklyn-sentinel
];
}
];
};
};
}Home Manager
Add to your Home Manager configuration:
{ inputs, pkgs, system, ... }: {
home.packages = [
inputs.franklyn.packages.${system}.franklyn-sentinel
];
}Without NixOS (nix profile)
Install into your user profile with:
nix profile install github:2526-4ahitm-itp/2526-4ahitm-franklyn#franklyn-sentinelRun without installing
nix run github:2526-4ahitm-itp/2526-4ahitm-franklyn#franklyn-sentinel -c franklynmacOS
Requires a Mac with Apple Silicon (M1 or newer) and macOS 14 (Sonoma) or newer. Intel Macs are not supported.
Open Terminal and run the same installer as on Linux. It installs into your home directory, no sudo required:
curl -fsSL https://franklyn.htl-leonding.ac.at/scripts/sentinel-install.sh | bashOpen a new terminal window afterwards so franklyn is on your PATH. Updating and uninstalling work exactly like in the Quick Install.
Screen Recording permission
The first time you run franklyn join <pin>, macOS asks whether your terminal app may record the screen:
- Click Open System Settings and turn on your terminal app (e.g. Terminal) under Privacy & Security → Screen & System Audio Recording.
- Let macOS Quit & Reopen the terminal.
- Run
franklyn join <pin>again.
The permission belongs to the terminal app, so you only grant it once — updates keep it. A different terminal app (e.g. iTerm) needs its own permission.
Manual download
Download franklyn-sentinel-[VERSION]-aarch64-darwin-portable.tar.gz from our Releases, then extract it outside of Downloads and remove the browser’s download mark:
cd ~
mkdir franklyn-sentinel
tar -xzf ~/Downloads/franklyn-sentinel-*-aarch64-darwin-portable.tar.gz -C franklyn-sentinel
xattr -dr com.apple.quarantine franklyn-sentinel
./franklyn-sentinel/bin/franklyn join <pin>Windows
Download the newest available windows portable from our Releases. Then unzip the directory and navigate to it in a terminal.
cd Downloads/franklyn-sentinel-[VERSION]-x86_64-windows-portablefranklyn.exe. Open a terminal and run franklyn.exe from there — sentinel requires a terminal to function correctly.You can now execute franklyn.exe in the terminal.
franklyn.exe join <pin>