environment-setup-ffmpeg

Goal

Installs and validates FFmpeg in a cross-platform way so Appium environments can use optional media-related capabilities when explicitly requested.

Decision Logic

• If host OS is unsupported: stop and ask the user to run on macOS, Linux, or Windows.
• If ffmpeg is already available in PATH: do not reinstall; only validate version output.
• If user has not explicitly requested FFmpeg-related capability: skip this skill.
• If host OS is macOS: prefer Homebrew install.
• If host OS is Linux: use distro package manager install.
• If host OS is Windows: prefer winget; fallback to Chocolatey if winget is unavailable.

Instructions

1. Detect OS and current FFmpeg availability macOS/Linux:

   uname -s
   command -v ffmpeg || echo "ffmpeg not found"
   ffmpeg -version || true
   

   Windows PowerShell:

   [System.Environment]::OSVersion.VersionString
   Get-Command ffmpeg.exe -ErrorAction SilentlyContinue
   ffmpeg -version
   

2. Install FFmpeg when missing macOS (Homebrew):

   brew install ffmpeg
   

   Linux (Debian/Ubuntu):

   sudo apt-get update
   sudo apt-get install -y ffmpeg
   

   Linux (RHEL/CentOS/Fedora):

   sudo dnf install -y ffmpeg
   

   Linux (Arch):

   sudo pacman -S --noconfirm ffmpeg
   

   Windows PowerShell (winget preferred):

   winget install --id Gyan.FFmpeg --exact --accept-package-agreements --accept-source-agreements
   

   Windows PowerShell (Chocolatey fallback):

   choco install ffmpeg -y
   

3. Validate installation and PATH macOS/Linux:

   command -v ffmpeg
   ffmpeg -version
   

   Windows PowerShell:

   Get-Command ffmpeg.exe -ErrorAction SilentlyContinue
   ffmpeg -version
   

4. Report capability in task result Include:
   • resolved FFmpeg executable path
   • first line of ffmpeg -version
   • whether installation was skipped because FFmpeg was already present

Completion criteria

Mark complete only when all are true:

• ffmpeg is resolvable from PATH
• ffmpeg -version succeeds
• result summary states whether install was performed or skipped

Constraints

• This is an optional skill; run only when the user explicitly requests FFmpeg-related setup.
• Ask before installing optional dependencies.
• If privileged commands are required, pause and provide exact commands for user execution.
• Do not modify unrelated Appium, Java, Android SDK, or Xcode configuration in this skill.