Home

Project Phoenix User Guide

Project Phoenix keeps Vitruvian V-Form Trainer and Trainer+ machines usable with a community-built Android and iOS app. This wiki is written for app users and reflects the current public release, v0.9.1 - Stability, Diagnostics, and Integration Sync, published May 25, 2026.

Supported Devices

Machine	Typical BLE name	Status
Vitruvian V-Form Trainer	Vee_*	Supported
Vitruvian Trainer+	VIT*	Supported

You need a phone or tablet with Bluetooth Low Energy. Android users need Android 8.0 or newer. iPhone and iPad users need iOS or iPadOS 14.0 or newer.

Install

• Android: join the beta from the project site, or install the APK from the v0.9.1 release.
• iOS: use TestFlight, or sideload the IPA from the v0.9.1 release if you are comfortable with AltStore or Apple Developer tools.
• See Installation for permissions, update behavior, and sideloading notes.

Quick Start

1. Install the app and accept the required Bluetooth permissions.
2. Power on the trainer and stay close to it.
3. Open the app and connect to the trainer from the workout flow.
4. From the Workout tab, choose:
   • Just Lift for a quick unplanned set.
   • Single Exercise to pick one exercise and configure its mode, weight, and reps.
   • Routines to run a saved sequence of exercises.
   • Training Cycles to follow an active multi-day schedule.
5. After the set or workout, review the summary, tag Just Lift sets when prompted, and check Analytics for history, progress, and PRs.

See First-Workout for the first full workout flow.

What Is New In v0.9.1

• Launch Pad redesign for faster access to Just Lift, Single Exercise, Routines, Training Cycles, 1RM assessment, and recent activity replay.
• Echo and TUT stability fixes, including corrected Echo defaults and packet layout behavior.
• BLE diagnostics, machine fault decoding, connection logs, replay navigation, and diagnostic export text.
• Expanded Hevy, Liftosaur, Health, Phoenix Portal, and Strong-compatible CSV integration surfaces.
• Smart Insights and readiness fixes, richer history/PR analytics, and expanded regression coverage.
• Android cue-audio reliability, bodyweight volume fixes, routine auto-start fixes, and dynamic percent-of-PR routine weight fixes.

Main Guides

• Installation
• First-Workout
• Workout-Modes
• Routines-and-Supersets
• Training-Cycles
• Analytics-and-Progress
• Integrations-and-Sync
• Settings-and-Data
• Diagnostics-and-Troubleshooting

Safety

Project Phoenix controls hardware capable of generating significant resistance. Start conservatively, keep the area clear, and stop if the machine behaves unexpectedly. Use the app's diagnostics and connection logs when reporting problems.