nfswebview is a high-performance, hardware-accelerated, GPU-to-GPU Android WebView rendering layer specifically engineered for the Kivy framework. By bypassing standard off-screen bitmap blitting, it directly hooks the Android hardware compositor into Kivy’s OpenGL ES context via a specialized GL_TEXTURE_EXTERNAL_OES pipeline.
This library delivers native 60 FPS scrolling, full support for hardware-accelerated WebRTC (video/audio streams), HTML5 Geolocation, advanced input handling (touch event mapping), and complete compatibility up to Android 16 (API 36).
Note
NfsBrowser is a full fledged open source browser application build using NfsWebview.
Standard off-screen rendering techniques capture web contents via pixel arrays, causing massive CPU bottlenecks. nfswebview eliminates this overhead through direct GPU memory mapping:
- OpenGL OES Binding: The Python wrapper initializes an external OpenGL texture pointer (
GL_TEXTURE_EXTERNAL_OES) via Kivy's graphics engine. - Surface Association: This texture ID is passed through Pyjnius to instantiate a native Android
SurfaceTextureand underlying hardwareSurface. - Offscreen Composite Routing: The native Java controller (
NfsWebview) forces the WebView's hardware canvas to draw explicitly to our targetSurface. - Custom Shading: A specialized GLSL fragment shader samples the external OES surface texture directly into Kivy’s drawing canvas canvas matrix.
- Bidirectional Input Bridges: Touch vectors are captured inside Kivy, translated to native Android scales, and injected directly into the WebView's event dispatch loop.
- Direct Keyboard Mapping: Mapped to use android system keyboard directly on textinput focus.
Add nfswebview as a dependency in following ways with different toolchains.
uv add git+https://github.com/Novfensec/nfswbview@masterSince the project explicitly uses ksp-builder backend, all java files will be placed in a .java folder under site-packages and then parsed by ksproject in the resulting AGP for compilation.
- Copy the
javafolder as it is aside the buildozer.spec. - Edit the
buildozer.specto have the dependency and include the java files.
requirements = python3, kivy, ...other..., nfswebview # or https://github.com/Novfensec/nfswebview/archive/master.zip
android.add_src = ./javaImport the NfsWebviewWidget directly into your layout hierarchy just like any standard Kivy component.
from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from nfswebview import NfsWebviewWidget
class WebBrowserApp(App):
def build(self):
layout = BoxLayout(orientation='vertical')
self.webview = NfsWebviewWidget(url="https://github.com")
layout.add_widget(self.webview)
return layout
if __name__ == '__main__':
WebBrowserApp().run()This project is licensed under the MIT License - see the LICENSE file for details.