Skip to content

ansha001/AirPointer

Repository files navigation

AirPointer - Wear OS Gesture Control for Presentations

AirPointer is a Wear OS app that allows you to control PowerPoint presentations on your laptop. Inspired by Samsung PPT Controller, it features a familiar interface with added gesture support using the watch's universal gesture capabilities.

Features

  • Samsung PPT-like Interface: Clean, intuitive UI with arrow buttons, slideshow controls, and touchpad
  • Universal Gesture Support: Use hand gestures in addition to button controls
    • Swipe Right → Next Slide
    • Swipe Left → Previous Slide
    • Tap → Toggle Presentation Mode
    • Swipe Up → Start Presentation
    • Swipe Down → End Presentation
  • Bezel Rotation: Rotate the watch bezel to navigate slides (clockwise = next, counter-clockwise = previous)
  • Touchpad Mode: Control your laptop cursor from the watch
  • Real-time Gesture Detection: Uses accelerometer and gyroscope sensors for accurate gesture recognition
  • No Laptop Script Required: Works with phone companion app or direct Bluetooth connection

Setup

1. Wear OS App Setup

  1. Build and install the app on your Wear OS watch
  2. Open the AirPointer app on your watch
  3. Make sure Bluetooth is enabled on your watch

2. Direct Laptop Connection (No Script Required)

The watch communicates directly with your laptop via Bluetooth. The app uses Bluetooth HID (Human Interface Device) to act as a keyboard, sending keypresses directly to your laptop - just like a standard Bluetooth keyboard. No scripts or additional software needed on the laptop!

How it works:

  • The watch appears as a Bluetooth keyboard to your laptop
  • When you use gestures or buttons, the watch sends keyboard shortcuts (arrow keys, F5, ESC, etc.)
  • Your laptop receives these as standard keyboard input - PowerPoint responds automatically

3. Pairing Steps

  1. On your laptop: Open Bluetooth settings and make sure Bluetooth is enabled and discoverable
  2. On your watch: Open AirPointer app
  3. Pair the devices:
    • From your laptop's Bluetooth settings, search for and pair with your watch
    • The watch will appear as "AirPointer" or your watch's name
  4. Connect from watch: In the AirPointer app, tap "Select Device" and choose your laptop
  5. Once connected, you'll see the PPT control screen with arrow buttons

Note:

  • Bluetooth HID requires Android 9.0 (P) or higher
  • Some devices may require special permissions for HID functionality
  • The app automatically detects and uses the best available method
  • If HID is not available, the app will use standard Bluetooth (which may require additional setup)

Usage

  1. Open your PowerPoint presentation on your laptop
  2. Connect your watch (via phone companion or direct Bluetooth)
  3. Use the PPT control screen:
    • Arrow Buttons: Tap left/right arrows to navigate slides
    • Bezel Rotation: Rotate the watch bezel to navigate (like Samsung PPT)
    • Start/Stop Button: Control slideshow mode
    • Touchpad: Tap the touchpad button to control cursor
    • Hand Gestures: Use natural hand movements:
      • Swipe Right (move hand right) → Next slide
      • Swipe Left (move hand left) → Previous slide
      • Quick Tap (quick hand movement) → Toggle presentation mode
      • Swipe Up → Start presentation
      • Swipe Down → End presentation

Technical Details

Gesture Detection

The app uses the watch's built-in sensors:

  • Accelerometer: Detects movement direction and magnitude
  • Gyroscope: Provides additional motion data for gesture refinement

Bluetooth Protocol

The app uses Bluetooth HID (Human Interface Device) when available (Android 9.0+), which allows the watch to act as a keyboard. This means:

  • No scripts needed - The laptop treats the watch like any Bluetooth keyboard
  • Direct keypresses - Arrow keys, F5, ESC, Spacebar are sent directly
  • Works with any app - Not just PowerPoint, but any application that responds to keyboard shortcuts

If HID is not available, the app falls back to standard Bluetooth communication.

Supported Commands

Command Action
NEXT_SLIDE Right arrow key (next slide)
PREV_SLIDE Left arrow key (previous slide)
TOGGLE_PRESENTATION Spacebar (toggle black screen)
START_PRESENTATION F5 (start slideshow)
END_PRESENTATION ESC (exit slideshow)

Troubleshooting

Connection Issues

  • Ensure Bluetooth is enabled on both devices
  • Make sure devices are paired before connecting
  • Check that the laptop receiver is running
  • Try disconnecting and reconnecting

Gesture Not Working

  • Make sure you're making clear, deliberate gestures
  • Swipe gestures should be smooth and sustained
  • Tap gestures should be quick and sharp
  • Check that the watch is properly secured on your wrist

PowerPoint Not Responding

  • Ensure PowerPoint is in focus on your laptop
  • Make sure the receiver script is running
  • Check that keyboard shortcuts are enabled in PowerPoint

Requirements

  • Wear OS 3.0+ watch
  • Android SDK 30+
  • Bluetooth-enabled laptop (Windows, macOS, or Linux)
  • PowerPoint or compatible presentation software

License

This project is open source and available for personal and educational use.

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors