update version to 1.5.1

[Feature] Parallel sounds

.github/workflows/git-archive.yml

@@ -0,0 +1,84 @@
+name: Git archive
+
+permissions:
+  contents: write
+  packages: write
+
+on:
+  push:
+    branches: [main, master]
+  workflow_dispatch:
+
+jobs:
+  build-and-upload:
+    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: Checkout code
+        uses: actions/checkout@v4
+        with:
+          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
+          COMMIT_SHA="${{ github.sha }}"
+          ARCHIVE_NAME="pwsp-${COMMIT_SHA}-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
+
+          zip -j "$ARCHIVE_NAME" "${FILES[@]}"
+
+      - name: Upload archive as artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: archive
+          path: pwsp-*.zip
+          retention-days: 7

.github/workflows/git-deb.yml

@@ -0,0 +1,53 @@
+name: Git deb
+
+permissions:
+  contents: write
+  packages: write
+
+on:
+  push:
+    branches: [main, master]
+  workflow_dispatch:
+
+jobs:
+  build-and-upload:
+    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: Checkout code
+        uses: actions/checkout@v4
+        with:
+          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) as artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: deb-packages
+          path: target/debian/*.deb
+          retention-days: 7

.github/workflows/git-flatpak.yml

@@ -0,0 +1,27 @@
+name: Git Flatpak
+
+on:
+    push:
+        branches: [main, master]
+    pull_request:
+        branches: [main, master]
+    workflow_dispatch:
+
+jobs:
+    flatpak-build:
+        runs-on: ubuntu-latest
+        container:
+            image: bilelmoussaoui/flatpak-github-actions:freedesktop-24.08
+            options: --privileged
+
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Build Flatpak
+              uses: flatpak/flatpak-github-actions/flatpak-builder@v6
+              with:
+                  bundle: ru.arabianq.pwsp.flatpak
+                  manifest-path: packages/flatpak/ru.arabianq.pwsp.yaml
+                  cache: true
+                  branch: master
+                  build-bundle: true

.github/workflows/release-archive.yml

@@ -0,0 +1,132 @@
+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
+
+          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: 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
+
+          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

.github/workflows/release-deb.yml

@@ -0,0 +1,102 @@
+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

.github/workflows/release-flatpak.yml

@@ -0,0 +1,72 @@
+name: Release Flatpak
+
+permissions:
+    contents: write
+
+on:
+    release:
+        types: [created]
+    workflow_dispatch:
+        inputs:
+            tag:
+                description: "Tag to attach assets to (e.g. v1.0.0)"
+                required: false
+
+jobs:
+    flatpak-release:
+        runs-on: ubuntu-latest
+        container:
+            image: bilelmoussaoui/flatpak-github-actions:freedesktop-24.08
+            options: --privileged
+
+        steps:
+            - name: Determine tag to use
+              id: tag
+              run: |
+                  set -euo pipefail
+
+                  INPUT_TAG="${{ github.event.inputs.tag || '' }}"
+                  if [ -n "$INPUT_TAG" ]; then
+                    echo "tag=$INPUT_TAG" >> $GITHUB_OUTPUT
+                    exit 0
+                  fi
+
+                  EVENT_TAG="${{ github.event.release.tag_name || '' }}"
+                  if [ -n "$EVENT_TAG" ]; then
+                    echo "tag=$EVENT_TAG" >> $GITHUB_OUTPUT
+                    exit 0
+                  fi
+
+                  if [[ "${GITHUB_REF:-}" =~ ^refs/tags/(.+)$ ]]; then
+                    echo "tag=${BASH_REMATCH[1]}" >> $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."
+                  exit 1
+
+            - uses: actions/checkout@v4
+              with:
+                  ref: ${{ steps.tag.outputs.tag }}
+
+            - name: Build Flatpak
+              uses: flatpak/flatpak-github-actions/flatpak-builder@v6
+              with:
+                  bundle: ru.arabianq.pwsp.flatpak
+                  manifest-path: packages/flatpak/ru.arabianq.pwsp.yaml
+                  cache: true
+                  branch: master
+                  build-bundle: true
+
+            - name: Upload Flatpak to release
+              uses: softprops/action-gh-release@v2
+              with:
+                  token: ${{ secrets.GITHUB_TOKEN }}
+                  tag_name: ${{ steps.tag.outputs.tag }}
+                  files: ru.arabianq.pwsp.flatpak

.gitignore

@@ -0,0 +1,2 @@
+/target
+.idea

.gitmodules

@@ -0,0 +1,9 @@
+[submodule "packages/aur"]
+	path = packages/aur
+	url = ssh://aur@aur.archlinux.org/pwsp.git
+[submodule "packages/aur/standart"]
+	path = packages/aur/standart
+	url = ssh://aur@aur.archlinux.org/pwsp.git
+[submodule "packages/aur/bin"]
+	path = packages/aur/bin
+	url = ssh://aur@aur.archlinux.org/pwsp-bin.git

Cargo.toml

@@ -0,0 +1,61 @@
+[package]
+name = "pwsp"
+version = "1.5.1"
+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.49.0", features = ["full"] }
+async-trait = "0.1.89"
+
+serde = { version = "1.0.228", features = ["derive"] }
+serde_json = "1.0.149"
+
+clap = { version = "4.5.55", default-features = false, features = ["std", "suggestions", "help", "usage", "error-context", "derive"] }
+dirs = "6.0.0"
+itertools = "0.14.0"
+
+rodio = { version = "0.21.1", default-features = false, features = ["symphonia-all", "playback"] }
+pipewire = "0.9.2"
+rfd = { version = "0.17.2", default-features = false, features = ["xdg-portal"]}
+
+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"
+egui_dnd = "0.14.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"],
+]

LICENSE

@@ -0,0 +1,21 @@
+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.

README.md

@@ -0,0 +1,210 @@
+# **🎵 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**.
+
+![screenshot.png](assets/screenshot.png)
+
+# **🌟 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.
+* **Collapsible Audio Tracks**: You can collapse every audio track to save space.
+* **Drag and Drop Directories**: Reorder your sound directories easily using drag and drop.
+* **Automatic Device Detection**: PWSP automatically detects when an input device is connected or disconnected and handles linking/unlinking.
+
+# **⚙️ 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 and .deb packages from
+the [releases page](https://github.com/arabianq/pipewire-soundpad/releases).
+
+## **Fedora Linux (and derivatives)**
+
+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-bin # or paru pwsp to build it locally
+```
+
+## **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 **"+"** 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 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. You can also play single file once using **"Play File"** button.
+
+### **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
+      ```
+
+### **Hotkeys & Controls**
+
+#### **Keyboard Shortcuts**
+
+| Key                      | Action                                               |
+| :----------------------- | :--------------------------------------------------- |
+| **Space**                | Pause / Resume audio                                 |
+| **Backspace**            | Stop all audio tracks                                |
+| **Enter**                | Play selected file (stops all other tracks)          |
+| **Ctrl + Enter**         | Add selected file to playback (plays simultaneously) |
+| **Shift + Enter**        | Replace the last added track with the selected one   |
+| **I**                    | Open / Close settings                                |
+| **/**                    | Focus search field                                   |
+| **Ctrl + ↑ / ↓**         | Navigate through files                               |
+| **Ctrl + Shift + ↑ / ↓** | Navigate through directories                         |
+
+#### **Mouse Controls**
+
+* **Left Click**: Play track (stops all other tracks).
+* **Ctrl + Left Click**: Add track (plays simultaneously with current tracks).
+* **Shift + Left Click**: Replace the last added track with the selected one.
+
+# **🤝 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).

