Carbon/README.md

98 lines
2.7 KiB
Markdown
Raw Normal View History

2020-10-19 13:52:10 +00:00
# Carbon Chat
2020-10-21 07:07:57 +00:00
Carbon is the Matrix client for Discord and Guilded refugees.
2020-10-19 13:52:10 +00:00
Visit the hosted instance on
[https://carbon.chat](https://carbon.chat).
## Report bugs and suggest features
Please briefly check this README and the issues page first to make
sure that the issue/feature is not already known!
- If you already have an account on Gitdab, use the issues page.
- If you don't have an account, and don't wish to create one, you can
send an email to the [mailing list].
If something in the interface isn't working as you think it should,
please provide a screenshot of any messages from the browser devtools
console. If using the mailing list, attachments aren't supported, so
you'll have to upload to some image host and post the link.
[mailing list]: https://lists.sr.ht/~cadence/carbon-discuss
2020-10-19 13:52:10 +00:00
## The dream
2020-10-21 07:32:48 +00:00
Carbon's planned features, compared to Discord and Guilded:
2020-10-19 13:52:10 +00:00
- End to end encryption
- Free of charge, per-account, custom emojis and custom emoji packs
2020-10-21 07:42:42 +00:00
- No limit to number of groups you can join at a time
2020-10-19 13:52:10 +00:00
- Uses the open Matrix and Mumble systems
2020-10-21 07:32:48 +00:00
- Much better IRC layout
2020-10-19 13:52:10 +00:00
- Probably more
Carbon's planned features, compared to Element:
- Get rid of the unmanageable combined rooms list
2020-10-21 07:07:57 +00:00
- Groups like Discord/Guilded guilds
2020-10-19 13:52:10 +00:00
- Always have one group selected at a time
- Synchronised membership, moderators, power levels and bans
- Ordered channel list
- Unread indicators
- Add existing channels to groups
- Pin any channel to the groups bar
- Tidy Mumble integration to add voice channels
- More reliable unreads
- Per-account custom emojis (Ponies+FluffyChat integration) and custom emoji packs
- Slightly better IRC layout
- Probably more
## The reality
Carbon is currently _technically_ usable as a chat app, but is very
early in development. These important features still need to be
implemented:
- Unreads
- Chat history
- Typing indicators
2020-10-19 13:52:10 +00:00
- Formatting
- Emojis
- Reactions
- Encryption
2020-10-19 13:52:10 +00:00
- Groups v2
- Group management
- Pinned channels
- Mumble integration
## The code
### Downloading a CI build
Visit [drone CI](https://drone.badat.dev/cadence/Carbon/branches),
select the branch you want to use, select `b2` on the left, scroll
down, and open the URL on the last line to download the build.
### Building yourself
2020-10-19 13:52:10 +00:00
npm install -D
npm run rebuild
### Hosting
Send the files from the `build` folder to a static file server. Apply
a long cache-control header to everything served under `/static`, and
no cache-control header to everything else.
### Developing
npm run watch
Files will be rebuilt as you save them.
Use `python3 -m http.server -d build` to serve the build on
[http://localhost:8000](http://localhost:8000).
(Avoid `npx http-server`, since this applies too much caching.)