2023-07-24 20:31:17 +02:00
< div align = "center" >
2023-07-24 17:38:53 +02:00
2023-05-11 23:26:52 -04:00
2023-08-19 17:49:08 -04:00
# WebUI v2.4.0
2021-03-20 19:53:42 -03:00
2023-07-24 20:29:59 +02:00
[](https://github.com/webui-dev/webui/actions?query=branch%3Amain) [](https://github.com/webui-dev/webui/issues) [](https://webui.me/)
2021-03-20 19:53:42 -03:00
2023-08-22 04:20:17 +02:00
> WebUI is not a web-server solution or a framework, but it allows you to use any web browser as a GUI, with your preferred language in the backend and HTML5 in the frontend. All in a lightweight portable lib.
2021-03-20 19:53:42 -03:00
2023-07-24 17:38:53 +02:00
2021-03-20 19:53:42 -03:00
2023-08-22 04:20:17 +02:00
< / div >
2023-04-24 22:11:31 -04:00
2023-09-02 12:17:30 -04:00
## Download
- [Latest Stable Release ](https://github.com/webui-dev/webui/releases )
2023-09-11 23:33:29 -04:00
- [Nightly Build ](https://github.com/webui-dev/webui/releases/tag/nightly )
2023-09-02 12:17:30 -04:00
2023-08-21 23:06:46 +02:00
## Contents
- [Features ](#features )
- [Showcase ](#showcase )
- [UI & The Web Technologies ](#ui--the-web-technologies )
- [Documentation ](#documentation )
- [Build ](#build )
- [Examples ](#examples )
- [Wrappers ](#wrappers )
- [Supported Web Browsers ](#supported-web-browsers )
- [License ](#license )
2021-03-20 19:53:42 -03:00
## Features
2022-10-30 15:29:10 -04:00
- Written in Pure C
WebUI v2.1.0
#New Features
* Supporting more web browsers
* Search for web browsers in Windows Reg.
* Using the same show() function for HTML script, files, and refresh content
* Support Chrome on macOS
#Breaking code
* Switching from `webui_show(win, html, browser);` to `webui_show(win, content);`, and it's used for HTML, files, and reload the window
* Removing `webui_show_cpy()`, `webui_refresh()`, `webui_refresh_cpy()`
2023-03-28 23:00:09 -04:00
- Fully Independent (*No need for any third-party runtimes*)
2023-09-06 14:52:59 +02:00
- Lightweight ~200 Kb & Small memory footprint
WebUI v2.1.0
#New Features
* Supporting more web browsers
* Search for web browsers in Windows Reg.
* Using the same show() function for HTML script, files, and refresh content
* Support Chrome on macOS
#Breaking code
* Switching from `webui_show(win, html, browser);` to `webui_show(win, content);`, and it's used for HTML, files, and reload the window
* Removing `webui_show_cpy()`, `webui_refresh()`, `webui_refresh_cpy()`
2023-03-28 23:00:09 -04:00
- Fast binary communication protocol between WebUI and the browser (*Instead of JSON*)
2022-09-24 20:34:28 -03:00
- One header file
2022-10-29 21:41:20 -04:00
- Multi-platform & Multi-Browser
2022-10-30 15:29:10 -04:00
- Using private profile for safety
2023-08-21 23:06:46 +02:00
## Showcase
2023-05-08 23:03:41 -04:00
2023-09-12 04:23:19 +02:00
This [text editor ](https://github.com/webui-dev/webui/tree/main/examples/C/text-editor ) is a lightweight and portable example written in C using WebUI as the GUI library.
2023-05-08 23:03:41 -04:00
2023-07-24 17:38:53 +02:00
< div align = "center" >
2023-07-24 23:10:50 +02:00
2023-07-24 17:38:53 +02:00
< / div >
2023-05-08 23:03:41 -04:00
2023-08-21 23:06:46 +02:00
## UI & The Web Technologies
WebUI v2.0.7
* Switch from GPL to LGPL
* Deno example is ready
* Adding `void _webui_free_all_mem()` to release all dynamic mem at exit
* Break Change `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char* data)` to `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char** data)`
* Updating readme
* Moving Zig build file into build folder
More code cleaning and more examples is needed before we release the version 2.0.7.
2023-03-21 18:47:19 -04:00
WebUI v2.1.0
#New Features
* Supporting more web browsers
* Search for web browsers in Windows Reg.
* Using the same show() function for HTML script, files, and refresh content
* Support Chrome on macOS
#Breaking code
* Switching from `webui_show(win, html, browser);` to `webui_show(win, content);`, and it's used for HTML, files, and reload the window
* Removing `webui_show_cpy()`, `webui_refresh()`, `webui_refresh_cpy()`
2023-03-28 23:00:09 -04:00
[Borislav Stanimirov ](https://ibob.bg/ ) discusses using HTML5 in the web browser as GUI at the [C++ Conference 2019 (*YouTube*) ](https://www.youtube.com/watch?v=bbbcZd4cuxg ).
WebUI v2.0.7
* Switch from GPL to LGPL
* Deno example is ready
* Adding `void _webui_free_all_mem()` to release all dynamic mem at exit
* Break Change `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char* data)` to `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char** data)`
* Updating readme
* Moving Zig build file into build folder
More code cleaning and more examples is needed before we release the version 2.0.7.
2023-03-21 18:47:19 -04:00
WebUI v2.1.0
#New Features
* Supporting more web browsers
* Search for web browsers in Windows Reg.
* Using the same show() function for HTML script, files, and refresh content
* Support Chrome on macOS
#Breaking code
* Switching from `webui_show(win, html, browser);` to `webui_show(win, content);`, and it's used for HTML, files, and reload the window
* Removing `webui_show_cpy()`, `webui_refresh()`, `webui_refresh_cpy()`
2023-03-28 23:00:09 -04:00
<!-- <div align="center">
WebUI v2.0.7
* Switch from GPL to LGPL
* Deno example is ready
* Adding `void _webui_free_all_mem()` to release all dynamic mem at exit
* Break Change `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char* data)` to `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char** data)`
* Updating readme
* Moving Zig build file into build folder
More code cleaning and more examples is needed before we release the version 2.0.7.
2023-03-21 18:47:19 -04:00
< a href = "https://www.youtube.com/watch?v=bbbcZd4cuxg" > < img src = "https://img.youtube.com/vi/bbbcZd4cuxg/0.jpg" alt = "Embrace Modern Technology: Using HTML 5 for GUI in C++ - Borislav Stanimirov - CppCon 2019" > < / a >
WebUI v2.1.0
#New Features
* Supporting more web browsers
* Search for web browsers in Windows Reg.
* Using the same show() function for HTML script, files, and refresh content
* Support Chrome on macOS
#Breaking code
* Switching from `webui_show(win, html, browser);` to `webui_show(win, content);`, and it's used for HTML, files, and reload the window
* Removing `webui_show_cpy()`, `webui_refresh()`, `webui_refresh_cpy()`
2023-03-28 23:00:09 -04:00
< / div > -->
2023-07-24 20:31:17 +02:00
< div align = "center" >
2023-09-05 19:35:02 +02:00
WebUI v2.0.7
* Switch from GPL to LGPL
* Deno example is ready
* Adding `void _webui_free_all_mem()` to release all dynamic mem at exit
* Break Change `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char* data)` to `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char** data)`
* Updating readme
* Moving Zig build file into build folder
More code cleaning and more examples is needed before we release the version 2.0.7.
2023-03-21 18:47:19 -04:00
2023-07-24 20:31:17 +02:00
< / div >
2022-11-02 21:43:48 -04:00
Web application UI design is not just about how a product looks but how it works. Using web technologies in your UI makes your product modern and professional, And a well-designed web application will help you make a solid first impression on potential customers. Great web application design also assists you in nurturing leads and increasing conversions. In addition, it makes navigating and using your web app easier for your users.
2023-08-21 23:06:46 +02:00
### Why Use Web Browsers?
2022-11-02 21:43:48 -04:00
Today's web browsers have everything a modern UI needs. Web browsers are very sophisticated and optimized. Therefore, using it as a GUI will be an excellent choice. While old legacy GUI lib is complex and outdated, a WebView-based app is still an option. However, a WebView needs a huge SDK to build and many dependencies to run, and it can only provide some features like a real web browser. That is why WebUI uses real web browsers to give you full features of comprehensive web technologies while keeping your software lightweight and portable.
2023-08-21 23:06:46 +02:00
### How Does it Work?
2022-10-30 15:29:10 -04:00
2023-07-24 20:31:17 +02:00
< div align = "center" >
2023-09-05 19:35:02 +02:00
2022-10-30 15:29:10 -04:00
2023-07-24 20:31:17 +02:00
< / div >
WebUI v2.1.0
#New Features
* Supporting more web browsers
* Search for web browsers in Windows Reg.
* Using the same show() function for HTML script, files, and refresh content
* Support Chrome on macOS
#Breaking code
* Switching from `webui_show(win, html, browser);` to `webui_show(win, content);`, and it's used for HTML, files, and reload the window
* Removing `webui_show_cpy()`, `webui_refresh()`, `webui_refresh_cpy()`
2023-03-28 23:00:09 -04:00
Think of WebUI like a WebView controller, but instead of embedding the WebView controller in your program, which makes the final program big in size, and non-portable as it needs the WebView runtimes. Instead, by using WebUI, you use a tiny static/dynamic library to run any installed web browser and use it as GUI, which makes your program small, fast, and portable. **All it needs is a web browser** .
WebUI v2.0.7
* Switch from GPL to LGPL
* Deno example is ready
* Adding `void _webui_free_all_mem()` to release all dynamic mem at exit
* Break Change `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char* data)` to `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char** data)`
* Updating readme
* Moving Zig build file into build folder
More code cleaning and more examples is needed before we release the version 2.0.7.
2023-03-21 18:47:19 -04:00
2023-08-21 23:06:46 +02:00
### Runtime Dependencies Comparison
WebUI v2.0.7
* Switch from GPL to LGPL
* Deno example is ready
* Adding `void _webui_free_all_mem()` to release all dynamic mem at exit
* Break Change `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char* data)` to `void webui_script_interface(webui_window_t* win, const char* script, unsigned int timeout, bool* error, unsigned int* length, char** data)`
* Updating readme
* Moving Zig build file into build folder
More code cleaning and more examples is needed before we release the version 2.0.7.
2023-03-21 18:47:19 -04:00
2022-10-30 15:29:10 -04:00
| | WebView | Qt | WebUI |
| ------ | ------ | ------ | ------ |
WebUI v2.1.0
#New Features
* Supporting more web browsers
* Search for web browsers in Windows Reg.
* Using the same show() function for HTML script, files, and refresh content
* Support Chrome on macOS
#Breaking code
* Switching from `webui_show(win, html, browser);` to `webui_show(win, content);`, and it's used for HTML, files, and reload the window
* Removing `webui_show_cpy()`, `webui_refresh()`, `webui_refresh_cpy()`
2023-03-28 23:00:09 -04:00
| Runtime Dependencies on Windows | *WebView2* | *QtCore, QtGui, QtWidgets* | ** *A Web Browser*** |
| Runtime Dependencies on Linux | *GTK3, WebKitGTK* | *QtCore, QtGui, QtWidgets* | ** *A Web Browser*** |
| Runtime Dependencies on macOS | *Cocoa, WebKit* | *QtCore, QtGui, QtWidgets* | ** *A Web Browser*** |
2021-03-20 19:53:42 -03:00
2022-11-07 23:33:03 -05:00
## Documentation
2023-08-22 04:20:17 +02:00
> **Note**
> We are currently writing documentation.
2023-04-24 22:11:31 -04:00
- [Online Documentation - C ](https://webui.me/docs/#/c_api )
2023-04-25 23:33:56 -04:00
- [Online Documentation - C++ ](https://webui.me/docs/#/cpp_api )
2022-11-07 23:33:03 -05:00
2022-09-29 13:46:24 -03:00
## Build
2023-08-21 18:22:40 +02:00
- **Windows**
```powershell
# GCC
mingw32-make
2023-08-21 23:06:46 +02:00
2023-08-21 18:22:40 +02:00
# MSVC
2023-08-21 23:06:46 +02:00
nmake -f Makefile.nmake
2023-08-21 18:22:40 +02:00
```
- **Linux**
```sh
# GCC
make
2023-08-21 23:06:46 +02:00
2023-08-21 18:22:40 +02:00
# Clang
2023-09-07 05:34:32 +02:00
make CC=clang
2023-08-21 18:22:40 +02:00
```
- **macOS**
```sh
make
```
2022-09-29 13:46:24 -03:00
## Examples
2023-08-21 23:06:46 +02:00
- [C ](https://github.com/webui-dev/webui/tree/main/examples/C )
- [C++ ](https://github.com/webui-dev/webui/tree/main/examples/C++ )
2023-05-13 10:47:42 -04:00
2023-08-21 23:06:46 +02:00
## Wrappers
2022-09-29 13:46:24 -03:00
2022-11-01 00:59:23 -04:00
| Language | Status | Link |
| ------ | ------ | ------ |
2023-05-13 10:47:42 -04:00
| Go | ✔️ | [Go-WebUI ](https://github.com/webui-dev/go-webui ) |
2023-08-22 20:41:20 +02:00
| Nim | ✔️ | [Nim-WebUI ](https://github.com/webui-dev/nim-webui ) |
| Pascal | ✔️ | [Pascal-WebUI ](https://github.com/webui-dev/pascal-webui ) |
| Python | ✔️ | [Python-WebUI ](https://github.com/webui-dev/python-webui ) |
2023-08-21 23:06:46 +02:00
| Rust | *not complete* | [Rust-WebUI ](https://github.com/webui-dev/rust-webui ) |
2023-08-22 20:41:20 +02:00
| TypeScript / JavaScript | ✔️ | [Deno-WebUI ](https://github.com/webui-dev/deno-webui ) |
2023-05-13 10:47:42 -04:00
| V | ✔️ | [V-WebUI ](https://github.com/webui-dev/v-webui ) |
2023-08-21 23:06:46 +02:00
| Zig | *not complete* | [Zig-WebUI ](https://github.com/webui-dev/zig-webui ) |
## Supported Web Browsers
| Browser | Windows | macOS | Linux |
| ------ | ------ | ------ | ------ |
| Mozilla Firefox | ✔️ | ✔️ | ✔️ |
| Google Chrome | ✔️ | ✔️ | ✔️ |
| Microsoft Edge | ✔️ | ✔️ | ✔️ |
| Chromium | ✔️ | ✔️ | ✔️ |
| Yandex | ✔️ | ✔️ | ✔️ |
| Brave | ✔️ | ✔️ | ✔️ |
| Vivaldi | ✔️ | ✔️ | ✔️ |
| Epic | ✔️ | ✔️ | *not available* |
| Apple Safari | *not available* | *coming soon* | *not available* |
| Opera | *coming soon* | *coming soon* | *coming soon* |
2021-03-20 19:53:42 -03:00
### License
2023-05-04 21:41:03 -04:00
> Licensed under MIT License.
2023-03-26 22:21:38 -04:00
2022-10-20 23:50:17 -03:00
### Stargazers
2023-05-13 10:47:42 -04:00
[](https://github.com/webui-dev/webui/stargazers)
