From f3acfa2f18b157c76028998dd91a848c7ed0634a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=B0=94=EA=B2=AC=EA=B7=9C?= Date: Sat, 28 Jun 2025 07:21:04 +0900 Subject: [PATCH] Add iOS client section to main README/ modify iOS README --- .DS_Store | Bin 8196 -> 8196 bytes Audio-Transcription-iOS/README.md | 51 +++++++++++++++++++++++++++++- README.md | 6 ++++ 3 files changed, 56 insertions(+), 1 deletion(-) diff --git a/.DS_Store b/.DS_Store index f737795c9a96f4f4f15e198525bafae43d2160dc..a63eb67cdcbd46fe107cfc6eabe3a27ef312fe18 100644 GIT binary patch delta 202 zcmZp1XmOa}&nUbxU^hRb@MazXaYj~I1_nmH$+rZoCMO9t3K^T~D41B9)aocyTN)Vv z*~XK<3KmW75SE$TDkLy@i?I0Q#lnJki(G4kjjw9P{L5`nUkNKl#`#tz`!8Dz`)oIr1k!T0g%POfTlXB zytn|Wdi&%&!9q3h>S|L%104l3LnOP*YHK+;M3wcegW|Jua`W;#CkKei3wL1}H#tH` zd-7@_fytAF#3$bn5}dqSNRIL9=37DqjBHF-f$HZ?4iGV(>@A`>d5s7+BdJz0c5N;Y VEoa=!F7b_J@*Uwks+n2B2mlSbYjgkr diff --git a/Audio-Transcription-iOS/README.md b/Audio-Transcription-iOS/README.md index 49bc17e..8e4455c 100644 --- a/Audio-Transcription-iOS/README.md +++ b/Audio-Transcription-iOS/README.md @@ -41,7 +41,56 @@ The app streams microphone audio to a WhisperLive server via WebSocket and displ 4. Run the app on a physical device (recommended) +## Running on a Physical Device (with Free Apple ID) + +You can run this app on a real iPhone without a paid Apple Developer account. Follow these steps: + +### 1. Register a Free Apple ID in Xcode + +1. Open Xcode ▸ Settings… (or Preferences) ▸ **Accounts** +2. Click the **+** button ▸ Select **Apple ID** +3. Sign in with your Apple ID (a free one is fine) +4. A "Personal Team" will be created automatically + +> ✅ You can deploy up to 3 apps on a physical device using a free Apple ID with a 7-day provisioning profile. + +--- + +### 2. Set Up Signing in Your Project + +1. In Xcode, select your **project** in the Project Navigator +2. Go to **TARGETS ▸ YourAppName ▸ Signing & Capabilities** +3. Set **Team** to your Personal Team +4. Set a unique **Bundle Identifier** (e.g., `com.yourname.whisperlive`) +5. Make sure **Automatically manage signing** is checked +6. If a red warning appears, click **"Resolve Issues"** + +--- + +### 3. Connect and Trust Your iPhone + +1. Connect your iPhone via USB +2. When prompted, tap **“Trust This Computer”** on your iPhone +3. Make sure your iPhone appears in Xcode's device list + +--- + +### 4. Enable Developer Mode on iPhone + +1. Press the **Build (▶︎)** button in Xcode +2. Your iPhone will ask to enable **Developer Mode** +3. On iPhone, go to: + **Settings ▸ Privacy & Security ▸ Developer Mode** +4. Enable it and restart the device if required + +--- + +Now you can run and debug the app on your real device! + + + ## Folder Structure +``` Audio-Transcription-iOS/ ├── AudioViewModel.swift ├── AudioStreamer.swift @@ -50,7 +99,7 @@ Audio-Transcription-iOS/ ├── WhisperLive_iOS_ClientApp.swift ├── Info.plist ├── README.md - +``` ## License diff --git a/README.md b/README.md index 306d8bc..49ed1bb 100644 --- a/README.md +++ b/README.md @@ -147,6 +147,12 @@ client(hls_url="http://as-hls-ww-live.akamaized.net/pool_904/live/ww/bbc_1xtra/b - Run the server with your desired backend as shown [here](https://github.com/collabora/WhisperLive?tab=readme-ov-file#running-the-server). - Transcribe audio directly from your browser using our Chrome or Firefox extensions. Refer to [Audio-Transcription-Chrome](https://github.com/collabora/whisper-live/tree/main/Audio-Transcription-Chrome#readme) and https://github.com/collabora/WhisperLive/blob/main/TensorRT_whisper.md +## iOS Client + +Use WhisperLive on iOS with our native iOS client. +Refer to [`ios-client`](https://github.com/collabora/WhisperLive/tree/main/Audio-Transcription-iOS) and [`ios-client/README.md`](https://github.com/collabora/WhisperLive/blob/main/Audio-Transcription-iOS/README.md) for setup and usage instructions. + + ## Whisper Live Server in Docker - GPU - Faster-Whisper