.NET (WPF and Windows Forms) bindings for the Chromium Embedded Framework
C# C++ HTML CSS PowerShell JavaScript
Clone or download
amaitland Revert "WPF - Capture mouse when left button down so scrollbar works …
…correctly outside of browser"

This reverts commit c843317.
Latest commit 0abf95b Aug 13, 2018
Permalink
Failed to load latest commit information.
.github Create config.yml Mar 22, 2018
CefSharp.BrowserSubprocess.Core Upgrade version numbers to 68.0.0 Aug 7, 2018
CefSharp.BrowserSubprocess Upgrade version numbers to 68.0.0 Aug 7, 2018
CefSharp.Core Untabify ClientAdapter.cpp Aug 7, 2018
CefSharp.Example DefaultResourceHandlerFactory - Rewrite so it stores byte[] instead o… Aug 13, 2018
CefSharp.OffScreen.Example Upgrade version numbers to 68.0.0 Aug 7, 2018
CefSharp.OffScreen WPF/OffScreen - OSR rendering now supports surface sync Aug 13, 2018
CefSharp.Test WinForms/Wpf/OffScreen - Create specific CefSettings class for each v… Aug 2, 2018
CefSharp.WinForms.Example Upgrade version numbers to 68.0.0 Aug 7, 2018
CefSharp.WinForms.Test 1.25.2 coming up. Jun 17, 2013
CefSharp.WinForms WinForms/Wpf/OffScreen - Create specific CefSettings class for each v… Aug 2, 2018
CefSharp.Wpf.Example Upgrade version numbers to 68.0.0 Aug 7, 2018
CefSharp.Wpf Revert "WPF - Capture mouse when left button down so scrollbar works … Aug 13, 2018
CefSharp DefaultResourceHandlerFactory - Rewrite so it stores byte[] instead o… Aug 13, 2018
NuGet Nuget - Revert back to the 63 package props/targets files Aug 12, 2018
old move current tests into old/ Feb 16, 2012
.gitattributes add *.vcproj to .gitattributes Mar 7, 2013
.gitignore Added DownloadItem .OriginalUrl (#1877) Dec 4, 2016
Build.bat Added build.bat script for slightly more convenient NuGet compiling Jan 7, 2015
CONTRIBUTING.md Update CONTRIBUTING.md Mar 23, 2018
CefSharp.Native.props Upgrade to CEF 3.3239.1700 Dec 19, 2017
CefSharp.props Default builds to using VS2015 Feb 5, 2018
CefSharp.shfbproj Sandcastle - Upgrade version number to 63.0.0 Feb 9, 2018
CefSharp.snk - BrowserControl now derived from Control. Dec 9, 2010
CefSharp3.ChildProcessDbgSettings VS2017 build support (using the VS2015 tooling) (#2179) Nov 29, 2017
CefSharp3.sln CefSharp3.sln - Remove .nuget folder from solution Mar 7, 2018
CefSharp3.sln.DotSettings Add new Resharper settings (upgraded to new version) May 21, 2015
ISSUE_TEMPLATE.md Update ISSUE_TEMPLATE.md Feb 2, 2018
LICENSE Updated copyright year and made sure it used same format everywhere (#… Mar 5, 2017
NuGet.config NuGet.config - Add appveyor cef-binary project feed Dec 29, 2017
README.WPF.md correction -> new CefSettings not new Settings Dec 12, 2014
README.md Update release branch in preparation for 67.0.0-pre01 Aug 7, 2018
afterbuild.example.ps1 add after build script example that shows how to automatically upload… Oct 14, 2014
appveyor.yml Upgrade version numbers to 68.0.0 Aug 7, 2018
build.ps1 Upgrade version numbers to 68.0.0 Aug 7, 2018
logo.png fix documentation links Dec 8, 2015

README.md

CefSharp Logo

Build status CefSharp.WinForms CefSharp.Wpf CefSharp.OffScreen

Got a quick question? Jump on Gitter

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.

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 FAQ #8.

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

If you have a simple question please start by asking it on Gitter. Please keep the Issue Tracker for Bugs only please! Before submitting a PR please read CONTRIBUTING

Stackoverflow as always is a useful resource, you can post your more complex issues here. The CefSharp Google Group is no longer active. It is however a useful resource for archived questions/answers.

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.

Note Due to so many Forks - Github can't process them through the Network Graphs Section so, if you need to do a search use the following: cefsharp fork:true and it will be able to process all of the forks.

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
Every commit on master produces a Nuget package. Use at your own risk!

  • MyGet Pre Release
  • MyGet Pre Release
  • MyGet Pre Release

Pre-release

  • CefSharp.WinForms
  • CefSharp.Wpf
  • CefSharp.OffScreen

Stable

  • CefSharp.WinForms
  • CefSharp.Wpf
  • CefSharp.OffScreen

Release Branches

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

Branch CEF Version VC++ Version .Net Version Status
master 3440 2015 4.5.2 Development
cefsharp/67 3396 2015 4.5.2 Pre-Release
cefsharp/65 3325 2015 4.5.2 Release
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

Financial Support

To continue developing/supporting the project I (@amaitland) am asking for financial contributions. Donations of any size are greatly appreciated!

67.0.0 Release: Bountysource

Recurring contributions can be made through BountySource Salt or contact me if you'd like to donate through Paypal.

Now that I (@amaitland) am a stay at home dad your contributions are the only reason I'm allowed to continue working on the project. Without continued funding the time I currently spend on the project will have to be put into finding other paid work.

Links

Projects using CefSharp

  • HtmlView : Visual Studio extension bringing CefSharp for showing HTML pages inside VS.
  • Chromely : Build .NET/.NET Core HTML5 desktop apps using cross-platform native GUI API.