apt/conf/distributions

@@ -1,15 +0,0 @@
-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

apt/db/version

@@ -1,4 +0,0 @@
-5.3.1
-3.3.0
-bdb5.3.28
-bdb5.3.0

apt/dists/nightly/InRelease

@@ -1,38 +0,0 @@
------BEGIN PGP SIGNED MESSAGE-----
-Hash: SHA512
-
-Origin: arabianq
-Label: PipeWire Soundpad
-Codename: nightly
-Date: Sun, 19 Jul 2026 14:32:10 UTC
-Architectures: amd64 arm64
-Components: main
-Description: Nightly APT Repository for PWSP
-MD5Sum:
- 5b8d95c58175011bede41253a094f735 650 main/binary-amd64/Packages
- 3388137f5dea2306a71d40f8411495ff 455 main/binary-amd64/Packages.gz
- facbb80485897bc6e0d67e37e5dd38e8 123 main/binary-amd64/Release
- de07cc56b3569ff00a857f8069307229 677 main/binary-arm64/Packages
- d9760f315fbc95b2ba923258827ca5eb 458 main/binary-arm64/Packages.gz
- 7418f9ee7493009aeaa4417f5d11ee62 123 main/binary-arm64/Release
-SHA1:
- 7bbde2167655513bf00efce26e726ffdc3987134 650 main/binary-amd64/Packages
- 79e27bd10d4d77d21d0e76de3545cdf2fbc22faf 455 main/binary-amd64/Packages.gz
- 66d8024fbaf66bb3aa03e04c8784ffc2d45d5e92 123 main/binary-amd64/Release
- f793ab83d22cd3fd65da3438aa8ea4857f07e513 677 main/binary-arm64/Packages
- 849811be7578b205f6d03ffbe3e3e05b4dd08272 458 main/binary-arm64/Packages.gz
- f7984ac62248818b3d8a2c59250042d426414d8c 123 main/binary-arm64/Release
-SHA256:
- 7cbaaf15727bca312ef19f6cbb077da4cdc189f227ce89e789913965736607d2 650 main/binary-amd64/Packages
- 64769e7cd47d356929291eae53f9d040d012bcf37804118ef29a26a1fbf9b5e6 455 main/binary-amd64/Packages.gz
- b5a22f248703739051a84b584c2b0ea20a9b69b28e823c5a8b0aca5f33f90bba 123 main/binary-amd64/Release
- ec63a6742d660b750793b51aef8ecb0c0afa9925f1757979fbc780abe62a1c74 677 main/binary-arm64/Packages
- af0bf6b25df0c62f22a6cc206610a4982c31ca274f127b13a2930a0bf7ed4bef 458 main/binary-arm64/Packages.gz
- a5e6d2298cf4bded7fd380a4bb06d97be39e9ea1a0b42acd5190a44aad619c92 123 main/binary-arm64/Release
------BEGIN PGP SIGNATURE-----
-
-iHUEARYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCalzf6gAKCRCDybDbLI+d
-FsJ1AQCQ9Zzg+qSTla1kSsHL3t0+gXh8M27rU/GFseOmHTQBqgEAopLIu3sSAMKG
-oHq+i5vJz7DXZZoAynPa9KD3p4xTGAM=
-=ZJjl
------END PGP SIGNATURE-----

