Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xmppo/xmppconsole
XMPP Console - A tool for XMPP hackers
https://github.com/xmppo/xmppconsole
jabber xmpp
Last synced: 2 months ago
JSON representation
XMPP Console - A tool for XMPP hackers
- Host: GitHub
- URL: https://github.com/xmppo/xmppconsole
- Owner: xmppo
- License: gpl-3.0
- Created: 2020-04-16T15:17:02.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-10-18T17:40:44.000Z (about 4 years ago)
- Last Synced: 2024-08-08T20:12:51.230Z (5 months ago)
- Topics: jabber, xmpp
- Language: C
- Homepage: https://github.com/xmppo/xmppconsole
- Size: 179 KB
- Stars: 15
- Watchers: 7
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-xmpp - xmpp-console - Send raw XMPP stanzas and display streams. (Tools)
README
xmppconsole
===========
xmppconsole is a tool for XMPP hackers.
This tool sends raw XMPP stanzas over an XMPP connection and displays the XMPP
stream. Main purpose is to study XEPs and debug implementation of XMPP entities.
xmppconsole supports multiple UI modules: GTK, ncurses, console. Therefore, you
can use it on a server without graphical interface.
How to run xmppconsole
----------------------
The straightforward way to run xmppconsole is to provide your JID and password:
```
xmppconsole [email protected] password
```
xmppconsole has multiple options which you can review with `--help` argument.
It allows you to connect to a server with misconfigured TLS and/or DNS record.
Also, you can connect to a server anonymously if the server supports this.
Or you can even start working with XMPP connection before authentication and
debug in-band registration or authentication mechanisms.
By default, xmppconsole detects whether it can run with graphical interface and
falls back to a text interface otherwise. However, you can set preferable UI
manually with `-u` option.
Build requirements
------------------
xmppconsole has only 1 required dependency:
* [libstrophe](https://github.com/strophe/libstrophe) version 0.10.0 or higher
You will need the following dependencies in order to build optional UI modules.
For GTK graphical interface:
* gtk-3.0
* gtksourceview (either version 3.0 or 4)
For ncurses-based text interface:
* ncurses
* readline
Supported systems: Unix-like systems (including Linux, MacOS, BSDs), Windows
with Cygwin.
Build instructions
------------------
There is no release tarballs at this point. You will have to build xmppconsole
from sources using autotools.
```
git clone https://github.com/pasis/xmppconsole.git
cd xmppconsole
./autogen.sh
./configure
make
```
Bugs
----
If you experience an issue with using xmppconsole, please, report at the
[issue tracker](https://github.com/pasis/xmppconsole/issues).
License
-------
xmppconsole is a free software and licensed under GPL3+.