> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gymlive.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Wear OS Connection

> Connect Samsung and Google Wear OS watches for real-time workout tracking

# Wear OS Live Connection

Connect your Samsung Galaxy Watch or Google Pixel Watch to GymLive for real-time heart rate and calorie tracking during live workout classes. The GymLive companion app on your Wear OS watch automatically pairs with your Android phone when both devices are linked to the same Google account.

<Info>
  Wear OS app requires Android phone with GymLive companion app installed.
</Info>

## Compatible Devices

### Samsung Galaxy Watches

* Galaxy Watch 6/6 Classic
* Galaxy Watch 5/5 Pro
* Galaxy Watch 4/4 Classic
* Galaxy Watch FE

### Google Pixel Watches

* Pixel Watch 2
* Pixel Watch

### Other Wear OS 3+ Devices

* Fossil Gen 6
* TicWatch Pro 3/5
* Montblanc Summit 3
* TAG Heuer Connected

<Note>
  Devices must run Wear OS 3.0 or later for full compatibility.
</Note>

## Installation Guide

<Steps>
  <Step title="Install Companion Watch App">
    You can install the GymLive companion app in two ways:

    **Option 1: From Play Store on Phone**

    1. Open the **Play Store** on your Android phone
    2. Search for **GymLive**
    3. Look for **"Install on Watch"** option
    4. Tap it and select your watch from the list
    5. The app will install automatically on your watch

    **Option 2: From Play Store on Watch**

    1. Open the **Play Store** directly on your Wear OS watch
    2. Search for **GymLive**
    3. Tap **Install**
    4. Wait for installation to complete

    <Tip>
      Make sure your watch is connected to your phone and has internet access during installation.
    </Tip>
  </Step>

  <Step title="Open App on Both Devices">
    After installation:

    1. Open **GymLive** on your Android phone
    2. Open **GymLive** on your Wear OS watch
    3. Both apps should be running and ready

    <Note>
      The apps will automatically sync if both devices are signed in to the same Google account.
    </Note>
  </Step>
</Steps>

## Connecting During Live Classes

<Steps>
  <Step title="Join or Host a Live Workout Class">
    Start by joining or hosting any live workout class:

    1. Open GymLive on your Android phone
    2. **Join** an existing class, or
    3. **Host** your own live workout class

    <Info>
      You can be either a participant or a coach - both work the same way.
    </Info>
  </Step>

  <Step title="Select Wear OS from Device List">
    Once in the class:

    1. Look for the **device list** options
    2. Tap **Wear OS** from the available devices
    3. The app will automatically pair with your watch

    <Warning>
      Automatic pairing only works if your Android phone and Wear OS watch are linked to the same Google account. If they're not, you'll need to sign in to the same account on both devices first.
    </Warning>
  </Step>

  <Step title="Start Workout or Join Class">
    **If you're the coach:**

    1. Press **Start Workout** when ready
    2. Your heart rate and calories will begin updating once the class begins

    **If you're a participant:**

    1. Simply **Join Class** and wait for it to begin
    2. Once the coach starts the class, your heart rate and calories will automatically start updating

    <Tip>
      Make sure your Wear OS watch is properly fitted on your wrist for accurate heart rate readings.
    </Tip>
  </Step>
</Steps>

## How It Works

### Automatic Pairing

When you select Wear OS from the device list:

* GymLive checks if your Android phone and Wear OS watch are linked to the same Google account
* If they are, pairing happens automatically - no manual connection needed
* Your watch's heart rate and calorie data streams to the live class in real-time

### Real-Time Data

Once the class begins:

* **Heart Rate**: Updates continuously from your Wear OS watch sensor
* **Calories**: Calculated based on your heart rate and activity
* **Live Display**: Your coach and other participants can see your metrics in real-time

<Info>
  Data only starts streaming when the class actually begins, not when you join.
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Watch app not installing">
    1. Check that your watch is paired with your Android phone
    2. Ensure both devices have internet connection
    3. Make sure your watch has sufficient storage space (200MB+)
    4. Verify Wear OS version is 3.0 or later (Settings > System > About)
    5. Try restarting both devices
    6. Install from Play Store on watch directly
  </Accordion>

  <Accordion title="Automatic pairing not working">
    1. Verify both devices are signed in to the same Google account:
       * Phone: Settings > Accounts
       * Watch: Settings > Accounts (on watch)
    2. Make sure both GymLive apps are open
    3. Check that Bluetooth is enabled on phone
    4. Ensure watch is connected to phone (check Wear OS app)
    5. Try closing and reopening both apps
    6. Sign out and back in to GymLive on both devices
  </Accordion>

  <Accordion title="Heart rate not updating">
    1. Ensure your watch is properly fitted (snug but comfortable)
    2. Clean the heart rate sensor on the back of the watch
    3. Make sure the class has actually started (data only streams during active classes)
    4. Check that you selected Wear OS from the device list
    5. Verify watch battery is above 20%
    6. Grant body sensor permissions: Watch Settings > Apps > GymLive > Permissions
  </Accordion>

  <Accordion title="Calories not showing">
    1. Heart rate must be working first
    2. Wait for the class to begin - calories only update during active sessions
    3. Make sure you're wearing the watch during the workout
    4. Check that physical activity permissions are granted
  </Accordion>

  <Accordion title="App crashes on watch">
    1. Force stop app: Watch Settings > Apps > GymLive > Force Stop
    2. Clear app cache
    3. Ensure watch software is updated
    4. Reinstall the app if persistent
    5. Check that phone app is running
  </Accordion>
</AccordionGroup>

## Permissions Required

GymLive requires the following permissions on your watch:

* **Body Sensors**: To read heart rate data
* **Physical Activity**: For accurate calorie calculations
* **Location**: For outdoor workouts (optional)

<Warning>
  All permissions are required for proper functionality. You can manage them in Watch Settings > Apps > GymLive > Permissions.
</Warning>

## Best Practices

<CardGroup cols={2}>
  <Card title="Proper Fit" icon="ruler">
    Wear watch snugly, one finger above wrist bone for accurate readings
  </Card>

  <Card title="Clean Sensor" icon="spray-can">
    Wipe the heart rate sensor regularly for best accuracy
  </Card>

  <Card title="Fully Charged" icon="battery-full">
    Charge your watch before long workout sessions
  </Card>

  <Card title="Same Account" icon="user-check">
    Ensure phone and watch use the same Google account for auto-pairing
  </Card>
</CardGroup>

## Privacy & Security

* Health data is encrypted on device
* Only shared during active workout sessions
* You control what data is shared with coaches
* No data stored permanently on watch
* Syncs securely via encrypted connection

## Related Resources

* [Samsung Galaxy Watch Support](https://www.samsung.com/support/mobile-devices/wearables/)
* [Google Pixel Watch Help](https://support.google.com/pixelwatch)
* [GymLive Troubleshooting Guide](/integrations/troubleshooting)