apt/dists/nightly/Release

@@ -1,28 +0,0 @@
-Origin: arabianq
-Label: PipeWire Soundpad
-Codename: nightly
-Date: Sun, 19 Jul 2026 14:32:10 UTC
-Architectures: amd64 arm64
-Components: main
-Description: Nightly APT Repository for PWSP
-MD5Sum:
- 5b8d95c58175011bede41253a094f735 650 main/binary-amd64/Packages
- 3388137f5dea2306a71d40f8411495ff 455 main/binary-amd64/Packages.gz
- facbb80485897bc6e0d67e37e5dd38e8 123 main/binary-amd64/Release
- de07cc56b3569ff00a857f8069307229 677 main/binary-arm64/Packages
- d9760f315fbc95b2ba923258827ca5eb 458 main/binary-arm64/Packages.gz
- 7418f9ee7493009aeaa4417f5d11ee62 123 main/binary-arm64/Release
-SHA1:
- 7bbde2167655513bf00efce26e726ffdc3987134 650 main/binary-amd64/Packages
- 79e27bd10d4d77d21d0e76de3545cdf2fbc22faf 455 main/binary-amd64/Packages.gz
- 66d8024fbaf66bb3aa03e04c8784ffc2d45d5e92 123 main/binary-amd64/Release
- f793ab83d22cd3fd65da3438aa8ea4857f07e513 677 main/binary-arm64/Packages
- 849811be7578b205f6d03ffbe3e3e05b4dd08272 458 main/binary-arm64/Packages.gz
- f7984ac62248818b3d8a2c59250042d426414d8c 123 main/binary-arm64/Release
-SHA256:
- 7cbaaf15727bca312ef19f6cbb077da4cdc189f227ce89e789913965736607d2 650 main/binary-amd64/Packages
- 64769e7cd47d356929291eae53f9d040d012bcf37804118ef29a26a1fbf9b5e6 455 main/binary-amd64/Packages.gz
- b5a22f248703739051a84b584c2b0ea20a9b69b28e823c5a8b0aca5f33f90bba 123 main/binary-amd64/Release
- ec63a6742d660b750793b51aef8ecb0c0afa9925f1757979fbc780abe62a1c74 677 main/binary-arm64/Packages
- af0bf6b25df0c62f22a6cc206610a4982c31ca274f127b13a2930a0bf7ed4bef 458 main/binary-arm64/Packages.gz
- a5e6d2298cf4bded7fd380a4bb06d97be39e9ea1a0b42acd5190a44aad619c92 123 main/binary-arm64/Release

