|
1 | 1 | <div align="center"> |
2 | 2 |
|
3 | | -<img src="icon.png" width="120" alt="Unleashed icon"> |
| 3 | +<img src="icon.png" width="120" alt="TumoCompanion icon"> |
4 | 4 |
|
5 | | -# Unleashed |
| 5 | +# TumoCompanion |
6 | 6 |
|
7 | 7 | **A native iOS companion for Flipper Zero** — BLE/USB SD file access, screen mirror, Sub-GHz/NFC, a Sber smart-relay failsafe, Marauder log analysis, ESP32 firmware flashing, and live Claude Code status on your Flipper. |
8 | 8 |
|
9 | | - |
| 9 | + |
10 | 10 |  |
11 | 11 |  |
12 | 12 |  |
|
25 | 25 | - [Firmware packages (atomic updater)](#firmware-packages-atomic-updater) |
26 | 26 | - [How the relay state works](#how-the-relay-state-works) |
27 | 27 | - [Privacy](#privacy) |
| 28 | +- [Build from source](#build-from-source) |
28 | 29 | - [Requirements](#requirements) |
29 | 30 |
|
30 | 31 | ## Install (Feather / AltStore) |
31 | 32 |
|
32 | 33 | Add the source, then install — Feather signs it with your own certificate and auto-updates on each release: |
33 | 34 |
|
34 | 35 | ``` |
35 | | -https://raw.githubusercontent.com/squazaryu/unleashed-companion/main/apps.json |
| 36 | +https://raw.githubusercontent.com/squazaryu/TumoCompanion/main/apps.json |
36 | 37 | ``` |
37 | 38 |
|
38 | 39 | > Unsigned IPA, sideloaded. Built for the **[tumoflip](https://github.com/squazaryu/tumoflip)** firmware (Unleashed-based — its App Bridge BLE service is what most of the integrations talk to). Works as a plain BLE file/screen client on stock firmware too. |
@@ -118,13 +119,29 @@ The Sber relay doesn't report a reliable *steady* state back to Home Assistant ( |
118 | 119 | - Update notifications are **local** (`BGAppRefreshTask` + local notifications); they only fetch public GitHub release tags. |
119 | 120 | - Bundles the public Russian Trusted Root CA so Sber's TLS validates — no private keys involved. |
120 | 121 |
|
| 122 | +## Build from source |
| 123 | + |
| 124 | +The repository contains the complete SwiftUI application, widget extension, |
| 125 | +tests, Feather source metadata and release scripts. The internal Xcode target |
| 126 | +remains `UnleashedCompanion` to preserve the existing iOS update identity. |
| 127 | + |
| 128 | +Prerequisites: Xcode 16+, XcodeGen and Swift Protobuf. |
| 129 | + |
| 130 | +```sh |
| 131 | +brew install xcodegen swift-protobuf protobuf |
| 132 | +./scripts/build_ipa.sh |
| 133 | +``` |
| 134 | + |
| 135 | +The unsigned IPA is written to `build/TumoCompanion-unsigned.ipa`. Sign it with |
| 136 | +your own certificate using Feather, SideStore, AltStore or Sideloadly. |
| 137 | + |
121 | 138 | ## Requirements |
122 | 139 |
|
123 | 140 | - iPhone on **iOS 17+**, a Flipper Zero, and (for most integrations) the **[tumoflip](https://github.com/squazaryu/tumoflip)** firmware (Unleashed-based) with App Bridge. |
124 | 141 | - Optional: a Mac running the AI Radar / Claude Buddy relay daemon for the Claude Code features and the HA relay bridge. |
125 | 142 |
|
126 | 143 | ## Releases |
127 | 144 |
|
128 | | -See [Releases](https://github.com/squazaryu/unleashed-companion/releases) for the changelog and IPAs. `apps.json` is the Feather source manifest. |
| 145 | +See [Releases](https://github.com/squazaryu/TumoCompanion/releases) for the changelog and IPAs. `apps.json` is the Feather source manifest. |
129 | 146 |
|
130 | 147 | <div align="center"><sub>Built for personal use with the Flipper Zero community. Not affiliated with Flipper Devices, Sber, or Anthropic.</sub></div> |
0 commit comments