6.9 KiB
PipeWire Soundpad (PWSP) 🎵
🇷🇺 Читать на русском | 🇺🇸 Read in English
PipeWire Soundpad (PWSP) — это современное приложение с низкой задержкой, которое позволяет воспроизводить аудиофайлы прямо в ваш микрофон. Разработано специально для Linux с использованием мощи PipeWire для достижения нативной интеграции без использования мостов Pulseaudio или сложных виртуальных устройств.
✨ Возможности
- Нативная интеграция с PipeWire: Прямое взаимодействие с PipeWire API для минимальной задержки.
- Модульная архитектура: Состоит из фонового демона (
daemon), интерфейса командной строки (cli) и графического интерфейса (gui). - Современный GUI: Построен на
egui, плавно работает как на Wayland, так и на X11. - Глобальные горячие клавиши: Работают через
evdev, позволяя воспроизводить звуки из любого окна. - Широкая поддержка форматов: Использует
rodioиsymphoniaдля поддержки большинства аудиоформатов.
🚀 Установка
Мы предоставляем несколько способов установки PWSP, включая стабильные релизы и постоянно обновляемые "nightly" сборки напрямую из ветки main.
📦 Flatpak (Рекомендуется)
Добавьте наш официальный OSTree репозиторий и установите приложение:
# Добавьте репозиторий
flatpak remote-add --if-not-exists pwsp https://arabianq.github.io/pipewire-soundpad/pwsp.flatpakrepo
# Установите стабильную (Stable) версию
flatpak install pwsp ru.arabianq.pwsp//stable
# ИЛИ установите Nightly версию (самые свежие обновления)
flatpak install pwsp ru.arabianq.pwsp//nightly
🟠 Debian / Ubuntu (APT Репозиторий)
Мы поддерживаем официальный APT-репозиторий для бесшовных обновлений через apt:
# 1. Скачайте публичный GPG ключ
wget -O- https://arabianq.github.io/pipewire-soundpad/apt/pubkey.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/pwsp.gpg
# 2. Добавьте репозиторий (Выберите STABLE или NIGHTLY)
# Для Stable:
echo "deb [signed-by=/etc/apt/keyrings/pwsp.gpg] https://arabianq.github.io/pipewire-soundpad/apt/ stable main" | sudo tee /etc/apt/sources.list.d/pwsp.list
# Для Nightly:
# echo "deb [signed-by=/etc/apt/keyrings/pwsp.gpg] https://arabianq.github.io/pipewire-soundpad/apt/ nightly main" | sudo tee /etc/apt/sources.list.d/pwsp.list
# 3. Обновите индексы и установите
sudo apt update
sudo apt install pwsp
🐧 Fedora / RHEL (COPR)
Доступно через репозиторий Fedora COPR:
sudo dnf copr enable arabianq/pwsp
sudo dnf install pwsp
⚙️ Ручная установка
Вы можете вручную скачать пакеты .deb или готовые бинарники .zip на странице релизов.
🦀 Сборка из исходников
Убедитесь, что у вас установлены Rust, Cargo и необходимые зависимости (libpipewire-0.3-dev, libclang-dev, libasound2-dev, libdbus-1-dev).
git clone https://github.com/arabianq/pipewire-soundpad.git
cd pipewire-soundpad
cargo build --release --locked
Собранные бинарники будут находиться в папке target/release/.
🎮 Использование
1. Запуск демона
PWSP работает через фоновый демон, который маршрутизирует аудио.
# Запуск демона
pwsp-daemon
(Подсказка: Если вы установили программу через пакетный менеджер, она включает пользовательский systemd-сервис. Вы можете включить его командой: systemctl --user enable --now pwsp-daemon.service)
2. Запуск GUI
Просто запустите графический интерфейс для управления и воспроизведения звуков:
pwsp-gui
3. Использование CLI
Вы также можете взаимодействовать с демоном напрямую через командную строку:
pwsp-cli play /path/to/sound.mp3
pwsp-cli stop
pwsp-cli status
📚 Документация и DeepWiki
Для детальной настройки, решения проблем, описания архитектуры и кастомных конфигураций, пожалуйста, посетите нашу официальную Wiki:
🤝 Вклад в проект (Contributing)
Будем рады вашей помощи, баг-репортам и идеям!
- Сделайте Fork проекта.
- Создайте свою ветку (
git checkout -b feat/amazing-feature). - Закоммитьте изменения (
git commit -m 'Add some amazing feature'). - Запушьте ветку (
git push origin feat/amazing-feature). - Откройте Pull Request.
📝 Лицензия
Распространяется под лицензией MIT. Подробнее см. в файле LICENSE.
Сделано с ❤️ для сообщества Linux.