# brandonlw/psychson

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/brandonlw-psychson).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

4,178 stars · 1,245 forks · C# · MIT

## Links

- GitHub: https://github.com/brandonlw/Psychson
- awesome-repositories: https://awesome-repositories.com/repository/brandonlw-psychson.md

## Description

Psychson is a toolset for modifying USB firmware binaries and flashing custom images to specific hardware controller architectures. It provides utilities for dumping, patching, and flashing custom firmware specifically for Phison 2251-03 USB controllers.

The software includes a payload injector for embedding HID keystroke scripts into USB firmware to automate inputs on a target machine. It also features a controller flasher for writing modified burner images directly to Phison-based USB hardware.

The suite covers firmware management and hardware forensic analysis, including capabilities for extracting metadata addresses and patching binary images to implement hidden partitions, password protection, or boot mode restrictions.

## Tags

### Hardware & IoT

- [Phison Controller Programming](https://awesome-repositories.com/f/hardware-iot/phison-controller-programming.md) — Provides a specialized toolset for extracting and flashing firmware specifically for Phison 2251-03 USB controllers.
- [Firmware Flashing](https://awesome-repositories.com/f/hardware-iot/connectivity-iot/hardware-communication/serial-device-communication/firmware-flashing.md) — Communicates via low-level protocols to transfer and write compiled binaries to the USB controller memory.
- [Embedded System Flashers](https://awesome-repositories.com/f/hardware-iot/embedded-robotics/embedded-system-flashers.md) — Provides a software interface for writing modified burner images to Phison-based USB hardware.
- [BadUSB Payloads](https://awesome-repositories.com/f/hardware-iot/badusb-payloads.md) — Integrates automated keystroke sequences into USB firmware to emulate keyboard inputs on target computers.
- [Firmware Image Parsers](https://awesome-repositories.com/f/hardware-iot/firmware-management/firmware-image-extractors/firmware-image-parsers.md) — Parses firmware images to retrieve specific addresses and equates needed for precise patching. ([source](https://github.com/brandonlw/psychson#readme))
- [Keyboard Payloads](https://awesome-repositories.com/f/hardware-iot/hid-emulations/keyboard-payloads.md) — Bakes formatted key scripts into custom firmware to execute automated keystroke sequences. ([source](https://github.com/brandonlw/psychson#readme))
- [USB Hardware Forensic Analysis](https://awesome-repositories.com/f/hardware-iot/usb-hardware-forensic-analysis.md) — Enables dumping and analyzing firmware images from USB devices to identify specific memory addresses and metadata.

### Mobile Development

- [Firmware Injection](https://awesome-repositories.com/f/mobile-development/mobile-operating-systems/firmware-customization-tools/custom-firmware-integration-systems/binary-only-firmware-modules/firmware-injection.md) — Writes modified binary images directly to the controller to replace the existing hardware operating system.

### Operating Systems & Systems Programming

- [Firmware Patching](https://awesome-repositories.com/f/operating-systems-systems-programming/custom-firmware-tools/firmware-patching.md) — Applies patches to USB device binaries to implement hidden partitions and boot mode restrictions.
- [USB Firmware Toolsets](https://awesome-repositories.com/f/operating-systems-systems-programming/custom-firmware-tools/firmware-patching/usb-firmware-toolsets.md) — Provides a comprehensive toolset for dumping, patching, and flashing custom firmware on Phison 2251-03 controllers.
- [Firmware Dumping Utilities](https://awesome-repositories.com/f/operating-systems-systems-programming/ios-firmware-analysis/firmware-dumping-utilities.md) — Extracts the current firmware image from a compatible USB drive to a local file. ([source](https://github.com/brandonlw/psychson#readme))
- [Metadata Extraction](https://awesome-repositories.com/f/operating-systems-systems-programming/binary-memory-mapping/metadata-extraction.md) — Extracts specific internal addresses and offsets from binary images to identify targets for firmware modification.

### Software Engineering & Architecture

- [Binary Patching Utilities](https://awesome-repositories.com/f/software-engineering-architecture/binary-patching-utilities.md) — Provides utilities to modify compiled firmware binaries to alter hardware behavior and security restrictions.