Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "voltkit"
version = "0.13.1"
version = "0.13.2"
authors = ["Alexis Rios-Negron"]
edition = "2024"
description = "A unified suite of desktop micro-utilities for Linux"
Expand Down
8 changes: 8 additions & 0 deletions README.de.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,8 @@ echo "deb [signed-by=/usr/share/keyrings/voltkit-archive-keyring.gpg] https://ar
sudo apt update && sudo apt install voltkit
```

**Vorher den Snap installiert?** Entfernen Sie ihn zuerst (`sudo snap remove voltkit`), sonst ist Voltkit doppelt installiert, und zwei Hintergrunddienste streiten um dieselben Tastenkürzel.

apt installiert die benötigten Werkzeuge (Tesseract, wl-clipboard, das Desktop-Portal) zusammen mit Voltkit, und
Aktualisierungen kommen mit `sudo apt upgrade`.

Expand All @@ -107,15 +109,21 @@ sudo dnf copr enable arios/voltkit
sudo dnf install voltkit
```

**Vorher den Snap installiert?** Entfernen Sie ihn zuerst (`sudo snap remove voltkit`), sonst ist Voltkit doppelt installiert, und zwei Hintergrunddienste streiten um dieselben Tastenkürzel.

Öffnen Sie Voltkit dann aus Ihren Apps; es richtet sich genauso ein. Aktualisierungen kommen mit
`sudo dnf upgrade`.

## Installation (Snap Store)

Den Snap gibt es vor allem, damit man Voltkit findet: Der Snap Store ist auf jeder Linux-Distribution verfügbar, die Snaps unterstützt. Die meisten Funktionen arbeiten im Snap genauso; für die wenigen, die ein Snap nicht darf, installieren Sie mit apt oder Fedora.

```bash
sudo snap install voltkit
```

**Vorher mit apt oder Fedora installiert?** Entfernen Sie diese Version zuerst (`sudo apt remove voltkit` oder `sudo dnf remove voltkit`), damit Voltkit nicht doppelt installiert ist.

