Skip to content

Releases: OnlineFix/Pearipherals

Pearipherals v1.2.1 — UNSIGNED prerelease

Choose a tag to compare

@OnlineFix OnlineFix released this 12 Sep 23:58
e33fa77

Warning

UNSIGNED PRERELEASE — NOT AN OFFICIAL SIGNED RELEASE

Pearipherals-1.2.1-unsigned.exe has no Authenticode signature. Windows cannot verify its publisher identity. SmartScreen may warn and Smart App Control may block it (without a per-app bypass). Do not disable system-wide Windows security protections to run it. Trusted signing is not currently available; this prerelease is for voluntary evaluation, not a verified-publisher claim.

What's new

  • Separate keyboard/trackpad low-battery notifications at 20% or below, one critical escalation at 5% or below, and rearming after a fresh 25% or above reading. Fresh low readings after launch warn too; simultaneous warnings are combined. Charging reports suppress alerts, and stale/missing/invalid readings do not become false 0% alerts.
  • Hardened input cleanup, plus minimize/restore fixes preserving window stacking order and the original foreground window.
  • Since 1.2.0: F6 opens Windows Snipping Tool selection (modifier+F6 passes through), About/status and build identity, privacy-limited optional diagnostics, and Prepare for removal with explicit recovery results.

Source and verification

  • Source/tag: e33fa77be0670b4512bb6f65cc2cf66574704111, v1.2.1-unsigned.
  • Merged PR #5; PR CI and main CI passed.
  • Fresh hosted build #34726613112: Windows Server 2022 runner, Python 3.11.9, PyInstaller 6.21.0, hash-locked dependencies without cache. 317 tests passed, byte compilation passed. Dispatched with submit_for_signing=false; all signing/submission steps skipped.
  • Downloaded artifact's embedded manifest matches the exact source SHA and version 1.2.1. Required application modules and Windows tray backend are present in the frozen archive.
  • x64 PE32+ Windows GUI; product Pearipherals, product/file version 1.2.1, original filename metadata Pearipherals.exe.
  • Authenticode NotSigned, no signer/timestamp certificate, empty PE certificate table.
  • Microsoft Defender custom scan completed with no matching threat detections (definitions 1.459.178.0). A clean scan is not a guarantee of safety.
  • EXE: 19,493,771 bytes. SHA-256:
4eceba42bbd4d6b248f0b3833fdf25918707ea26cf07ec7197b2b5e388f369de  Pearipherals-1.2.1-unsigned.exe

SHA-256 detects mismatch/corruption only. It does not authenticate the publisher, establish safety, or substitute for a digital signature. The checksum and unsigned warning are also attached as plain text.

Testing limitations

The maintainer accepted both battery labels, minimize/restore with foreground preservation, left/right Task View, F6/Shift+F6 and function keys on the local candidate from the same source tree; pointer movement and scrolling were accepted earlier. Synthetic native battery notification visibility was confirmed. Real low-battery transitions, hardware sleep/wake behavior, and exhaustive Apply/Restore were not explicitly tested. This fresh hosted binary was inspected and scanned but was not launched or separately hardware-tested. Windows notification settings, Do Not Disturb, Explorer, sleeping devices, and stale readings may prevent warnings. No guarantee is made that a warning arrives before a device dies.

Install and update safely

  1. Requires Windows 10/11 x64 and supported Apple Bluetooth hardware. For Magic Trackpad pointer movement/two-finger scrolling, use the free signed mac-precision-touchpad driver; no driver is bundled here.
  2. Read the unsigned warning before downloading. Verify the EXE with PowerShell: Get-FileHash .\Pearipherals-1.2.1-unsigned.exe -Algorithm SHA256 and compare the full hash above. If security policy blocks it, do not weaken protections to proceed.
  3. Before updating, back up the existing EXE and its adjacent pearipherals.json, retaining the original touchpad-setting backup stored there. Keep backups private. Quit the old instance from its tray before replacing files; do not overwrite configuration with an empty/default file.
  4. Place the new EXE in a user-controlled persistent directory, such as C:\Tools\Pearipherals, alongside your existing configuration when updating. Launch only when ready: first launch can enable autostart and apply touchpad settings, with a notification explaining changes. Run once from the final location to update the autostart path. This release publication does not update or stop any installed app automatically.
  5. Use About/status to confirm version/build identity. Keep the previous EXE/configuration backup until satisfied. To roll back, quit the new instance and restore the previous EXE and matching saved configuration; do not discard original settings backups.

Removal

Choose Prepare for removal…, confirm, and inspect every result. It disables custom input features, removes startup entries, and restores backed-up Windows touchpad settings; partial recovery is not success. Alternatively disable Start with Windows, set gestures Off, and use Touchpad settings → Restore original Windows settings. Resolve any reported restoration failure before deleting backups. Then choose Quit, delete the EXE (including its versioned unsigned filename) and adjacent runtime files you no longer need: pearipherals.json, pearipherals.err.log, and pearipherals-diagnostics.json. The separately installed trackpad driver is not removed by deleting Pearipherals.

Documentation · Privacy · Signing policy. No account, telemetry, or automatic uploads. Pearipherals is not affiliated with Apple Inc.

Pearipherals v1.2.0 — UNSIGNED prerelease

