# wolfmix-automation: reconstructing W1 project files and USB control

> wolfmix-automation reconstructs the Wolfmix W1 .wpj project format and USB control protocol from controlled editor changes, owned project files, and device observations. It publishes a byte-level specification and Python tools to inspect, diff, round-trip, compile, and generate project files, plus a USB client.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/Adridot/wolfmix-automation>
- Primary source: <https://github.com/Adridot/wolfmix-automation/blob/d1d77efaee649d257ddf6b3ede4821831984b7a6/README.md>
- Catalog page: <https://awesomerea.org/resources/wolfmix-automation-case/>
- Record JSON: <https://awesomerea.org/resources/wolfmix-automation-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/wolfmix-automation-case/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.10 or later; macOS or Linux is required for the USB device client.
- **Prerequisites:** Bring a .wpj project file of your own; USB operations additionally require a Wolfmix W1 Mk1 with WTOOLS closed.
- **Limits:** Fields without sufficient evidence are not writable, and the project describes itself as unfinished research.
- **License:** MIT License.

## Primary sources

1. <https://github.com/Adridot/wolfmix-automation/blob/d1d77efaee649d257ddf6b3ede4821831984b7a6/README.md>
2. <https://github.com/Adridot/wolfmix-automation/blob/d1d77efaee649d257ddf6b3ede4821831984b7a6/docs/methodology.md>
3. <https://github.com/Adridot/wolfmix-automation/blob/d1d77efaee649d257ddf6b3ede4821831984b7a6/LICENSE>

## More in Protocols

- [Mammotion RTK 3: reconstructing the mower's LoRa correction link](https://awesomerea.org/resources/mammotion-rtk-lora-case/index.md) · Case study
- [DingTalk A1 Local Toolkit: reconstructing BLE recording access](https://awesomerea.org/resources/dingtalk-a1-local-toolkit-case/index.md) · Case study
- [Remote for Apple TV: rebuilding Companion Link control on Android](https://awesomerea.org/resources/apple-tv-remote-android-case/index.md) · Case study
- [panelbeater: reconstructing ScanSnap iX1500 panel control](https://awesomerea.org/resources/panelbeater-case/index.md) · Case study
- [VT-Ragnaros: reconstructing Redragon SS552 USB control](https://awesomerea.org/resources/vt-ragnaros-case/index.md) · Case study
- [PixMob Wave2: reconstructing RF wristband commands for Flipper Zero](https://awesomerea.org/resources/pixmob-wave2-flipper-zero-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.