diff --git a/web/src/app/faq/page.tsx b/web/src/app/faq/page.tsx
index 1d3c3b6..b3100bf 100644
--- a/web/src/app/faq/page.tsx
+++ b/web/src/app/faq/page.tsx
@@ -22,7 +22,7 @@ const faqCategories = [
questions: [
{
q: "How do I install Voculinux?",
- a: "Run the one-liner installer: curl -fsSL https://raw.githubusercontent.com/VocaHQ/vocalinux/main/install.sh | bash. The installer handles dependencies and configuration. You can also download an AppImage from GitHub Releases if you prefer a no-root portable binary (host xdotool/wtype/ydotool still required for text injection), or grab a .deb, .rpm, Snap, or Flatpak package for your distro.",
+ a: "Run the one-liner installer: curl -fsSL https://raw.githubusercontent.com/VocaHQ/vocalinux/main/install.sh | bash. Fork status: this fetches the upstream install script, so it installs Vocalinux (upstream), not Voculinux; fork release artefacts are not published yet. The installer handles dependencies and configuration. You can also download an AppImage from upstream GitHub Releases if you prefer a no-root portable binary (host xdotool/wtype/ydotool still required for text injection), or grab a .deb, .rpm, Snap, or Flatpak package for your distro.",
},
{
q: "Which Linux distributions are supported?",
diff --git a/web/src/app/faster-whisper/page.tsx b/web/src/app/faster-whisper/page.tsx
index febfabf..9f8c448 100644
--- a/web/src/app/faster-whisper/page.tsx
+++ b/web/src/app/faster-whisper/page.tsx
@@ -308,6 +308,11 @@ export default function FasterWhisperPage() {
))}
+
+ Fork status: these commands fetch the upstream install script, so they
+ install Vocalinux (upstream), not Voculinux. Fork release artefacts
+ are not published yet.
+
{setupSteps.map((step, index) => (
Install from the VocaHQ remote
+
+ Fork status: the fork Flatpak remote below is not published yet —
+ these commands resolve once the first fork release lands. The install
+ script installs upstream Vocalinux today.
+
1. {installSteps[0].name}
diff --git a/web/src/app/install/[distro]/page.tsx b/web/src/app/install/[distro]/page.tsx
index 6e20b6d..16a387d 100644
--- a/web/src/app/install/[distro]/page.tsx
+++ b/web/src/app/install/[distro]/page.tsx
@@ -51,19 +51,19 @@ bash /tmp/vl.sh`;
const DEB_OPTION: InstallOption = {
label: "Native .deb package",
- note: "Download the .deb for your CPU from GitHub Releases (arm64 files are attached too). It is a thin package: Python and GTK come from the distro, whisper.cpp runs on the CPU, and there is no auto-update. On Wayland, add yourself to the input group (sudo usermod -aG input $USER, then log out and back in) or the default hotkey stays off.",
+ note: "Fork status: the fork .deb is not published yet. Download the .deb for your CPU from upstream GitHub Releases in the meantime (arm64 files are attached too). It is a thin package: Python and GTK come from the distro, whisper.cpp runs on the CPU, and there is no auto-update. On Wayland, add yourself to the input group (sudo usermod -aG input $USER, then log out and back in) or the default hotkey stays off.",
command: "sudo apt install ./voculinux_*_amd64.deb",
};
const RPM_OPTION: InstallOption = {
label: "Native .rpm package",
- note: "Download the .rpm for your CPU from GitHub Releases (aarch64 files are attached too). It is a thin package: Python and GTK come from Fedora, whisper.cpp runs on the CPU, and there is no auto-update or COPR yet. On Wayland, add yourself to the input group (sudo usermod -aG input $USER, then log out and back in) or the default hotkey stays off.",
+ note: "Fork status: the fork .rpm is not published yet. Download the .rpm for your CPU from upstream GitHub Releases in the meantime (aarch64 files are attached too). It is a thin package: Python and GTK come from Fedora, whisper.cpp runs on the CPU, and there is no auto-update or COPR yet. On Wayland, add yourself to the input group (sudo usermod -aG input $USER, then log out and back in) or the default hotkey stays off.",
command: "sudo dnf install ./voculinux-*.x86_64.rpm",
};
const FLATPAK_OPTION: InstallOption = {
label: "Flatpak from the VocaHQ remote",
- note: "Not on Flathub. The self-hosted vocahq remote updates with flatpak update and ships whisper.cpp only.",
+ note: "Fork status: the fork Flatpak remote is not published yet. Not on Flathub. The self-hosted vocahq remote updates with flatpak update and ships whisper.cpp only once published.",
command:
"flatpak install https://vocahq.github.io/voculinux-flatpak/com.voculinux.Voculinux.flatpakref",
};
@@ -185,7 +185,7 @@ const distroConfig: Record = {
otherInstallOptions: [
{
label: "AUR packages",
- note: "voculinux builds the canonical release sdist against Arch dependencies. voculinux-bin installs the prebuilt release AppImage. voculinux-git is a community package that tracks main. The three conflict, so install only one.",
+ note: "Fork status: fork AUR packages are not published yet. Once published, voculinux builds the canonical release sdist against Arch dependencies. voculinux-bin installs the prebuilt release AppImage. voculinux-git is a community package that tracks main. The three conflict, so install only one.",
command: `yay -S voculinux # canonical release sdist, built against Arch dependencies
yay -S voculinux-git # community package; tracks main`,
},
@@ -223,7 +223,7 @@ yay -S voculinux-git # community package; tracks main`,
FLATPAK_OPTION,
{
label: "AppImage",
- note: "Download the x86_64 or aarch64 AppImage from GitHub Releases. It starts on Tumbleweed and uses Vulkan through the host driver, but still needs host text-injection tools (xdotool on X11; wtype, ydotool or clipboard tools on Wayland).",
+ note: "Download the x86_64 or aarch64 AppImage from upstream GitHub Releases until fork releases land. It starts on Tumbleweed and uses Vulkan through the host driver, but still needs host text-injection tools (xdotool on X11; wtype, ydotool or clipboard tools on Wayland).",
command: `chmod +x Voculinux-*-x86_64.AppImage # or aarch64
./Voculinux-*-x86_64.AppImage`,
},
@@ -535,9 +535,9 @@ export default async function DistroInstallPage({
- Fork status: this command fetches the upstream install script, so
- it installs Vocalinux (upstream), not Voculinux. Fork release
- artefacts are not published yet.
+ Fork status: this command fetches the upstream install script, so it
+ installs Vocalinux (upstream), not Voculinux. Fork release artefacts
+ are not published yet.
diff --git a/web/src/app/install/nixos/page.tsx b/web/src/app/install/nixos/page.tsx
index d61b721..640fbc9 100644
--- a/web/src/app/install/nixos/page.tsx
+++ b/web/src/app/install/nixos/page.tsx
@@ -217,12 +217,12 @@ export default function NixosInstallPage() {
Voculinux does not yet publish its own Nix flake. The flake below is
- the upstream Vocalinux flake: it builds the app against nixpkgs,
- ships a NixOS module and a Home Manager module, and wires every
+ the upstream Vocalinux flake: it builds the app against nixpkgs, ships
+ a NixOS module and a Home Manager module, and wires every
text-injection and clipboard tool onto the wrapped binary’s
PATH. Its snippets install Vocalinux (upstream), not Voculinux. For
- Voculinux on Void Linux, use the signed xbps repository or the
- install script.
+ Voculinux on Void Linux, use the install script today; a signed xbps
+ repository will ship with fork releases once published.
diff --git a/web/src/app/install/page.tsx b/web/src/app/install/page.tsx
index f6c33e1..6795d71 100644
--- a/web/src/app/install/page.tsx
+++ b/web/src/app/install/page.tsx
@@ -37,7 +37,8 @@ const distroGuides = [
{
name: "Debian",
href: "/install/debian/",
- description: "Debian 12+ with the install script or the native .deb package.",
+ description:
+ "Debian 12+ with the install script or the native .deb package.",
icon: Terminal,
},
{
@@ -49,7 +50,8 @@ const distroGuides = [
{
name: "Linux Mint",
href: "/install/linux-mint/",
- description: "Voice dictation on Linux Mint releases built on Ubuntu 24.04.",
+ description:
+ "Voice dictation on Linux Mint releases built on Ubuntu 24.04.",
icon: Laptop,
},
{
@@ -88,7 +90,8 @@ export default function InstallGuidesPage() {
Install Voice Dictation on Linux
Pick your distro guide and follow a proven setup flow for offline
- speech-to-text on Linux. Every guide is written for real desktop usage.
+ speech-to-text on Linux. Every guide is written for real desktop
+ usage.
@@ -99,12 +102,13 @@ export default function InstallGuidesPage() {
/>
- Then launch voculinux.
+ Then launch vocalinux — the upstream binary the script
+ installs today. Fork releases will ship voculinux.
- Fork status: this command fetches the upstream install script, so
- it installs Vocalinux (upstream), not Voculinux. Fork release
- artefacts are not published yet.
+ Fork status: this command fetches the upstream install script, so it
+ installs Vocalinux (upstream), not Voculinux. Fork release artefacts
+ are not published yet.
@@ -127,18 +131,15 @@ export default function InstallGuidesPage() {
New
Native packages
- .deb for Debian 12+ and Ubuntu 24.04+. .rpm for Fedora.
- x86_64 and aarch64 on every release.
+ .deb for Debian 12+ and Ubuntu 24.04+. .rpm for Fedora. x86_64 and
+ aarch64 on every fork release once published.
+ Fork status: packaged artefacts (AppImage, .deb/.rpm, Flatpak, Snap,
+ AUR) are not published yet — the cards above link upstream artefacts
+ or reserved fork names until the first fork release lands.
+
@@ -191,7 +198,7 @@ export default function InstallGuidesPage() {
href={guide.href}
className="subpage-card group p-5"
>
-
+
{guide.name}
@@ -212,13 +219,18 @@ export default function InstallGuidesPage() {
- Hold Right Alt (Option) to dictate, or switch to toggle mode in Settings.
+ Hold Right Alt (Option) to dictate, or switch to toggle mode in
+ Settings.
Choose whisper.cpp for speed, Whisper for maximum model
diff --git a/web/src/app/page.tsx b/web/src/app/page.tsx
index a4e61cf..96f99de 100644
--- a/web/src/app/page.tsx
+++ b/web/src/app/page.tsx
@@ -292,8 +292,8 @@ export default function HomePage() {
In any app.
- Hold Right Alt. Text lands in the focused window. Local engines
- by default.
+ Hold Right Alt. Text lands in the focused window. Local engines by
+ default.
@@ -480,9 +480,9 @@ export default function HomePage() {
model / path
Choose where the model runs.
- On-device mode is the default: download a speech-to-text
- model and process here. If you want shared compute, point
- Remote API at a server you run.
+ On-device mode is the default: download a speech-to-text model
+ and process here. If you want shared compute, point Remote API
+ at a server you run.
Engine and model controls
- Pick whisper.cpp, Faster Whisper, Whisper, VOSK, Parakeet, or a Remote API you trust.
+ Pick whisper.cpp, Faster Whisper, Whisper, VOSK, Parakeet, or a
+ Remote API you trust.
@@ -720,19 +721,15 @@ export default function HomePage() {
What you can inspect
- The application is open source under AGPL-3.0. Settings, engines,
- and the injection path are in the repository.
+ The application is open source under AGPL-3.0. Settings,
+ engines, and the injection path are in the repository.
-
+
@@ -741,8 +738,8 @@ export default function HomePage() {
The interactive installer detects hardware, lets you pick an
engine, and wires the desktop app. Ubuntu, Fedora, Debian, Arch,
- and openSUSE. Native .deb, .rpm, Snap, and Flatpak packages
- ship with every release.
+ and openSUSE. Native .deb, .rpm, Snap, and Flatpak packages are
+ planned for every fork release.
-
Then launch voculinux.
+
+ Then launch vocalinux — the upstream binary the script
+ installs today. Fork releases will ship voculinux.
+
- Fork status: this command fetches the upstream install script, so
- it installs Vocalinux (upstream), not Voculinux. Fork release
- artefacts are not published yet.
+ Fork status: this command fetches the upstream install script, so it
+ installs Vocalinux (upstream), not Voculinux. Fork release artefacts
+ are not published yet.
@@ -790,8 +790,8 @@ export default function HomePage() {
New
Native packages
- .deb for Debian 12+ and Ubuntu 24.04+. .rpm for Fedora.
- x86_64 and aarch64 on every release.
+ .deb for Debian 12+ and Ubuntu 24.04+. .rpm for Fedora. x86_64
+ and aarch64 on every fork release once published.
+ Fork status: packaged artefacts (AppImage, .deb/.rpm, Flatpak, Snap,
+ AUR, xbps) are not published yet — the cards above link upstream
+ artefacts or reserved fork names until the first fork release lands.
+
Ubuntu guide
{" · "}
@@ -854,7 +860,10 @@ export default function HomePage() {
All distro notes
-
+
Uninstall
@@ -881,9 +890,8 @@ export default function HomePage() {
answer: (
<>
Local engines (whisper.cpp, Faster Whisper, Whisper, VOSK,
- and Parakeet) process speech on your machine. Remote API is
- optional and only
- talks to servers you configure.{" "}
+ and Parakeet) process speech on your machine. Remote API
+ is optional and only talks to servers you configure.{" "}
Offline details.
>
),
@@ -908,9 +916,9 @@ export default function HomePage() {
question: "How do I switch between speech engines?",
answer: (
<>
- Settings dialog or CLI:{" "}
- --engine whisper_cpp, whisper,{" "}
- vosk, or remote_api.{" "}
+ Settings dialog or CLI: --engine whisper_cpp,{" "}
+ whisper, vosk, or{" "}
+ remote_api.{" "}
Compare engines.
>
),
@@ -981,9 +989,9 @@ export default function HomePage() {
Voculinux is a hard fork of Vocalinux for Void Linux (glibc,
- Wayland-primary under niri). The internal Python module keeps
- the upstream name so fixes stay cheap to port by hand; upstream
- links below are retained as provenance.
+ Wayland-primary under niri). The internal Python module keeps the
+ upstream name so fixes stay cheap to port by hand; upstream links
+ below are retained as provenance.
@@ -1025,8 +1033,8 @@ export default function HomePage() {
Vocalinux (upstream)
- The upstream Linux dictation app this fork is ported from.
- Fixes are taken by hand, one at a time.
+ The upstream Linux dictation app this fork is ported from. Fixes
+ are taken by hand, one at a time.