{"id":19853862,"url":"https://github.com/magnetikonline/docker-acestream-server","last_synced_at":"2025-04-05T07:06:19.505Z","repository":{"id":147825609,"uuid":"133236943","full_name":"magnetikonline/docker-acestream-server","owner":"magnetikonline","description":"Ace Stream server Docker image and playback CLI for media players.","archived":false,"fork":false,"pushed_at":"2024-11-26T01:19:52.000Z","size":20,"stargazers_count":133,"open_issues_count":4,"forks_count":36,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-29T06:07:45.369Z","etag":null,"topics":["acestream","acestream-engine","docker","python","vlc","vlc-media-player"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/magnetikonline/acestream-server/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/magnetikonline.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}},"created_at":"2018-05-13T12:55:01.000Z","updated_at":"2025-03-02T19:38:17.000Z","dependencies_parsed_at":"2025-01-05T06:14:25.254Z","dependency_job_id":null,"html_url":"https://github.com/magnetikonline/docker-acestream-server","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magnetikonline%2Fdocker-acestream-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magnetikonline%2Fdocker-acestream-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magnetikonline%2Fdocker-acestream-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magnetikonline%2Fdocker-acestream-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/magnetikonline","download_url":"https://codeload.github.com/magnetikonline/docker-acestream-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247299832,"owners_count":20916190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["acestream","acestream-engine","docker","python","vlc","vlc-media-player"],"created_at":"2024-11-12T14:07:52.826Z","updated_at":"2025-04-05T07:06:19.485Z","avatar_url":"https://github.com/magnetikonline.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Ace Stream server\n\nAn [Ace Stream](http://www.acestream.org/) server Docker image.\n\n- [Overview](#overview)\n- [Building](#building)\n- [Usage](#usage)\n- [Reference](#reference)\n\n## Overview\n\nWhat this provides:\n\n- Dockerized Ace Stream server (version `3.1.49`) running under Debian 8 (Jessie) slim.\n- Bash script to start server and present HTTP API endpoint to host.\n- Python playback script [`playstream.py`](playstream.py) instructing server to:\n\t- Commence streaming of a given program ID.\n\t- ...and optionally start a compatible media player (such as [VLC](https://www.videolan.org/vlc/)) to view stream.\n\nSince a single HTTP endpoint exposed from the Docker container controls the server _and_ provides the output stream, this provides one of the easier methods for playback of Ace Streams on traditionally unsupported operating systems such as macOS.\n\n## Building\n\nTo build Docker image:\n\n```sh\n$ ./build.sh\n```\n\nAlternatively pull the Docker Hub image:\n\n```sh\n$ docker pull magnetikonline/acestream-server:3.1.49_debian_8.11\n```\n\n## Usage\n\nStart the server via:\n\n```sh\n$ ./run.sh\n```\n\nFor Linux hosts the alternative [`run-tmpfs.sh`](run-tmpfs.sh) is recommended, mounting the cache directory into a [temporary based `tmpfs`](run-tmpfs.sh#L12) file system. This saves thrashing of the file system as stream contents is written to disk - which does not seem possible to disable via server launch arguments.\n\nServer will now be available from `http://127.0.0.1:6878`:\n\n```sh\n$ curl http://127.0.0.1:6878/webui/api/service?method=get_version\n# {\"result\": {\"code\": 3014900, \"platform\": \"linux\", \"version\": \"3.1.49\"}, \"error\": null}\n```\n\nA program ID can be started with [`playstream.py`](playstream.py):\n\n```sh\n$ ./playstream.py --help\nusage: playstream.py [-h] --ace-stream-pid HASH [--player PLAYER] [--progress]\n                     [--server HOSTNAME] [--port PORT]\n\nInstructs server to commence a given program ID. Will optionally execute a\nlocal media player once playback has started.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --ace-stream-pid HASH\n                        program ID to stream\n  --player PLAYER       media player to execute once stream active\n  --progress            continue to output stream statistics (connected\n                        peers/transfer rates) every 2 seconds\n  --server HOSTNAME     server hostname, defaults to 127.0.0.1\n  --port PORT           server HTTP API port, defaults to 6878\n```\n\nFor example, to stream `PROGRAM_ID` and send playback to `vlc` when ready:\n\n```sh\n$ ./playstream.py \\\n\t--ace-stream-pid PROGRAM_ID \\\n\t--player /usr/bin/vlc \\\n\t--progress\n\nAwaiting successful connection to stream\nWaiting... [Peers: 5 // Down: 80KB // Up: 0KB]\nWaiting... [Peers: 40 // Down: 343KB // Up: 4KB]\nReady!\n\nPlayback available at [http://127.0.0.1/XXXX]\nStarting media player...\n\nStreaming... [Peers: 18 // Down: 467KB // Up: 16KB]\n```\n\nSend \u003ckbd\u003eCtrl + C\u003c/kbd\u003e to exit.\n\n## Reference\n\n- Binary downloads: https://wiki.acestream.org/Download\n- Ubuntu install notes: https://wiki.acestream.org/Install_Ubuntu\n- HTTP API usage: https://wiki.acestream.org/Engine_HTTP_API\n- `playstream.py` routines inspired by: https://github.com/jonian/acestream-launcher\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagnetikonline%2Fdocker-acestream-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmagnetikonline%2Fdocker-acestream-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagnetikonline%2Fdocker-acestream-server/lists"}