Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
cbc4c95
fix: Implement CefKeyEvent for direct keyboard event injection
trethore Feb 8, 2026
c576360
feat: Add direct mouse and mouse wheel event injection support
trethore Feb 9, 2026
9f8d306
feat: Add CefPoint and CefRect classes; enhance CefBrowser and CefRen…
trethore Feb 11, 2026
36f2966
fix: Prevent deadlock during native initialization on macOS
trethore Feb 17, 2026
f812cbd
feat: removed unused dependencies. (#2)
trethore Feb 26, 2026
a1d834e
feat: accelerated paint (#3)
trethore Mar 21, 2026
ff780a6
fix: Add missing preprocessor directive for Linux in render_handler.cpp
trethore Mar 21, 2026
e97317b
feat: update Java version to 17 and adjust compilation scripts accord…
trethore Mar 22, 2026
e994315
refactor: replace deprecated Boolean constructor with valueOf method
trethore Mar 22, 2026
c5c0137
fix: marshal async beforeunload JS dialog callbacks onto CEF UI threa…
trethore Mar 26, 2026
3018e20
fix: update CefPostTask to use CefCreateClosureTask for UI thread con…
trethore Mar 26, 2026
ceeefbe
fix: handle off-screen browsers correctly in AddCefBrowser function
trethore Apr 8, 2026
106a3ae
Update to CEF 146.0.10+g8219561+chromium-146.0.7680.179 (#531) (#7)
trethore Apr 13, 2026
65f9d7b
Merge branch 'chromiumembedded:master' into master
trethore Apr 13, 2026
7b073d0
Merge upstream chromiumembedded/java-cef (excluding CLAUDE.md)
trethore Jul 10, 2026
e40503b
docs: modernize fork documentation
trethore Jul 10, 2026
c8468ae
feat: validation
trethore Jul 10, 2026
3bb487f
fix: avoid double-deleting CefScreenInfo JNI local reference
trethore Jul 12, 2026
d479119
fix: remove redundant focus setting in CefClient
trethore Jul 12, 2026
2a4137b
fix: expose popup navigation metadata
trethore Jul 15, 2026
5855f3c
feat: expose custom context menu callback
trethore Jul 17, 2026
2f8354b
fix: preserve persistent query callbacks
trethore Aug 11, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Normalize text files by default.
* text=auto

# Keep LF endings for source files and Unix scripts.
*.sh text eol=lf
*.py text eol=lf
*.java text eol=lf
*.c text eol=lf
*.cc text eol=lf
*.cpp text eol=lf
*.h text eol=lf
*.hpp text eol=lf
*.m text eol=lf
*.mm text eol=lf
*.cmake text eol=lf
CMakeLists.txt text eol=lf
*.xml text eol=lf
*.md text eol=lf
*.txt text eol=lf
*.yml text eol=lf
*.yaml text eol=lf

# Keep CRLF endings for Windows scripts.
*.bat text eol=crlf
*.cmd text eol=crlf

# Treat bundled artifacts as binary.
*.jar binary
*.png binary
*.jpg binary
*.jpeg binary
*.gif binary
*.ico binary
*.icns binary
*.dll binary
*.so binary
*.dylib binary
*.exe binary
*.dat binary
*.bin binary
*.pak binary
37 changes: 37 additions & 0 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
name: validate

on:
push:
pull_request:

permissions:
contents: read

jobs:
source:
runs-on: ubuntu-latest
steps:
- name: Check out source
uses: actions/checkout@v6
with:
fetch-depth: 2

- name: Set up Python
uses: actions/setup-python@v6
with:
python-version: "3.12"

- name: Check Python syntax
run: python -m py_compile tools/*.py tools/dev/*.py

- name: Check Ant project syntax
run: python -c "import xml.etree.ElementTree as ET; ET.parse('build.xml')"

- name: Check shell syntax
run: git ls-files -z '*.sh' | xargs -0 -r -n1 bash -n

- name: Check Markdown links
run: python tools/dev/check_markdown_links.py

- name: Check whitespace
run: git diff --check HEAD^ HEAD
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,7 @@ Thumbs.db
# JCEF generated files
/native/jcef_version.h
# CEF downloads
references/
/third_party/cef/cef_binary_*
# clang-format downloads
/tools/buildtools/external_bin
Expand Down
3 changes: 3 additions & 0 deletions .ignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
!references/
!references/**
!references/cef/**
81 changes: 0 additions & 81 deletions CLAUDE.md

This file was deleted.

2 changes: 1 addition & 1 deletion CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -203,7 +203,7 @@ message(STATUS "Using Python: ${PYTHON_EXECUTABLE}")
#

# Minimum required Java version.
set(JDK_MIN_VERSION 1.7)
set(JDK_MIN_VERSION 17)

set(JAVA_FATAL_ERROR "A Java installation is required. Set the JAVA_HOME "
"environment variable to explicitly specify the Java "
Expand Down
121 changes: 66 additions & 55 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,55 +1,66 @@
The Java Chromium Embedded Framework (JCEF) is a simple framework for embedding Chromium-based browsers in other applications using the Java programming language.

# Quick Links

* Building JCEF - https://chromiumembedded.github.io/java-cef/branches_and_building
* Support Forum - http://magpcss.org/ceforum/viewforum.php?f=17
* Issue Tracker - https://github.com/chromiumembedded/java-cef/issues
* Downloads - https://github.com/jcefmaven/jcefbuild
* Maven/Gradle Artifacts - https://github.com/jcefmaven/jcefmaven
* Donations - https://github.com/sponsors/magreenblatt

# Introduction

CEF is a BSD-licensed open source project founded by Marshall Greenblatt in 2008 and based on the [Google Chromium](http://www.chromium.org/Home) project. Unlike the Chromium project itself, which focuses mainly on Google Chrome application development, CEF focuses on facilitating embedded browser use cases in third-party applications. CEF insulates the user from the underlying Chromium and Blink code complexity by offering production-quality stable APIs, release branches tracking specific Chromium releases, and binary distributions. Most features in CEF have default implementations that provide rich functionality while requiring little or no integration work from the user. There are currently over 100 million installed instances of CEF around the world embedded in products from a wide range of companies and industries. A partial list of companies and products using CEF is available on the [CEF Wikipedia page](http://en.wikipedia.org/wiki/Chromium_Embedded_Framework#Applications_using_CEF). Some use cases for CEF include:

* Embedding an HTML5-compliant Web browser control in an existing native application.
* Creating a light-weight native “shell” application that hosts a user interface developed primarily using Web technologies.
* Rendering Web content “off-screen” in applications that have their own custom drawing frameworks.
* Acting as a host for automated testing of existing Web properties and applications.

CEF supports a wide range of programming languages and operating systems and can be easily integrated into both new and existing applications. It was designed from the ground up with both performance and ease of use in mind. The base framework includes C and C++ programming interfaces exposed via native libraries that insulate the host application from Chromium and Blink implementation details. It provides close integration between the browser and the host application including support for custom plugins, protocols, JavaScript objects and JavaScript extensions. The host application can optionally control resource loading, navigation, context menus, printing and more, while taking advantage of the same performance and HTML5 technologies available in the Google Chrome Web browser.

This project provides a Java Wrapper for CEF (JCEF).

# Building JCEF

The JCEF project is an extension of the Chromium Embedded Framework (CEF) project hosted at https://github.com/chromiumembedded/cef. JCEF maintains a development branch that tracks the most recent CEF3 release branch. JCEF source code can be downloaded, built and packaged into a binary distribution. Once you have created the binary distribution for your platform you can distribute it as a stand-alone package without further dependencies on the JCEF, CEF or Chromium source code. Visit the [Branches and Building](https://chromiumembedded.github.io/java-cef/branches_and_building) page for detailed instructions.

# Helping Out

JCEF is still very much a work in progress. Some ways that you can help out:

\- Vote for issues in the [JCEF issue tracker](https://github.com/chromiumembedded/java-cef/issues) that are important to you. This helps with development prioritization.

\- Report any bugs that you find or feature requests that are important to you. Make sure to first search for existing issues before creating new ones. Please use the [JCEF Forum](http://magpcss.org/ceforum/viewforum.php?f=17) and not the issue tracker for usage questions. Each JCEF issue should:

* Include the JCEF revision, CEF revision or binary distribution version.
* Include information about your OS and compiler version.
* If the issue is a bug please provide detailed reproduction information.
* If the issue is a feature please describe why the feature is beneficial.

\- Write unit tests for new or existing functionality.

\- Pull requests and patches are welcome. View open issues in the [JCEF issue tracker](https://github.com/chromiumembedded/java-cef/issues) or search for TODO(cef) in the source code for ideas.

If you would like to contribute source code changes to JCEF please follow the below guidelines:

\- Create or find an appropriate issue for each distinct bug, feature or change.

\- Submit a [pull request](https://chromiumembedded.github.io/java-cef/contributing_with_git) or create a patch with your changes and attach it to the JCEF issue. Changes should:

* Be submitted against the current [JCEF master branch](https://github.com/chromiumembedded/java-cef/tree/master) unless explicitly fixing a bug in a CEF release branch.
* Follow the style of existing JCEF source files. In general JCEF uses the [Chromium coding style](http://www.chromium.org/developers/coding-style).
* Include new or modified unit tests as appropriate to the functionality.
* Not include unnecessary or unrelated changes.
# JCEF

This repository is a fork of the [Java Chromium Embedded
Framework (JCEF)](https://github.com/chromiumembedded/java-cef).

This fork exists to maintain a small set of patches (Java 17+, game-specific
APIs). Its original motivation is to integrate an embedded Chromium browser
into Minecraft Java.

## What about the upstream?

1. Upstream JCEF changes are merged regularly.
2. Fork-specific patches are kept small and isolated where practical.
3. The upstream `java/`, `native/`, `tools/`, and build layouts are preserved to
reduce merge conflicts.
4. Fixes that are useful to the wider JCEF project should still be proposed
upstream when appropriate.

See [Fork policy](docs/explanation/fork-policy.md) and [Synchronize with
upstream JCEF](docs/how-to/sync-upstream.md) for more information.

## Supported environments

| Environment | Supported versions and architectures |
| --- | --- |
| Java | 17 or newer |
| Linux | x64 and ARM64 |
| Windows | x64 and ARM64 |
| macOS | x64 and ARM64 |

## Project repositories

| Repository | Responsibility |
| --- | --- |
| [`trethore/jcef`](https://github.com/trethore/jcef) | Upstream JCEF source plus fork patches |
| [`trethore/jcefbuild`](https://github.com/trethore/jcefbuild) | Multi-platform native builds and binary distributions |
| [`trethore/jcefgithub`](https://github.com/trethore/jcefgithub) | Maven artifacts, GitHub Packages, Maven Central, and runtime native loading |

For normal Maven or Gradle use, see `trethore/jcefgithub`. This repository
primarily acts as patched source code for my experiments with JCEF.

## Building

JCEF combines Java, JNI, C++, CEF binary distributions, and platform-specific
toolchains. See [Your first local JCEF build](docs/tutorials/first-local-build.md)
for a guided introduction or [Build JCEF](docs/how-to/build-jcef.md) for the
command reference.
Reproducible release builds are produced by `trethore/jcefbuild`.

## Documentation

Documentation starts [HERE](docs/README.md)!

## Support and issue routing

Please respect this routing to avoid annoying the wrong people!

- Fork source patches and Minecraft-related integration requirements -> this repository
- Native build and CI failures -> [`trethore/jcefbuild`](https://github.com/trethore/jcefbuild/issues)
- Maven artifacts and runtime native loading -> [`trethore/jcefgithub`](https://github.com/trethore/jcefgithub/issues)
- General JCEF defects -> [upstream JCEF issue tracker](https://github.com/chromiumembedded/java-cef/issues)
- JCEF and CEF usage questions -> [CEF Forum](https://magpcss.org/ceforum/viewforum.php?f=17)

## License

JCEF is distributed under the BSD-style license in [LICENSE.txt](LICENSE.txt).
54 changes: 0 additions & 54 deletions appveyor.yml

This file was deleted.

Loading