harmony/README.md

44 lines
1.5 KiB
Markdown
Raw Normal View History

2019-11-24 10:38:48 +00:00
# harmony
2020-01-23 01:40:22 +00:00
[![CI status](https://gitlab.com/tslocum/harmony/badges/master/pipeline.svg)](https://gitlab.com/tslocum/harmony/commits/master)
2019-11-24 10:38:48 +00:00
[![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-13 03:49:21 +00:00
## Screenshot
[![](https://harmony.rocketnine.space/static/screenshot_v010_2.png)](https://harmony.rocketnine.space/static/screenshot_v010_2.png)
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
2019-12-12 03:10:06 +00:00
## Server
[**Download harmony-server**](https://harmony.rocketnine.space/download/?sort=name&order=desc)
2019-12-10 00:16:24 +00:00
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
2020-01-23 01:40:22 +00:00
See [HOSTING.md](https://gitlab.com/tslocum/harmony/blob/master/HOSTING.md) for information
2019-12-10 16:25:13 +00:00
on hosting a server.
2019-12-10 00:16:24 +00:00
2020-02-21 17:59:25 +00:00
See [PROTOCOL.md](https://gitlab.com/tslocum/harmony/blob/master/PROTOCOL.md) for information
on the harmony protocol.
2019-11-24 10:38:48 +00:00
## Support
2020-02-21 17:59:25 +00:00
Please share issues and suggestions [here](https://gitlab.com/tslocum/harmony/issues).
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
2020-02-21 17:59:25 +00:00
* [pion/webrtc](https://github.com/pion/webrtc) - WebRTC connections and audio
* [gorilla/websocket](https://github.com/gorilla/websocket) - WebSocket connections