# libnice


## The GLib ICE implementation

Libnice is an implementation of the IETF's Interactive Connectivity Establishment (ICE) standard (RFC 5245).

It provides a GLib-based library, libnice, as well as [[GStreamer|http://www.gstreamer.net]] elements.

ICE is useful for applications that want to establish peer-to-peer UDP data streams. It automates the process of traversing NATs and provides security against some attacks. It also allows applications to create reliable streams using a TCP over UDP layer.

Existing standards that use ICE include Session Initiation Protocol (SIP), XMPP Jingle and WebRTC.

#### Links

* [[Bug reports in freedesktop.org GitLab|https://gitlab.freedesktop.org/libnice/libnice/issues/]]
* [[git repository|https://gitlab.freedesktop.org/libnice/libnice]]
 * [[GitHub mirror|https://github.com/libnice/libnice]] — merge requests and issues should be filed on the freedesktop GitLab above, not GitHub or GitLab.com
 * [[GitLab.com mirror|https://gitlab.com/libnice/libnice]]
* [[Release downloads|https://nice.freedesktop.org/releases/]]
* [[API documentation|https://nice.freedesktop.org/libnice/]]
 * Explanation of how to use it with [[GStreamer]]
* [[Mailing list|https://lists.freedesktop.org/mailman/listinfo/nice]]

#### Reporting bugs

Please [[report bugs using freedesktop.org GitLab|https://gitlab.freedesktop.org/libnice/libnice/issues/]] (preferred) or [[via the mailing list|https://lists.freedesktop.org/mailman/listinfo/nice]]. Patches can be submitted via freedesktop.org [[GitLab merge requests|https://gitlab.freedesktop.org/libnice/libnice/merge_requests/]]. They're not accepted on the [[GitHub|https://github.com/libnice/libnice]] or [[GitLab.com|https://gitlab.com/libnice/libnice]] mirrors.

#### Relevant Standards

* [[ICE RFC 5245|http://tools.ietf.org/html/rfc5245]]
* [[STUN RFC 3489|http://tools.ietf.org/html/rfc3489]]
* [[STUN (bis) RFC 5389|http://tools.ietf.org/html/rfc5389]]
* [[TURN RFC 5766|http://tools.ietf.org/html/rfc5766]]

[[Farstream|https://freedesktop.org/wiki/Software/Farstream]] is a complete streaming implementation, build for peer-to-peer audio and video, that uses libnice.