https://github.com/semro/syncwatch
Browser extension to watch videos together
https://github.com/semro/syncwatch
chrome-extension firefox-extension nodejs opera-extension realtime social socket-io synchronization video-player
Last synced: about 2 months ago
JSON representation
Browser extension to watch videos together
- Host: GitHub
- URL: https://github.com/semro/syncwatch
- Owner: Semro
- License: mit
- Created: 2018-02-03T01:15:12.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-05-11T21:58:11.000Z (5 months ago)
- Last Synced: 2025-08-22T00:23:37.407Z (about 2 months ago)
- Topics: chrome-extension, firefox-extension, nodejs, opera-extension, realtime, social, socket-io, synchronization, video-player
- Language: TypeScript
- Homepage:
- Size: 12.3 MB
- Stars: 159
- Watchers: 9
- Forks: 22
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/semro/syncwatch/releases/latest)
[](LICENSE.md)
[](https://t.me/syncwatch)
[](https://discord.gg/7AYpju4)
# SyncWatch
SyncWatch is extension for browsers which lets you watch videos together with friends synchrounosly.
## Browsers support
| [
Firefox](https://addons.mozilla.org/firefox/addon/syncwatch/) | [
Chrome](https://chrome.google.com/webstore/detail/syncwatch/ggiafipgeeaaahnjamgpjcgkdpanhddg) | [
Opera](https://addons.opera.com/extensions/details/syncwatch/) |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
## How to use
1. Install extension.
1. Click on plugin icon.
1. Write your name and room name. (If room is not exist it will be created)
1. Click 'connect'.
1. Share name of the room with friends. They must follow this instruction (1-4 steps).
1. Go to the page where video is located.
1. Click 'share' to send link in room.
1. Other in room should open this link.
## Run server locally
To get a local copy up and running follow these simple steps.
1. Clone the repo
```sh
git clone https://github.com/Semro/syncwatch.git
```
2. Move to the project directory
```sh
cd syncwatch/packages/syncwatch-server
```
3. Install NPM packages
```sh
npm ci
```
4. Run the server
```sh
npm run start:dev
```
- Run the server on other port
```sh
npx cross-env PORT=8080 npm run start:dev
```
## How to add a localization
1. Determine an ISO language code such as `en` referring to [kLanguageInfoTable](https://src.chromium.org/viewvc/chrome/trunk/src/third_party/cld/languages/internal/languages.cc).
1. Go to locales package folder: `cd packages/syncwatch-locales`
1. Add a column to [locales.csv](packages/syncwatch-locales/locales.csv) with language code at the top cell.
1. Add translated messages in following cells.
1. Generate localized files with `npm run locales` (optional step, you can just pull request `.csv` file).
1. To localize store description, make a folder in [web-store-assets](web-store-assets) with a corresponding ISO code.
## License
[MIT](https://choosealicense.com/licenses/mit/)