An open API service indexing awesome lists of open source software.

https://github.com/adolfintel/waifupnp

UPnP Port Forwarding for Java couldn't get any easier!
https://github.com/adolfintel/waifupnp

Last synced: 6 months ago
JSON representation

UPnP Port Forwarding for Java couldn't get any easier!

Awesome Lists containing this project

README

          

# WaifUPnP

UPnP Port Forwarding for Java couldn't be any easier!

WaifUPnP is an _extermely_ lightweight Java library that allows you to:

- open/close TCP/UDP ports
- check if there's an UPnP router available
- check if a port is already mapped

using literally 1 line of code, as it should be!

It's as easy as:

```java
UPnP.openTCP();
```

Usage Examples are included.

## Usage

To compile, import the project in Netbeans.
Alternatively, download the binaries from http://fdossena.com/?p=waifupnp/index.frag

Once you have the .jar files:

- Import `WaifUPnP.jar` into your application
- Optionally, import `WaifUPnP-javadoc.jar` if you need JavaDoc
- `WaifUPnP-sources.jar` contains the source code and should not be imported into your project

## Compatibility

Java 6 and newer

## Limitations

WaifUPnP is a very basic implementation of UPnP, that only scans for the default gateway, and can only open/close ports.

While this is enough for most people, if you need a full implementation of UPnP, you should take a look at [Cling](http://4thline.org/projects/cling/)

## License
Copyright (C) 2015-2018 Federico Dossena

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 2.1 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this program. If not, see .