You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Philippe Normand ff9ee9912f candidate: Add utility function to get STUN server address 1 week ago
agent candidate: Add utility function to get STUN server address 1 week ago
docs candidate: Add utility function to get STUN server address 1 week ago
examples Remove autotools build 2 years ago
gst gstnicesink: disable drop out of segment on nicesink 6 months ago
nice candidate: Add utility function to get STUN server address 1 week ago
random Remove autotools build 2 years ago
socket tcp-active: Fix use-after-free in error case 6 months ago
stun stun: Use a specific variable to enable Win32 crypto 7 months ago
subprojects subprojects: Get zlib from Qt mirror 10 months ago
tests Don't try to use link-local addresses outside local network 1 month ago
.gitignore gitignore: Remove in-tree built files 2 years ago
.gitlab-ci.yml gitlab-ci: Allow manual runs 6 months ago
AUTHORS Fix for make distcheck to work 14 years ago
COPYING relicense under MPL+LGPL 15 years ago
COPYING.LGPL move COPYING -> COPYING.LGPL 15 years ago
COPYING.MPL add COPYING.MPL 15 years ago
NEWS version 0.1.19 2 weeks ago
README Use https instead of http as far as possible in README 1 year ago
TODO TODO: Update to match current state 8 years ago
meson.build Add NICE_CHECK_VERSION macro 2 weeks ago
meson_options.txt build: add default ignore network interface prefix 3 years ago

README


Nice: GLib ICE library
======================

Copyright
---------

(C) 2006-2020 Collabora Ltd.
(C) 2006-2011 Nokia Corporation

License
-------

See the file COPYING.

Requirements
------------

glib >= 2.54
pkg-config
gnutls >= 2.12.0 or OpenSSL
gupnp-igd >= 0.1.2 (optional)
gstreamer-0.10 (optional)
gstreamer-1.0 (optional)

Build instructions
------------------

libnice uses the Meson Build System: https://mesonbuild.com

To build on Linux and Mac, you only need to type the usual commands :

meson builddir
ninja -C builddir
ninja -C builddir test (or "meson test -C builddir" for more control)
sudo ninja -C builddir install

See https://mesonbuild.com/Quick-guide.html#compiling-a-meson-project
for more details and how to install the Meson build system.

Structure
---------

agent/ - ICE agent
docs/ - Design and API documentation
gst/ - Gstreamer elements
nice/ - libnice library
random/ - random number generation
socket/ - Socket abstraction layer
stun/ - STUN implementation
tests/ - Unit tests

Relevant standards
------------------

These standards are relevant to nice's current implementation.

ICE
https://tools.ietf.org/html/rfc5245 (old)
https://tools.ietf.org/html/rfc8445
STUN
https://tools.ietf.org/html/rfc3489 (old)
https://tools.ietf.org/html/rfc5389
STUN Consent Freshness RFC
https://tools.ietf.org/html/rfc7675
TURN
https://tools.ietf.org/html/rfc5766
RTP
https://tools.ietf.org/html/rfc3550
ICE-TCP RFC
https://tools.ietf.org/html/rfc6544
Trickle ICE
https://tools.ietf.org/html/draft-ietf-ice-trickle-21
XMPP Jingle ICE transport
https://www.xmpp.org/extensions/xep-0176.html

In future, nice may additionally support the following standards.

NAT-PMP
http://files.dns-sd.org/draft-cheshire-nat-pmp.txt