From d321fb6784db39b8f14be7a6d33c4a1da974fec8 Mon Sep 17 00:00:00 2001 From: Suresh-Krishna-P Date: Mon, 2 Feb 2026 05:53:59 +0530 Subject: [PATCH] fix: Add mpv dependency documentation and AUR package configuration - Document mpv as required runtime dependency in Linux installation guide - Add recommended installation method using apt install with .deb file - Include troubleshooting section for dependency resolution - Add mpv to AUR PKGBUILD depends array for automatic installation on Arch Linux Fixes: Missing mpv dependency on .deb package installation --- .github/workflows/aur-publish.yml | 2 +- INSTALLATION.md | 35 ++++++++++++++++++++++--------- 2 files changed, 26 insertions(+), 11 deletions(-) diff --git a/.github/workflows/aur-publish.yml b/.github/workflows/aur-publish.yml index 10d9108e..d79f27ee 100644 --- a/.github/workflows/aur-publish.yml +++ b/.github/workflows/aur-publish.yml @@ -57,7 +57,7 @@ jobs: arch=('x86_64' 'aarch64') url="https://apidash.dev" license=('Apache-2.0') - depends=() + depends=('mpv') options=('!emptydirs' '!strip') source=("LICENSE::https://raw.githubusercontent.com/foss42/apidash/main/LICENSE") source_x86_64=("apidash-linux-amd64.deb::https://github.com/foss42/apidash/releases/download/v${{ steps.get_version.outputs.version }}/apidash-linux-amd64.deb") diff --git a/INSTALLATION.md b/INSTALLATION.md index f6285b4a..d01a70ff 100644 --- a/INSTALLATION.md +++ b/INSTALLATION.md @@ -91,21 +91,36 @@ https://user-images.githubusercontent.com/1382619/227956871-87376f18-d80f-4a53-9 ### Debian-based Linux Distributions (Debian, Ubuntu, Linux Mint, etc.) -Download the `.deb` file from the [latest release](https://github.com/foss42/apidash/releases/latest) corresponding to you CPU architecture (x64/amd64 or arm64). +API Dash requires `mpv` as a runtime dependency for audio/video functionality. -`cd` to the Downloads folder and execute the following command to install API Dash. +**Installation Steps:** +1. Download the `.deb` file from the [latest release](https://github.com/foss42/apidash/releases/latest) corresponding to your CPU architecture (x64/amd64 or arm64). + +2. `cd` to the Downloads folder and execute one of the following commands to install API Dash: + + **Recommended Method** (automatically resolves dependencies): + ``` + sudo apt install ./apidash-.deb + ``` + + Or, manually install the dependency first: + ``` + sudo apt update + sudo apt install mpv + sudo dpkg -i apidash-.deb + ``` + +3. Launch API Dash via `apidash` command or by clicking on the API Dash app icon. + +**Troubleshooting:** + +If you encounter a dependency error mentioning `mpv is not installed`, run: ``` -sudo apt install ./apidash-.deb +sudo apt install --fix-broken ``` -or - -``` -sudo dpkg -i apidash-.deb -``` - -Launch API Dash via `apidash` command or by clicking on the API Dash app icon. +This will automatically install any missing dependencies. ### Red Hat-based Linux Distributions (Fedora, Rocky, AlmaLinux, CentOS, RHEL, etc.)