README.md

Skype4J

This is a Skype API for Java. It does not support P2P chats. You can tell whether you're in a P2P chat or not based on the output of the /help command. If it contains commands such as /kickban, you're in a P2P chat and should switch to cloud chats immediately (try using /fork).

Here is an example of using this API to log into your Skype account.

Skype skype = new SkypeBuilder(username, password).withAllResources().build();
skype.login();
skype.getEventDispatcher().registerListener(new Listener() {
  @EventHandler
  public void onMessage(MessageReceivedEvent e) {
    System.out.println("Got message: " + e.getMessage().getContent());
  }
});
skype.subscribe();
// Do stuff
skype.logout();

If you want to use a guest account, you can do that too

Skype skype = new SkypeBuilder("Skype4JGuest").withChat("19:[email protected]").withAllResources().build();
skype.login();
skype.getEventDispatcher().registerListener(new Listener() {
  @EventHandler
  public void onMessage(MessageReceivedEvent e) {
    System.out.println("Got message: " + e.getMessage().getContent());
  }
});
skype.subscribe();
// Do stuff
skype.logout();

For more examples, please consult the wiki

Maven

Maven is used for dependency management and deployment. To use this API, simply add the following to your pom.xml

<dependency>
  <groupId>com.samczsun</groupId>
  <artifactId>skype4j</artifactId>
  <version>0.1.5</version>
</dependency>

You can also download the latest build of this project from Jenkins
If you want to use Maven with the latest build and don't want to manually install, JitPack may do the trick.

JavaDocs

JavaDocs can be found here

Licensing

This project is licensed under the Apache 2.0 license

Contributing

If you want to help out, thanks a lot! However, there are a few legalities to work out first.

Any contributions you wish to make must be accompanied by a Contributer License Agreement ("CLA"). This simply gives myself, or whoever is maintaining the project, the right to redistribute your contributions.

The CLA can be found in the root directory of the project, in the file called "CLA". Please read it carefully.

You only need to submit your CLA once, so if you've already signed a CLA there's no need to do it again.

Acknowledgements

YourKit supports open source projects with its full-featured Java Profiler.

YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.