Getting Started
Install
Section titled “Install”Find your distribution. For the .deb, .rpm and AppImage, download the file from the
releases page first. “In Penates” means it updates itself: new versions appear under Updates,
signed and checked before they install.
| Distribution | Install | Updates |
|---|---|---|
| Arch Linux | paru -S penates-bin or yay -S penates-bin, or without a helper: see below |
your AUR helper |
| CachyOS | paru -S penates-bin |
paru -Syu |
| Debian | sudo apt install ./penates_*_amd64.deb |
in Penates |
| elementary OS | sudo apt install ./penates_*_amd64.deb |
in Penates |
| EndeavourOS | yay -S penates-bin |
yay -Syu |
| Fedora | sudo dnf install ./penates-*.x86_64.rpm |
in Penates |
| Garuda Linux | paru -S penates-bin |
paru -Syu |
| Linux Mint | sudo apt install ./penates_*_amd64.deb |
in Penates |
| Manjaro | pamac build penates-bin (AUR support on in Pamac) |
pamac upgrade -a |
| openSUSE | sudo zypper install --allow-unsigned-rpm ./penates-*.x86_64.rpm |
in Penates |
| Pop!_OS | sudo apt install ./penates_*_amd64.deb |
in Penates |
| Ubuntu | sudo apt install ./penates_*_amd64.deb |
in Penates |
| Zorin OS | sudo apt install ./penates_*_amd64.deb |
in Penates |
| Any other | the AppImage: chmod +x penates_*_amd64.AppImage && ./penates_*_amd64.AppImage |
in Penates |
On Arch and its relatives the AUR has two packages, and they replace each other: penates-bin is the
prebuilt release (installs in seconds, recommended), penates builds on your computer from the release’s
source (a few minutes). Without an AUR helper, use the tools every Arch system has; pacman installs what
makepkg builds, and git pull && makepkg -si in that folder updates it:
sudo pacman -S --needed git base-devel # oncegit clone https://aur.archlinux.org/penates-bin.gitcd penates-binmakepkg -siEach release also has an Arch package for pacman alone (it does not update by itself):
sudo pacman -U ./penates-bin-*-x86_64.pkg.tar.zst.
From source, with git (any distribution). On Arch, the repo’s own PKGBUILD builds and installs your checkout:
sudo pacman -S --needed git base-devel rustup webkit2gtk-4.1 libayatana-appindicatorrustup default stablegit clone https://github.com/Natetronn/penates && cd penates/packaging/archmakepkg -siElsewhere, install Rust (from rustup.rs) and the WebKitGTK development files
(Debian and Ubuntu: libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev build-essential pkg-config;
Fedora: webkit2gtk4.1-devel libappindicator-gtk3-devel librsvg2-devel gcc), then build a tarball and
install it for your user:
git clone https://github.com/Natetronn/penates && cd penates./scripts/make-tarball.shtar -xzf dist/penates-*.tar.gz -C /tmp && PREFIX=$HOME/.local /tmp/penates-*/install.shDownload the installer from the releases page and run it. It installs Penates for your user, and Penates updates itself: new versions appear under Updates, signed and checked before they install.
| Windows | Download | Updates |
|---|---|---|
| Windows 11 | Penates_<version>_x64-setup.exe |
in Penates |
| Windows 10 | the same installer; if Microsoft Edge WebView2 is missing, it downloads it | in Penates |
Download the .dmg for your Mac from the releases page, open it and drag Penates to Applications.
It needs macOS 14 (Sonoma) or later, and updates itself: new versions appear under Updates, signed and
checked before they install.
| Mac | Download | Updates |
|---|---|---|
| Apple silicon (M1 and later) | Penates_<version>_aarch64.dmg |
in Penates |
| Intel | Penates_<version>_x64.dmg |
in Penates |
Not sure which Mac you have? Apple menu → About This Mac: “Chip: Apple M…” is Apple silicon, “Processor: Intel…” is Intel.
Penates updates itself on Windows and macOS and as an AppImage, .deb or .rpm; the updates are signed and
checked before they install. AUR packages update with your AUR helper or makepkg.
Make Your First App
Section titled “Make Your First App”- Open Penates from your application menu.
- Pick one under Catalog, or go to Create, paste any site’s address and choose Create app.
- The app appears in your application menu and opens in its own window, with its own login.
Or from a terminal:
penates create github.compenates run githubGood to Know
Section titled “Good to Know”- Links to other sites open in your browser; the site’s own pages and its sign-in popups stay in the app.
- Keys: Alt+← and Alt+→ (or your mouse’s side buttons) go back and forward, F5 or Ctrl+R reloads, Alt+Home goes to the app’s start page. F1 or Ctrl+/ shows these keys in any app.
- The toolbar above each site has back, forward, reload, start page, the address, the key list and Open in browser, in the site’s own color. Turn it off or pick its color under Edit → Window.
- Each app’s options (window size, tray icon, start minimized or in the tray, permissions) are under its Edit button.
- Updates for Penates and for your apps are under Updates.