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: 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-----

apt/dists/nightly/Release

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

apt/dists/nightly/Release.gpg

@@ -1,7 +0,0 @@
------BEGIN PGP SIGNATURE-----
-
-iHUEABYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCaqGqEwAKCRCDybDbLI+d
-FuNMAQCtjnEsKYB9dEETRabshZ/2S1BwNKAgWKj3aE5+afDCBQD+JfPjQQ2+6tt+
-/xCuU3JRqZFbUqMSbY6ZL0ZkTzERIgM=
-=qgSp
------END PGP SIGNATURE-----

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

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

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.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.
-

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: 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-----

apt/dists/stable/Release

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

apt/dists/stable/Release.gpg

@@ -1,7 +0,0 @@
------BEGIN PGP SIGNATURE-----
-
-iHUEABYKAB0WIQSq48VrHi02dxCM8oCDybDbLI+dFgUCaqGyvAAKCRCDybDbLI+d
-FvBpAQDPkQcCTHgvBtnRvP1TIv6ofOq3UAG0joDPBOUXPCDxsAEAo2nUt63XsNxF
-d3H6UgcFl5w6IyQF0zzOo6/fovKZYAM=
-=b6kV
------END PGP SIGNATURE-----

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

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

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.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.
-

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