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++ 2019 is required starting with version 93<br/> ** For .Net Core Packages .Net Core 3.1 or .Net 5/6/7 are required.