{"id":23461334,"url":"https://github.com/hhromic/opencubicplayer-docker","last_synced_at":"2026-04-15T12:37:15.960Z","repository":{"id":178135832,"uuid":"611507201","full_name":"hhromic/opencubicplayer-docker","owner":"hhromic","description":"Docker images for running the Unix fork of Open Cubic Player.","archived":false,"fork":false,"pushed_at":"2026-03-23T00:03:05.000Z","size":56,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-23T05:25:10.953Z","etag":null,"topics":["docker","docker-image","flac","hvl","impulsetracker","midi-player","mod","modulefiles","music","music-player","music-visualizer","ogg-vorbis","opl2","opl3","s3m","sid","timidity"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hhromic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-03-09T00:51:14.000Z","updated_at":"2026-03-23T00:03:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"37b66e5c-956b-4166-8c6e-2533520e6da1","html_url":"https://github.com/hhromic/opencubicplayer-docker","commit_stats":null,"previous_names":["hhromic/opencubicplayer-docker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hhromic/opencubicplayer-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhromic%2Fopencubicplayer-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhromic%2Fopencubicplayer-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhromic%2Fopencubicplayer-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhromic%2Fopencubicplayer-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hhromic","download_url":"https://codeload.github.com/hhromic/opencubicplayer-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhromic%2Fopencubicplayer-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31842185,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T11:29:19.690Z","status":"ssl_error","status_checked_at":"2026-04-15T11:29:19.171Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-image","flac","hvl","impulsetracker","midi-player","mod","modulefiles","music","music-player","music-visualizer","ogg-vorbis","opl2","opl3","s3m","sid","timidity"],"created_at":"2024-12-24T07:34:32.075Z","updated_at":"2026-04-15T12:37:15.951Z","avatar_url":"https://github.com/hhromic.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# opencubicplayer-docker\n\nThis repository contains files for building Docker images for the\n[Unix fork of Open Cubic Player](https://github.com/mywave82/opencubicplayer).\n\n\u003e Unix port of [Open Cubic Player](https://www.cubic.org/player/), which is a text-based player\n\u003e with some few graphical views. Visual output can be done through nCurses, Linux console\n\u003e (VCSA + FrameBuffer), X11 or SDL. This port can be compiled for various different\n\u003e Unix-based operating systems, including MinGW compilers.\n\nTwo image targets are available in the provided [Dockerfile](Dockerfile):\n\n* `opencubicplayer`: Produces an image containing Open Cubic Player.\n* `opencubicplayer-midi`: Produces an `opencubicplayer` image with MIDI playback support.\n\nAll images are based on the official\n[Debian Bookworm](https://hub.docker.com/_/debian) image.\n\nFor MIDI playback support, the `opencubicplayer-midi` target pre-configures Timidity and\nbundles the [GeneralUser GS](https://github.com/mrbumpy409/GeneralUser-GS) Soundfont.\nThis Soundfont provides high quality MIDI audio rendering. Other Soundfont files can\nbe used as well.\n\nRefer to the [usage](#usage) section for more details.\n\n## Usage\n\nReady to use images are available in the\n[GitHub Container Registry](https://github.com/hhromic?tab=packages\u0026repo_name=opencubicplayer-docker).\n\n\u003e [!TIP]\n\u003e Use the `opencubicplayer-midi:latest` image/tag for MIDI playback support.\n\n### Linux\n\nThe images can be used in Linux with ALSA (without audio servers) or PulseAudio.\n\nTwo versions of Docker are available for Linux:\n* [Docker Desktop for Linux](https://docs.docker.com/desktop/install/linux-install/)\n  (limited as it uses virtualization)\n* [Docker Engine](https://docs.docker.com/engine/install/) (the recommended version)\n\nWhen using graphical mode in Linux, access to X11 must be granted to `root` by running:\n```\nxhost +local:root\n```\n\n\u003e [!WARNING]\n\u003e The above access grant is lost when the X11 server is restarted.\n\n#### Using ALSA\n\nTo run Open Cubic Player in Linux using ALSA (ncurses mode):\n```\ndocker run --rm -it \\\n    --device /dev/snd\n    -v /path/to/media:/media:ro \\\n    ghcr.io/hhromic/opencubicplayer:latest \\\n    ocp-curses\n```\n\nTo run Open Cubic Player in Linux using ALSA (graphical mode):\n```\ndocker run --rm -it \\\n    --device /dev/snd\n    -v /path/to/media:/media:ro \\\n    -v /tmp/.X11-unix:/tmp/.X11-unix \\\n    -e DISPLAY \\\n    ghcr.io/hhromic/opencubicplayer:latest \\\n    ocp-sdl2\n```\n\n#### Using PulseAudio\n\n\u003e [!NOTE]\n\u003e The examples below are for Debian/Ubuntu desktops.\n\u003e Please review the paths in other distributions.\n\nTo run Open Cubic Player in Linux using PulseAudio (ncurses mode):\n```\ndocker run --rm -it \\\n    -v /path/to/media:/media:ro \\\n    -v /run/user/$(id -u):/run/user/$(id -u) \\\n    -v $HOME/.config/pulse:/root/.config/pulse:ro \\\n    -e PULSE_SERVER=/run/user/$(id -u)/pulse/native \\\n    ghcr.io/hhromic/opencubicplayer:latest \\\n    ocp-curses -spdevpSDL2\n```\n\nTo run Open Cubic Player in Linux using PulseAudio (graphical mode):\n```\ndocker run --rm -it \\\n    -v /path/to/media:/media:ro \\\n    -v /run/user/$(id -u):/run/user/$(id -u) \\\n    -v $HOME/.config/pulse:/root/.config/pulse:ro \\\n    -v /tmp/.X11-unix:/tmp/.X11-unix \\\n    -e PULSE_SERVER=/run/user/$(id -u)/pulse/native \\\n    -e DISPLAY \\\n    ghcr.io/hhromic/opencubicplayer:latest \\\n    ocp-sdl2 -spdevpSDL2\n```\n\n### Windows Subsystem for Linux (WSL2)\n\nThe images can be used in [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install)\nwith [WSLg](https://github.com/microsoft/wslg) and\n[Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)\nin Windows 10/11.\n\nWSLg provides support for PulseAudio and graphical mode via X11.\n\nTo run Open Cubic Player in WSL2 with WSLg (ncurses mode):\n```\ndocker run --rm -it \\\n    -v /path/to/media:/media:ro \\\n    -v /mnt/wslg:/mnt/wslg \\\n    -e PULSE_SERVER \\\n    ghcr.io/hhromic/opencubicplayer:latest \\\n    ocp-curses -spdevpSDL2\n```\n\nTo run Open Cubic Player in WSL2 with WSLg (graphical mode):\n```\ndocker run --rm -it \\\n    -v /path/to/media:/media:ro \\\n    -v /mnt/wslg:/mnt/wslg \\\n    -v /tmp/.X11-unix:/tmp/.X11-unix \\\n    -e PULSE_SERVER \\\n    -e DISPLAY \\\n    ghcr.io/hhromic/opencubicplayer:latest \\\n    ocp-sdl2 -spdevpSDL2\n```\n\n### Custom MIDI Soundfont\n\nTo use a custom Soundfont file for MIDI playback (ncurses mode):\n```\ndocker run --rm -it \\\n    -v /path/to/media:/media:ro \\\n    -v /path/to/soundfont.sf2:/usr/share/soundfonts/default.sf2:ro \\\n    -v /mnt/wslg:/mnt/wslg \\\n    -e PULSE_SERVER \\\n    ghcr.io/hhromic/opencubicplayer-midi:latest \\\n    ocp-curses -spdevpSDL2\n```\n\n### Data Persistence\n\nOpen Cubic Player fully conforms to the\n[XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/latest/)\nfor storing user configuration and data.\n\nTo simplify data persistence, the images are pre-configured with the following XDG base directories:\n\n* `XDG_CONFIG_HOME` set to `/xdg/config`.\n* `XDG_CACHE_HOME` set to `/xdg/cache`.\n* `XDG_DATA_HOME` set to `/xdg/data`.\n* `XDG_STATE_HOME` set to `/xdg/state`.\n\nThis configuration allows to use [Docker volumes](https://docs.docker.com/engine/storage/volumes/)\neasily for data persistence.\n\nTo mount a local `/path/to/ocp-data` path for data persistence of the container:\n```\ndocker run --rm -it \\\n    -v /path/to/ocp-data:/xdg \\\n    -v /path/to/media:/media:ro \\\n    -v /mnt/wslg:/mnt/wslg \\\n    -v /tmp/.X11-unix:/tmp/.X11-unix \\\n    -e PULSE_SERVER \\\n    -e DISPLAY \\\n    ghcr.io/hhromic/opencubicplayer:latest \\\n    ocp-sdl2 -spdevpSDL2\n```\n\nFor easier management, it is recommended to use\n[named volumes](https://docs.docker.com/engine/storage/volumes/#named-and-anonymous-volumes):\n```\ndocker volume create ocp-data\ndocker run --rm -it \\\n    -v ocp-data:/xdg \\\n    -v /path/to/media:/media:ro \\\n    -v /mnt/wslg:/mnt/wslg \\\n    -v /tmp/.X11-unix:/tmp/.X11-unix \\\n    -e PULSE_SERVER \\\n    -e DISPLAY \\\n    ghcr.io/hhromic/opencubicplayer:latest \\\n    ocp-sdl2 -spdevpSDL2\ndocker volume rm ocp-data\n```\n\n## Building\n\nTo build the images locally, use [Docker Build Bake](https://docs.docker.com/build/bake/):\n```\ndocker buildx bake\n```\n\n## Licenses\n\nThis project is licensed under the [Apache License Version 2.0](LICENSE).\n\nOpen Cubic Player (Unix fork) is licensed under the\n[GNU General Public License v2.0](https://github.com/mywave82/opencubicplayer/blob/master/COPYING).\n\nThe bundled GeneralUser GS Soundfont is under\n[its own license](https://github.com/mrbumpy409/GeneralUser-GS/blob/main/documentation/LICENSE.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhhromic%2Fopencubicplayer-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhhromic%2Fopencubicplayer-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhhromic%2Fopencubicplayer-docker/lists"}