CefSharp

Got a quick question? Discussions here on GitHub is the preferred place to ask!

CefSharp lets you embed Chromium in .NET apps. It is a lightweight .NET wrapper around the Chromium Embedded Framework (CEF) by Marshall A. Greenblatt. About 30% of the bindings are written in C++/CLI with the majority of code here is C#. It can be used from C# or VB, or any other CLR language. CefSharp provides both WPF and WinForms web browser control implementations.

CefSharp is BSD licensed, so it can be used in both proprietary and free/open source applications. For the full details, see the LICENSE file.

If you like and use CefSharp please consider signing up for a small monthly donation, even $25 can help tremendously. See Financial Support for more details.

Releases

Stable binaries are released on NuGet, and contain everything you need to embed Chromium in your .Net/CLR application. For usage see the Quick Start guide or checkout CefSharp.MinimalExample project for basic demos using the CefSharp NuGet packages.

• CefSharp.WinForms
• CefSharp.Wpf
• CefSharp.OffScreen
• CefSharp.Wpf.HwndHost (A HwndHost based WPF implementation, similar to hosting the WinForms version in WPF, supports data binding, airspace issues apply).

Documentation

• See the CefSharp.Wpf.Example or CefSharp.WinForms.Example projects for example web browsers built with CefSharp. They demo most of the available features.
• See the CefSharp.MinimalExample project for a basic demo of using the CefSharp NuGet packages.
• See the General Usage Guide in help getting started/dealing with common scenarios.
• See the Wiki for work-in-progress documentation
• See the FAQ for help with common issues
• Upgrading from an earlier version of CefSharp? See the ChangeLog for breaking changes and upgrade tips.
• CefSharp API generated from the source code comments.

Contact

Please keep the Issue Tracker for Bugs only please! Before submitting a PR please read CONTRIBUTING.

• CefSharp Discussions is generally where CefSharp specific questions should be asked, please search before posting, thanks!
• Stackoverflow is where generic html/javascript/C# questions can be asked.
• Chromium Embedded Framework(CEF) Forum

Branches & Forks

This is the official CefSharp fork, as maintained by the CefSharp community. You can also view the entire network of public forks/branches.

Development is done in the master branch. New features are preferably added in feature branches, if the changes are more than trivial. New PR's should be targeted against master.

When a new release is imminent a release branch is created. We try to avoid making public facing API changes in release branches (Adding new features is fine, just not breaking changes).

Releases

CI Builds<br/> Every commit on master produces a Nuget package. Use at your own risk!

• 
• 
• 

Pre-release<br>

• 

• 

• 

• 

• 

• 

Stable<br>

• 

• 

• 

• 

• 

• 

Release Branches

With each release a new branch is created, for example the 92.0.260 release corresponds to the cefsharp/92 branch. If you're new to CefSharp and are downloading the source to check it out, please use a Release branch.

* VC++ 2022 is required starting with version 138<br/> ** For NetCore packages .Net 6 or greater is required.

| Branch | CEF Version | VC++ Version | .Net Version | Status | |-----------------------------------------------------------------------|------|-------|---------|-----------------| | master | 7680 | 2022* | 4.6.2** | Development | | cefsharp/146| 7680 | 2022* | 4.6.2** | Release | | cefsharp/145| 7632 | 2022* | 4.6.2** | Unsupported | | cefsharp/144| 7559 | 2022* | 4.6.2** | Unsupported | | cefsharp/143| 7499 | 2022* | 4.6.2** | Unsupported | | cefsharp/141| 7390 | 2022* | 4.6.2** | Unsupported | | cefsharp/140| 7339 | 2022* | 4.6.2** | Unsupported | | cefsharp/139| 7258 | 2022* | 4.6.2** | Unsupported | | cefsharp/138| 7204 | 2022* | 4.6.2** | Unsupported | | cefsharp/137| 7151 | 2019* | 4.6.2** | Unsupported | | cefsharp/136| 7103 | 2019* | 4.6.2** | Unsupported | | cefsharp/135| 7049 | 2019* | 4.6.2** | Unsupported | | cefsharp/134| 6998 | 2019* | 4.6.2** |