VoiceTel Phone — Knowledge Base

Clear, step-by-step install guides for mobile and desktop. No prior experience assumed.

← Back to Landing Page

iPhone: Enable Developer Mode & Install

These steps guide you from enabling Developer Mode to installing the app with Xcode. A Mac is required.

  1. Turn on Developer Mode
    1. Update your iPhone to the latest iOS version.
    2. Open Settings → Privacy & Security.
    3. Scroll to Developer Mode and toggle it on.
    4. Restart when prompted, then confirm Developer Mode is enabled.
  2. Install Required Software (Mac)
    1. Open the Mac App Store and install Xcode.
    2. Launch Xcode, accept license prompts, and sign in with your Apple ID.
    3. (Optional) Install Command Line Tools via Xcode → Settings → Locations.
  3. Get the App Source
    1. Download the source from your repository (e.g., mobile-ios).
    2. Extract the ZIP and open the .xcodeproj or .xcworkspace in Xcode.
  4. Build & Install
    1. Connect your iPhone via USB and unlock it.
    2. Select your iPhone as the run target in Xcode.
    3. Open Signing & Capabilities and choose your Apple ID team.
    4. Click Run ▶ to build and install.
    5. On the phone: Settings → General → VPN & Device Management → Trust your developer profile (first run only).
Tip: If the build fails, open Xcode → Settings → Locations and ensure Command Line Tools is set.

Android: Enable Developer Options & Install

  1. Turn on Developer Options
    1. Open Settings → About Phone.
    2. Tap Build Number seven times until you see a confirmation.
    3. Go back to Settings → System → Developer Options.
    4. Enable USB Debugging.
  2. Install Required Software
    1. Download and install Android Studio.
    2. During setup, install the Android SDK Platform Tools.
    3. Connect your device via USB and allow debugging access on the phone.
  3. Build & Install
    1. Download the source (e.g., mobile-android repository).
    2. Open the project in Android Studio; wait for Gradle sync to complete.
    3. Choose Run ▶ → Run App and select your device.
Tip: If you see device offline, run adb kill-server then adb start-server in a terminal, and reconnect the phone.

Windows: Install Desktop App

  1. Download the installer (.exe) from the VoiceTel release page.
  2. Double‑click the file and follow the prompts.
  3. If SmartScreen appears, click More Info → Run Anyway.
  4. Launch VoiceTel Phone from the Start Menu.

macOS: Install Desktop App

  1. Download the .dmg from the release page and open it.
  2. Drag VoiceTel Phone to Applications.
  3. On first launch, if blocked, go to System Settings → Privacy & Security → Open Anyway.

Linux: Install Desktop App

  1. Download your preferred package: .AppImage, .deb, or .rpm.
  2. For AppImage:
    1. Right‑click the file → Properties → Permissions.
    2. Enable Allow executing file as program.
    3. Double‑click to launch.
  3. For Debian/Ubuntu:
    1. Open Terminal.
    2. Run sudo apt install ./voicetel.deb.
  4. For Fedora/Red Hat:
    1. Open Terminal.
    2. Run sudo rpm -i voicetel.rpm.

Troubleshooting

  1. iPhone not detected in Xcode:
    1. Unlock the phone and tap Trust This Computer.
    2. Try a different cable/USB port.
  2. Android build errors:
    1. Verify SDK/NDK versions in Android Studio.
    2. Run File → Invalidate Caches / Restart and rebuild.
  3. Audio devices not found:
    1. Confirm OS microphone permissions.
    2. Select the correct input/output device in app settings.