Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/banksio/remote-media
A node.js web app to synchronise videos (and the audio) between different users.
https://github.com/banksio/remote-media
audio nodejs reciever sync youtube youtube-videos
Last synced: 3 days ago
JSON representation
A node.js web app to synchronise videos (and the audio) between different users.
- Host: GitHub
- URL: https://github.com/banksio/remote-media
- Owner: banksio
- License: mit
- Created: 2019-02-11T18:34:26.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-10T16:44:29.000Z (almost 2 years ago)
- Last Synced: 2024-08-08T04:56:35.692Z (3 months ago)
- Topics: audio, nodejs, reciever, sync, youtube, youtube-videos
- Language: JavaScript
- Homepage:
- Size: 1.3 MB
- Stars: 3
- Watchers: 5
- Forks: 1
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# remote-media
[](https://banksio.visualstudio.com/remote-media/_build/latest?definitionId=6&branchName=master)
[](https://banksio.visualstudio.com/remote-media/_build/latest?definitionId=6&branchName=master)
[](https://banksio.visualstudio.com/remote-media/_build/latest?definitionId=6&branchName=master)
[](https://david-dm.org/banksio/remote-media)
[](https://hub.docker.com/r/banksio/remote-media)
A node.js web app to synchronise YouTube videos (and the audio) between different users. Currently designed for audio, this solution does not yet keep users in sync if they manually seek after the video has begun. Everyone should be in sync at the beginning of the video and otherwise if they do not seek their video manually.
Currently in beta: There may still be some rough edges, but please feel free to test it and report any bugs found, or new features that may be beneficial!
## Features
* Play a YouTube video in sync across multiple clients.
* Enqueue other YouTube videos to play automatically after the current video.
* Automatically parse YouTube playlists for their videos. (Only up to 100 videos for now due to a bug upstream)
Coming soon:
* Keep the videos in sync if someone seeks.
## Run
### Docker
remote-media can be run with docker using the docker hub, `docker-compose` file or just by building a docker image manually from the repo.
Through Docker Hub:
```bash
docker pull banksio/remote-media
docker run --publish 3694:3694 --detach --name remotemedia banksio/remote-media:latest
```
With docker-compose (you can use something other than `curl` if you wish):
```bash
mkdir remote-media
cd remote-media
curl https://raw.githubusercontent.com/banksio/remote-media/master/docker-compose.yml -o docker-compose.yml
docker-compose up
```
Building manually:
```bash
git clone https://github.com/banksio/remote-media.git
cd remote-media
docker build --tag remote-media:1.0 .
docker run --publish 3694:3694 --detach --name remotemedia remote-media:1.0
```
And kill with: `docker rm --force remotemedia`
### Manual
#### Prerequisites
* Node.js and npm
1. Clone or download the repo onto your local machine or server.
2. Run `npm install`.
3. Run `npm start`.
4. Connect to the web interface on port 3694.
## Usage
remote-media runs on port 3694 by default.
The root page is the "receiver", and the admin panel is used to control the media playing on the receivers. The admin page is located at `/admin`.
**If it doesn't work, please [submit a bug](https://github.com/banksio/remote-media/issues).**
## Development
To develop for remote-media, just follow the instructions listed to run the app manually above.