2019-11-24 10:38:48 +00:00
|
|
|
# harmony
|
|
|
|
[![GoDoc](https://godoc.org/git.sr.ht/~tslocum/harmony?status.svg)](https://godoc.org/git.sr.ht/~tslocum/harmony)
|
|
|
|
[![builds.sr.ht status](https://builds.sr.ht/~tslocum/harmony.svg)](https://builds.sr.ht/~tslocum/harmony)
|
|
|
|
[![Donate](https://img.shields.io/liberapay/receives/rocketnine.space.svg?logo=liberapay)](https://liberapay.com/rocketnine.space)
|
|
|
|
|
|
|
|
Voice and text communications platform
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
2019-12-02 16:45:32 +00:00
|
|
|
- Low-latency voice chat using [Opus](https://en.wikipedia.org/wiki/Opus_%28audio_format%29)
|
|
|
|
- Rich text chat using [Markdown](https://en.wikipedia.org/wiki/Markdown)
|
2019-11-24 10:38:48 +00:00
|
|
|
|
2019-12-10 00:16:24 +00:00
|
|
|
## Web client
|
|
|
|
|
2019-12-10 16:25:13 +00:00
|
|
|
The only client currently implemented is a web interface (located in pkg/web)
|
|
|
|
hosted by the server.
|
2019-12-10 00:16:24 +00:00
|
|
|
|
|
|
|
## harmony-server
|
|
|
|
|
2019-12-10 16:25:13 +00:00
|
|
|
The server (located in cmd/harmony-server) passes voice and text communications
|
|
|
|
between clients.
|
2019-12-10 00:16:24 +00:00
|
|
|
|
2019-12-10 16:25:13 +00:00
|
|
|
See [HOSTING.md](https://man.sr.ht/~tslocum/harmony/HOSTING.md) for information
|
|
|
|
on hosting a server.
|
2019-12-10 00:16:24 +00:00
|
|
|
|
2019-11-24 10:38:48 +00:00
|
|
|
## Support
|
|
|
|
|
|
|
|
Please share suggestions/issues [here](https://todo.sr.ht/~tslocum/harmony).
|
2019-12-10 00:16:24 +00:00
|
|
|
|
|
|
|
## Libraries
|
|
|
|
|
2019-12-11 15:50:26 +00:00
|
|
|
The following libraries are used to build harmony:
|
2019-12-10 00:16:24 +00:00
|
|
|
|
|
|
|
* [webrtc](https://github.com/pion/webrtc) - WebRTC connections and audio
|
|
|
|
* [websocket](https://github.com/gorilla/websocket) - WebSocket connections
|