apt/dists/nightly/Release.gpg

@@ -1,7 +0,0 @@
------BEGIN PGP SIGNATURE-----
-
-iHUEABYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCalzf6gAKCRCDybDbLI+d
-FiYqAQDiHbAeWDp24vgDsWO8zIo2qEsV1yXelZ6Jrwdp6+gebgD9FRNEzRSveL8v
-vE53+zpll7w0Wm1Lo1A/YN2jchGdMgY=
-=V8ei
------END PGP SIGNATURE-----

apt/dists/nightly/main/binary-amd64/Packages

@@ -1,17 +0,0 @@
-Package: pwsp
-Version: 1.12.4+git20260719.322b93e
-Architecture: amd64
-Homepage: https://pwsp.arabianq.ru
-Maintainer: arabian
-Installed-Size: 39429
-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.12.4+git20260719.322b93e_amd64.deb
-Size: 8638520
-SHA256: 6694384923817503f7f74015404f7b74a09a026f0e77c16d8ab4f85d7947888d
-SHA1: cda9e2711b2e72412cc76b0785b1d8dfc773a46d
-MD5sum: 3d1184e75e9039adce6e913c42dbc0aa
-Description: PWSP lets you play audio files through your microphone. Has both CLI and GUI
- clients.
-

apt/dists/nightly/main/binary-amd64/Release

@@ -1,5 +0,0 @@
-Component: main
-Origin: arabianq
-Label: PipeWire Soundpad
-Architecture: amd64
-Description: Nightly APT Repository for PWSP

apt/dists/nightly/main/binary-arm64/Packages

@@ -1,17 +0,0 @@
-Package: pwsp
-Version: 1.12.4+git20260719.322b93e
-Architecture: arm64
-Homepage: https://pwsp.arabianq.ru
-Maintainer: arabian
-Installed-Size: 37253
-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.12.4+git20260719.322b93e_arm64.deb
-Size: 7709364
-SHA256: 1a796813b0e24164ccebeb3d31054da23cd92a827b749a543ebe97adb021dd33
-SHA1: 63ab36dde059cddc73e778b933eabe102c8ee68e
-MD5sum: 1e0fac94c1f493b3d588ab815fc8d302
-Description: PWSP lets you play audio files through your microphone. Has both CLI and GUI
- clients.
-

apt/dists/nightly/main/binary-arm64/Release

@@ -1,5 +0,0 @@
-Component: main
-Origin: arabianq
-Label: PipeWire Soundpad
-Architecture: arm64
-Description: Nightly APT Repository for PWSP

apt/dists/stable/InRelease

@@ -1,38 +0,0 @@
------BEGIN PGP SIGNED MESSAGE-----
-Hash: SHA512
-
-Origin: arabianq
-Label: PipeWire Soundpad
-Codename: stable
-Date: Tue, 07 Jul 2026 17:42:23 UTC
-Architectures: amd64 arm64
-Components: main
-Description: APT Repository for PWSP
-MD5Sum:
- 869c96abbb5976d86c44302fac936984 614 main/binary-amd64/Packages
- 0f5d05d7a3c9fc30d58ed03ed1654604 440 main/binary-amd64/Packages.gz
- f82d685802fbb32fec3c9ba8e11e55b9 115 main/binary-amd64/Release
- b8d8fb0e8e8ec10430f645c2fe86792a 614 main/binary-arm64/Packages
- 7b8182f752d178e46694dd6a0b05bd26 438 main/binary-arm64/Packages.gz
- 113dd4f621500874592b2a2f1eeb45ae 115 main/binary-arm64/Release
-SHA1:
- 3dfa923770c4413856340b833eeb8490d0ea030f 614 main/binary-amd64/Packages
- 5a32a96958dbd7d5f0a2cce78bb947740078f2a7 440 main/binary-amd64/Packages.gz
- 1ff55a261c49c41f38e6da56f1f5d7136d38b08f 115 main/binary-amd64/Release
- 3329fe20b45dd1cd4d2892e1132771887202388e 614 main/binary-arm64/Packages
- 33d0957f621c8f9651d63a53f1c0e00d03037baa 438 main/binary-arm64/Packages.gz
- be63fa980d70857efdc424c837cd54ab986a40cd 115 main/binary-arm64/Release
-SHA256:
- c587995f0269786078e56e837c0c9775558208e33a7135aa1dafe4cc3f66df47 614 main/binary-amd64/Packages
- 49e5def689255f59112ae0423f6511e2f59632bf8b9e5891f8ee34b71c78db09 440 main/binary-amd64/Packages.gz
- c670ad086ec5b85d17211cb15e8e4ac1fb49a6398d0c9672992c26a009229d8c 115 main/binary-amd64/Release
- 189e4c7bc0a4672791af06a223f1e1a22326c5f4c8d862c3dbfa2245e2603b09 614 main/binary-arm64/Packages
- c45d85796ccd1b77bb1aff64d091a53fa9c839499e3858d32ed45f82ea06b577 438 main/binary-arm64/Packages.gz
- 4a90ce2395fbe57635b23de83540564c0917b2f419cd69ab2630fc1520bb5c11 115 main/binary-arm64/Release
------BEGIN PGP SIGNATURE-----
-
-iHQEARYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCak06fwAKCRCDybDbLI+d
-Fh7oAPdbMkcOyajWTJKJda9EEw8dGcB0Lc0LmGvf+aLHF4ZpAP9O20JQnaFwqAEV
-BzNxNvi4w9VGHD89XxazepUR3y9QAw==
-=KrwB
------END PGP SIGNATURE-----

apt/dists/stable/Release

@@ -1,28 +0,0 @@
-Origin: arabianq
-Label: PipeWire Soundpad
-Codename: stable
-Date: Tue, 07 Jul 2026 17:42:23 UTC
-Architectures: amd64 arm64
-Components: main
-Description: APT Repository for PWSP
-MD5Sum:
- 869c96abbb5976d86c44302fac936984 614 main/binary-amd64/Packages
- 0f5d05d7a3c9fc30d58ed03ed1654604 440 main/binary-amd64/Packages.gz
- f82d685802fbb32fec3c9ba8e11e55b9 115 main/binary-amd64/Release
- b8d8fb0e8e8ec10430f645c2fe86792a 614 main/binary-arm64/Packages
- 7b8182f752d178e46694dd6a0b05bd26 438 main/binary-arm64/Packages.gz
- 113dd4f621500874592b2a2f1eeb45ae 115 main/binary-arm64/Release
-SHA1:
- 3dfa923770c4413856340b833eeb8490d0ea030f 614 main/binary-amd64/Packages
- 5a32a96958dbd7d5f0a2cce78bb947740078f2a7 440 main/binary-amd64/Packages.gz
- 1ff55a261c49c41f38e6da56f1f5d7136d38b08f 115 main/binary-amd64/Release
- 3329fe20b45dd1cd4d2892e1132771887202388e 614 main/binary-arm64/Packages
- 33d0957f621c8f9651d63a53f1c0e00d03037baa 438 main/binary-arm64/Packages.gz
- be63fa980d70857efdc424c837cd54ab986a40cd 115 main/binary-arm64/Release
-SHA256:
- c587995f0269786078e56e837c0c9775558208e33a7135aa1dafe4cc3f66df47 614 main/binary-amd64/Packages
- 49e5def689255f59112ae0423f6511e2f59632bf8b9e5891f8ee34b71c78db09 440 main/binary-amd64/Packages.gz
- c670ad086ec5b85d17211cb15e8e4ac1fb49a6398d0c9672992c26a009229d8c 115 main/binary-amd64/Release
- 189e4c7bc0a4672791af06a223f1e1a22326c5f4c8d862c3dbfa2245e2603b09 614 main/binary-arm64/Packages
- c45d85796ccd1b77bb1aff64d091a53fa9c839499e3858d32ed45f82ea06b577 438 main/binary-arm64/Packages.gz
- 4a90ce2395fbe57635b23de83540564c0917b2f419cd69ab2630fc1520bb5c11 115 main/binary-arm64/Release

apt/dists/stable/Release.gpg

@@ -1,7 +0,0 @@
------BEGIN PGP SIGNATURE-----
-
-iHUEABYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCak06fwAKCRCDybDbLI+d
-Ft61AQD7Z6SUCFVr9Q0GLUoM/cVOFgCDnKVCQCR3vI4eEanlowD8DUYMQGaABmFD
-X9i5y+B2J63QJnQ8BLE2+oDRhhOoogQ=
-=KE2B
------END PGP SIGNATURE-----

