{"id":13588909,"url":"https://github.com/Zibbp/Radium","last_synced_at":"2025-04-08T06:33:00.647Z","repository":{"id":42046850,"uuid":"282735149","full_name":"Zibbp/Radium","owner":"Zibbp","description":"Synced stream and video playback with VOD capabilities utilizing HLS. Developed for movie nights but has many use cases.","archived":false,"fork":false,"pushed_at":"2023-11-04T18:45:57.000Z","size":6722,"stargazers_count":193,"open_issues_count":16,"forks_count":29,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-06T08:43:23.346Z","etag":null,"topics":["hacktoberfest","hls","nginx","rtmp","streaming","sync","video","vod"],"latest_commit_sha":null,"homepage":"https://github.com/Zibbp/Radium","language":"Vue","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/Zibbp.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}},"created_at":"2020-07-26T21:20:11.000Z","updated_at":"2024-11-01T18:21:15.000Z","dependencies_parsed_at":"2024-01-14T04:44:10.967Z","dependency_job_id":"d5c2cdb5-053f-4e97-9061-b2f4e8f5d327","html_url":"https://github.com/Zibbp/Radium","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zibbp%2FRadium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zibbp%2FRadium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zibbp%2FRadium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zibbp%2FRadium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zibbp","download_url":"https://codeload.github.com/Zibbp/Radium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247792233,"owners_count":20996880,"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":["hacktoberfest","hls","nginx","rtmp","streaming","sync","video","vod"],"created_at":"2024-08-01T15:07:01.051Z","updated_at":"2025-04-08T06:32:55.567Z","avatar_url":"https://github.com/Zibbp.png","language":"Vue","funding_links":[],"categories":["Vue","Software","HarmonyOS"],"sub_categories":["Media Streaming - Video Streaming","Windows Manager"],"readme":"\u003ch1 align=\"center\"\u003e\r\n  \u003cbr\u003e\r\n  \u003ca href=\"https://github.com/Zibbp/Radium\"\u003e\u003cimg src=\"https://i.imgur.com/gylnyVs.png\" alt=\"Radium\" width=\"500\"\u003e\u003c/a\u003e\r\n  \u003cbr\u003e\r\n\u003c/h1\u003e\r\n\r\n## Radium Next\r\n\r\n[Radium Next](https://github.com/Zibbp/Radium/tree/next) is a sub-second streaming version of Radium using [OvenMediaEngine](https://github.com/AirenSoft/OvenMediaEngine). Visit the [branch](https://github.com/Zibbp/Radium/tree/next) for more information.\r\n\r\n\u003ch4 align=\"center\"\u003e🖥️\u003ca href=\"https://radium-demo.herokuapp.com\" target=\"_blank\"\u003eDemo\u003c/a\u003e\u003ci\u003e may take a minute to wake app\u003c/i\u003e\u003c/h4\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n  Radium\u003ca href=\"https://github.com/Zibbp/Radium\"\u003e\r\n    \u003cimg src=\"https://github.com/Zibbp/Radium/workflows/Build/badge.svg?branch=master\"\r\n         alt=\"Docker Image\"\u003e\r\n  \u003c/a\u003e\r\n  Nginx-RTMP-HLS \u003ca href=\"https://github.com/Zibbp/Nginx-RTMP-HLS\"\u003e\u003cimg src=\"https://github.com/Zibbp/Nginx-RTMP-HLS/workflows/Build/badge.svg\"\u003e\u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n![screenshot](https://i.imgur.com/lHmxc6m.png)\r\nAdvanced Controls found below the player\r\n![screenshot_ac](https://i.imgur.com/vHE50aH.png)\r\n\r\n## Features\r\n\r\n- HLS\r\n  - RTMP to HLS stream with VOD capabilities\r\n  - Direct HLS playback\r\n- Controls\r\n  - Play, pause, and sync all members in the room\r\n- Sync Room\r\n  - Sync button pushes users time to all clients\\*\r\n- Chat\r\n  - No login, simply enter a displayname\r\n  - Custom emotes from images\r\n  - Admin authentication\\*\r\n- Now Playing\r\n  - Set what is being played [more info](https://github.com/Zibbp/Radium/wiki/Now-Playing---OMDb-API)\r\n- More coming soon!\r\n\r\n\\*Only Admins are able to sync the room\r\n\r\n## Getting Started\r\n\r\n### Basic usage\r\n\r\nRadium runs in a Docker container, simply modify and run the docker command.\r\n\r\n```bash\r\n# Basic Docker Container\r\n$ docker run -d --name=radium -p 3000:3000 -e BASE_URL=https://radium.example.com zibbp/radium:latest\r\n```\r\n\r\n**Prefer using docker compose? Check out the [`docker-compose.yml`](https://github.com/Zibbp/Radium/blob/master/docker-compose.yml)**\r\n\r\nWant to use Heroku? Click the button, enter environment variables, and click deploy!\r\n\r\n[![Deploy to Heroku](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy)\r\n\r\n### Options\r\n\r\n##### Base URL _(REQUIRED)_\r\n\r\nThe base url is required for basic functionality.\r\n\r\n_If not using a reverse proxy and a domain, the IP and PORT need to be supplied._\r\n\r\n```bash\r\n# Add the following environment variable\r\n-e BASE_URL=https://radium.example.com\r\n```\r\n\r\nor\r\n\r\n```bash\r\n# Add the following environment variable\r\n-e BASE_URL=http://1.2.3.4:3000\r\n```\r\n\r\n##### HLS\r\n\r\nThe HLS url can be changed via an environment variable or within the application when running. To set a permanent url, pass the environment variable `HLS_URL` through.\r\n\r\n```bash\r\n# Add the following environment variable\r\n-e HLS_URL=https://domain.com/stream.m3u8\r\n```\r\n\r\n_If the `HLS_URL` variable is not passed through, a default demo file will play._\r\n\r\n\u003e Visit the documentation for generating HLS media.\r\n\r\n##### Admin Token\r\n\r\nThe admin token is automatically generated and logged to the console whenever started, but a custom one can be passed through.\r\n\r\n```bash\r\n# Add the following environment variable\r\n-e ADMIN_TOKEN=secret123\r\n```\r\n\r\n\u003e Visit the documentation for token usage.\r\n\r\n## Documentation\r\n\r\n### [Full Documentation](https://github.com/Zibbp/Radium/wiki)\r\n\r\n#### Highlights\r\n\r\n- [Generating HLS media](https://github.com/Zibbp/Radium/wiki/HLS)\r\n- [Chat Commands](https://github.com/Zibbp/Radium/wiki/Chat-Commands)\r\n- [Advanced Usage](https://github.com/Zibbp/Radium/wiki/Advanced-Usage)\r\n\r\n## Alternatives\r\n\r\n##### Looking for something else? Check out these amazing opensource projects.\r\n\r\n- [MovieNight](https://github.com/zorchenhimer/MovieNight) _This is a single-instance streaming server with chat. Originally written to replace Rabbit as the platform for watching movies with a group of people online._\r\n- [Open Streaming Platform](https://gitlab.com/Deamos/flask-nginx-rtmp-manager) _A Self-Hosted Video Streaming and Recording Server Using Python, Flask, Nginx-RTMP._\r\n- [Jellyfin](https://github.com/jellyfin/jellyfin) _The Free Software Media System_ **v10.6 introduced a synced playback feature**\r\n\r\n## Information\r\n\r\n\u003e [zibbp.tech](https://zibbp.tech) \u0026nbsp;\u0026middot;\u0026nbsp;\r\n\u003e GitHub [@zibbp](https://github.com/zibbp) \u0026nbsp;\u0026middot;\u0026nbsp;\r\n\r\n## License\r\n\r\nRadium is distributed under the terms of the MIT license. See [LICENSE.md](https://github.com/Zibbp/Radium/blob/master/LICENSE) for details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZibbp%2FRadium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZibbp%2FRadium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZibbp%2FRadium/lists"}