🇩🇪… [Deutsche Version der Readme hier verfügbar.](README.md) / [Francais ici](README-fr.md)
monocles chat is a modern and secure Android XMPP client. Based on blabber.im and [Conversations](https://github.com/siacs/Conversations) but with a lot of changes and additional features.
The changes aim to improve usability and ease transition from pre-installed and other widespread chats. Here are some screenshots:
If we can't fix your problem there, you can open an issue [here](https://codeberg.org/Arne/monocles_chat/issues), detailing your problem, how to reproduce it and provide logs. See instructions below on how to create log files.
### How to create debug logs? (adb)
#### GNU/Linux, OSX and other Unix-like systems:
1. First install The **A**ndroid **D**ebugging **B**ridge, if not already present.
###### Debian and derivates like Ubuntu / Linux Mint
```
sudo apt-get update
sudo apt-get update adb
# Debian Jessie or older:
# sudo apt-get install android-tools-adb
```
###### openSUSE 42.2 and 42.3
```
sudo zypper ref
sudo zypper install android-tools
```
###### openSUSE Tumbleweed
here you need to add the following repo (e.g. via Yast):
4. Open the command line (CMD) using the start menu: Start > Execute: cmd
5. Navigate to the directory you extracted the zip to as following. We will be using `C:\ADB\`
```
c:
cd ADB
```
6. On your smartphone open the settings and search for the item `Developer Options`. If this option is not already present on your phone you will need to unlock it beforehand. To do this navigate to `Settings > About phone`, there locate `Build number` (or similar) and tap it 7-times in succession. You should now see a notification, that you are now a developer. Congrats, `Developer Options` are now available in your settings menu.
7. Inside `Developer Options` search activate the setting `USB-Debugging` (sometimes just called `Android Debugging`).
8. Connect your phone to your computer via USB cable. The necessary drivers should now be downloaded and installed if not already present. On Windows all necessary drivers should be downloaded automatically if you followed step [2] beforehand. On most GNU/Linux systems no additional action is required.
9. If everything worked out, you can now return to the command line and test if your device is being recognised. Enter `adb devices -l`; you should see output similar to:
```
> adb devices -l
List of devices attached
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
042111560169500303f4 unauthorized
```
10. If your devices is labelled as `unautorized`, you must first accept a prompt on your phone asking if debugging over USB should be allowed. When rerunning `adb devices` you should now see:
```
> adb devices
List of devices attached
042111560169500303f4 device
```
11. Start outputting your log to a file on your computer. We will be using `logcat.txt` in `C:\ADB\`. Just enter the following (without `> ` into the command line):
13. Stop logging (`Ctrl+C`). Now take a close look at your log file and remove any personal and private information you may find before sending it together with a detailed description of your issue, instructions on how to reproduce to me. You can use GitHub's issue tracker: [Issues](https://github.com/kriztan/Monocles-Messenger/issues)
