Python CLI Tool

SidecarPatcher

Prototype experimental de reactivation de Sidecar sur Mac et iPad non supportes.

Get Started View on GitHub

218 Lines of Python

stdlib only

0 Dependencies

zero pip install

5 CLI Options

argparse flags

Project Evolution

v1.0.0 Initial Release

Automated signature scanning, flexible offsets, backup safety, NOP padding.

v0.0.1-alpha Research Phase

Binary extraction, Hopper analysis, first manual patch.

Features

Signature Scanning

Automatically locates the compatibility check function in SidecarCore via binary pattern matching.

Flexible Offsets

Supports automatic detection or manual override via --force-offset (decimal or hex).

Backup Safety

Creates automatic .bak backups before overwriting the original binary.

NOP Padding

Configurable NOP instruction padding with --nop-count for binary alignment.

Quick Start

Clone, patch, run. Zero dependencies.

Setup & Patch

git clone https://github.com/Sofian-bll/SidecarPatcher.git
cd SidecarPatcher
Auto-detect & patch
python3 sidecar_patcher.py SidecarCore

Advanced Usage

Manual offset
python3 sidecar_patcher.py SidecarCore --force-offset 0x3A2C
Custom output & padding
python3 sidecar_patcher.py SidecarCore -o /tmp/out --nop-count 5
Skip auto-backup
python3 sidecar_patcher.py SidecarCore --no-backup

Architecture

Project structure at a glance.

project-architecture

SidecarPatcher/
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.en.md
├── README.md
├── assets/
│ └── logo.svg
├── docs/
│ ├── COMMANDES.md
│ ├── INSTALLATION.md
│ ├── RECHERCHE.md
│ └── assets/
└── sidecar_patcher.py