SOX-Player

SOX-Player

Docker app from grtgbln's Repository

Overview

Play sounds on a host machine. Comes with a simple HTTP API for playing back audio on demand from a remote process or system. Designed for use in playing pre-recorded audio notifications for home automation software (openHAB).

Docker Hub

Dockerfiles and scripts for my Images hosted at https://hub.docker.com/u/kosdk.

You can build most of the images using the build.ps1 powershell script in each folder to build the respective images. Check the sections below for any parameters that you can pass to the builder.

The PowerShell build scripts have a $tag variable that you can edit so you can customize the image tag name for your repository. There is also a environment variable called DOCKER_HUB_PROFILE which contains the profile repository that these images are hosted on. The DOCKER_HUB_PROFILE must be set before using the build.ps1 scripts.

These build scripts use the experimental buildx command in Docker Desktop 2.0.4.0 or higher to build for multiple Linux platforms. You need to enable experimental features. Read more about this command here.

All these packages support multiple linux architectures including the Raspberry Pi. You're welcome!

Building Images

You can build them using the build.ps1 in their folder or for packages marked as UBT, building of the images is done via the unified build tool. Located in the repository root, the UBT build.ps1 can build all compatible packages.

The environment variable DOCKER_HUB_PROFILE must be set before you can build as this specifies the docker hub profile to build the image for.

Parameter Type Description
-image string The image to build. Required.
-output string The docker build output type (load, push, folder).
-outputpath string The output path when the output type is folder.
-version string Specifies a tag for the image. Required when image does not provide a version.

Check the readme for each image to see if there are any additional parameters to pass to build tool for the image.

Build Example

.\build soxplayer -output load -version 123

Images

UBT = Build using the Unified Build Tool.

Web Service Discovery host daemon

Readme | UBT

Allows legacy samba shares to be discovered by Windows 10 version 1511 and higher. Useful when hosting samba in docker. Runs on Python 3.

Chocolatey Package Manager

Readme

Supports building packages and pushing them to a Chocolatey Registry in a Linux Container.

This image only supports the choco pack, choco new and choco push commands.

PowerShell Core

Readme

Run PowerShell Core in a Linux Container.

ISC DHCP Server

Readme

The ISC DHCP Server running in a Docker Container.

RTL-SDR TCP Server

Readme | UBT

The RTL_TCP tool running in a Docker container.

Mega.nz megacmd

Readme | UBT

megacmd with some convenience functions to help with backing up files.

Sox Player

Readme | BSD 3-Clause | UBT

Runs sox player in a container with a simple HTTP web API to play/stop audio on demand.

File Backup

Readme | BSD 3-Clause | UBT

A linux container with a script to update files at set intervals with support for many platforms.

File Updater

Readme | BSD 3-Clause | UBT

A linux container with a script to update files at set intervals with support for many platforms.

DuckDNS Updater Client

Readme | BSD 3-Clause | UBT

A linux container to update your Dynamic DNS with DuckDNS with support for many platforms.

Docker in Docker with Powershell

Readme

A amd64 only container built from the official Docker container that includes Powershell Core.

Install SOX-Player on Unraid in a few clicks.

Find SOX-Player in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for SOX-Player Review the template variables and paths Click Install

Download Statistics

478
Total Downloads

Details

Repository
kosdk/soxplayer:latest
Last Updated2022-01-21
First Seen2025-10-31

Runtime arguments

Network
bridge
Privileged
false

Template configuration

API PortPorttcp

Container Port: 3859

Target
3859
Default
3859
Value
3859
Output DeviceDevice

Path to the output sound device (e.g., /dev/snd)

Target
/dev/snd
Sound FilesPathro

Path to the folder containing sound files to be played

Target
/data
Deny File ListingVariable

If true, prevents listing of available sound files via the API

Target
DENY_LIST
Default
false|true
Internal API PortVariable

Internal port the API listens on. Not recommended to change.

Target
PORT
Default
3859
Value
3859
Internal Sound Files LocationVariable

Internal path to the sound files location. Not recommended to change.

Target
LOCATION
Default
/data
Value
/data