Awesome
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.
Branch | CEF Version | VC++ Version | .Net Version | Status |
---|---|---|---|---|
master | 6723 | 2019* | 4.6.2** | Development |
cefsharp/127 | 6723 | 2019* | 4.6.2** | Release |
cefsharp/127 | 6668 | 2019* | 4.6.2** | Unsupported |
cefsharp/127 | 6613 | 2019* | 4.6.2** | Unsupported |
cefsharp/127 | 6533 | 2019* | 4.6.2** | Unsupported |
cefsharp/126 | 6478 | 2019* | 4.6.2** | Unsupported |
cefsharp/125 | 6422 | 2019* | 4.6.2** | Unsupported |
cefsharp/124 | 6367 | 2019* | 4.6.2** | Unsupported |
cefsharp/123 | 6312 | 2019* | 4.6.2** | Unsupported |
cefsharp/122 | 6261 | 2019* | 4.6.2** | Unsupported |
cefsharp/121 | 6167 | 2019* | 4.6.2** | Unsupported |
cefsharp/120 | 6099 | 2019* | 4.6.2** | Unsupported |
cefsharp/119 | 6045 | 2019* | 4.6.2** | Unsupported |
cefsharp/118 | 5993 | 2019* | 4.6.2** | Unsupported |
cefsharp/117 | 5938 | 2019* | 4.6.2** | Unsupported |
cefsharp/116 | 5845 | 2019* | 4.6.2** | Unsupported |
cefsharp/115 | 5790 | 2019* | 4.6.2** | Unsupported |
cefsharp/114 | 5735 | 2019* | 4.5.2** | Unsupported |
cefsharp/113 | 5615 | 2019* | 4.5.2** | Unsupported |
cefsharp/112 | 5615 | 2019* | 4.5.2** | Unsupported |
cefsharp/111 | 5563 | 2019* | 4.5.2** | Unsupported |
cefsharp/110 | 5481 | 2019* | 4.5.2** | Unsupported |
cefsharp/109 | 5414 | 2019* | 4.5.2** | Unsupported |
cefsharp/108 | 5359 | 2019* | 4.5.2** | Unsupported |
cefsharp/107 | 5304 | 2019* | 4.5.2** | Unsupported |
cefsharp/106 | 5249 | 2019* | 4.5.2** | Unsupported |
cefsharp/105 | 5195 | 2019* | 4.5.2** | Unsupported |
cefsharp/104 | 5112 | 2019* | 4.5.2** | Unsupported |
cefsharp/103 | 5060 | 2019* | 4.5.2** | Unsupported |
cefsharp/102 | 5005 | 2019* | 4.5.2** | Unsupported |
cefsharp/101 | 4951 | 2019* | 4.5.2** | Unsupported |
cefsharp/100 | 4896 | 2019* | 4.5.2** | Unsupported |
cefsharp/99 | 4844 | 2019* | 4.5.2** | Unsupported |
cefsharp/98 | 4758 | 2019* | 4.5.2** | Unsupported |
cefsharp/97 | 4692 | 2019* | 4.5.2** | Unsupported |
cefsharp/96 | 4664 | 2019* | 4.5.2** | Unsupported |
cefsharp/95 | 4638 | 2019* | 4.5.2** | Unsupported |
cefsharp/94 | 4606 | 2019* | 4.5.2** | Unsupported |
cefsharp/93 | 4577 | 2019* | 4.5.2** | Unsupported |
cefsharp/92 | 4515 | 2015* | 4.5.2** | Unsupported |
cefsharp/91 | 4472 | 2015* | 4.5.2** | Unsupported |
cefsharp/90 | 4430 | 2015* | 4.5.2** | Unsupported |
cefsharp/89 | 4389 | 2015* | 4.5.2** | Unsupported |
cefsharp/88 | 4324 | 2015* | 4.5.2** | Unsupported |
cefsharp/87 | 4280 | 2015* | 4.5.2** | Unsupported |
cefsharp/86 | 4240 | 2015 | 4.5.2 | Unsupported |
cefsharp/85 | 4183 | 2015 | 4.5.2 | Unsupported |
cefsharp/84 | 4147 | 2015 | 4.5.2 | Unsupported |
cefsharp/83 | 4103 | 2015 | 4.5.2 | Unsupported |
cefsharp/81 | 4044 | 2015 | 4.5.2 | Unsupported |
cefsharp/79 | 3945 | 2015 | 4.5.2 | Unsupported |
cefsharp/77 | 3865 | 2015 | 4.5.2 | Unsupported |
cefsharp/75 | 3770 | 2015 | 4.5.2 | Unsupported |
cefsharp/73 | 3683 | 2015 | 4.5.2 | Unsupported |
cefsharp/71 | 3578 | 2015 | 4.5.2 | Unsupported |
cefsharp/69 | 3497 | 2015 | 4.5.2 | Unsupported |
cefsharp/67 | 3396 | 2015 | 4.5.2 | Unsupported |
cefsharp/65 | 3325 | 2015 | 4.5.2 | Unsupported |
cefsharp/63 | 3239 | 2013 | 4.5.2 | Unsupported |
cefsharp/62 | 3202 | 2013 | 4.5.2 | Unsupported |
cefsharp/57 | 2987 | 2013 | 4.5.2 | Unsupported |
cefsharp/55 | 2883 | 2013 | 4.5.2 | Unsupported |
cefsharp/53 | 2785 | 2013 | 4.5.2 | Unsupported |
cefsharp/51 | 2704 | 2013 | 4.5.2 | Unsupported |
cefsharp/49 | 2623 | 2013 | 4.0 | Unsupported |
cefsharp/47 | 2526 | 2013 | 4.0 | Unsupported |
cefsharp/45 | 2454 | 2013 | 4.0 | Unsupported |
cefsharp/43 | 2357 | 2012 | 4.0 | Unsupported |
cefsharp/41 | 2272 | 2012 | 4.0 | Unsupported |
cefsharp/39 | 2171 | 2012 | 4.0 | Unsupported |
cefsharp/37 | 2062 | 2012 | 4.0 | Unsupported |
* VC++ 2019 is required starting with version 93<br/> ** For .Net Core Packages .Net Core 3.1/.Net 5.0 or greater is required.
Financial Support
Is your company making money thanks to CefSharp
? Do you rely on regular updates to the project? Alex Maitland needs your support! Signup to GitHub Sponsors.
One-Time or Recurring contributions can be made through GitHub Sponsors it only takes a GitHub account and a credit card. You can also make a One-Time contribution via PayPal.
As a stay at home dad I (@amaitland) rely on your contributions to help support my family.
Links
- CefGlue: An alternative .NET CEF wrapper built using P/Invoke.
- CEF GitHub Project : The official CEF issue tracker
- CEF Forum : The official CEF Forum
- CEF API Docs : Well worth a read if you are implementing a new feature
- CefSharp API Doc
Projects using CefSharp
- HtmlView : Visual Studio extension bringing CefSharp for showing HTML pages inside VS.
- SharpBrowser : The fastest web browser for C# with tabbed browsing and HTML5/CSS3.
- Chromely CefSharp : Build HTML Desktop Apps on .NET/.NET Core 3/.NET 5 using native GUI, HTML5/CSS.