---
name: Bug Report
about: Report a bug to help improve Vocalinux
title: "[BUG] "
labels: bug
assignees: ''
---

## Bug description

A clear description of what went wrong.

## Steps to reproduce

1.
2.
3.

## Expected behavior

What you expected to happen.

## Actual behavior

What happened instead.

## Screenshots

If applicable, attach screenshots.

## Environment

- **OS / distro**: (e.g. Ubuntu 24.04)
- **Python version**: (e.g. 3.12; 3.11+ required)
- **Vocalinux version**: (`vocalinux --version`)
- **Install method**: (installer / AppImage / AUR / Flatpak / Snap / source / PyPI)
- **Display server**: (X11 / Wayland)
- **Desktop environment**: (e.g. GNOME, KDE Plasma)
- **Speech engine**: (whisper_cpp / whisper / vosk / parakeet / remote_api)
- **Model**: (e.g. tiny, medium.en-q5_0, v3-european)

## Debug logs

Run `vocalinux --debug` and paste the relevant output:

```
[paste logs here]
```

## Additional context

Anything else that might help (recent upgrade, Bluetooth mic, multi-GPU, etc.).