mirror of
https://github.com/arabianq/pipewire-soundpad.git
synced 2026-09-20 22:23:31 +00:00
Compare commits
127
Commits
v1.1.4
..
5e4ff7679f
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5e4ff7679f | ||
|
|
26aad57538 | ||
|
|
ef6193f220 | ||
|
|
738664ee01 | ||
|
|
a22864d591 | ||
|
|
3ca6ba8f48 | ||
|
|
3194b66143 | ||
|
|
f992d57b88 | ||
|
|
6cae1ef10c | ||
|
|
0b1ec82b8d | ||
|
|
5278cd5662 | ||
|
|
0467c14f1f | ||
|
|
f19cef451e | ||
|
|
dc25fe9a2d | ||
|
|
04c5b8d6be | ||
|
|
089d0ce17e | ||
|
|
34ba3aff6b | ||
|
|
97a058bd23 | ||
|
|
d9bc79733e | ||
|
|
74007651a6 | ||
|
|
7331da1cb1 | ||
|
|
25b0b1ef1e | ||
|
|
5a525ffe7d | ||
|
|
4c3c670d41 | ||
|
|
6444b3b1a9 | ||
|
|
9f1122842f | ||
|
|
0c106a2316 | ||
|
|
a45c20d6a0 | ||
|
|
e393e71c34 | ||
|
|
6fc85a3178 | ||
|
|
8d8e2de0a5 | ||
|
|
738ce8f76d | ||
|
|
3f53ee31cf | ||
|
|
fb6ab8e751 | ||
|
|
ef7803c9eb | ||
|
|
331b44231b | ||
|
|
ea003ce24d | ||
|
|
3ed7f155c7 | ||
|
|
ace9dafeec | ||
|
|
f5e4b3a145 | ||
|
|
8a2175d0ea | ||
|
|
8166cd9d20 | ||
|
|
5052bf787b | ||
|
|
e18cf9607e | ||
|
|
90a7a5a2d5 | ||
|
|
6f523b7a6b | ||
|
|
34973cd4ad | ||
|
|
a5a605bfc8 | ||
|
|
a61dc9f8be | ||
|
|
6e3554e403 | ||
|
|
bcb6f1f92a | ||
|
|
69b1a5860b | ||
|
|
929199b981 | ||
|
|
b781f03484 | ||
|
|
d2e8de422a | ||
|
|
69e9a4b5b6 | ||
|
|
d780985d15 | ||
|
|
992e5bf8d8 | ||
|
|
7c3cad6e6e | ||
|
|
10fc6d84c9 | ||
|
|
5d262ba412 | ||
|
|
7ff3cd3a0e | ||
|
|
6409e041ff | ||
|
|
c3feb3fc06 | ||
|
|
8fa1d56fc4 | ||
|
|
0611a22f83 | ||
|
|
b0640d7809 | ||
|
|
3d34ec6e98 | ||
|
|
004ae0907d | ||
|
|
7a19d79d08 | ||
|
|
a2aeab5a16 | ||
|
|
5a87f06e16 | ||
|
|
b6d5cfcd0c | ||
|
|
42e8723977 | ||
|
|
26e5d8b02a | ||
|
|
af5a7851ed | ||
|
|
454ab9b3a6 | ||
|
|
4e92298873 | ||
|
|
437d7fdb4e | ||
|
|
39816a4dbe | ||
|
|
93f3460e2d | ||
|
|
f1ac8b91d7 | ||
|
|
e1f12f5ce4 | ||
|
|
6ca239ffc9 | ||
|
|
0599e38625 | ||
|
|
ddaee8c1e9 | ||
|
|
fcde9614e2 | ||
|
|
b51f453ec3 | ||
|
|
758f685413 | ||
|
|
702acccb55 | ||
|
|
9d4d5016fa | ||
|
|
39b726f8c4 | ||
|
|
bb57bfb1a8 | ||
|
|
183c961710 | ||
|
|
b985132ed7 | ||
|
|
f79614da75 | ||
|
|
12f986db1e | ||
|
|
c826b7ae4d | ||
|
|
dc9fc64a16 | ||
|
|
c4776c43eb | ||
|
|
b091c65935 | ||
|
|
e08de17e64 | ||
|
|
868b6ce432 | ||
|
|
8b991d56a9 | ||
|
|
e796a2248d | ||
|
|
406f9957f4 | ||
|
|
2d37280217 | ||
|
|
563aa1d90c | ||
|
|
9a74eeb14b | ||
|
|
a672127081 | ||
|
|
2b95b5040b | ||
|
|
125dbd3f8f | ||
|
|
dae190dd5f | ||
|
|
964205907a | ||
|
|
c1a7d050ab | ||
|
|
8556b27f0d | ||
|
|
3c8722d1f6 | ||
|
|
ebfb5d402c | ||
|
|
6d31f503b9 | ||
|
|
bd0f1a941d | ||
|
|
955a696cbc | ||
|
|
1597cb67fd | ||
|
|
0cb31d6e89 | ||
|
|
8128036313 | ||
|
|
0adf869d5c | ||
|
|
1d1df22920 | ||
|
|
ed4bfa7d1b |
@@ -1,140 +0,0 @@
|
||||
name: Release archive
|
||||
|
||||
permissions:
|
||||
contents: write
|
||||
packages: write
|
||||
|
||||
on:
|
||||
release:
|
||||
types: [created]
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
tag:
|
||||
description: 'Tag to attach assets to (e.g. v1.0.0)'
|
||||
required: false
|
||||
|
||||
jobs:
|
||||
build-and-release:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Install apt deps (jq/zip + dev-libs)
|
||||
run: |
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
zip jq \
|
||||
libpipewire-0.3-dev \
|
||||
libclang-dev \
|
||||
libasound2-dev
|
||||
|
||||
- name: Determine tag to use
|
||||
id: tag
|
||||
run: |
|
||||
set -euo pipefail
|
||||
|
||||
# приоритет 1: входной параметр workflow_dispatch
|
||||
INPUT_TAG="${{ github.event.inputs.tag || '' }}"
|
||||
if [ -n "$INPUT_TAG" ]; then
|
||||
echo "Using input tag: $INPUT_TAG"
|
||||
echo "tag=$INPUT_TAG" >> $GITHUB_OUTPUT
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# приоритет 2: если запущено событием release
|
||||
EVENT_TAG="${{ github.event.release.tag_name || '' }}"
|
||||
if [ -n "$EVENT_TAG" ]; then
|
||||
echo "Using event tag: $EVENT_TAG"
|
||||
echo "tag=$EVENT_TAG" >> $GITHUB_OUTPUT
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# приоритет 3: если GITHUB_REF — refs/tags/...
|
||||
if [[ "${GITHUB_REF:-}" =~ ^refs/tags/(.+)$ ]]; then
|
||||
echo "Using GITHUB_REF tag: ${BASH_REMATCH[1]}"
|
||||
echo "tag=${BASH_REMATCH[1]}" >> $GITHUB_OUTPUT
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# приоритет 4: пробуем получить последний релиз через API
|
||||
echo "No tag in input/event/GITHUB_REF — querying latest release via API..."
|
||||
LATEST_JSON=$(curl -sSf -H "Authorization: Bearer $GITHUB_TOKEN" -H "Accept: application/vnd.github+json" "https://api.github.com/repos/${{ github.repository }}/releases/latest" || true)
|
||||
TAG_NAME=$(echo "$LATEST_JSON" | jq -r '.tag_name // empty')
|
||||
if [ -n "$TAG_NAME" ]; then
|
||||
echo "Found latest release tag: $TAG_NAME"
|
||||
echo "tag=$TAG_NAME" >> $GITHUB_OUTPUT
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo "No tag found"
|
||||
echo "tag=" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Fail if no tag determined
|
||||
if: ${{ steps.tag.outputs.tag == '' }}
|
||||
run: |
|
||||
echo "ERROR: No tag determined. Provide a tag when running manually or ensure a release exists."
|
||||
exit 1
|
||||
|
||||
- name: Checkout code at tag
|
||||
uses: actions/checkout@v4
|
||||
with:
|
||||
ref: ${{ steps.tag.outputs.tag || github.ref }}
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Setup Rust toolchain
|
||||
uses: actions-rs/toolchain@v1
|
||||
with:
|
||||
toolchain: stable
|
||||
|
||||
- name: Extract all binary names
|
||||
id: cargo-meta
|
||||
run: |
|
||||
set -euo pipefail
|
||||
BIN_NAMES=$(cargo metadata --no-deps --format-version 1 \
|
||||
| jq -r '.packages[0].targets[] | select(.kind[] | contains("bin")) | .name')
|
||||
# сохраним построчно в выход
|
||||
echo "bin_names<<EOF" >> $GITHUB_OUTPUT
|
||||
echo "$BIN_NAMES" >> $GITHUB_OUTPUT
|
||||
echo "EOF" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Build all release binaries
|
||||
run: cargo build --release --locked
|
||||
|
||||
- name: Package all binaries into one archive
|
||||
shell: bash
|
||||
run: |
|
||||
set -euo pipefail
|
||||
TAG="${{ steps.tag.outputs.tag }}"
|
||||
ARCHIVE_NAME="pwsp-${TAG}-linux-x64.zip"
|
||||
echo "Creating archive: $ARCHIVE_NAME"
|
||||
|
||||
# читаем построчно список бинарников и формируем массив файлов
|
||||
FILES=()
|
||||
while IFS= read -r BIN; do
|
||||
[ -z "$BIN" ] && continue
|
||||
FILES+=("target/release/$BIN")
|
||||
done <<< "${{ steps.cargo-meta.outputs.bin_names }}"
|
||||
|
||||
if [ "${#FILES[@]}" -eq 0 ]; then
|
||||
echo "Error: no binaries were discovered via cargo metadata." >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# проверим, что все бинарники действительно есть
|
||||
for f in "${FILES[@]}"; do
|
||||
if [ ! -f "$f" ]; then
|
||||
echo "Error: expected binary not found: $f" >&2
|
||||
exit 1
|
||||
fi
|
||||
echo "Will add: $f"
|
||||
done
|
||||
|
||||
# создаём архив с бинарниками внутри как просто pwsp-gui, pwsp-daemon, pwsp-cli
|
||||
zip -j "$ARCHIVE_NAME" "${FILES[@]}"
|
||||
|
||||
- name: Upload release archive
|
||||
uses: softprops/action-gh-release@v2
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN }}
|
||||
tag_name: ${{ steps.tag.outputs.tag }}
|
||||
files: |
|
||||
pwsp-*.zip
|
||||
@@ -1,102 +0,0 @@
|
||||
name: Release deb
|
||||
|
||||
permissions:
|
||||
contents: write
|
||||
packages: write
|
||||
|
||||
on:
|
||||
release:
|
||||
types: [created]
|
||||
workflow_dispatch:
|
||||
inputs:
|
||||
tag:
|
||||
description: 'Tag to attach assets to (e.g. v1.0.0)'
|
||||
required: false
|
||||
|
||||
jobs:
|
||||
build-and-release:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- name: Install apt deps (jq/zip + dev-libs)
|
||||
run: |
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y \
|
||||
zip jq \
|
||||
libpipewire-0.3-dev \
|
||||
libclang-dev \
|
||||
libasound2-dev
|
||||
|
||||
- name: Determine tag to use
|
||||
id: tag
|
||||
run: |
|
||||
set -euo pipefail
|
||||
|
||||
INPUT_TAG="${{ github.event.inputs.tag || '' }}"
|
||||
if [ -n "$INPUT_TAG" ]; then
|
||||
echo "Using input tag: $INPUT_TAG"
|
||||
echo "tag=$INPUT_TAG" >> $GITHUB_OUTPUT
|
||||
exit 0
|
||||
fi
|
||||
|
||||
EVENT_TAG="${{ github.event.release.tag_name || '' }}"
|
||||
if [ -n "$EVENT_TAG" ]; then
|
||||
echo "Using event tag: $EVENT_TAG"
|
||||
echo "tag=$EVENT_TAG" >> $GITHUB_OUTPUT
|
||||
exit 0
|
||||
fi
|
||||
|
||||
if [[ "${GITHUB_REF:-}" =~ ^refs/tags/(.+)$ ]]; then
|
||||
echo "Using GITHUB_REF tag: ${BASH_REMATCH[1]}"
|
||||
echo "tag=${BASH_REMATCH[1]}" >> $GITHUB_OUTPUT
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo "No tag in input/event/GITHUB_REF — querying latest release via API..."
|
||||
LATEST_JSON=$(curl -sSf -H "Authorization: Bearer $GITHUB_TOKEN" -H "Accept: application/vnd.github+json" "https://api.github.com/repos/${{ github.repository }}/releases/latest" || true)
|
||||
TAG_NAME=$(echo "$LATEST_JSON" | jq -r '.tag_name // empty')
|
||||
if [ -n "$TAG_NAME" ]; then
|
||||
echo "Found latest release tag: $TAG_NAME"
|
||||
echo "tag=$TAG_NAME" >> $GITHUB_OUTPUT
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo "No tag found"
|
||||
echo "tag=" >> $GITHUB_OUTPUT
|
||||
|
||||
- name: Fail if no tag determined
|
||||
if: ${{ steps.tag.outputs.tag == '' }}
|
||||
run: |
|
||||
echo "ERROR: No tag determined. Provide a tag when running manually or ensure a release exists."
|
||||
exit 1
|
||||
|
||||
- name: Checkout code at tag
|
||||
uses: actions/checkout@v4
|
||||
with:
|
||||
ref: ${{ steps.tag.outputs.tag || github.ref }}
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Setup Rust toolchain
|
||||
uses: actions-rs/toolchain@v1
|
||||
with:
|
||||
toolchain: stable
|
||||
|
||||
- name: Build all release binaries
|
||||
run: cargo build --release --locked
|
||||
|
||||
- name: Install cargo-deb and create .deb
|
||||
shell: bash
|
||||
run: |
|
||||
set -euo pipefail
|
||||
cargo install --locked cargo-deb
|
||||
export PATH="$HOME/.cargo/bin:$PATH"
|
||||
|
||||
cargo-deb
|
||||
|
||||
- name: Upload .deb(s) to release
|
||||
uses: softprops/action-gh-release@v2
|
||||
with:
|
||||
token: ${{ secrets.GITHUB_TOKEN }}
|
||||
tag_name: ${{ steps.tag.outputs.tag }}
|
||||
files: |
|
||||
target/debian/*.deb
|
||||
@@ -1,2 +0,0 @@
|
||||
/target
|
||||
.idea
|
||||
Generated
-4606
File diff suppressed because it is too large
Load Diff
-60
@@ -1,60 +0,0 @@
|
||||
[package]
|
||||
name = "pwsp"
|
||||
version = "1.1.4"
|
||||
edition = "2024"
|
||||
authors = ["arabian"]
|
||||
description = "PWSP lets you play audio files through your microphone. Has both CLI and GUI clients."
|
||||
readme = "README.md"
|
||||
homepage = "https://pwsp.arabianq.ru"
|
||||
repository = "https://github.com/arabianq/pipewire-soundpad"
|
||||
license = "MIT"
|
||||
keywords = ["soundpad", "pipewire", "linux", "cli", "gui"]
|
||||
|
||||
|
||||
[dependencies]
|
||||
tokio = { version = "1.48.0", features = ["full"] }
|
||||
futures = { version = "0.3.31", features = ["thread-pool"] }
|
||||
async-trait = "0.1.89"
|
||||
|
||||
serde = { version = "1.0.228", features = ["derive"] }
|
||||
serde_json = "1.0.145"
|
||||
|
||||
clap = { version = "4.5.53", default-features = false, features = ["std", "suggestions", "help", "usage", "error-context", "derive"] }
|
||||
dirs = "6.0.0"
|
||||
|
||||
rodio = { version = "0.21.1", default-features = false, features = ["symphonia-all", "playback"] }
|
||||
pipewire = "0.9.2"
|
||||
rfd = "0.16.0"
|
||||
|
||||
egui = { version = "0.33.3", default-features = false, features = ["default_fonts", "rayon"] }
|
||||
eframe = { version = "0.33.3", default-features = false, features = ["default_fonts", "glow", "x11", "wayland"] }
|
||||
egui_material_icons = "0.5.0"
|
||||
|
||||
[[bin]]
|
||||
name = "pwsp-daemon"
|
||||
path = "src/bin/daemon.rs"
|
||||
|
||||
[[bin]]
|
||||
name = "pwsp-cli"
|
||||
path = "src/bin/cli.rs"
|
||||
|
||||
[[bin]]
|
||||
name = "pwsp-gui"
|
||||
path = "src/main.rs"
|
||||
|
||||
[profile.release]
|
||||
strip = true
|
||||
lto = true
|
||||
codegen-units = 1
|
||||
opt-level = "z"
|
||||
panic = "abort"
|
||||
|
||||
[package.metadata.deb]
|
||||
assets = [
|
||||
["target/release/pwsp-daemon", "usr/bin/", "755"],
|
||||
["target/release/pwsp-cli", "usr/bin/", "755"],
|
||||
["target/release/pwsp-gui", "usr/bin/", "755"],
|
||||
["assets/pwsp-gui.desktop", "usr/share/applications/pwsp.desktop", "644"],
|
||||
["assets/icon.png", "usr/share/icons/hicolor/256x256/apps/pwsp.png", "644"],
|
||||
["assets/pwsp-daemon.service", "usr/lib/systemd/user/pwsp-daemon.service", "644"],
|
||||
]
|
||||
@@ -1,21 +0,0 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2025 Tarasov Alexander
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
@@ -1,185 +0,0 @@
|
||||
# **🎵 Pipewire Soundpad (PWSP)**
|
||||
|
||||
**PipeWire Soundpad (PWSP)** is a simple yet powerful **soundboard application** written in **Rust**. It provides a
|
||||
user-friendly graphical interface for **managing and playing audio files, directing their output directly to the virtual
|
||||
microphone.** This makes it an ideal tool for gamers, streamers, and anyone looking to inject sound effects into voice
|
||||
chats on platforms like **Discord, Zoom, or Teamspeak**.
|
||||
|
||||

|
||||
|
||||
# **🌟 Key Features**
|
||||
|
||||
* **Multi-Format Support**: Play audio files in popular formats, including _**mp3**_, _**wav**_, _**ogg**_, _**flac**_,
|
||||
_**mp4**_, and _**aac**_.
|
||||
* **Virtual Microphone Output**: The application routes audio through a virtual device created by PipeWire, allowing
|
||||
other users to hear the sounds as if you were speaking into your microphone.
|
||||
* **Modern and Clean GUI**: The interface is built with the [egui](https://egui.rs) library, ensuring an intuitive and
|
||||
responsive user experience.
|
||||
* **Sound Collection Management**: Easily add and remove directories containing your audio files. The application scans
|
||||
these folders and displays all supported files for quick access.
|
||||
* **Quick Search**: Use the built-in search bar to instantly find any sound file within your library.
|
||||
* **Detailed Playback Controls**:
|
||||
* **Play/Pause button**.
|
||||
* **Volume slider** for individual sound adjustment.
|
||||
* **Position slider** to fast-forward or rewind the audio.
|
||||
* **Persistent Configuration**: The list of added directories and your selected audio output device are saved
|
||||
automatically, so you won't need to reconfigure them every time you launch the application.
|
||||
|
||||
# **⚙️ How It Works**
|
||||
|
||||
PWSP is designed with a clear separation of concerns, operating through a client-server architecture. It consists of
|
||||
three main components:
|
||||
|
||||
* **pwsp-daemon**: This is the core of the application. It runs silently in the background, managing all the
|
||||
heavy-lifting tasks. The daemon is responsible for:
|
||||
* Creating and managing virtual audio devices.
|
||||
* Linking these devices within the PipeWire graph.
|
||||
* Handling all audio playback.
|
||||
* **pwsp-gui**: This is the graphical user interface. It acts as a client that communicates with pwsp-daemon via a *
|
||||
*UnixSocket**. This is how you interact with your sound collection, control playback, and configure settings.
|
||||
* **pwsp-cli**: This is the command-line interface, also acting as a client. It provides a way to control the daemon
|
||||
without a GUI, allowing for scripting or quick command-based actions.
|
||||
|
||||
# **🚀 Installation**
|
||||
|
||||
## **Pre-built Packages**
|
||||
|
||||
You can download pre-built binaries, .deb and .rpm packages from
|
||||
the [releases page](https://github.com/arabianq/pipewire-soundpad/releases).
|
||||
|
||||
## **Fedora Linux**
|
||||
|
||||
If you're using Fedora, you can install PWSP from a dedicated repository using DNF.
|
||||
|
||||
Add the repository:
|
||||
|
||||
```bash
|
||||
sudo dnf copr enable arabianq/pwsp
|
||||
```
|
||||
|
||||
Update cache:
|
||||
|
||||
```bash
|
||||
sudo dnf makecache
|
||||
```
|
||||
|
||||
Install PWSP:
|
||||
|
||||
```bash
|
||||
sudo dnf install pwsp
|
||||
```
|
||||
|
||||
## **Arch Linux**
|
||||
There is pwsp package in AUR.
|
||||
You can install it using yay, paru or any other AUR helper.
|
||||
```bash
|
||||
paru pwsp
|
||||
```
|
||||
|
||||
## **Installing using cargo**
|
||||
|
||||
```bash
|
||||
cargo install pwsp
|
||||
```
|
||||
|
||||
## **Building from source**
|
||||
|
||||
#### **Requirements**
|
||||
|
||||
* **Rust**: Install [Rust](https://www.rust-lang.org/tools/install) (using rustup is recommended).
|
||||
* **PipeWire**: Ensure that [PipeWire](https://pipewire.org/) is installed and running on your system.
|
||||
|
||||
#### **Build Instructions**
|
||||
|
||||
Clone the repository:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/arabianq/pipewire-soundpad.git
|
||||
cd pipewire-soundpad
|
||||
```
|
||||
|
||||
Build the project:
|
||||
|
||||
```bash
|
||||
cargo build --release
|
||||
```
|
||||
|
||||
Now you have three binary files inside ./target/release/:
|
||||
|
||||
- **pwsp-gui**
|
||||
- **pwsp-cli**
|
||||
- **pwsp-daemon**
|
||||
|
||||
# **🎮 Usage**
|
||||
|
||||
Before using pwsp-gui or pwsp-cli, you **must** first run the pwsp-daemon in the background.
|
||||
|
||||
### **Running the Daemon**
|
||||
|
||||
You can start the daemon from the terminal or enable the systemd service for automatic startup.
|
||||
|
||||
* **Manual Start:**
|
||||
|
||||
```bash
|
||||
/path/to/your/pwsp-daemon &
|
||||
```
|
||||
|
||||
* **Using systemd (recommended):**
|
||||
If you installed PWSP using prebuilt packages, the systemd service is added automatically.
|
||||
1. **Start the service:**
|
||||
```bash
|
||||
systemctl --user start pwsp-daemon
|
||||
```
|
||||
2. **Enable autostart (starts on login):**
|
||||
```bash
|
||||
systemctl --user enable --now pwsp-daemon
|
||||
```
|
||||
|
||||
### **Using the GUI**
|
||||
|
||||
1. **Add Sounds**: Click the **"Add Directory"** button and select a folder containing your audio files. The application
|
||||
will automatically list all supported files.
|
||||
2. **Select Microphone**: In the main application window, select your **physical microphone**. PWSP will automatically
|
||||
create a virtual microphone and feed it sound from two sources: **your microphone** and the **audio files**.
|
||||
3. **Playback**: Click on a file in the list to load it, then use the **"Play"** and **"Pause"** buttons to control
|
||||
playback.
|
||||
|
||||
### **Using the CLI**
|
||||
|
||||
The pwsp-cli tool allows you to control the daemon from the command line.
|
||||
|
||||
* **General Help**: To see a list of all available commands, run:
|
||||
|
||||
```bash
|
||||
pwsp-cli --help
|
||||
```
|
||||
|
||||
* **Example Commands**:
|
||||
* **Play a file**:
|
||||
|
||||
```bash
|
||||
pwsp-cli action play <file_path>
|
||||
```
|
||||
|
||||
* **Get the current volume**:
|
||||
|
||||
```bash
|
||||
pwsp-cli get volume
|
||||
```
|
||||
|
||||
* **Set playback position to 20 seconds**:
|
||||
|
||||
```bash
|
||||
pwsp-cli set position 20
|
||||
```
|
||||
|
||||
# **🤝 Contributing**
|
||||
|
||||
Contributions are welcome\! If you have ideas for improvements or find a bug, feel free to create
|
||||
an [issue](https://github.com/arabianq/pipewire-soundpad/issues) or submit
|
||||
a [pull request](https://github.com/arabianq/pipewire-soundpad/pulls).
|
||||
|
||||
# **📜 License**
|
||||
|
||||
This project is licensed under
|
||||
the [MIT License](https://github.com/arabianq/pipewire-soundpad/blob/main/LICENSE).
|
||||
@@ -0,0 +1,15 @@
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Codename: stable
|
||||
Architectures: amd64 arm64
|
||||
Components: main
|
||||
Description: APT Repository for PWSP
|
||||
SignWith: AAE3C56B1E2D3677108CF28083C9B0DB2C8F9D16
|
||||
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Codename: nightly
|
||||
Architectures: amd64 arm64
|
||||
Components: main
|
||||
Description: Nightly APT Repository for PWSP
|
||||
SignWith: AAE3C56B1E2D3677108CF28083C9B0DB2C8F9D16
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,4 @@
|
||||
5.3.1
|
||||
3.3.0
|
||||
bdb5.3.28
|
||||
bdb5.3.0
|
||||
@@ -0,0 +1,38 @@
|
||||
-----BEGIN PGP SIGNED MESSAGE-----
|
||||
Hash: SHA512
|
||||
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Codename: nightly
|
||||
Date: Wed, 09 Sep 2026 18:48:51 UTC
|
||||
Architectures: amd64 arm64
|
||||
Components: main
|
||||
Description: Nightly APT Repository for PWSP
|
||||
MD5Sum:
|
||||
3e8a1e59f9a8bb32384272a516540eeb 650 main/binary-amd64/Packages
|
||||
39aac0337f53645e357c05dbce8b4f49 455 main/binary-amd64/Packages.gz
|
||||
facbb80485897bc6e0d67e37e5dd38e8 123 main/binary-amd64/Release
|
||||
c5733df15a9c736031fd78308a97a5e2 677 main/binary-arm64/Packages
|
||||
bb77bec1ae2e3310b50711eddf443222 460 main/binary-arm64/Packages.gz
|
||||
7418f9ee7493009aeaa4417f5d11ee62 123 main/binary-arm64/Release
|
||||
SHA1:
|
||||
06f372e0ef385b6c3f1fab4df4f8af907d4d26a5 650 main/binary-amd64/Packages
|
||||
c6fded561328223ca3886a659146dbb338e5b1e5 455 main/binary-amd64/Packages.gz
|
||||
66d8024fbaf66bb3aa03e04c8784ffc2d45d5e92 123 main/binary-amd64/Release
|
||||
cf873cf2b29e7d92d7a9e2a6d2052b408b7bb44c 677 main/binary-arm64/Packages
|
||||
71b072b70890d4408f5ef3ca1a5eff22e846a9c2 460 main/binary-arm64/Packages.gz
|
||||
f7984ac62248818b3d8a2c59250042d426414d8c 123 main/binary-arm64/Release
|
||||
SHA256:
|
||||
216f6f95e339fb5bd578267618e7697f7c0c3d5fddf0ff313b8438bac0c293d8 650 main/binary-amd64/Packages
|
||||
666641510d6ddc248e6efabdfe5a1c663b7daff74e31572433babea8761cca82 455 main/binary-amd64/Packages.gz
|
||||
b5a22f248703739051a84b584c2b0ea20a9b69b28e823c5a8b0aca5f33f90bba 123 main/binary-amd64/Release
|
||||
adc62583e0a5526eabf9ff7741226c685e548ba4bc15fba035cbbbbbad46d70b 677 main/binary-arm64/Packages
|
||||
c7054f3aaf05d4eaacb497d439b2d823e5d0a32c02b68b561e7102a94ad563d8 460 main/binary-arm64/Packages.gz
|
||||
a5e6d2298cf4bded7fd380a4bb06d97be39e9ea1a0b42acd5190a44aad619c92 123 main/binary-arm64/Release
|
||||
-----BEGIN PGP SIGNATURE-----
|
||||
|
||||
iHUEARYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCaqGqEwAKCRCDybDbLI+d
|
||||
FqvEAP9N4HuHvkp1B1Dgb0lhiI5IvVmdeUvLxOj/V01C5zKm/gEAx5cUyEEF8YmX
|
||||
SaW78ZcuI3l5KtZSvUJ4mxp9vQ6gLAc=
|
||||
=cInL
|
||||
-----END PGP SIGNATURE-----
|
||||
@@ -0,0 +1,28 @@
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Codename: nightly
|
||||
Date: Wed, 09 Sep 2026 18:48:51 UTC
|
||||
Architectures: amd64 arm64
|
||||
Components: main
|
||||
Description: Nightly APT Repository for PWSP
|
||||
MD5Sum:
|
||||
3e8a1e59f9a8bb32384272a516540eeb 650 main/binary-amd64/Packages
|
||||
39aac0337f53645e357c05dbce8b4f49 455 main/binary-amd64/Packages.gz
|
||||
facbb80485897bc6e0d67e37e5dd38e8 123 main/binary-amd64/Release
|
||||
c5733df15a9c736031fd78308a97a5e2 677 main/binary-arm64/Packages
|
||||
bb77bec1ae2e3310b50711eddf443222 460 main/binary-arm64/Packages.gz
|
||||
7418f9ee7493009aeaa4417f5d11ee62 123 main/binary-arm64/Release
|
||||
SHA1:
|
||||
06f372e0ef385b6c3f1fab4df4f8af907d4d26a5 650 main/binary-amd64/Packages
|
||||
c6fded561328223ca3886a659146dbb338e5b1e5 455 main/binary-amd64/Packages.gz
|
||||
66d8024fbaf66bb3aa03e04c8784ffc2d45d5e92 123 main/binary-amd64/Release
|
||||
cf873cf2b29e7d92d7a9e2a6d2052b408b7bb44c 677 main/binary-arm64/Packages
|
||||
71b072b70890d4408f5ef3ca1a5eff22e846a9c2 460 main/binary-arm64/Packages.gz
|
||||
f7984ac62248818b3d8a2c59250042d426414d8c 123 main/binary-arm64/Release
|
||||
SHA256:
|
||||
216f6f95e339fb5bd578267618e7697f7c0c3d5fddf0ff313b8438bac0c293d8 650 main/binary-amd64/Packages
|
||||
666641510d6ddc248e6efabdfe5a1c663b7daff74e31572433babea8761cca82 455 main/binary-amd64/Packages.gz
|
||||
b5a22f248703739051a84b584c2b0ea20a9b69b28e823c5a8b0aca5f33f90bba 123 main/binary-amd64/Release
|
||||
adc62583e0a5526eabf9ff7741226c685e548ba4bc15fba035cbbbbbad46d70b 677 main/binary-arm64/Packages
|
||||
c7054f3aaf05d4eaacb497d439b2d823e5d0a32c02b68b561e7102a94ad563d8 460 main/binary-arm64/Packages.gz
|
||||
a5e6d2298cf4bded7fd380a4bb06d97be39e9ea1a0b42acd5190a44aad619c92 123 main/binary-arm64/Release
|
||||
@@ -0,0 +1,7 @@
|
||||
-----BEGIN PGP SIGNATURE-----
|
||||
|
||||
iHUEABYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCaqGqEwAKCRCDybDbLI+d
|
||||
FuNMAQCtjnEsKYB9dEETRabshZ/2S1BwNKAgWKj3aE5+afDCBQD+JfPjQQ2+6tt+
|
||||
/xCuU3JRqZFbUqMSbY6ZL0ZkTzERIgM=
|
||||
=qgSp
|
||||
-----END PGP SIGNATURE-----
|
||||
@@ -0,0 +1,17 @@
|
||||
Package: pwsp
|
||||
Version: 1.16.2+git20260909.e216842
|
||||
Architecture: amd64
|
||||
Homepage: https://pwsp.arabianq.ru
|
||||
Maintainer: arabian
|
||||
Installed-Size: 40222
|
||||
Depends: libasound2t64 (>= 1.1.0), libc6 (>= 2.34), libc6 (>= 2.39), libpipewire-0.3-0t64 (>= 0.3.1), libssl3t64 (>= 3.0.0)
|
||||
Priority: optional
|
||||
Section: sound
|
||||
Filename: pool/main/p/pwsp/pwsp_1.16.2+git20260909.e216842_amd64.deb
|
||||
Size: 8893772
|
||||
SHA256: 86bb78c332cf5fc33ee6b879902de7ac650b207a0080b16b2340e5af99f5e00c
|
||||
SHA1: 4fcef4388a17437e5fbc49794be134a2aee30d27
|
||||
MD5sum: 0b59dadc399133e5f4d2dc29b088cd14
|
||||
Description: PWSP lets you play audio files through your microphone. Has both CLI and GUI
|
||||
clients.
|
||||
|
||||
Binary file not shown.
@@ -0,0 +1,5 @@
|
||||
Component: main
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Architecture: amd64
|
||||
Description: Nightly APT Repository for PWSP
|
||||
@@ -0,0 +1,17 @@
|
||||
Package: pwsp
|
||||
Version: 1.16.2+git20260909.e216842
|
||||
Architecture: arm64
|
||||
Homepage: https://pwsp.arabianq.ru
|
||||
Maintainer: arabian
|
||||
Installed-Size: 37776
|
||||
Depends: libasound2t64 (>= 1.0.16), libasound2t64 (>= 1.1.0), libc6 (>= 2.34), libc6 (>= 2.39), libpipewire-0.3-0t64 (>= 0.3.1), libssl3t64 (>= 3.0.0)
|
||||
Priority: optional
|
||||
Section: sound
|
||||
Filename: pool/main/p/pwsp/pwsp_1.16.2+git20260909.e216842_arm64.deb
|
||||
Size: 7860952
|
||||
SHA256: bc2df1ae7d02d6b2572e834c2fa3bde3d1664886e53c7419dbbcf12e4393e2e8
|
||||
SHA1: 1ac06d9719f89f2e7949413eb66ce1ecef37ed8a
|
||||
MD5sum: 7980838eb070ed775325ab85a9c30e06
|
||||
Description: PWSP lets you play audio files through your microphone. Has both CLI and GUI
|
||||
clients.
|
||||
|
||||
Binary file not shown.
@@ -0,0 +1,5 @@
|
||||
Component: main
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Architecture: arm64
|
||||
Description: Nightly APT Repository for PWSP
|
||||
@@ -0,0 +1,38 @@
|
||||
-----BEGIN PGP SIGNED MESSAGE-----
|
||||
Hash: SHA512
|
||||
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Codename: stable
|
||||
Date: Wed, 09 Sep 2026 19:25:48 UTC
|
||||
Architectures: amd64 arm64
|
||||
Components: main
|
||||
Description: APT Repository for PWSP
|
||||
MD5Sum:
|
||||
e79ec5acf5678eb2f658f67626b8ddb6 614 main/binary-amd64/Packages
|
||||
4eaaa5452431abe5bdae6744ed00f2ba 440 main/binary-amd64/Packages.gz
|
||||
f82d685802fbb32fec3c9ba8e11e55b9 115 main/binary-amd64/Release
|
||||
f563a833397c3d4d278a4b08204e8db9 614 main/binary-arm64/Packages
|
||||
b5d20fded73b9fb2596768d0884705c9 438 main/binary-arm64/Packages.gz
|
||||
113dd4f621500874592b2a2f1eeb45ae 115 main/binary-arm64/Release
|
||||
SHA1:
|
||||
8db6fa456696d34f85101ff0b573c31d3b03da6a 614 main/binary-amd64/Packages
|
||||
493c85716944ca8559542aa3faa6625d37a2664b 440 main/binary-amd64/Packages.gz
|
||||
1ff55a261c49c41f38e6da56f1f5d7136d38b08f 115 main/binary-amd64/Release
|
||||
02080e7eaecdf46b2b37a776a41418b7bc48b239 614 main/binary-arm64/Packages
|
||||
90bdce0d525450e7809165d143810c600ae5d42f 438 main/binary-arm64/Packages.gz
|
||||
be63fa980d70857efdc424c837cd54ab986a40cd 115 main/binary-arm64/Release
|
||||
SHA256:
|
||||
8d1d26b55a0c96e1500a9c6276e210f8950fdb99364bdd9f611777beed80355f 614 main/binary-amd64/Packages
|
||||
45fc0d2d2b12ba5bc382df8b821fc38d8f3ebbc18f1ca8e8ebd7ad3bdd8e9d71 440 main/binary-amd64/Packages.gz
|
||||
c670ad086ec5b85d17211cb15e8e4ac1fb49a6398d0c9672992c26a009229d8c 115 main/binary-amd64/Release
|
||||
fd3a75e5351e602dbfc0ce79b1cdeb66346625fe62b11d973f2a5e114ee12d98 614 main/binary-arm64/Packages
|
||||
d614049b3e0142cbb6878b0f89450e2350d5561fc19e934ad37990bc08008b17 438 main/binary-arm64/Packages.gz
|
||||
4a90ce2395fbe57635b23de83540564c0917b2f419cd69ab2630fc1520bb5c11 115 main/binary-arm64/Release
|
||||
-----BEGIN PGP SIGNATURE-----
|
||||
|
||||
iHUEARYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCaqGyvAAKCRCDybDbLI+d
|
||||
Fi7FAPwLaXSo37W6cUCUAjnxupr40qvRertMHPm+BoEcmzkiCQEA+mUMtxSS2Sgv
|
||||
an7pc6858dazFBddO9XuktYE+QV+IwY=
|
||||
=CRJo
|
||||
-----END PGP SIGNATURE-----
|
||||
@@ -0,0 +1,28 @@
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Codename: stable
|
||||
Date: Wed, 09 Sep 2026 19:25:48 UTC
|
||||
Architectures: amd64 arm64
|
||||
Components: main
|
||||
Description: APT Repository for PWSP
|
||||
MD5Sum:
|
||||
e79ec5acf5678eb2f658f67626b8ddb6 614 main/binary-amd64/Packages
|
||||
4eaaa5452431abe5bdae6744ed00f2ba 440 main/binary-amd64/Packages.gz
|
||||
f82d685802fbb32fec3c9ba8e11e55b9 115 main/binary-amd64/Release
|
||||
f563a833397c3d4d278a4b08204e8db9 614 main/binary-arm64/Packages
|
||||
b5d20fded73b9fb2596768d0884705c9 438 main/binary-arm64/Packages.gz
|
||||
113dd4f621500874592b2a2f1eeb45ae 115 main/binary-arm64/Release
|
||||
SHA1:
|
||||
8db6fa456696d34f85101ff0b573c31d3b03da6a 614 main/binary-amd64/Packages
|
||||
493c85716944ca8559542aa3faa6625d37a2664b 440 main/binary-amd64/Packages.gz
|
||||
1ff55a261c49c41f38e6da56f1f5d7136d38b08f 115 main/binary-amd64/Release
|
||||
02080e7eaecdf46b2b37a776a41418b7bc48b239 614 main/binary-arm64/Packages
|
||||
90bdce0d525450e7809165d143810c600ae5d42f 438 main/binary-arm64/Packages.gz
|
||||
be63fa980d70857efdc424c837cd54ab986a40cd 115 main/binary-arm64/Release
|
||||
SHA256:
|
||||
8d1d26b55a0c96e1500a9c6276e210f8950fdb99364bdd9f611777beed80355f 614 main/binary-amd64/Packages
|
||||
45fc0d2d2b12ba5bc382df8b821fc38d8f3ebbc18f1ca8e8ebd7ad3bdd8e9d71 440 main/binary-amd64/Packages.gz
|
||||
c670ad086ec5b85d17211cb15e8e4ac1fb49a6398d0c9672992c26a009229d8c 115 main/binary-amd64/Release
|
||||
fd3a75e5351e602dbfc0ce79b1cdeb66346625fe62b11d973f2a5e114ee12d98 614 main/binary-arm64/Packages
|
||||
d614049b3e0142cbb6878b0f89450e2350d5561fc19e934ad37990bc08008b17 438 main/binary-arm64/Packages.gz
|
||||
4a90ce2395fbe57635b23de83540564c0917b2f419cd69ab2630fc1520bb5c11 115 main/binary-arm64/Release
|
||||
@@ -0,0 +1,7 @@
|
||||
-----BEGIN PGP SIGNATURE-----
|
||||
|
||||
iHUEABYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCaqGyvAAKCRCDybDbLI+d
|
||||
FvBpAQDPkQcCTHgvBtnRvP1TIv6ofOq3UAG0joDPBOUXPCDxsAEAo2nUt63XsNxF
|
||||
d3H6UgcFl5w6IyQF0zzOo6/fovKZYAM=
|
||||
=b6kV
|
||||
-----END PGP SIGNATURE-----
|
||||
@@ -0,0 +1,17 @@
|
||||
Package: pwsp
|
||||
Version: 1.16.2-1
|
||||
Architecture: amd64
|
||||
Homepage: https://pwsp.arabianq.ru
|
||||
Maintainer: arabian
|
||||
Installed-Size: 14326
|
||||
Depends: libasound2t64 (>= 1.1.0), libc6 (>= 2.34), libc6 (>= 2.39), libpipewire-0.3-0t64 (>= 0.3.1), libssl3t64 (>= 3.0.0)
|
||||
Priority: optional
|
||||
Section: sound
|
||||
Filename: pool/main/p/pwsp/pwsp_1.16.2-1_amd64.deb
|
||||
Size: 4567768
|
||||
SHA256: 0e585036cd3b0946fe8c1b07eb4cbe6a1fa76427f1d1abc7b5ca345b5c61ea5c
|
||||
SHA1: 1e999b4c9f9ecd298faeb92cef9ad09faf5ae171
|
||||
MD5sum: fc8c10736f323891236c31662811b578
|
||||
Description: PWSP lets you play audio files through your microphone. Has both CLI and GUI
|
||||
clients.
|
||||
|
||||
Binary file not shown.
@@ -0,0 +1,5 @@
|
||||
Component: main
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Architecture: amd64
|
||||
Description: APT Repository for PWSP
|
||||
@@ -0,0 +1,17 @@
|
||||
Package: pwsp
|
||||
Version: 1.16.2-1
|
||||
Architecture: arm64
|
||||
Homepage: https://pwsp.arabianq.ru
|
||||
Maintainer: arabian
|
||||
Installed-Size: 11710
|
||||
Depends: libasound2t64 (>= 1.1.0), libc6 (>= 2.34), libc6 (>= 2.39), libpipewire-0.3-0t64 (>= 0.3.1), libssl3t64 (>= 3.0.0)
|
||||
Priority: optional
|
||||
Section: sound
|
||||
Filename: pool/main/p/pwsp/pwsp_1.16.2-1_arm64.deb
|
||||
Size: 4042940
|
||||
SHA256: fa26175c4ecfb7bd7a0b1e4419de7a0b3b265e06c73112754a0b601c3d8f6934
|
||||
SHA1: 9388cbf33980562c6a09bd635f4be7f6dbf3d9e4
|
||||
MD5sum: 22dfb74ba207d0d02877f19e7149c5f5
|
||||
Description: PWSP lets you play audio files through your microphone. Has both CLI and GUI
|
||||
clients.
|
||||
|
||||
Binary file not shown.
@@ -0,0 +1,5 @@
|
||||
Component: main
|
||||
Origin: arabianq
|
||||
Label: PipeWire Soundpad
|
||||
Architecture: arm64
|
||||
Description: APT Repository for PWSP
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user