Bluetooth
Bluetooth in Vostok Linux
Vostok Linux ships with Bluetooth support fully configured out of the box. The bluetoothd daemon starts automatically on every boot — you don't need to install anything or enable any services manually.
The Bluetooth stack is built on BlueZ 5 — the official Linux Bluetooth protocol stack, the same one used by every major distribution. In Vostok, it runs under runit and integrates seamlessly with KDE Plasma.
What's Included
bluez— the complete Bluetooth protocol stack for Linuxbluetoothd— the Bluetooth daemon, running automatically via runit- PipeWire handles Bluetooth audio natively — headphones, speakers, and headsets work without extra configuration
KDE Plasma — Graphical Interface
The easiest way to manage Bluetooth is through KDE Plasma:
- Click the Bluetooth icon in the system tray (bottom right corner)
- Toggle Bluetooth on if it's not already enabled
- Click Add New Device to scan for nearby devices
- Select your device from the list and follow the pairing prompts
- Once paired, the device reconnects automatically on future sessions
For full Bluetooth settings, open System Settings → Bluetooth.
bluetoothctl — Command Line
For terminal users, bluetoothctl is the standard interactive Bluetooth manager that comes with BlueZ.
Start the interactive shell:
bluetoothctl
Inside the shell, use these commands:
Power on the Bluetooth adapter:
power on
Enable scanning for nearby devices:
scan on
List discovered devices:
devices
Pair with a device (replace with your device's MAC address):
pair XX:XX:XX:XX:XX:XX
Trust the device so it reconnects automatically:
trust XX:XX:XX:XX:XX:XX
Connect to a paired device:
connect XX:XX:XX:XX:XX:XX
Disconnect from a device:
disconnect XX:XX:XX:XX:XX:XX
Remove a paired device:
remove XX:XX:XX:XX:XX:XX
Stop scanning:
scan off
Exit the shell:
exit
Non-interactive Commands
You can also run bluetoothctl commands directly without entering the interactive shell:
Check Bluetooth status:
bluetoothctl show
List all paired devices:
bluetoothctl devices
Connect to a known device:
bluetoothctl connect XX:XX:XX:XX:XX:XX
Diagnostics
Check that the Bluetooth service is running:
sv status bluetoothd
List available Bluetooth adapters:
bluetoothctl list
Show detailed adapter information:
bluetoothctl show
Check if Bluetooth is blocked by rfkill:
rfkill list
If it shows Soft blocked: yes, unblock it:
rfkill unblock bluetooth
Common Issues
Bluetooth adapter not found
Check if the adapter is visible to the system:
lsusb
or for internal adapters:
lspci | grep -i bluetooth
If the hardware is detected but not working, the firmware may be missing. Install the nonfree firmware:
sudo xbps-install -S void-repo-nonfree
sudo xbps-install -S linux-firmware
Device pairs but won't connect
Remove the device and pair again:
bluetoothctl remove XX:XX:XX:XX:XX:XX
bluetoothctl scan on
bluetoothctl pair XX:XX:XX:XX:XX:XX
bluetoothctl trust XX:XX:XX:XX:XX:XX
bluetoothctl connect XX:XX:XX:XX:XX:XX
Bluetooth headphones connected but no audio
Make sure PipeWire is running — it handles Bluetooth audio:
sv status wireplumber
Then in KDE System Settings → Audio, select the Bluetooth device as the output.
Or via terminal:
pactl list sinks short
pactl set-default-sink <bluetooth-sink-name>
Device doesn't reconnect automatically
Make sure the device is trusted:
bluetoothctl trust XX:XX:XX:XX:XX:XX
bluetoothd service is down
Start it manually:
sudo sv start bluetoothd
To make sure it starts on every boot (it should already be enabled in Vostok):
sudo ln -s /etc/sv/bluetoothd /var/service/
Restart Bluetooth
If Bluetooth is misbehaving, restart the daemon:
sudo sv restart bluetoothd
For deeper Bluetooth documentation, see:
Bluetooth в Vostok Linux
Vostok Linux поставляется с полностью настроенной поддержкой Bluetooth из коробки. Демон bluetoothd запускается автоматически при каждой загрузке — не нужно ничего устанавливать или включать вручную.
Стек Bluetooth построен на BlueZ 5 — официальном стеке протоколов Bluetooth для Linux, том же что используется во всех крупных дистрибутивах. В Vostok он работает под runit и бесшовно интегрируется с KDE Plasma.
Что включено
bluez— полный стек протоколов Bluetooth для Linuxbluetoothd— демон Bluetooth, запускается автоматически через runit- PipeWire обрабатывает Bluetooth аудио нативно — наушники, колонки и гарнитуры работают без дополнительной настройки
KDE Plasma — Графический интерфейс
Самый простой способ управлять Bluetooth — через KDE Plasma:
- Нажмите на иконку Bluetooth в системном трее (правый нижний угол)
- Включите Bluetooth если ещё не включён
- Нажмите Добавить новое устройство для поиска ближайших устройств
- Выберите устройство из списка и следуйте инструкциям сопряжения
- После сопряжения устройство переподключается автоматически в будущих сессиях
Для полных настроек Bluetooth откройте Параметры системы → Bluetooth.
bluetoothctl — Командная строка
Для работы в терминале bluetoothctl — стандартный интерактивный менеджер Bluetooth из пакета BlueZ.
Запустите интерактивную оболочку:
bluetoothctl
Внутри оболочки используйте эти команды:
Включить Bluetooth адаптер:
power on
Включить сканирование ближайших устройств:
scan on
Список обнаруженных устройств:
devices
Выполнить сопряжение с устройством (замените на MAC адрес вашего устройства):
pair XX:XX:XX:XX:XX:XX
Доверять устройству чтобы оно переподключалось автоматически:
trust XX:XX:XX:XX:XX:XX
Подключиться к сопряжённому устройству:
connect XX:XX:XX:XX:XX:XX
Отключиться от устройства:
disconnect XX:XX:XX:XX:XX:XX
Удалить сопряжённое устройство:
remove XX:XX:XX:XX:XX:XX
Остановить сканирование:
scan off
Выйти из оболочки:
exit
Команды без интерактивной оболочки
Можно запускать команды bluetoothctl напрямую без входа в интерактивную оболочку:
Проверить статус Bluetooth:
bluetoothctl show
Список всех сопряжённых устройств:
bluetoothctl devices
Подключиться к известному устройству:
bluetoothctl connect XX:XX:XX:XX:XX:XX
Диагностика
Проверить что служба Bluetooth запущена:
sv status bluetoothd
Список доступных Bluetooth адаптеров:
bluetoothctl list
Подробная информация об адаптере:
bluetoothctl show
Проверить не заблокирован ли Bluetooth через rfkill:
rfkill list
Если показывает Soft blocked: yes, разблокируйте:
rfkill unblock bluetooth
Частые проблемы
Bluetooth адаптер не найден
Проверьте видит ли система адаптер:
lsusb
или для встроенных адаптеров:
lspci | grep -i bluetooth
Если железо обнаружено но не работает, возможно отсутствует прошивка. Установите несвободные прошивки:
sudo xbps-install -S void-repo-nonfree
sudo xbps-install -S linux-firmware
Устройство сопрягается но не подключается
Удалите устройство и выполните сопряжение заново:
bluetoothctl remove XX:XX:XX:XX:XX:XX
bluetoothctl scan on
bluetoothctl pair XX:XX:XX:XX:XX:XX
bluetoothctl trust XX:XX:XX:XX:XX:XX
bluetoothctl connect XX:XX:XX:XX:XX:XX
Bluetooth наушники подключены но нет звука
Убедитесь что PipeWire запущен — он обрабатывает Bluetooth аудио:
sv status wireplumber
Затем в Параметры системы KDE → Аудио выберите Bluetooth устройство как выход.
Или через терминал:
pactl list sinks short
pactl set-default-sink <имя-bluetooth-устройства>
Устройство не переподключается автоматически
Убедитесь что устройству выдано доверие:
bluetoothctl trust XX:XX:XX:XX:XX:XX
Служба bluetoothd не запущена
Запустите вручную:
sudo sv start bluetoothd
Чтобы служба запускалась при каждой загрузке (в Vostok уже должна быть включена):
sudo ln -s /etc/sv/bluetoothd /var/service/
Перезапуск Bluetooth
Если Bluetooth ведёт себя некорректно, перезапустите демон:
sudo sv restart bluetoothd
Для более глубокой документации по Bluetooth см.: