kolbicz GitHub avatar

SBTweaker

kolbicz

SBTweaker 是一个针对 iOS 17.0–17.3.1 Relaxin 越狱的 SpringBoard 插件合集，通过设置偏好面板提供可配置的 Dock、主屏幕网格、间距、图标缩放、动画控制等功能。

Stars

7

7 天增长

暂无数据

Fork 数

1

开放 Issue

0

开源协议

MIT

最近更新

2026-07-29

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它以现代的进程内 substrate 钩子重新实现了一个流行插件集，适用于最新的可越狱 iOS 版本，提供统一的 MIT 许可包，并支持动画开关即时生效。

适合谁使用

  • iOS 17.0–17.3.1 (Relaxin) 越狱用户
  • 希望自定义 SpringBoard 的插件爱好者
  • 寻找清晰 substrate 钩子实现参考的开发者

典型使用场景

  • 调整 Dock 图标数量 (4–7) 并在重启后保持
  • 自定义主屏幕网格列/行数和图标间距
  • 独立缩放主屏幕和 Dock 图标
  • 禁用唤醒/睡眠动画以及锁屏或主屏幕上的双击锁屏功能

项目优势

  • 将多种流行插件整合为一个包，统一设置面板
  • 动画开关无需重启即可生效
  • 包含 Respring 按钮方便其他设置生效
  • 开源 (MIT) 并基于 roothide theos 分支构建，适配现代越狱

使用前须知

  • 仅兼容 iOS 17.0–17.3.1 的 Relaxin 越狱
  • 大部分更改需要 Respring
  • 不支持旧版 iOS 或其他越狱工具

README 快速开始

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.