Matrix-ClientServer-API-java

A small and simple java API for the Matrix ClientServer Protocol (see clientServer api) The API is still in Beta and known for bugs. If you found or missing a feature one you can create a new issue.

Usage

Login

With credentials

//https not supported yet
Client c = new Client("http://matrix.your.server.xyz:8008");  
c.login("examplebot", "wordpass123", loginData -> {  
  if (loginData.isSuccess()) {
    //Do sth with the bot
  } else {  
    System.err.println("error logging in");  
  }
});

With Usertoken

//https not supported yet
Client c = new Client("http://matrix.your.server.xyz:8008");  
c.login("Y0ur70ken", loginData -> {  
  if (loginData.isSuccess()) {
    //Do sth with the bot
  } else {  
    System.err.println("error logging in");  
  }
});

For an examplebot you can have a look at my Grep Bot

Features

• Login
  • UserID/Password
  • Usertoken
• Events
  • Receive&Send roomevents (join, messages, typing, ....)
  • Get eventdata by EventID
  • Multiple eventlistener
  • Receive events happened when bot was offline
  • Custom sync filter
• User
  • Presence
  • Typing
  • Receipts
  • Send text/messages (formatted and raw)
  • Login/Logout/Logout all
  • Join/leave room
  • Get roommembers
  • Kick
  • Ban
  • Unban
  • Create new room