Choose a tag to compare

@OnlineFix OnlineFix released this 19 Aug 19:55

Warning

UNSIGNED PRERELEASE — NOT AN OFFICIAL SIGNED RELEASE

Pearipherals-1.2.0-unsigned.exe has no Authenticode signature. Windows cannot verify its publisher identity. Microsoft Defender SmartScreen may warn, and Smart App Control may block it; Smart App Control has no per-app bypass. Do not disable system-wide Windows security protections to run this build.

Download

Download Pearipherals-1.2.0-unsigned.exe below. The separately attached warning and SHA-256 file repeat the trust status and expected checksum.

This prerelease exists so people can use and evaluate the current open-source version while Pearipherals establishes the public adoption required to reapply for free trusted signing.

Source and build provenance

  • Source commit: 25c8dc465a502bd842313507eb1a4fe7e70616a5
  • Tag: v1.2.0-unsigned (must resolve to the source commit above)
  • GitHub Actions run: Build and sign Windows release #32294606204
  • Runner: GitHub-hosted windows-2022
  • Build environment: Python 3.11.9, PyInstaller 6.21.0, complete hash-locked dependencies, no dependency cache
  • Signing steps: deliberately skipped because submit_for_signing=false; no SignPath credential or signature was used

Verification

  • Complete automated suite: 83 tests passed
  • Python byte compilation: passed
  • PE format: x64 PE32+ Windows GUI executable
  • Product name: Pearipherals
  • Product version / file version: 1.2.0
  • Original filename metadata: Pearipherals.exe
  • Get-AuthenticodeSignature: NotSigned
  • PE certificate table: empty (VirtualAddress=0, Size=0)
  • Microsoft Defender custom scan on the downloaded artifact: no threats found
  • Published EXE size: 19,425,000 bytes
  • SHA-256:
253cd57c0c66c8e7673e372b27df91ecdca1e3605541ea4a2497041b74e259cd  Pearipherals-1.2.0-unsigned.exe

The checksum detects a file mismatch or corruption only. It does not authenticate the publisher, establish that the executable is safe, or substitute for a digital signature. A clean antivirus scan is also not a guarantee of safety.

What changed since v1.1

  • Separate Magic Keyboard and Magic Trackpad battery levels in the tray
  • Safer battery polling and sleep/wake recovery
  • Hardened keyboard-hook, pointer-suppression, shutdown, and retry behavior
  • More reliable three-finger gesture tracking across contact churn, lifts, disconnects, and stale reports
  • Fixed padding contact ID 65535 falsely turning two-finger scrolling into a three-finger gesture
  • Safer, durable backup and restoration of Windows touchpad settings
  • Corrupt-configuration preservation and recovery handling
  • Windows product/version metadata and a verified release-build pipeline

The v1.2.0 feature set and the two-finger padding-contact fix have been physically accepted on the maintainer's Windows 11 setup. This downloadable artifact was rebuilt from the exact source commit above by GitHub Actions and passed the automated gates listed here.

Requirements

  • Windows 10 or Windows 11
  • Apple Magic Keyboard and/or Magic Trackpad 2 over Bluetooth
  • For Magic Trackpad pointer movement and two-finger scrolling: the free, signed mac-precision-touchpad driver

Signing status

Pearipherals applied to SignPath Foundation for free open-source signing. The application was not accepted because the project is new and does not yet have enough established public usage. This was an adoption/reputation decision, not a malware finding. The project plans to reapply after more people use it.

See the code signing policy, privacy policy, and uninstall instructions.

Pearipherals is not affiliated with Apple Inc.

Pearipherals v1.1 — Apple Magic Keyboard and Magic Trackpad 2 for Windows

Choose a tag to compare

@OnlineFix OnlineFix released this 28 Jul 00:27

Pearipherals is a free, open-source Windows tray app for Apple Magic Keyboard and Magic Trackpad 2.

Important Windows trust notice

The v1.1 Pearipherals.exe below is unsigned. Windows may show an unknown or untrusted publisher warning, Microsoft Defender SmartScreen may warn about it, and Smart App Control may block it. Smart App Control has no per-app Run anyway exception. Do not disable a system-wide Windows security feature just to run this unsigned build.

This is a publisher-identity and software-reputation limitation, not by itself a malware verdict. The complete source is public for inspection and local builds.

Pearipherals applied for free open-source signing through SignPath Foundation. The application was not accepted because the project is still new and does not yet have enough established public usage. We plan to apply again as the user base grows.

Read the Code signing policy, privacy policy, and uninstall instructions.

What v1.1 provides

  • "Tragic" Keyboard: Mac-style Apple Magic Keyboard function keys on Windows
  • "Tragic" Trackpad: three-finger Magic Trackpad 2 gestures and natural-scrolling control
  • "Moodio" Display: brightness keys for Apple Studio Display and other monitors
  • One portable EXE with local configuration and no account or telemetry

Magic Trackpad pointer movement and two-finger scrolling require the free, signed mac-precision-touchpad driver. Keyboard features do not require that driver.

Newer source improvements are available on the main branch. This release asset remains the original unsigned v1.1 build and is labeled accordingly.

Requires Windows 10/11. MIT licensed.

Pearipherals is not affiliated with Apple Inc.