mirror of
https://github.com/Nheko-Reborn/nheko.git
synced 2024-12-05 00:28:49 +03:00
65c6e96e24
This will look bad on some platforms and older versions for now, but should fix a lot of crashes and we can report the rest as bugs.
505 lines
18 KiB
Markdown
505 lines
18 KiB
Markdown
nheko
|
|
----
|
|
|
|
[](https://matrix.to/#/#nheko-reborn:matrix.org)
|
|
[](https://nheko.im/nheko-reborn/nheko/-/pipelines/latest)
|
|
|
|
The motivation behind the project is to provide a native desktop app for [Matrix] that
|
|
feels more like a mainstream chat app ([Element], Telegram etc) and less like an IRC client.
|
|
|
|
## Installation Quicklinks
|
|
|
|
### Stable
|
|
|
|
[](https://github.com/Nheko-Reborn/nheko/releases/latest)
|
|
<a href='https://flathub.org/apps/details/im.nheko.Nheko'><img height='32' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-en.png'/></a>
|
|
[](https://repology.org/project/nheko/versions)
|
|
|
|
For other options and details see the [Installation](#installation) section.
|
|
|
|
### Unstable
|
|
|
|
[](https://nheko.im/nheko-reborn/nheko/-/pipelines?page=1&scope=all&ref=master)
|
|
<a href='https://flatpak.neko.dev/repo/nightly/appstream/im.nheko.Nheko.flatpakref' download='nheko-nightly.flatpakref'><img alt='Download Nightly Flatpak' src='https://img.shields.io/badge/download-flatpak--nightly-green'/></a>
|
|
<a href='https://nheko-reborn.pages.nheko.im/nheko/NhekoNightly.appinstaller' download='NhekoNightly.appinstaller'><img alt='Windows Nightly Automatic Updates' src='https://img.shields.io/badge/download-windows--nightly-green'/></a>
|
|
|
|
### Translations ###
|
|
[](http://weblate.nheko.im/engage/nheko/?utm_source=widget)
|
|
|
|
Help us with translations so as many people as possible will be able to use nheko!
|
|
|
|
### Note regarding End-to-End encryption
|
|
|
|
The current implementation is mostly stable, but it was never audited. If you
|
|
rely on it for security, we can't make any guarantees.
|
|
|
|
## Features
|
|
|
|
Most of the features you would expect from a chat application are missing right now
|
|
but we are getting close to a more feature complete client.
|
|
Specifically there is support for:
|
|
- E2E encryption.
|
|
- VoIP calls (voice & video, support varies by platform).
|
|
- User registration.
|
|
- Creating, joining & leaving rooms.
|
|
- Sending & receiving invites.
|
|
- Sending & receiving files and emoji (inline widgets for images, audio and file messages).
|
|
- Custom stickers and emoji.
|
|
- Replies with text, images and other media (and actually render them as inline widgets).
|
|
- Typing notifications.
|
|
- Username auto-completion.
|
|
- Message & mention notifications.
|
|
- Redacting messages.
|
|
- Read receipts.
|
|
- Presence and status messages (if enabled on the server side).
|
|
- Basic communities support.
|
|
- Room switcher (ctrl-K).
|
|
- Light, Dark & System themes.
|
|
- Creating separate profiles (command line only, use `-p name`).
|
|
- D-Bus API to allow integration with third-party plugins (does not support Windows or macOS).
|
|
|
|
## Installation
|
|
|
|
### Releases
|
|
|
|
Releases for Linux (Flatpak), macOS (disk image) & Windows (x64 msix or appinstaller)
|
|
can be found in the [GitHub releases](https://github.com/Nheko-Reborn/nheko/releases).
|
|
The appinstaller on Windows will regularly check our servers for updates. The msix won't.
|
|
|
|
### Repositories
|
|
|
|
[](https://repology.org/project/nheko/versions)
|
|
|
|
#### Arch Linux
|
|
|
|
```bash
|
|
sudo pacman -Syu nheko
|
|
```
|
|
|
|
The development version is available in the AUR:
|
|
|
|
```bash
|
|
yay -S nheko-git # Or your favorite way of installing AUR packages
|
|
```
|
|
|
|
Nheko requires a secret server to run, so you'll need to install and configure a service such as [KDE Wallet](https://wiki.archlinux.org/title/KDE_Wallet) or [GNOME Keyring](https://wiki.archlinux.org/title/GNOME/Keyring) if not provided by your desktop environment.
|
|
|
|
#### Debian (10 and above) / Ubuntu (18.04 and above)
|
|
|
|
```bash
|
|
sudo apt install nheko
|
|
```
|
|
|
|
#### Fedora
|
|
```bash
|
|
sudo dnf install nheko
|
|
```
|
|
|
|
#### Gentoo Linux
|
|
|
|
```bash
|
|
sudo eselect repository enable guru
|
|
sudo emaint sync -r guru
|
|
sudo emerge -a nheko
|
|
```
|
|
|
|
If you are using Gnome Keyring or KeepassXC as your secrets daemon, ensure that the `keyring` useflag is enabled on `dev-libs/qtkeychain`.
|
|
|
|
#### Mageia (9 and above)
|
|
```bash
|
|
sudo urpmi nheko
|
|
```
|
|
|
|
#### Nix(os)
|
|
|
|
```bash
|
|
# Imperatively: (not recommended)
|
|
nix-env -iA nixpkgs.nheko
|
|
|
|
# In an ephemeral shell: (recommended if you just want to try it out without committing to a full installation)
|
|
nix-shell -p nheko --run nheko
|
|
# Note: The above command will both install and run Nheko.
|
|
# To stop it from running immediately, just remove the `--run nheko` from the end.
|
|
```
|
|
Alternatively, add it to your config in one of the following ways: (recommended for long-term installation)
|
|
|
|
**System-wide:**
|
|
```nix
|
|
environment.systemPackages = with pkgs; [
|
|
# ...
|
|
nheko
|
|
# ...
|
|
];
|
|
```
|
|
**User-specific:**
|
|
```nix
|
|
users.users.<user>.packages = with pkgs; [
|
|
# ...
|
|
nheko
|
|
# ...
|
|
];
|
|
```
|
|
**via `home-manager`:**
|
|
```nix
|
|
programs.nheko.enable = true;
|
|
```
|
|
|
|
|
|
|
|
#### Alpine Linux (and postmarketOS)
|
|
|
|
Make sure you have the testing repositories from `edge` enabled. Note that this is not needed on postmarketOS.
|
|
|
|
```sh
|
|
sudo apk add nheko
|
|
```
|
|
|
|
#### openSUSE
|
|
|
|
Note: these instructions have only been tested on Tumbleweed.
|
|
|
|
First, install nheko:
|
|
```bash
|
|
sudo zypper addrepo https://download.opensuse.org/repositories/network:messaging:matrix/openSUSE_Tumbleweed/network:messaging:matrix.repo
|
|
sudo zypper ref
|
|
sudo zypper in nheko
|
|
```
|
|
|
|
If you want to add jdenticon support:
|
|
|
|
```bash
|
|
sudo zypper install qt-jdenticon
|
|
```
|
|
|
|
#### Flatpak
|
|
|
|
```
|
|
flatpak install flathub im.nheko.Nheko
|
|
```
|
|
|
|
#### Guix
|
|
|
|
```
|
|
guix install nheko
|
|
```
|
|
|
|
#### Steam Deck
|
|
|
|
Install nheko via the `Discover` app in Desktop Mode (this installs the flatpak). To also make it work in Game Mode you'll have create a wrapper script that starts kwalletd and then nheko. You can create `/home/deck/nheko.sh` with the following content and then add this script as a "Non-Steam Game" to Steam.
|
|
```bash
|
|
#!/bin/sh
|
|
kwalletd6&
|
|
flatpak run --env=XDG_CURRENT_DESKTOP=KDE --env=KDE_SESSION_VERSION=5 --branch=stable --arch=x86_64 --command=im.nheko.Nheko --file-forwarding im.nheko.Nheko @@u @@
|
|
```
|
|
|
|
#### macOS (10.14 and above)
|
|
|
|
with [homebrew](https://brew.sh/):
|
|
|
|
```sh
|
|
brew install --cask nheko
|
|
```
|
|
|
|
#### Windows
|
|
|
|
with [Chocolatey](https://chocolatey.org/):
|
|
|
|
```posh
|
|
choco install nheko-reborn
|
|
```
|
|
|
|
#### D-Bus plugins
|
|
|
|
nheko does not provide binaries for any D-Bus plugins. However, we do provide the following list of known plugins:
|
|
|
|
- [nheko-krunner](https://github.com/LorenDB/nheko-krunner)
|
|
- [rofi-nheko](https://mzte.de/git/LordMZTE/rofi-nheko)
|
|
|
|
### FAQ
|
|
|
|
---
|
|
|
|
**Q:** Why don't videos run for me on Windows?
|
|
|
|
**A:** You're probably missing the required video codecs, download [K-Lite Codec Pack](https://codecguide.com/download_kl.htm).
|
|
|
|
---
|
|
|
|
**Q:** What commands are supported by nheko?
|
|
|
|
**A:** See <https://github.com/Nheko-Reborn/nheko/wiki/Commands>
|
|
|
|
---
|
|
|
|
**Q:** Does nheko support end-to-end encryption (EE2E)?
|
|
|
|
**A:** Yes, see [feature list](#features)
|
|
|
|
---
|
|
|
|
**Q:** Can I test a bleeding edge development version?
|
|
|
|
**A:** Checkout nightly builds <https://matrix-static.neko.dev/room/!TshDrgpBNBDmfDeEGN:neko.dev/>
|
|
|
|
---
|
|
|
|
**Q:** How do I add stickers and custom emojis?
|
|
|
|
**A:** Stickers and custom emojis are organized in image packs. There is one
|
|
user image pack that only your account has access to and there are room image
|
|
packs that are accessible by everyone in the room they are defined in. You can
|
|
activate a room image pack globally to use it in any room.
|
|
|
|
To manage image packs in nheko, go to the room settings and enter the Sticker &
|
|
Emote Settings. You will see the Private pack (your user image pack) and can
|
|
edit it there. The Shortcode is a unique identifier you use to select the image
|
|
with and the Body is the alternate text that is displayed on clients that don't
|
|
support images (like the alt tag in HTML images).
|
|
|
|
If you have the necessary permissions you can create new room packs with the
|
|
button at the bottom of the image pack list. They are the same as the user pack
|
|
but you can create as many as you want and everyone in the room can use them. It
|
|
might be a good idea to create an extra room just for your image packs to make
|
|
sharing easier.
|
|
|
|
---
|
|
|
|
**Q:** I can't see some image types!
|
|
|
|
**A:** Nheko uses Qt's image plugins to render images. You might need to install
|
|
additional packages to display some image types like webp. Usually those
|
|
packages are called `qt6-image-formats-plugins`, `qt6-imageformats` or similar.
|
|
KDE has similar plugins, that can extend the supported image types even more.
|
|
|
|
---
|
|
|
|
### Build Requirements
|
|
|
|
- Qt6 (6.5 or greater). Required for overlapping hover handlers in Qml.
|
|
- CMake 3.15 or greater.
|
|
- [mtxclient](https://github.com/Nheko-Reborn/mtxclient)
|
|
- [coeurl](https://nheko.im/nheko-reborn/coeurl)
|
|
- [LMDB](https://www.symas.com/lmdb)
|
|
- [lmdb++](https://github.com/hoytech/lmdbxx) (0.9.14 too old)
|
|
- [cmark](https://github.com/commonmark/cmark) 0.29 or greater.
|
|
- [libolm](https://gitlab.matrix.org/matrix-org/olm)
|
|
- [spdlog](https://github.com/gabime/spdlog) (1.8.1 too old)
|
|
- [fmt](https://github.com/fmtlib/fmt)
|
|
- [GStreamer](https://gitlab.freedesktop.org/gstreamer) 1.20.0 or greater (optional, needed for VoIP support. Pass `-DVOIP=OFF` to disable.).
|
|
- Installing the gstreamer core library plus gst-plugins-base, gst-plugins-good & gst-plugins-bad
|
|
is often sufficient. The qmlgl plugin though is often packaged separately. The actual plugin requirements
|
|
are as follows:
|
|
- Voice call support: dtls, opus, rtpmanager, srtp, webrtc
|
|
- Video call support (optional): compositor, opengl, qmlgl, rtp, vpx
|
|
- [libnice](https://gitlab.freedesktop.org/libnice/libnice)
|
|
- XCB, XCB-EWMH: For screensharing support on X11 and setting window roles. Can be disabled with `-DSCREENSHARE_X11=OFF`.
|
|
- [qtkeychain](https://github.com/frankosterfeld/qtkeychain) (You need at least version 0.12 for proper Gnome Keychain support. The bundled version requires libsecret, unless you pass `-DLIBSECRET_SUPPORT=OFF`.)
|
|
- [KDSingleApplication](https://github.com/KDAB/KDSingleApplication) (1.0 or greater with Qt6 support)
|
|
- A compiler that supports C++ 20:
|
|
- Clang 16 (Only clazy 16 is tested in CI)
|
|
- GCC 11.3 (tested on Gitlab CI)
|
|
- MSVC 19.13 (tested on AppVeyor)
|
|
|
|
Nheko can use bundled version for most of those libraries automatically, if the versions in your distro are too old.
|
|
To use them, you can enable the hunter integration by passing `-DHUNTER_ENABLED=ON`.
|
|
It is probably wise to link those dependencies statically by passing `-DBUILD_SHARED_LIBS=OFF`
|
|
You can select which bundled dependencies you want to use by passing various `-DUSE_BUNDLED_*` flags. By default all dependencies are bundled *if* you enable hunter. (The exception to that is OpenSSL, which is always disabled by default.)
|
|
If you experience build issues and you are trying to link `mtxclient` library without hunter, make sure the library version(commit) as mentioned in the `CMakeList.txt` is used. Sometimes we have to make breaking changes in `mtxclient` and for that period the master branch of both repos may not be compatible.
|
|
|
|
The bundle flags are currently:
|
|
|
|
- USE_BUNDLED_SPDLOG
|
|
- USE_BUNDLED_OLM
|
|
- USE_BUNDLED_GTEST
|
|
- USE_BUNDLED_CMARK
|
|
- USE_BUNDLED_JSON
|
|
- USE_BUNDLED_OPENSSL
|
|
- USE_BUNDLED_MTXCLIENT
|
|
- USE_BUNDLED_LMDB
|
|
- USE_BUNDLED_LMDBXX
|
|
- USE_BUNDLED_COEURL
|
|
- USE_BUNDLED_LIBCURL
|
|
- USE_BUNDLED_LIBEVENT
|
|
- USE_BUNDLED_KDSINGLEAPPLICATION
|
|
|
|
A note on bundled OpenSSL: You need to explicitly enable it and it will not be using your system certificate directory by default, if you enable it. You need to override that at runtime with the SSL_CERT_FILE variable. On Windows it will still be using your system certificates though, since it loads them from the system store instead of the OpenSSL directory.
|
|
|
|
#### Linux (Appimage)
|
|
|
|
If you don't want to install any external dependencies, you can generate an AppImage locally using docker. It is not that well maintained though...
|
|
|
|
```bash
|
|
make docker-app-image
|
|
```
|
|
|
|
#### Arch Linux
|
|
|
|
```bash
|
|
sudo pacman -S qt6-base \
|
|
qt6-tools \
|
|
qt6-multimedia \
|
|
qt6-svg \
|
|
cmake \
|
|
gcc \
|
|
fontconfig \
|
|
lmdb \
|
|
cmark \
|
|
qtkeychain-qt6
|
|
```
|
|
|
|
#### Debian 13 [Testing/Sid] (Nheko QT6 Version)
|
|
|
|
```bash
|
|
# Install build requirements
|
|
sudo apt install -y cmake asciidoc-base libevent-dev libspdlog-dev libre2-dev liblmdb++-dev libcurl4-openssl-dev libssl-dev libolm-dev libcmark-dev nlohmann-json3-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev libkdsingleapplication-qt6-dev
|
|
sudo apt install -y qt6-base-dev qt6-tools-dev qt6-svg-dev qt6-multimedia-dev qt6-declarative-dev qtkeychain-qt6-dev qt6-base-private-dev qt6-declarative-private-dev
|
|
# Clone nheko repository from github
|
|
sudo apt install -y git
|
|
git clone https://github.com/Nheko-Reborn/nheko && cd nheko
|
|
# Build
|
|
cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DUSE_BUNDLED_COEURL=1 -DUSE_BUNDLED_MTXCLIENT=1 -DUSE_BUNDLED_LMDBXX=1
|
|
cmake --build build
|
|
```
|
|
|
|
#### Debian 11-12 / Ubuntu 22.04 (Nheko QT5 11.3 Release Version)
|
|
*Build requirements + qml modules needed at runtime (you may not need all of them, but the following seem to work according to reports):*
|
|
```bash
|
|
sudo apt install --no-install-recommends g++ cmake make zlib1g-dev libssl-dev libolm-dev liblmdb-dev libcmark-dev nlohmann-json3-dev libspdlog-dev libevent-dev libcurl4-openssl-dev libre2-dev libxcb-ewmh-dev asciidoc-base \
|
|
qt{base,declarative,tools,multimedia,quickcontrols2-}5-dev libqt6svg5-dev qt6keychain-dev qml-module-qt{gstreamer,multimedia,quick-extras,-labs-settings,graphicaleffects,quick-controls2,quick-particles2} \
|
|
libgstreamer1.0-dev libgstreamer-plugins-{base,bad}1.0-dev qtgstreamer-plugins-qt6 libnice-dev ninja-build
|
|
```
|
|
lmdb++-dev is too old so bundled lmdbxx must be used.
|
|
libspdlog-dev in debian bullseye is too old (without backporting) so requires using hunter to use bundled spdlog.
|
|
Suggested flags for debian bullseye: `-DHUNTER_ENABLED=ON -DBUILD_SHARED_LIBS=OFF -DUSE_BUNDLED_OPENSSL=OFF`
|
|
Suggested flags for debian bookworm: `-DUSE_BUNDLED_COEURL=1 -DUSE_BUNDLED_MTXCLIENT=1 -DUSE_BUNDLED_LMDBXX=1`
|
|
|
|
#### Fedora
|
|
|
|
```bash
|
|
sudo dnf builddep nheko # note that some newer packages might not be captured by that
|
|
```
|
|
|
|
#### Gentoo Linux
|
|
|
|
```bash
|
|
sudo emerge -a ">=dev-qt/qtgui-5.15.0" media-libs/fontconfig dev-libs/qtkeychain
|
|
```
|
|
|
|
#### Guix
|
|
|
|
```bash
|
|
guix environment nheko
|
|
```
|
|
|
|
#### macOS (Xcode 10.2 or later)
|
|
|
|
```bash
|
|
brew update
|
|
brew install qt6 lmdb cmake llvm spdlog cmark libolm qtkeychain
|
|
```
|
|
|
|
#### Windows
|
|
|
|
1. Install Visual Studio 2022's "Desktop Development" and "Linux Development with C++"
|
|
(for the CMake integration) workloads.
|
|
|
|
2. Download the latest Qt for windows installer and install it somewhere.
|
|
Make sure to install the `MSVC 2022 64-bit` toolset for at least Qt 5.15.
|
|
|
|
3. If you don't have openssl installed, you will need to install perl to build it (i.e. Strawberry Perl).
|
|
|
|
### Building
|
|
|
|
We can now build nheko:
|
|
|
|
```bash
|
|
cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release
|
|
cmake --build build
|
|
```
|
|
|
|
To use bundled dependencies you can use hunter, i.e.:
|
|
|
|
```bash
|
|
cmake -S. -Bbuild -DHUNTER_ENABLED=ON -DBUILD_SHARED_LIBS=OFF -DUSE_BUNDLED_OPENSSL=OFF
|
|
cmake --build build --config Release
|
|
```
|
|
|
|
Adapt the USE_BUNDLED_* as needed.
|
|
|
|
If the build fails with the following error
|
|
```
|
|
Could not find a package configuration file provided by "Qt6Widgets" with
|
|
any of the following names:
|
|
|
|
Qt6WidgetsConfig.cmake
|
|
qt6widgets-config.cmake
|
|
```
|
|
You might need to pass `-DCMAKE_PREFIX_PATH` to cmake to point it at your qt6 install.
|
|
|
|
e.g on macOS
|
|
|
|
```
|
|
cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$(brew --prefix qt6)
|
|
cmake --build build
|
|
```
|
|
|
|
The `nheko` binary will be located in the `build` directory.
|
|
|
|
#### Windows
|
|
|
|
After installing all dependencies, you need to edit the `CMakeSettings.json` to
|
|
be able to load and compile nheko within Visual Studio.
|
|
|
|
You need to fill out the paths for the `Qt6_DIR`.
|
|
The Qt6 dir should point to the `lib\cmake\Qt6` dir.
|
|
|
|
Examples for the paths are:
|
|
- `C:\\Qt\\6.5.2\\msvc2017_64\\lib\\cmake\\Qt6`
|
|
|
|
You should also enable hunter by setting `HUNTER_ENABLED` to `ON` and `BUILD_SHARED_LIBS` to `OFF`.
|
|
|
|
Now right click into the root nheko source directory and choose `Open in Visual Studio`.
|
|
You can choose the build type Release and Debug in the top toolbar.
|
|
After a successful CMake generation you can select the `nheko.exe` as the run target.
|
|
Now choose `Build all` in the CMake menu or press `F7` to compile the executable.
|
|
|
|
To be able to run the application the last step is to install the needed Qt dependencies next to the
|
|
nheko binary.
|
|
|
|
Start the "Qt x.xx.x 64-bit for Desktop (MSVC 2017)" command promt and run `windeployqt`.
|
|
```cmd
|
|
cd <path-to-nheko>\build-vc\Release\Release
|
|
windeployqt nheko.exe
|
|
```
|
|
|
|
The final binary will be located inside `build-vc\Release\Release` for the Release build
|
|
and `build-vc\Debug\Debug` for the Debug build.
|
|
|
|
Also copy the respective cmark.dll to the binary dir from `build/cmark-build/src/Release` (or Debug).
|
|
|
|
|
|
### Contributing
|
|
|
|
See [CONTRIBUTING](.github/CONTRIBUTING.md).
|
|
|
|
### Using the D-Bus API
|
|
|
|
Currently, there is no documentation for the D-Bus API, so if you'd like to make use of it, come ask
|
|
for support in [#nheko:nheko.im](https://matrix.to/#/#nheko:nheko.im).
|
|
|
|
### Screens
|
|
|
|
Here are some screen shots to get a feel for the UI, but things will probably change.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Third party
|
|
|
|
- [Fluent Icons](https://github.com/microsoft/fluentui-system-icons)
|
|
|
|
[Matrix]:https://matrix.org
|
|
[Element]:https://element.io
|