nheko/README.md

84 lines
2.3 KiB
Markdown
Raw Normal View History

2017-04-06 03:03:46 +02:00
nheko
----
2017-04-09 16:09:22 +02:00
[![Build Status](https://travis-ci.org/mujx/nheko.svg?branch=master)](https://travis-ci.org/mujx/nheko) [![Build status](https://ci.appveyor.com/api/projects/status/07qrqbfylsg4hw2h/branch/master?svg=true)](https://ci.appveyor.com/project/mujx/nheko/branch/master)
2017-04-06 03:03:46 +02:00
The motivation behind the project is to provide a native desktop app for [Matrix] that
feels more like a mainstream chat app ([Riot], Telegram etc) and less like an IRC client.
2017-04-23 23:40:24 +02:00
Join the discussion on Matrix [#nheko:matrix.org](https://matrix.to/#/#nheko:matrix.org).
2017-04-09 02:54:39 +02:00
### Features
2017-04-06 03:03:46 +02:00
Most of the features you'd expect from a chat application are missing right now
but you can of course receive and send messages in the rooms that you are a member of.
2017-04-09 02:54:39 +02:00
### Requirements
2017-04-06 03:03:46 +02:00
- Qt5 (5.7 or greater). Qt 5.7 adds support for color font rendering with
Freetype, which is essential to properly support emoji.
2017-04-10 01:28:06 +02:00
- CMake 3.1 or greater.
- A compiler that supports C++11.
- Clang 3.3 (or greater).
2017-04-11 18:21:11 +02:00
- GCC 4.8 (or greater).
2017-04-06 03:03:46 +02:00
2017-04-09 02:54:39 +02:00
##### Arch Linux
2017-04-06 03:03:46 +02:00
```bash
$ sudo pacman -S qt5-base cmake gcc fontconfig
2017-04-06 03:03:46 +02:00
```
2017-04-10 01:28:06 +02:00
##### Ubuntu 14.04
```bash
$ sudo add-apt-repository ppa:beineri/opt-qt58-trusty
2017-04-10 01:28:06 +02:00
$ sudo add-apt-repository ppa:george-edison55/cmake-3.x
$ sudo apt-get update
$ sudo apt-get install qt58base cmake
2017-04-10 01:28:06 +02:00
```
2017-04-06 03:03:46 +02:00
2017-04-10 01:28:06 +02:00
##### OSX (Xcode 7 or later)
```bash
$ brew update
$ brew install qt5
```
N.B. you will need to pass `-DCMAKE_PREFIX_PATH=/usr/local/opt/qt5`
to cmake to point it at your qt5 install (tweaking the path as needed)
2017-04-10 01:28:06 +02:00
### Building
```bash
cmake -H. -Bbuild -DCMAKE_BUILD_TYPE=Release # Default is Debug.
make -C build
```
The `nheko` binary will be located in the `build` directory.
2017-04-06 03:03:46 +02:00
2017-04-10 01:28:06 +02:00
[Here](https://ci.appveyor.com/project/mujx/nheko/branch/master/artifacts) you can
find development builds for Windows.
2017-04-09 02:54:39 +02:00
### Contributing
2017-04-06 03:03:46 +02:00
Any kind of contribution to the project is greatly appreciated. You are also
encouraged to open feature request issues.
2017-04-09 02:54:39 +02:00
### Screens
2017-04-06 03:03:46 +02:00
Here is a screen shot to get a feel for the UI, but things will probably change.
2017-04-26 01:52:51 +02:00
![nheko](https://dl.dropboxusercontent.com/s/cs2891enrf2lqo9/nheko.jpg)
2017-04-06 03:03:46 +02:00
2017-04-19 18:38:39 +02:00
### Third party
- [Emoji One](http://emojione.com)
- [Open Sans](https://fonts.google.com/specimen/Open+Sans)
2017-04-06 03:03:46 +02:00
2017-04-09 02:54:39 +02:00
### License
2017-04-06 03:03:46 +02:00
[GPLv3]
[Matrix]:https://matrix.org
[Riot]:https://riot.im
[GPLv3]:https://www.gnu.org/licenses/gpl-3.0.en.html