synctv/README.md

119 lines
5.0 KiB
Markdown
Raw Permalink Normal View History

2023-10-04 06:27:00 +00:00
<div align="center">
<a href="https://github.com/synctv-org/docs"><img height="100px" alt="logo" src="https://cdn.jsdelivr.net/gh/synctv-org/docs@main/logo/logo.png"/></a>
<p><em>👫A program that allows you to watch movies/live broadcasts together remotely🍿</em></p>
<div>
<a href="https://goreportcard.com/report/github.com/synctv-org/synctv">
<img src="https://goreportcard.com/badge/github.com/synctv-org/synctv" alt="latest version" />
</a>
<a href="https://github.com/synctv-org/synctv/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/synctv-org/synctv" alt="License" />
</a>
2023-10-04 07:24:52 +00:00
<a href="https://github.com/synctv-org/synctv/actions?query=workflow%3Abuild">
<img src="https://img.shields.io/github/actions/workflow/status/synctv-org/synctv/build.yml?branch=main" alt="Build status" />
</a>
<a href="https://github.com/synctv-org/synctv/releases">
<img src="https://img.shields.io/github/release/synctv-org/synctv" alt="latest version" />
</a>
</div>
<div>
<a href="https://github.com/synctv-org/synctv/releases">
<img src="https://img.shields.io/github/downloads/synctv-org/synctv/total?color=%239F7AEA&logo=github" alt="Downloads" />
</a>
<a href="https://hub.docker.com/r/synctvorg/synctv">
<img src="https://img.shields.io/docker/pulls/synctvorg/synctv?color=%2348BB78&logo=docker&label=pulls" alt="Downloads" />
</a>
2023-10-04 06:27:00 +00:00
</div>
</div>
2023-10-04 15:43:02 +00:00
2023-10-04 06:27:00 +00:00
---
2023-10-04 05:59:36 +00:00
English | [中文](./README-CN.md)
2023-10-05 04:25:47 +00:00
# What is SyncTV?
SyncTV is a program that allows you to watch movies and live broadcasts together remotely. It provides synchronized viewing, theater, and proxy features. With SyncTV, you can watch videos and live streams with your friends and family, no matter where they are.
SyncTV's synchronized viewing feature ensures that everyone watching the video is at the same point in the video. This means that you can pause, rewind, or fast-forward the video, and everyone else will be synced to the same point. SyncTV also supports live streaming, so you can watch live events together in real-time.
The theater feature provides a chat and bullet chat function, allowing you to communicate with your friends and family while watching the video. The proxy feature allows you to watch videos and live streams that may be connect to origin server slow.
2023-10-04 05:59:36 +00:00
# Features
- [x] Synchronized viewing
- [x] Videos Sync
- [x] Live streaming
- [x] Theater
- [x] Chat
- [x] Bullet chat
- [x] Proxy
2023-12-08 13:55:06 +00:00
- [x] Videos proxy
- [x] Live proxy
- [x] Parse
- [x] Parse video
2023-12-26 11:21:53 +00:00
- [x] Alist
2023-12-08 13:55:06 +00:00
- [x] Bilibili
2023-12-26 11:21:53 +00:00
- [x] Emby
2023-12-08 13:55:06 +00:00
- [ ] Parse live
2023-10-04 05:59:36 +00:00
2023-10-04 15:43:02 +00:00
---
2023-10-09 11:28:34 +00:00
# Demo
2023-11-06 09:29:13 +00:00
https://demo.synctv.wiki
2023-10-09 11:28:34 +00:00
---
2023-10-09 07:07:53 +00:00
# Installation
## Binary
You can download the latest binary from [release page](https://github.com/synctv-org/synctv/releases) and install it manually.
## Script
You can use the script to install and run SyncTV.
```bash
2023-12-05 10:19:01 +00:00
sudo -v ; curl -fsSL https://raw.gitmirror.com/synctv-org/synctv/main/script/install.sh | sudo bash -s -- -v latest
2023-10-09 07:07:53 +00:00
```
## Docker
You can also use docker to install and run SyncTV.
```bash
docker run -d --name synctv -p 8080:8080 synctvorg/synctv
```
---
2023-11-06 09:29:13 +00:00
# Run
2023-10-04 15:43:02 +00:00
`synctv server` to start the server
```bash
synctv server
# or
2023-11-06 09:29:13 +00:00
synctv server --data-dir ./
2023-10-04 15:43:02 +00:00
```
2023-12-01 15:03:46 +00:00
> Every time it starts, it will check for users with root permissions. If none are found, it will initialize a `root` user with the password `root`. Please change the username and password promptly.
>
2024-06-11 03:14:38 +00:00
> The user registration function requires the use of any `OAuth2` service, such as `Google`, `Github`, etc. For specific configuration, please refer to [documentation](https://docs.synctv.wiki/#/oauth2).
2023-12-01 14:56:49 +00:00
2023-11-06 09:29:13 +00:00
# Documentation
2024-06-11 03:14:38 +00:00
https://docs.synctv.wiki
2023-10-13 09:30:06 +00:00
2023-12-08 13:55:06 +00:00
# Special sponsors
2024-02-11 13:20:35 +00:00
- [亚洲云](https://www.asiayun.com) supports the server for the [demo](https://demo.synctv.wiki) site.
- [LucasYuYu](https://github.com/LucasYuYu) ¥ 18.88
2023-10-04 15:43:02 +00:00
2023-10-04 06:27:00 +00:00
# Contributors
Thanks goes to these wonderful people:
[![Contributors](https://contrib.nn.ci/api?repo=synctv-org/synctv&repo=synctv-org/synctv-web&repo=synctv-org/docs)](https://github.com/synctv-org/synctv/graphs/contributors)
2023-10-04 05:59:36 +00:00
# License
The `SyncTV` is open-source software licensed under the AGPL-3.0 license.
# Disclaimer
- This program is a free and open-source project. It aims to play video files on the internet, making it convenient for multiple people to watch videos and learn golang together.
- Please comply with relevant laws and regulations when using it, and do not abuse it.
- The program only plays video files/forwards traffic on the client-side and will not intercept, store, or tamper with any user data.
- Before using the program, you should understand and assume the corresponding risks, including but not limited to copyright disputes, legal restrictions, etc., which are not related to the program.
2023-11-17 04:04:55 +00:00
- If there is any infringement, please contact me via [email](mailto:pyh1670605849@gmail.com), and it will be dealt with promptly.
# Discussion
- [Telegram](https://t.me/synctv)