apt/dists/stable/main/binary-amd64/Packages

@@ -1,17 +0,0 @@
-Package: pwsp
-Version: 1.12.4-1
-Architecture: amd64
-Homepage: https://pwsp.arabianq.ru
-Maintainer: arabian
-Installed-Size: 14054
-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.12.4-1_amd64.deb
-Size: 4472924
-SHA256: 1a85c5e97d67db3a804bc414961ad977d95098fc588dc0c1f25b2b8235b6bb8b
-SHA1: d6ba52feb64cb08b9f4c5c48b70f14120c22a0bc
-MD5sum: c6fb84e6f5bc24f49f6d2418f43beadb
-Description: PWSP lets you play audio files through your microphone. Has both CLI and GUI
- clients.
-

apt/dists/stable/main/binary-amd64/Release

@@ -1,5 +0,0 @@
-Component: main
-Origin: arabianq
-Label: PipeWire Soundpad
-Architecture: amd64
-Description: APT Repository for PWSP

apt/dists/stable/main/binary-arm64/Packages

@@ -1,17 +0,0 @@
-Package: pwsp
-Version: 1.12.4-1
-Architecture: arm64
-Homepage: https://pwsp.arabianq.ru
-Maintainer: arabian
-Installed-Size: 11518
-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.12.4-1_arm64.deb
-Size: 3965844
-SHA256: 82bb82eda274752ac0118e17cd71c73e373c0a393733756bab2acec3db657cbf
-SHA1: efe4c88ff6b908a4a7ffd82bff74003d05055038
-MD5sum: d88f9c676e07e31477be52eb3105ae64
-Description: PWSP lets you play audio files through your microphone. Has both CLI and GUI
- clients.
-

apt/dists/stable/main/binary-arm64/Release

@@ -1,5 +0,0 @@
-Component: main
-Origin: arabianq
-Label: PipeWire Soundpad
-Architecture: arm64
-Description: APT Repository for PWSP

apt/pubkey.gpg

@@ -1,13 +0,0 @@
------BEGIN PGP PUBLIC KEY BLOCK-----
-
-mDMEaezCthYJKwYBBAHaRw8BAQdAyDiO0akghMksZ6O02KlelezoaePzXhH8yNWS
-eAWTuRi0DGEudGV2Z0B5YS5ydYiZBBMWCgBBFiEEquPFax4tNncQjPKAg8mw2yyP
-nRYFAmnswrYCGwMFCQWjmoAFCwkIBwICIgIGFQoJCAsCBBYCAwECHgcCF4AACgkQ
-g8mw2yyPnRbXawEAo0EPrAfePpIVj+CIph+Muj1ZU9Ui5+CD32J9XtSJYRcBANTz
-txOH1oG5n3eFZ/HCnU4Z+yiqEhGI2b//fC8jxx0HuDgEaezCthIKKwYBBAGXVQEF
-AQEHQEt/m+vl2KMpu+TZWaLDa6jnR3ctu3xbYpjfqDtOl+YnAwEIB4h4BBgWCgAg
-FiEEquPFax4tNncQjPKAg8mw2yyPnRYFAmnswrYCGwwACgkQg8mw2yyPnRbEHAD+
-PiMF1s5ZYNlfp3RcOTasrasWDjmCXvFYbeM3vWCAO94BAIlfzEZKodeZ4jfTuf+u
-QoXpv5yiGFpf7xFOxcvXE38B
-=F4OX
------END PGP PUBLIC KEY BLOCK-----

assets/pwsp-daemon.service

@@ -0,0 +1,11 @@
+[Unit]
+Description=Pipewire Soundpad Daemon
+After=pipewire.service
+
+[Service]
+ExecStart=/usr/bin/pwsp-daemon
+Restart=no
+RuntimeDirectory=pwsp
+
+[Install]
+WantedBy=default.target

assets/pwsp-gui.desktop

@@ -0,0 +1,8 @@
+[Desktop Entry]
+Name=PWSP (Soundpad)
+Comment=Let's you play audio files through you microphone
+Exec=pwsp-gui %u
+Icon=pwsp
+Terminal=false
+Type=Application
+Categories=Audio

config

@@ -1,4 +0,0 @@
-[core]
-repo_version=1
-mode=archive-z2
-indexed-deltas=true