2020-04-14 19:04:13 +01:00
|
|
|
[](https://libwebsockets.org/git/libwebsockets) [](https://scan.coverity.com/projects/3576) [](https://bestpractices.coreinfrastructure.org/projects/2266) [](https://www.codacy.com/app/lws-team/libwebsockets?utm_source=github.com&utm_medium=referral&utm_content=warmcat/libwebsockets&utm_campaign=Badge_Grade) [](https://lgtm.com/projects/g/warmcat/libwebsockets/alerts/) [](https://lgtm.com/projects/g/warmcat/libwebsockets/context:cpp) [](https://lgtm.com/projects/g/warmcat/libwebsockets/context:javascript)
|
2014-12-01 01:21:10 +01:00
|
|
|
|
2018-11-16 09:10:41 +08:00
|
|
|
# Libwebsockets
|
|
|
|
|
|
2020-07-13 13:21:22 +01:00
|
|
|
Libwebsockets is a simple-to-use, MIT-license, pure C library providing client and server
|
2020-03-04 10:01:28 +00:00
|
|
|
for **http/1**, **http/2**, **websockets**, **MQTT** and other protocols in a security-minded,
|
2018-11-16 09:10:41 +08:00
|
|
|
lightweight, configurable, scalable and flexible way. It's easy to build and
|
|
|
|
|
cross-build via cmake and is suitable for tasks from embedded RTOS through mass
|
|
|
|
|
cloud serving.
|
|
|
|
|
|
2021-08-02 07:23:52 +01:00
|
|
|
It supports a lot of lightweight ancilliary implementations for things like JSON,
|
|
|
|
|
CBOR, JOSE, COSE, and supports OpenSSL and MbedTLS v2 and v3 out of the box for everything.
|
|
|
|
|
It's very gregarious when it comes to event loop sharing, supporting libuv, libevent, libev,
|
|
|
|
|
sdevent, glib and uloop, as well as custom event libs.
|
2018-11-16 09:10:41 +08:00
|
|
|
|
2021-08-02 07:23:52 +01:00
|
|
|
[100+ independent minimal examples](https://libwebsockets.org/git/libwebsockets/tree/minimal-examples) for various scenarios, CC0-licensed
|
|
|
|
|
(public domain) for cut-and-paste, allow you to get started quickly.
|
2021-04-15 17:43:39 +01:00
|
|
|
|
2021-08-02 07:23:52 +01:00
|
|
|
[There are a lot of READMEs](https://libwebsockets.org/git/libwebsockets/tree/READMEs) on a variety of topics.
|
|
|
|
|
|
2021-09-30 09:31:26 +01:00
|
|
|
[We do a huge amount of CI testing per push](https://libwebsockets.org/sai/), currently 582 builds on 30 platforms.
|
|
|
|
|
[You can see the lws CI rack and read about how lws-based Sai is used to coordinate all the testing](https://warmcat.com/2021/08/21/Sai-CI.html).
|
2021-04-15 17:43:39 +01:00
|
|
|
|
2018-12-13 20:05:12 +08:00
|
|
|
|
2014-12-01 01:21:10 +01:00
|
|
|
|
2017-03-16 10:46:31 +08:00
|
|
|
News
|
|
|
|
|
----
|
|
|
|
|
|
2021-10-04 13:36:44 +01:00
|
|
|
## v4.3 is released
|
|
|
|
|
|
|
|
|
|
See the [changelog](https://libwebsockets.org/git/libwebsockets/tree/changelog)
|
|
|
|
|
|
|
|
|
|
|
2021-09-30 09:31:26 +01:00
|
|
|
## Lws work retrospective
|
|
|
|
|
|
|
|
|
|
The initial commit for lws will have been 11 years ago come Oct 28 2021, it's been a lot of work.
|
|
|
|
|
There are a total of 4.3K patches, touching 800KLOC cumulatively (this is not the size in the
|
|
|
|
|
repo, but over the years, how many source lines were changed by patches).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Gratifyingly, it turns out over the years, ~15% of that was contributed by 404 contributors: that's not so bad.
|
|
|
|
|
Thanks a lot to everyone who has provided patches.
|
|
|
|
|
|
|
|
|
|
Today at least tens of millions of devices and product features rely on lws to
|
|
|
|
|
handle their communications including several from FAANG; Google now include lws
|
|
|
|
|
as part of Android sources.
|
|
|
|
|
|
2018-03-08 12:04:13 +08:00
|
|
|
## Support
|
2016-08-07 08:33:08 +08:00
|
|
|
|
2013-02-06 16:07:27 +09:00
|
|
|
This is the libwebsockets C library for lightweight websocket clients and
|
|
|
|
|
servers. For support, visit
|
|
|
|
|
|
2016-02-21 10:42:46 +08:00
|
|
|
https://libwebsockets.org
|
2013-02-06 16:07:27 +09:00
|
|
|
|
|
|
|
|
and consider joining the project mailing list at
|
|
|
|
|
|
2016-02-21 10:42:46 +08:00
|
|
|
https://libwebsockets.org/mailman/listinfo/libwebsockets
|
2013-02-06 16:07:27 +09:00
|
|
|
|
2016-02-21 10:42:46 +08:00
|
|
|
You can get the latest version of the library from git:
|
2013-02-06 16:07:27 +09:00
|
|
|
|
2016-02-21 10:42:46 +08:00
|
|
|
- https://libwebsockets.org/git
|
2013-02-06 16:07:27 +09:00
|
|
|
|
2021-07-12 09:36:35 +01:00
|
|
|
Doxygen API docs for development: https://libwebsockets.org/lws-api-doc-main/html/index.html
|
2013-02-06 16:07:27 +09:00
|
|
|
|
