Vocalinux

https://vocalinux.com
Admin
Vocalinux is an offline voice dictation application for Linux that enables 100% private...
Tokens:8,827
Snippets:208
Trust Score:6.1
Update:5 months ago
Show doc for...
Tokens:
Raw
### Install Vocalinux (Interactive)

Source: https://vocalinux.com/

Run this command for a guided installation with hardware detection. Compatible with various Linux distributions.

```bash
$ curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --interactive
```

--------------------------------

### Install Vocalinux

Source: https://vocalinux.com/troubleshooting

Install Vocalinux using the provided installation script. Ensure you have curl installed.

```bash
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/main/install.sh | bash
```

--------------------------------

### Install Vocalinux on Ubuntu

Source: https://vocalinux.com/install/ubuntu

Run this command to download and execute the Vocalinux installation script interactively.

```bash
curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --interactive
```

--------------------------------

### Install Vocalinux (whisper.cpp)

Source: https://vocalinux.com/

Installs Vocalinux using the whisper.cpp engine, offering the fastest installation and Vulkan GPU support for AMD, Intel, and NVIDIA GPUs.

```bash
$ curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh
```

--------------------------------

### Install libayatana-appindicator3-1 (Debian/Ubuntu)

Source: https://vocalinux.com/troubleshooting

Install the Ayatana AppIndicator library, which may be required for system tray icon functionality.

```bash
sudo apt install libayatana-appindicator3-1
```

--------------------------------

### Install xdotool (Debian/Ubuntu)

Source: https://vocalinux.com/troubleshooting

Install the xdotool utility, required for text injection on X11 display servers.

```bash
sudo apt install xdotool
```

--------------------------------

### Install System Dependencies (Debian/Ubuntu)

Source: https://vocalinux.com/troubleshooting

Manually install essential Python and virtual environment dependencies for Vocalinux.

```bash
sudo apt install python3-pip python3-gi python3-venv
```

--------------------------------

### Install Vocalinux (VOSK)

Source: https://vocalinux.com/

Installs Vocalinux using the VOSK engine, suitable for low-RAM systems (4GB or less) due to its minimal footprint.

```bash
$ curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --engine=vosk
```

--------------------------------

### Install Vocalinux (OpenAI Whisper)

Source: https://vocalinux.com/

Installs Vocalinux with the OpenAI Whisper engine (PyTorch). This option requires an NVIDIA GPU and involves a larger download size and installation time.

```bash
$ curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh --engine=whisper
```

--------------------------------

### Start Vocalinux Minimized

Source: https://vocalinux.com/autostart

Launch Vocalinux with the --start-minimized flag to skip the welcome dialog.

```bash
vocalinux --start-minimized
```

--------------------------------

### Install AppIndicator Extension (GNOME)

Source: https://vocalinux.com/troubleshooting

Install the AppIndicator extension for GNOME to ensure the system tray icon appears.

```bash
sudo apt install gnome-shell-extension-appindicator
```

--------------------------------

### Install IBus Package

Source: https://vocalinux.com/wayland

Install the IBus package and its GTK frontends if they are not already present on your system. This is a prerequisite for using Vocalinux's IBus integration.

```bash
sudo apt install ibus ibus-gtk ibus-gtk3
```

--------------------------------

### Start IBus Daemon

Source: https://vocalinux.com/wayland

Ensure the IBus daemon is running in your current session. This command starts the daemon with options for running in the background and enabling XIM.

```bash
ibus-daemon -drx
```

--------------------------------

### Reinstall Vocalinux

Source: https://vocalinux.com/troubleshooting

Perform a clean reinstallation of Vocalinux by first uninstalling and then installing.

```bash
./uninstall.sh && ./install.sh
```

--------------------------------

### Run Vocalinux

Source: https://vocalinux.com/wayland

Execute the Vocalinux command to start the voice dictation service. It will automatically detect the Wayland environment and configure IBus.

```bash
vocalinux
```

--------------------------------

### Check Disk Space

Source: https://vocalinux.com/troubleshooting

Use this command to check available disk space, which can be a factor during installation.

```bash
df -h
```

--------------------------------

### Check Python Version

Source: https://vocalinux.com/troubleshooting

Verify that your Python installation meets the minimum version requirement (3.9+).

```bash
python3 --version
```

--------------------------------

### Enable Vocalinux Autostart

Source: https://vocalinux.com/autostart

Manually enable Vocalinux autostart by creating the autostart directory and copying the .desktop file.

```bash
mkdir -p ~/.config/autostart && cp /usr/share/applications/vocalinux.desktop ~/.config/autostart/
```

--------------------------------

### Run Vocalinux with Debug Output

Source: https://vocalinux.com/troubleshooting

Use this command to enable detailed logging for troubleshooting startup issues.

```bash
vocalinux --debug
```

--------------------------------

### Test Microphone Recording (Linux)

Source: https://vocalinux.com/troubleshooting

Record a short audio clip and play it back to test microphone functionality on Linux.

```bash
arecord -d 3 test.wav && aplay test.wav
```

--------------------------------

### Activate Virtual Environment

Source: https://vocalinux.com/troubleshooting

Activate the Python virtual environment for Vocalinux to ensure correct dependencies are used.

```bash
source ~/.local/share/vocalinux/venv/bin/activate
```

--------------------------------

### Disable Vocalinux Autostart

Source: https://vocalinux.com/autostart

Manually disable Vocalinux autostart by removing the .desktop file from the autostart directory.

```bash
rm ~/.config/autostart/vocalinux.desktop
```

--------------------------------

### Check Microphone Detection (Linux)

Source: https://vocalinux.com/troubleshooting

Verify if your microphone is detected by the system on Linux.

```bash
arecord -l
```

--------------------------------

### Uninstall Vocalinux

Source: https://vocalinux.com/

Execute this command for a clean removal of Vocalinux from your system.

```bash
$ curl -fsSL https://raw.githubusercontent.com/jatinkrmalik/vocalinux/main/uninstall.sh -o /tmp/vul.sh && bash /tmp/vul.sh
```
Tokens:
Raw