SBTweaker is a single-package collection of SpringBoard tweaks for iOS 17.0–17.3.1 on the Relaxin jailbreak, offering configurable dock, home screen grid, spacing, icon scale, animation controls, and more via a Settings preference bundle.

Stars

7

7-day growth

No data

Forks

2

Open issues

0

License

MIT

Last updated

2026-07-29

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It reimplements a popular tweak set as modern in-process substrate hooks for the latest jailbreakable iOS version, providing a unified, MIT-licensed package with immediate animation toggles.

Who it is for

  • Jailbreak users on iOS 17.0–17.3.1 (Relaxin)
  • Tweak enthusiasts wanting customizable SpringBoard
  • Developers looking for a clean substrate hook implementation reference

Use cases

  • Adjust dock icon count (4–7) and preserve them across resprings
  • Customize home screen grid columns/rows and icon spacing
  • Scale home screen and dock icons independently
  • Disable wake/sleep animations and double-tap-to-lock on lock or home screen

Strengths

  • Bundles many popular tweaks into one package with a single preference pane
  • Animation switches apply immediately without respring
  • Respring button included for other settings
  • Open-source (MIT) and built on the roothide theos fork for modern jailbreaks

Considerations

  • Only compatible with Relaxin jailbreak on iOS 17.0–17.3.1
  • Most changes require a respring
  • No support for older iOS versions or other jailbreaks

README quick start

SBTweaker

A collection of SpringBoard tweaks in a single package, with a preference bundle. These are reimplementations of my DarkSword Tweaks for the Relaxin jailbreak (iOS 17.0 – 17.3.1), converted from out-of-process RemoteCall code to classic in-process substrate hooks.

Features

  • Dock: configurable icon count (4–7), plus optional restore of extra dock icons across resprings and icon-state validation
  • Home Screen grid: configurable columns (3–7) and rows (4–8)
  • Spacing: extra layout insets for the Home Screen (L/R/T/B) and dock
  • Icon scale: separate scaling for Home Screen and dock icons
  • Hide App Library: removes the App Library page
  • Double Tap to Lock: separate switches for Home Screen and Lock Screen (ignores icons, folders, dock and the passcode pad)
  • Animations:
    • Drag Coefficient slider (UIAnimationDragCoefficient, 0.01–2.00, default 0.25; 1.0 = stock, leaves the system value untouched)
    • Disable Wake Animation (screen on)
    • Disable Screen Off Fade (screen off)
    • Disable Unlock Icon Fly-In

All settings live in Settings → SBTweaker. Changes take effect after a respring (a respring button is included); the animation switches apply immediately.

Building

Requires the roothide theos fork installed at ~/theos-roothide (adjust the THEOS export in the Makefile otherwise) and an iOS 16.5 SDK. The Makefile already sets THEOS_PACKAGE_SCHEME=roothide.

make package FINALPACKAGE=1

The resulting .deb lands in packages/.

Credits

  • DarkSword Tweaks — my tweak collection, implemented by cyanide; this package reimplements them as in-process substrate hooks.
  • SBCustomizer (from cyanide) — used as the starting point for this project.
  • Speedster — reference for the wake/sleep animation settings (backlightFadeDuration vs. speedMultiplierForWake mapping).

License

MIT — see LICENSE. Fork, modify and recompile as you like.