Der Snap läuft in einer Sandbox. Deshalb funktionieren GPU-Tuning, Hosts & Umgebung, App-Berechtigungen, Kürzel beim Tippen und einige weitere Funktionen nur mit apt oder Fedora, und manche Werkzeuge brauchen eine Berechtigung, die einmal mit `sudo snap connect` verbunden wird. Jede betroffene Seite weist darauf hin; die Befehle stehen unter [Nach der Installation des Snaps](https://arios4k.github.io/voltkit/manual/install.html#snap-store) (auf Englisch).

## Installation (aus dem Quellcode)
Expand Down
8 changes: 8 additions & 0 deletions README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,8 @@ echo "deb [signed-by=/usr/share/keyrings/voltkit-archive-keyring.gpg] https://ar
sudo apt update && sudo apt install voltkit
```

**¿Instalaste el snap antes?** Quítalo primero (`sudo snap remove voltkit`), o Voltkit quedará instalado dos veces, con dos servicios en segundo plano compitiendo por los mismos atajos.

apt instala las herramientas necesarias (Tesseract, wl-clipboard, el portal del escritorio) junto con Voltkit, y
las actualizaciones llegan con `sudo apt upgrade`.

Expand All @@ -106,15 +108,21 @@ sudo dnf copr enable arios/voltkit
sudo dnf install voltkit
```

**¿Instalaste el snap antes?** Quítalo primero (`sudo snap remove voltkit`), o Voltkit quedará instalado dos veces, con dos servicios en segundo plano compitiendo por los mismos atajos.

Luego abre Voltkit desde tus apps; se configura solo de la misma forma. Las actualizaciones llegan con
`sudo dnf upgrade`.

## Instalación (Snap Store)

El snap existe sobre todo para que la gente encuentre Voltkit: la Snap Store está disponible en todas las distribuciones Linux que admiten snaps. La mayoría de las funciones son iguales en el snap; para las pocas que un snap no tiene permitidas, instálalo con apt o Fedora.

```bash
sudo snap install voltkit
```

**¿Lo instalaste antes con apt o Fedora?** Quita esa versión primero (`sudo apt remove voltkit` o `sudo dnf remove voltkit`), para que Voltkit no quede instalado dos veces.

El snap funciona en un entorno aislado, así que el ajuste de GPU, Hosts y entorno, Permisos de apps, los disparadores al escribir y algunas otras funciones solo funcionan con apt o Fedora, y algunas herramientas necesitan un permiso que se conecta una vez con `sudo snap connect`. Cada página afectada lo indica; consulta [después de instalar el snap](https://arios4k.github.io/voltkit/manual/install.html#snap-store) (en inglés) para ver los comandos.

## Instalación (desde el código fuente)
Expand Down
8 changes: 8 additions & 0 deletions README.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,8 @@ echo "deb [signed-by=/usr/share/keyrings/voltkit-archive-keyring.gpg] https://ar
sudo apt update && sudo apt install voltkit
```

**Vous aviez installé le snap ?** Supprimez-le d’abord (`sudo snap remove voltkit`), sinon Voltkit sera installé deux fois, avec deux services en arrière-plan qui se disputent les mêmes raccourcis.

apt installe les outils nécessaires (Tesseract, wl-clipboard, le portail du bureau) avec Voltkit, et les mises à jour
arrivent avec `sudo apt upgrade`.

Expand All @@ -113,15 +115,21 @@ sudo dnf copr enable arios/voltkit
sudo dnf install voltkit
```

**Vous aviez installé le snap ?** Supprimez-le d’abord (`sudo snap remove voltkit`), sinon Voltkit sera installé deux fois, avec deux services en arrière-plan qui se disputent les mêmes raccourcis.

Ouvrez ensuite Voltkit depuis vos applications ; il se configure de la même façon. Les mises à jour arrivent avec
`sudo dnf upgrade`.

## Installation (Snap Store)

Le snap existe surtout pour qu’on trouve Voltkit : le Snap Store est disponible sur toutes les distributions Linux qui prennent en charge les snaps. La plupart des fonctions marchent de la même façon dans le snap ; pour les rares qu’un snap n’a pas le droit d’utiliser, installez-le avec apt ou Fedora.

```bash
sudo snap install voltkit
```

**Vous l’aviez installé avec apt ou Fedora ?** Supprimez d’abord cette version (`sudo apt remove voltkit` ou `sudo dnf remove voltkit`), pour que Voltkit ne soit pas installé deux fois.

Le snap s’exécute dans un bac à sable : le réglage du GPU, Hôtes et environnement, les autorisations des applications, les déclencheurs saisis et quelques autres fonctions ne marchent qu’avec apt ou Fedora, et certains outils ont besoin d’une autorisation à connecter une fois avec `sudo snap connect`. Chaque page concernée le signale ; les commandes sont dans [Après l’installation du snap](https://arios4k.github.io/voltkit/manual/install.html#snap-store) (en anglais).

## Installation (depuis les sources)
Expand Down
8 changes: 8 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,8 @@ echo "deb [signed-by=/usr/share/keyrings/voltkit-archive-keyring.gpg] https://ar
sudo apt update && sudo apt install voltkit
```

**Installed the snap before?** Remove it first (`sudo snap remove voltkit`), or Voltkit ends up installed twice, with two background services fighting over the same shortcuts.

apt installs the required tools (Tesseract, wl-clipboard, the desktop portal) along with Voltkit, and
updates arrive with `sudo apt upgrade`.

Expand All @@ -103,15 +105,21 @@ sudo dnf copr enable arios/voltkit
sudo dnf install voltkit
```

**Installed the snap before?** Remove it first (`sudo snap remove voltkit`), so Voltkit isn't installed twice.

Then open Voltkit from your apps; it sets itself up the same way. Updates arrive with
`sudo dnf upgrade`.

## Install (Snap Store)

The snap is here mostly so people can find Voltkit: the Snap Store is available on every Linux distribution that supports snaps. Most features work the same in the snap; for the few that a snap isn't allowed, install with apt or Fedora.

```bash
sudo snap install voltkit
```

**Installed with apt or Fedora before?** Remove that version first (`sudo apt remove voltkit` or `sudo dnf remove voltkit`), so Voltkit isn't installed twice.

The snap runs in a sandbox, so GPU tuning, Hosts & Environment, App Permissions, typed triggers and a few other features work only with apt or Fedora, and some tools need a permission connected once with `sudo snap connect`. Each affected page says so; see [after installing the snap](https://arios4k.github.io/voltkit/manual/install.html#snap-store) for the commands.

## Install (from source)
Expand Down
8 changes: 8 additions & 0 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,8 @@ echo "deb [signed-by=/usr/share/keyrings/voltkit-archive-keyring.gpg] https://ar
sudo apt update && sudo apt install voltkit
```

**之前安装过 snap 版?** 请先移除它(`sudo snap remove voltkit`),否则 Voltkit 会被安装两次,两个后台服务会争抢同一组快捷键。

apt 会在安装 Voltkit 的同时安装所需工具(Tesseract、wl-clipboard、桌面门户),之后的更新通过 `sudo apt upgrade` 获得。

然后从应用列表中打开 Voltkit:它会自动设置后台服务和键盘快捷键。接下来该做什么,请参阅手册中的 [Install](https://arios4k.github.io/voltkit/manual/install.html) 和 [A tour of the app](https://arios4k.github.io/voltkit/manual/tour.html)。
Expand All @@ -106,14 +108,20 @@ sudo dnf copr enable arios/voltkit
sudo dnf install voltkit
```

**之前安装过 snap 版?** 请先移除它(`sudo snap remove voltkit`),否则 Voltkit 会被安装两次,两个后台服务会争抢同一组快捷键。

然后从应用列表中打开 Voltkit;它会以同样的方式完成自身设置。更新通过 `sudo dnf upgrade` 获得。

## 安装(Snap Store)

提供 snap 版主要是为了让更多人发现 Voltkit:所有支持 snap 的 Linux 发行版都可以使用 Snap Store。大多数功能在 snap 版中完全相同;少数 snap 不被允许的功能,请通过 apt 或 Fedora 安装使用。

```bash
sudo snap install voltkit
```

**之前用 apt 或 Fedora 安装过?** 请先移除该版本(`sudo apt remove voltkit` 或 `sudo dnf remove voltkit`),以免 Voltkit 被安装两次。

Snap 版运行在沙盒中,因此 GPU 调节、Hosts 与环境变量、应用权限、键入触发词等少数功能只能在 apt 或 Fedora 版中使用,部分工具还需要用 `sudo snap connect` 连接一次权限。受影响的页面都会提示;命令见[安装 snap 之后](https://arios4k.github.io/voltkit/manual/install.html#snap-store)(英文)。

## 安装(从源码)
Expand Down
16 changes: 16 additions & 0 deletions data/io.github.arios4k.Voltkit.metainfo.xml
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,22 @@
<lang percentage="100">zh_CN</lang>
</languages>
<releases>
<release version="0.13.2" date="2026-11-15">
<description>
<p>The snap explains its limits.</p>
<p xml:lang="es">El snap explica sus límites.</p>
<p xml:lang="de">Der Snap erklärt seine Einschränkungen.</p>
<p xml:lang="fr">Le snap explique ses limites.</p>
<p xml:lang="zh_CN">snap 版会说明自身的限制。</p>
<ul>
<li>In the snap, each limited tool says why it needs the APT or Fedora version</li>
<li xml:lang="es">En el snap, cada herramienta limitada explica por qué necesita la versión APT o Fedora</li>
<li xml:lang="de">Im Snap erklärt jedes eingeschränkte Werkzeug, warum es die APT- oder Fedora-Version braucht</li>
<li xml:lang="fr">Dans le snap, chaque outil limité explique pourquoi il faut la version APT ou Fedora</li>
<li xml:lang="zh_CN">在 snap 版中,每个受限工具都会说明为何需要 APT 或 Fedora 版本</li>
</ul>
</description>
</release>
<release version="0.13.1" date="2026-11-15">
<description>
<p>Snap Store packaging fix.</p>
Expand Down
44 changes: 32 additions & 12 deletions docs/manual/pages/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,12 @@ echo "deb [signed-by=/usr/share/keyrings/voltkit-archive-keyring.gpg] https://ar
sudo apt update && sudo apt install voltkit
```

> [!IMPORTANT] **Installed the snap before?** Remove it first, or Voltkit is installed twice: two Voltkit entries in your apps, and two background services fighting over the same keyboard shortcuts.

```bash
sudo snap remove voltkit
```

The repository is signed with a GPG key, and apt installs the tools Voltkit needs (Tesseract, wl-clipboard, the desktop portal) together with it. Updates arrive with `sudo apt upgrade`.

## Fedora
Expand All @@ -27,16 +33,26 @@ sudo dnf install voltkit

Updates arrive with `sudo dnf upgrade`.

> [!IMPORTANT] **Installed the snap before?** Remove it first, or Voltkit is installed twice: two Voltkit entries in your apps, and two background services fighting over the same keyboard shortcuts.

```bash
sudo snap remove voltkit
```

## Snap Store

Voltkit is also in the Snap Store, so you can find it in Ubuntu's App Center:
**Why a snap?** Mostly so people can find Voltkit. The Snap Store is available on every Linux distribution that supports snaps, and it shows up in app stores such as Ubuntu's App Center, so more people can discover the tool and install it in one step. **Most of Voltkit works the same in the snap:** 16 of its 18 tools work there, most of them fully. For the few features a snap isn't allowed (see [What works only with apt or Fedora](#what-works-only-with-apt-or-fedora)), apt or Fedora is the way to install it.

Install it from Ubuntu's App Center, or with:

```bash
sudo snap install voltkit
```

Snap updates arrive automatically.

> [!IMPORTANT] **Installed Voltkit with apt or Fedora before?** Remove that version first, or Voltkit is installed twice: two Voltkit entries in your apps, and two background services fighting over the same keyboard shortcuts. Use `sudo apt remove voltkit` (Ubuntu, Debian) or `sudo dnf remove voltkit` (Fedora).

> [!IMPORTANT] Apps from the Snap Store run in a sandbox that can't ask for your administrator password, change system files or read the desktop's permission store. Some features need one of them, so they work only when Voltkit is installed with apt (Ubuntu, Debian) or DNF (Fedora). Each tool affected shows a banner at the top of its page that says what is missing and why.

### After installing the snap
Expand Down Expand Up @@ -79,17 +95,21 @@ Its *Snap Store version* section lists each permission and whether it is connect

### What works only with apt or Fedora

| Tool | What the snap can't do |
|---|---|
| [GPU Tuner](gpu) | Changing settings (power limit, fans, clocks, voltage) and applying profiles at startup. Monitoring works. |
| [Hosts & Environment](system) | The whole tool: editing `/etc/hosts` and your session's environment variables. |
| [App Permissions](permissions) | The whole tool: the sandbox can't read the desktop's permission store. |
| [Text Expansion](snippets) | Typed triggers such as `;date`. The snippet picker (<kbd>Super</kbd>+<kbd>Shift</kbd>+<kbd>E</kbd>) works. |
| [System Report](sysreport) | Drive health, memory slots and firmware update checks. |
| [What's Using This?](using) | Seeing and closing apps that belong to other users or to the system. |
| [Why Didn't It Sleep?](sleep) | Stopping a USB device from waking the computer. |

These need the administrator password (Voltkit asks through `pkexec`), write system files or read the desktop's permission store, and a snap is allowed none of them. To use them, remove the snap and install with [apt](#ubuntu-debian-and-derivatives) or [Fedora](#fedora) instead:
**This is a limitation of snaps, not of Voltkit.** Every app from the Snap Store runs in a sandbox (*strict confinement*) that keeps it away from the rest of the system: it can't ask for your administrator password, can't change system files, can't write to your hidden settings folders, and can only talk to the system services the Snap Store allows. That protects you from apps you haven't checked, but a few Voltkit features need exactly those things. Installed with [apt](#ubuntu-debian-and-derivatives) or [Fedora](#fedora), Voltkit has none of these limits.

| Tool | What the snap can't do | Why |
|---|---|---|
| [GPU Tuner](gpu) | Change settings (power limit, fans, clocks, voltage) and apply profiles at startup. **Monitoring works.** | Settings are written to the graphics driver by a helper that runs as administrator after asking for your password (`pkexec`). A snap can't ask for it, and applying a profile at startup needs a system service, which a snap can't install. |
| [Hosts & Environment](system) | The whole tool. | `/etc/hosts` is a system file only the administrator can change. Environment variables are saved in your hidden settings folder (`~/.config/environment.d`), which a snap can't write to: it only sees its own private copy. |
| [App Permissions](permissions) | The whole tool. | The answers you gave apps are kept by the desktop's permission store (`xdg-permission-store`), a service snaps aren't allowed to talk to. |
| [Text Expansion](snippets) | Typed triggers such as `;date`. **The snippet picker** (<kbd>Super</kbd>+<kbd>Shift</kbd>+<kbd>E</kbd>) **works.** | Typed triggers read the keyboard and type for you, which needs a one-time setup by the administrator (a rule in `/etc/udev`). A snap can't make that change, and the Snap Store reserves keyboard access for apps it reviews by hand. |
| [System Report](sysreport) | Drive health, memory slots and firmware update checks. **Everything else works** once `hardware-observe` and `system-observe` are connected. | Drive health comes from the system's disk service (UDisks), which snaps aren't allowed to query; memory slot details are in a table (SMBIOS) only the administrator can read; firmware checks use the `fwupdmgr` tool, which isn't inside the snap. |
| [What's Using This?](using) | See and close apps that belong to other users or to the system. **Your own apps work** once `system-observe` is connected. | Other users' and the system's apps are visible only to the administrator, and closing them needs your password. |
| [Why Didn't It Sleep?](sleep) | Stop a USB device from waking the computer. **Everything else works** once `log-observe` and `login-session-observe` are connected. | Which devices may wake the computer is a system setting; changing it, and keeping it after a restart, needs the administrator password. |

Inside the app, each of these pages shows a banner, and its **Details** button gives the same explanation. `voltkit doctor` lists them too.

If you need these features, remove the snap and install with [apt](#ubuntu-debian-and-derivatives) or [Fedora](#fedora) instead. Your settings start fresh, because the snap kept its own copy:

```bash
sudo snap remove voltkit
Expand Down
7 changes: 7 additions & 0 deletions docs/manual/pages/whats-new.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ This page lists what changed in every Voltkit release, newest first, with links

> [!TIP] Update with `sudo apt upgrade` (Ubuntu, Debian and derivatives) or `sudo dnf upgrade` (Fedora). Your settings and snippets are kept.

## Version 0.13.2

*November 15, 2026*

- **The snap explains its limits.** In the snap, the **Details** button on each limited tool now says why that feature needs the APT or Fedora version, and that it is a limitation of snaps, not of Voltkit. `voltkit doctor` gives the same reasons.
- **Install:** why there is a snap version (so more people can find Voltkit), what works in it (most of Voltkit), the reason behind each limit, and a reminder to remove the other version first so Voltkit isn't installed twice. See [Install](install#snap-store).

## Version 0.13.1

*November 15, 2026*
Expand Down
2 changes: 1 addition & 1 deletion man/de/voltkit-awake.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH voltkit-awake 1 "Voltkit 0.13.1" Voltkit-Handbuch
.TH voltkit-awake 1 "Voltkit 0.13.2" Voltkit-Handbuch
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH NAME
Expand Down
2 changes: 1 addition & 1 deletion man/de/voltkit-color.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH voltkit-color 1 "Voltkit 0.13.1" Voltkit-Handbuch
.TH voltkit-color 1 "Voltkit 0.13.2" Voltkit-Handbuch
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH NAME
Expand Down
2 changes: 1 addition & 1 deletion man/de/voltkit-compress.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH voltkit-compress 1 "Voltkit 0.13.1" Voltkit-Handbuch
.TH voltkit-compress 1 "Voltkit 0.13.2" Voltkit-Handbuch
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH NAME
Expand Down
2 changes: 1 addition & 1 deletion man/de/voltkit-convert.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH voltkit-convert 1 "Voltkit 0.13.1" Voltkit-Handbuch
.TH voltkit-convert 1 "Voltkit 0.13.2" Voltkit-Handbuch
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH NAME
Expand Down
2 changes: 1 addition & 1 deletion man/de/voltkit-daemon.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH voltkit-daemon 1 "Voltkit 0.13.1" Voltkit-Handbuch
.TH voltkit-daemon 1 "Voltkit 0.13.2" Voltkit-Handbuch
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH NAME
Expand Down
2 changes: 1 addition & 1 deletion man/de/voltkit-doctor.1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH voltkit-doctor 1 "Voltkit 0.13.1" Voltkit-Handbuch
.TH voltkit-doctor 1 "Voltkit 0.13.2" Voltkit-Handbuch
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.SH NAME
Expand Down
Loading
Loading