Skip to content
UInt2048 edited this page Oct 21, 2024 · 13 revisions

Welcome to the CyberKit wiki!

What is CyberKit?

As you may already know, iOS provides a system installation of WebKit in the operating system. However, an updated browser is pretty important, and due to Apple's OS optimizations on iOS, we've acted as if it's not possible to upgrade WebKit without updating iOS.

CyberKit is a drop-in replacement for WebKit, thanks to Apple open sourcing WebKit for all these years. Simply put, the project backports newer WebKit to make it function on older OS versions.

How is CyberKit distributed?

CyberKit is distributed as two test browsers, rather than attempting to replace the system implementation of WebKit.

  • MobileMiniBrowser is basically the most barebones browser you can imagine, made by WebKit for testing, with virtually zero features beyond CyberKit itself.
  • Fennec is a compiled version of the iOS Mozilla Firefox browser, altered to use CyberKit instead of WebKit.

What do I download?

There's a lot of files in the assets dropdown (you may need to click "Show all assets" to see them all).

  • Files beginning with "com.matthewbenedict.ios.fennec" are releases of Fennec.
  • Files beginning with "com.matthewbenedict.mobileminibrowser" are releases of MobileMiniBrowser.
  • For DEB files, the next character will be + or -. + indicates rootful releases and - indicates rootless releases.
  • After that, the number is the major iOS version it was built for. You should install the one that matches yours.
  • The remaining characters are version information.

If you're jailbroken, you might install through the repo: https://uint2048.github.io/

Why is there no Fennec release available?

The Fennec release for v0.0.9 alpha was deferred due to the then-upcoming implementation of #30. Fennec releases were provided in successive nightly builds as a result.

If CyberKit has reached alpha support for an iOS version and the CyberKit version is v0.0.6 alpha or later, a Fennec release exists.

Fennec releases will expose even more bugs of CyberKit than the barebones MobileMiniBrowser. It would make no sense to even try to work on these minor things when they can't really be tested until alpha support.

If you think this inconveniences you, CyberKit isn't ready for you to install yet anyways.

Nightly builds may or may not have a Fennec release regardless of whether the release does, for my convenience.

I'm installing a version before 0.0.9 alpha. Why doesn't it work?

Versions of CyberKit before 0.0.9 alpha additionally have to do legacy jetsam configuration before installing.

There's a separate wiki page on this here. Feel free to use the automatic method.

What iOS versions are supported?

Some values are extrapolated from reports or presumed, rather than directly observed. Please report if this table is erroneous in any way.

The meaning of symbols within are explained below the table.

iOS 10 iOS 11 iOS 12 iOS 13 iOS 14 iOS 15 iOS 16 iOS 17 iOS 18 Release Name
🥉 🥈 🥈 🥈 🥈 v0.0.9 alpha
🥉 🥈 🥈 🔴 🔴 v0.0.8 alpha
🔺 🔺 🥈 🔴 🔴 v0.0.7 alpha
🔺 🥈 🔴 🔴 v0.0.6 alpha
🔺 🥈 🔴 🔴 v0.0.5 alpha
🥈 🔴 🔴 v0.0.4 alpha
🥈 🔴 🔴 v0.0.3 alpha
🥈 🔴 🔴 v0.0.2 alpha
🥈 🔴 🔴 v0.0.1 alpha

Explanations

If you encounter something specific in a CyberKit build, even if it matches this chart, and you neither see it in the open issues nor a known issue for the release in question, please report the issue regardless.

Legacy jetsam configuration is considered part of installation for builds that require it.

Symbol Definition
🥇 Beta support (relatively inconsequential bugs may exist, but it can be used as a primary browser)
🥈 Alpha support (somewhat significant bugs impact usability, but it can visit sites)
🥉 Pre-alpha support (significant bugs prevent visiting most sites, but it has been observed to display a specific webpage)
Untested (behavior unknown, CyberKit is presumed to fail)
🔺 Not supported (installation always succeeds, but CyberKit always fails)
🔴 Not supported (installation conditionally succeeds, but CyberKit always fails)
🔻 Not supported (installation exists, but never succeeds)
No attempt to support (no installation exists)
+ Rootful
- Rootless

This table only applies if you are jailbroken or have TrollStore.

Please note that iOS and iPadOS are considered equivalent in CyberKit.

wen eta

CyberKit is an entirely free and open source project worked on in my spare time, and is not funded at all to support its development. It's not required that you respect this, but all questions asking for an ETA for a higher level of support will be directed here to get the answer "s0n".