QCefView is a Qt-based QWidget that encapsulates CEF (Chromium Embedded Framework). With QCefView, you can build your application UI using modern frontend development techniques, boosting project efficiency while keeping UI and business logic decoupled. Most importantly, QCefView enables seamless CEF integration within Qt applications.
| Platform | Lastest Build Status | OSR Production Ready | NCW Production Ready |
|---|---|---|---|
| Windows-x86_64 |  |
✔️ | ✔️ |
| macOS-x86_64 |  |
✔️ | ✔️ |
| Linux-x86_64 |  |
✔️ | ❌ |
- OSR = Offscreen Rendering Mode
- NCW = Native Child Window Mode
| Platform | NCW CEF All Versions |
OSR - Software Rendering CEF All Versions |
OSR - Hardware Rendering CEF 125+ |
|---|---|---|---|
| Windows | ✔️ | ✔️ | ✔️ (DirectX 11) |
| MacOS | ✔️ | ✔️ | ❌ WIP (Metal) |
| Linux | ✔️ | ✔️ | ❌ WIP (OpenGL) |
WIP (Work In Progress): Features under development, no guaranteed release date.
git clone https://github.com/CefView/QCefView.gitThe dependency on CefViewCore has been converted to CMake FetchContent, meaning submodules are no longer required. Refer to: cmake/CefViewCoreConfig.cmake for more details.
Find the latest documentation here:
These resources will help you quickly understand and integrate QCefView into your projects.
QCefView supports CEF offscreen rendering mode (OSR), which is enabled by default. To disable OSR mode, set setWindowlessRenderingEnabled to false in the configuration:
QCefConfig config;
// OSR (Windowless Rendering) is enabled by default
// Set to false to disable OSR mode
config.setWindowlessRenderingEnabled(false);Starting from CEF 125+, GPU resource sharing is generally available. QCefView now supports hardware acceleration for OSR mode. To enable it:
QCefSetting setting;
// Enable hardware renderer (only applicable in OSR mode)
setting.setHardwareAcceleration(true);
// Set frame rate limit
setting.setWindowlessFrameRate(240);
// Create the QCefView widget
auto qCefViewWidget = new QCefView("https://www.testufo.com/", &setting);The performance comparison：
Software VS Hardware Rendering
We welcome contributions and suggestions! To maintain consistency, please ensure your code adheres to the style defined in .clang-format.
- 📌 Solve an issue (e.g., answer a question in the Issues section or Gitter chat)
- 🛠 Fix a bug or report one
- 📖 Improve documentation (even fixing typos helps!)
If you're interested in becoming a QCefView maintainer (e.g., merging PRs, triaging issues), please contact me via email: sheentianshen#gmail.com. I'm happy to help set the right permissions for you.
💡 Let's build a better QCefView together! 🚀
