https://github.com/red5pro/red5pro-ice
ICE library
https://github.com/red5pro/red5pro-ice
Last synced: 2 months ago
JSON representation
ICE library
- Host: GitHub
- URL: https://github.com/red5pro/red5pro-ice
- Owner: red5pro
- Created: 2023-07-12T17:29:06.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-04T16:07:53.000Z (over 1 year ago)
- Last Synced: 2025-03-04T17:23:54.612Z (over 1 year ago)
- Language: Java
- Size: 633 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# red5pro-ice
ICE library for the Red5 Pro Server. This library was originally derived from ice4j with a fork being heavily modified by Red5. The I/O layer and much of the logic has been reimagined to fulfill our needs and now lives here as a separate and distinct project.
## Features
I/O via [Mina](https://mina.apache.org/)
mDNS support via [jmdns](https://github.com/jmdns/jmdns)
## Building
```bash
# Build (default goal: clean install, tests skipped by default)
mvn clean install
# Build with tests
mvn clean install -DskipTests=false
```
## Testing
### Unit Tests
Unit tests cover STUN message encoding/decoding, attributes, and core ICE functionality.
```bash
# Run all unit tests via the test suite
mvn test -DskipTests=false
# Run a specific test class
mvn test -DskipTests=false -Dtest=com.red5pro.ice.attribute.AddressAttributeTest
```
### Integration Tests
Integration tests verify STUN/TURN candidate harvesting against a real coturn server running in Docker.
**Prerequisites:**
- Docker must be installed and running
- The `coturn/coturn` image will be pulled automatically if not present
```bash
# Run all integration tests
mvn test -DskipTests=false -Dtest=IntegrationTestSuite
# Run STUN tests only
mvn test -DskipTests=false -Dtest=StunHarvesterIntegrationTest
# Run TURN tests only
mvn test -DskipTests=false -Dtest=TurnHarvesterIntegrationTest
```
Tests will automatically skip if Docker is not available.
## Links
* [Red5](https://github.com/Red5/ice4j) fork
* Original project [Jitsi](https://jitsi.org/)