mirror of https://github.com/calzoneman/sync.git
Update the README
This commit is contained in:
Calvin Montgomery
parent
304a6c9cfa
commit
6070f7fc06
109
README.md
109
README.md
|
|
@ -1,91 +1,46 @@
|
||||||
Read before submitting an issue: https://github.com/calzoneman/sync/wiki/Reporting-an-Issue
|
CyTube
|
||||||
===========================================================================================
|
======
|
||||||
|
|
||||||
calzoneman/sync
|
CyTube is a project I started in early 2013 as a hobby project to build my own
|
||||||
===============
|
clone of synchtube.com (now defunct).
|
||||||
|
|
||||||
About
|
The basic concept is that users register channels where connected viewers can
|
||||||
-----
|
watch videos from different video hosts (e.g., YouTube, Twitch) and the playback
|
||||||
|
is synchronized for all the viewers in the channel.
|
||||||
|
|
||||||
CyTube is a web application providing media synchronization, chat, and more for an arbitrary number of channels.
|
Each channel has a playlist where users can queue up videos to play, as well as
|
||||||
I began developing this as a hobby project, and when synchtube.com announced their closure, I
|
an integrated chatroom for discussion.
|
||||||
began polishing it and readying it for the public.
|
|
||||||
|
|
||||||
I am hosting a CyTube server at http://cytu.be
|
The official server is located at https://cytu.be, but there are other public
|
||||||
|
servers hosted for various communities.
|
||||||
|
|
||||||
The serverside is written in JavaScript and runs on Node.JS. It makes use
|
## Installation
|
||||||
of a MySQL database to store user registrations, cached media metadata, and
|
|
||||||
data about each channel.
|
|
||||||
|
|
||||||
The clientside is written in JavaScript and makes use of Socket.IO and
|
The installation guide for server administrators is located [on the
|
||||||
jQuery as well as the APIs for various media providers.
|
wiki](https://github.com/calzoneman/sync/wiki/CyTube-3.0-Installation-Guide).
|
||||||
The web interface uses Bootstrap for layout and styling.
|
|
||||||
|
|
||||||
Features
|
## Contact
|
||||||
--------
|
|
||||||
- Standalone web/socket.io server
|
|
||||||
- Optional SSL support for socket.io and the account API
|
|
||||||
- Synchronized playback from the following sources:
|
|
||||||
- YouTube (individual videos + playlists)
|
|
||||||
- Google Docs videos
|
|
||||||
- Vimeo
|
|
||||||
- Dailymotion
|
|
||||||
- Soundcloud
|
|
||||||
- Raw video/audio files (via video.js)
|
|
||||||
- Embedding of the following sources:
|
|
||||||
- livestream.com
|
|
||||||
- twitch.tv
|
|
||||||
- justin.tv
|
|
||||||
- ustream.tv
|
|
||||||
- RTMP streams
|
|
||||||
- Custom `<iframe>` and `<object>` embeds
|
|
||||||
- Channel customization
|
|
||||||
- HTML Message of the Day
|
|
||||||
- CSS
|
|
||||||
- JavaScript
|
|
||||||
- Permissions
|
|
||||||
- Tiered ranks (Site admin > Channel admin > Moderator > Leader > Member > Guest > Anonymous)
|
|
||||||
- Chat filters (based on regular expressions)
|
|
||||||
- Lock/unlock playlist to allow additions by non-moderators (configurable with permissions)
|
|
||||||
- Searchable library of videos
|
|
||||||
- Integrated YouTube search
|
|
||||||
- Save/load playlists per user account
|
|
||||||
- Polls
|
|
||||||
- Voteskip (can be disabled by a channel moderator)
|
|
||||||
- Auto-AFK status (can be configured per-channel)
|
|
||||||
- Leader
|
|
||||||
- Grants control of playback to a user (can pause/seek)
|
|
||||||
- Can also be used to grant temporary mod-like powers to a user
|
|
||||||
- Not necessary for synchronization as the server has an internal timer
|
|
||||||
- Channel state saves/loads on restart
|
|
||||||
- Account management
|
|
||||||
- Password change
|
|
||||||
- Password reset (via email)
|
|
||||||
- Profile avatar and text
|
|
||||||
- Moderation
|
|
||||||
- Mute users
|
|
||||||
- Kick users
|
|
||||||
- Ban users by name
|
|
||||||
- Ban users by IP address (and by /24 range)
|
|
||||||
- Administration
|
|
||||||
- Log viewer
|
|
||||||
- Global bans
|
|
||||||
- Search registered channels and users
|
|
||||||
- Currently loaded channels
|
|
||||||
- Stats (usercount, channelcount, RAM usage)
|
|
||||||
|
|
||||||
Installing
|
**Please check if the
|
||||||
----------
|
[FAQ](https://github.com/calzoneman/sync/wiki/Frequently-Asked-Questions)
|
||||||
|
answers your question already.**
|
||||||
|
|
||||||
Installation instructions are available here: https://github.com/calzoneman/sync/wiki/CyTube-3.0-Installation-Guide
|
For bug reports and feature requests, please open a GitHub issue. To report a
|
||||||
|
security vulnerability, or to discuss an issue with https://cytu.be itself
|
||||||
|
(unrelated to the code), please send me an email: cyzon@cytu.be
|
||||||
|
|
||||||
|
Please be courteous and search through [the open and closed
|
||||||
|
issues](https://github.com/calzoneman/sync/issues?utf8=%E2%9C%93&q=is%3Aissue)
|
||||||
|
for your request before submitting a new one.
|
||||||
|
|
||||||
Feedback
|
General help with the software and the website is also available on the IRC
|
||||||
--------
|
channel at [irc.esper.net#cytube](http://webchat.esper.net/?channels=cytube)
|
||||||
|
during US daytime hours.
|
||||||
|
|
||||||
Please open a GitHub Issue.
|
## License
|
||||||
|
|
||||||
License
|
Original source code in this repository is provided under the MIT license
|
||||||
-------
|
(see the LICENSE file for the full text).
|
||||||
|
|
||||||
Licensed under MIT. See LICENSE for the full license text.
|
Bundled source code, such as third-party CSS and JavaScript libraries, are
|
||||||
|
provided under their respective licenses.
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue