mirror of
https://github.com/arabianq/pipewire-soundpad.git
synced 2026-07-26 05:46:59 +00:00
150 lines
7.0 KiB
Markdown
150 lines
7.0 KiB
Markdown
# PipeWire Soundpad (PWSP) 🎵
|
|
|
|
|
|
|
|
[🇷🇺 Читать на русском](README.ru.md) | [🇺🇸 Read in English](README.md)
|
|
|
|
[](https://github.com/arabianq/pipewire-soundpad/actions)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](https://github.com/arabianq/pipewire-soundpad/releases/latest)
|
|
[](https://pipewire.org/)
|
|
|
|
**PipeWire Soundpad (PWSP)** — это современное приложение с низкой задержкой, которое позволяет воспроизводить аудиофайлы прямо в ваш микрофон. Разработано специально для Linux с использованием мощи PipeWire для достижения нативной интеграции без использования мостов Pulseaudio или сложных виртуальных устройств.
|
|
|
|
---
|
|
|
|
## ✨ Возможности
|
|
|
|
- **Нативная интеграция с PipeWire:** Прямое взаимодействие с PipeWire API для минимальной задержки.
|
|
- **Модульная архитектура:** Состоит из фонового демона (`daemon`), интерфейса командной строки (`cli`) и графического интерфейса (`gui`).
|
|
- **Современный GUI:** Построен на `egui`, плавно работает как на Wayland, так и на X11.
|
|
- **Глобальные горячие клавиши:** Работают через `evdev`, позволяя воспроизводить звуки из любого окна.
|
|
- **Широкая поддержка форматов:** Использует `rodio` и `symphonia` для поддержки большинства аудиоформатов.
|
|
|
|
---
|
|
|
|
## 🚀 Установка
|
|
|
|
Мы предоставляем несколько способов установки PWSP, включая стабильные релизы и постоянно обновляемые "nightly" сборки напрямую из ветки `main`.
|
|
|
|
### 📦 Flatpak (Рекомендуется)
|
|
|
|
Добавьте наш официальный OSTree репозиторий и установите приложение:
|
|
|
|
```bash
|
|
# Добавьте репозиторий
|
|
flatpak remote-add --if-not-exists arabianq-repo https://arabianq.github.io/pipewire-soundpad/
|
|
|
|
# Установите стабильную (Stable) версию
|
|
flatpak install arabianq-repo ru.arabianq.pwsp//stable
|
|
|
|
# ИЛИ установите Nightly версию (самые свежие обновления)
|
|
flatpak install arabianq-repo ru.arabianq.pwsp//nightly
|
|
```
|
|
|
|
### 🟠 Debian / Ubuntu (APT Репозиторий)
|
|
|
|
Мы поддерживаем официальный APT-репозиторий для бесшовных обновлений через `apt`:
|
|
|
|
```bash
|
|
# 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-gui
|
|
```
|
|
|
|
### 🐧 Fedora / RHEL (COPR)
|
|
|
|
Доступно через репозиторий Fedora COPR:
|
|
|
|
```bash
|
|
sudo dnf copr enable arabianq/pwsp
|
|
sudo dnf install pwsp
|
|
```
|
|
|
|
### ⚙️ Ручная установка
|
|
|
|
Вы можете вручную скачать пакеты `.deb` или готовые бинарники `.zip` на [странице релизов](https://github.com/arabianq/pipewire-soundpad/releases).
|
|
|
|
### 🦀 Сборка из исходников
|
|
|
|
Убедитесь, что у вас установлены Rust, Cargo и необходимые зависимости (`libpipewire-0.3-dev`, `libclang-dev`, `libasound2-dev`, `libdbus-1-dev`).
|
|
|
|
```bash
|
|
git clone https://github.com/arabianq/pipewire-soundpad.git
|
|
cd pipewire-soundpad
|
|
cargo build --release --locked
|
|
```
|
|
|
|
Собранные бинарники будут находиться в папке `target/release/`.
|
|
|
|
---
|
|
|
|
## 🎮 Использование
|
|
|
|
### 1. Запуск демона
|
|
|
|
PWSP работает через фоновый демон, который маршрутизирует аудио.
|
|
|
|
```bash
|
|
# Запуск демона
|
|
pwsp-daemon
|
|
```
|
|
|
|
_(Подсказка: Если вы установили программу через пакетный менеджер, она включает пользовательский systemd-сервис. Вы можете включить его командой: `systemctl --user enable --now pwsp-daemon.service`)_
|
|
|
|
### 2. Запуск GUI
|
|
|
|
Просто запустите графический интерфейс для управления и воспроизведения звуков:
|
|
|
|
```bash
|
|
pwsp-gui
|
|
```
|
|
|
|
### 3. Использование CLI
|
|
|
|
Вы также можете взаимодействовать с демоном напрямую через командную строку:
|
|
|
|
```bash
|
|
pwsp-cli play /path/to/sound.mp3
|
|
pwsp-cli stop
|
|
pwsp-cli status
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 Документация и DeepWiki
|
|
|
|
Для детальной настройки, решения проблем, описания архитектуры и кастомных конфигураций, пожалуйста, посетите нашу официальную Wiki:
|
|
|
|
[](https://deepwiki.com/arabianq/pipewire-soundpad)
|
|
|
|
---
|
|
|
|
## 🤝 Вклад в проект (Contributing)
|
|
|
|
Будем рады вашей помощи, баг-репортам и идеям!
|
|
|
|
1. Сделайте Fork проекта.
|
|
2. Создайте свою ветку (`git checkout -b feat/amazing-feature`).
|
|
3. Закоммитьте изменения (`git commit -m 'Add some amazing feature'`).
|
|
4. Запушьте ветку (`git push origin feat/amazing-feature`).
|
|
5. Откройте Pull Request.
|
|
|
|
---
|
|
|
|
## 📝 Лицензия
|
|
|
|
Распространяется под лицензией MIT. Подробнее см. в файле `LICENSE`.
|
|
|
|
_Сделано с ❤️ для сообщества Linux._
|