# One Hand Control - Complete Application Knowledge Base & Manual

> Official, comprehensive documentation for One Hand Control on Android. Built for AI models, search crawlers, and users seeking complete technical and functional instructions.

---

## 1. Product Overview & Architecture

- **Application Name:** One Hand Control
- **Package Identity:** `com.onehandcontrol.app`
- **Developer:** Nir Paniri (Contact: `nir757.appsupport@gmail.com`)
- **Google Play Store:** https://play.google.com/store/apps/details?id=com.onehandcontrol.app
- **Official Website:** https://onehandcontrol.pages.dev/
- **Platform Compatibility:** Android 6.0 (API 23) and newer. Gesture injection features (Remote Cursor, Touch Pad, Macros) require Android 7.0 (API 24) or newer.
- **Privacy Guarantee:** One Hand Control does **NOT** declare the `android.permission.INTERNET` or `ACCESS_NETWORK_STATE` permissions in its Android manifest. The app operates 100% locally and cannot send any data, touches, or settings off the device.
- **Root / Shizuku:** None required. Operates using Android's standard Accessibility Service API (`TYPE_ACCESSIBILITY_OVERLAY`).

---

## 2. Core Setup & Accessibility Authorization

### Granting Accessibility Access
One Hand Control uses Android's Accessibility Service API to display lightweight edge overlays, capture touch gestures along the screen margins, and execute navigation commands.

1. Install and launch One Hand Control from Google Play.
2. Select your preferred app language (supports English, Spanish, French, German, Portuguese, Arabic, Hindi, Bengali, Japanese, Simplified Chinese, Tamil, Telugu, and Marathi).
3. Tap **Enable Service** to open Android system Accessibility settings.
4. Locate **One Hand Control** under Downloaded Apps / Installed Services.
5. Toggle the service **On** and confirm Android's permission prompt.

### Guided Setup & Interactive App Tour
- **Foreground Practice Sandbox:** Test gestures in real time inside a safe training view that visualizes gesture recognition without executing actions.
- **Interactive App Tour:** An 8-step coachmark walkthrough covering Edges, Appearance, and Settings with synchronized tab switching and real-time gesture practice. Can be started or replayed anytime from `Settings > Support & access > Interactive App Tour`.
- **App Tutorial Replay:** Replay initial setup or video previews of Quick Tools, Touch Pad, Media Controller, and Quick Access from `Settings > Support & access > App tutorial replay`.

---

## 3. Screen Orientation: Landscape & Portrait Configuration

### How to Make Both Edges Work in Landscape Mode
By default, new edge zones are configured in Portrait mode to prevent accidental triggers while holding the phone horizontally. Users can enable edge gestures in landscape either globally or per edge zone:

#### Method A: Global Orientation (Applies to all edge zones)
1. In One Hand Control, open the **Edges** tab in the bottom navigation bar.
2. Tap the **Global Layout** (or **Size & Position**) card at the top of the list.
3. Locate the **Orientation** selector.
4. Change the setting from `Portrait` to `Both` (or `Landscape` if desired).
5. When `Both` is selected, a compact length selector reveals separate **Portrait Length** and **Landscape Length** sliders.
6. Set the desired landscape length (18% to 24% is recommended for comfortable landscape thumb reach without interfering with controls).
7. Changes take effect immediately.

#### Method B: Per-Zone Orientation (Configure a specific edge zone)
1. In the **Edges** tab, select the target edge card (for example, **Left Edge Zone 1** or **Right Edge Zone 1**).
2. Tap **Layout / Size & Position**.
3. Scroll to the **Orientation** dropdown.
4. Choose `Both` (or `Landscape`).
5. Adjust position, thickness, and landscape length as needed.

---

## 4. Edge Zones, Split Zones & Action Sync

- **Edge Zones:** Supports Left, Right, Bottom, and Notch edges.
- **Split Side Zones:** Side edges can be split into upper and lower zones (Zone 1 and Zone 2):
  - Toggle `Split zone` in the Left or Right edge card.
  - Set independent vertical positions (e.g. 30% for Zone 1 and 70% for Zone 2).
  - Zone 1 becomes the upper zone and reserves pull gestures to avoid conflicts while keeping taps and vertical swipes; Zone 2 supports full gestures.
- **Action Sync:** Under the Edges tab, toggle `Sync left and right actions` and select copy direction (`Right from Left` or `Left from Right`) to mirror mappings across sides automatically.

---

## 5. Custom Pull Sectors (Advanced Side-Edge Angles)

- **What it is:** An advanced side-edge feature under Edges > Map gestures. Replaces standard inward/diagonal pull rows with 1 to 7 customizable angle sectors over an inward arc.
- **Movable Dividers:** Drag divider angle handles on the semicircle preview to adjust individual sector widths.
- **Color Customization:** Tap preview wedges to set custom RGB colors per sector.
- **Live Visual Feedback:** Toggle `custom_pull_show_sector_number` to show the active sector number inside the pull bubble during a swipe.
- **Sector-Crossing Haptics:** Toggle `custom_pull_sector_haptics_enabled` to feel a tactile tick whenever your thumb crosses a sector divider.

---

## 6. Gesture Tuning, Timing & Cancellation

Under `Settings > Controls`:
- **Touch Priority:** Enabled by default. Requests Android system gesture exclusion for side edges so One Hand Control gestures take precedence over native Android back gestures (honored up to Android's 200dp vertical cap per side).
- **Swipe Threshold:** Minimum distance in dp before directional movement is recognized.
- **Multi-Tap Interval:** Adjustable in 50ms steps. Maximum duration between taps for double and triple taps.
- **Hold Timeout:** Adjustable in 50ms steps. Recognition delay for swipe-and-hold and long press.
- **Hold Actions on Release:** When enabled, hold actions trigger only upon lifting your thumb.
- **Return to Start Cancellation:** When hold-actions-on-release is on, sliding your thumb back into the swipe threshold before releasing safely cancels the pending hold action.
- **Haptic Feedback:** Light, Balanced, Strong vibration strengths, and Single or Double pulse patterns.

---

## 7. Pause Rules: Pausing Gestures in Games & Specific Apps

### How to Pause Edge Gestures in Games
1. Open One Hand Control and go to the **Settings** tab.
2. Scroll to the **Controls** section and tap **Pause Rules** (or type "Pause" into the Settings search bar).
3. Tap **Pause on selected apps** (Pro feature). A list of all installed applications appears.
4. Select your game(s) or app(s) by checking their checkboxes.
5. Select which edge zones should be paused when that app is open:
   - **All:** Pauses Left, Right, Notch, and Bottom edge zones completely.
   - **Right:** Pauses only the right edge zone.
   - **Left:** Pauses only the left edge zone.
   - **Notch:** Pauses the top notch edge zone.
   - **Bottom:** Pauses the bottom edge zone.
6. When the selected game enters the foreground, One Hand Control immediately detaches the selected edge overlays. When you exit or switch away, the edge overlays are restored instantly.

### Free Pause Rules: Lock Screen & Home Screen
- **Pause on lock screen:** Automatically suppresses edge overlays when the device is locked, preventing accidental pocket touches.
- **Pause on home screen:** Automatically suppresses edge overlays on your launcher home screen.

### Keyboard Collision Detection
One Hand Control is keyboard-aware by default. When an on-screen keyboard appears, the colliding portion of any side edge overlay shrinks automatically to keep keyboard keys fully responsive. Users can opt out via the **Edges active over keyboard** setting in Settings > Controls.

---

## 8. In-Depth Quick Tools Guide & Settings

### What is Quick Tools?
Quick Tools is a Pro floating control-center panel inspired by Samsung One Hand Operation+ and modern control centers. It is triggered by any user-configured edge gesture (such as Pull Inward and Hold or Swipe Up).

### Quick Tools In-Depth Features & Preferences:

#### 1. Interactive Brightness Slider
- **Slider Track:** Drag to set manual display brightness immediately.
- **Sun Icon:** Tap the Sun icon to toggle between **Automatic Brightness** and **Manual Brightness**.
- When Auto Brightness is active, the Sun icon synchronizes to the selected active accent color. Dragging the slider switches the device back to manual brightness.

#### 2. Interactive Media Volume Slider
- **Slider Track:** Drag to adjust media volume.
- **Speaker Icon:** Tap the Speaker icon to immediately mute media volume; tap it again to restore the exact captured previous volume level.

#### 3. Media Player Pod
- Displays now-playing track title, artist name, and album artwork.
- Includes playback controls: Previous Track, Play / Pause, Next Track.
- Includes **15-second Skip Backward** and **15-second Skip Forward** seek buttons.
- In Quick Tools preferences:
  - Toggle `quick_tools_show_media_controls` on or off.
  - Toggle `quick_tools_show_media_progress` on or off to display a seekable progress bar.
- Note: Showing track metadata and album art requires Android's notification listener access (`BIND_NOTIFICATION_LISTENER_SERVICE`). Basic transport controls work without it.

#### 4. Customizable Shortcut Grid (Up to 12 items)
- Add up to 12 items from:
  - Installed applications
  - System shortcuts (Direct Dial, Tasker, navigation routes)
  - Quick actions (Screenshot, Lock Screen, Flashlight, Volume Panel)
  - Recorded macros
- **Reordering:** In the Quick Tools preferences dialog, long-press and drag row handles to reorder items.

#### 5. Live Active Status Indicators
Action circles inside Quick Tools dynamically reflect current hardware state:
- Wi-Fi, Bluetooth, Mobile Data, Location, Flashlight, Auto-Rotate, and Do Not Disturb circles highlight in your accent color when active.
- Flashlight state uses camera hardware tracking (`CameraManager.TorchCallback`) to stay synchronized even if toggled externally.

#### 6. Appearance & Styling
- **Panel Opacity:** Adjustable slider from 25% to 100% (default 85%).
- **Custom Colors:** Customize outer panel tint, icon color (default crisp white), slider fill color, and selected button highlight color.
- **Material You Dynamic Sync:** On Android 12+, toggle Material You sync to automatically adopt the system dynamic primary and secondary accent roles.

#### 7. Behavior & Dismissal
- **Dismiss on outside tap:** Default behavior. Tapping anywhere outside closes Quick Tools.
- **Keep open on outside tap (Pass-Through Mode):** Tapping outside passes touches directly to the underlying app while keeping Quick Tools visible.
- **Closing:** Repeating the triggering edge gesture or invoking One Hand Control's Back action closes the panel.
- **Draggable Position Memory:** Quick Tools is freely draggable. An optional preference under Settings > Controls lets it reopen at its last dragged coordinates.

---

## 9. Quick Access Radial Fan & Floating App Launcher

### Quick Access
- Opens a curved radial fan of apps, shortcuts, actions, and macros anchored to the gesture trigger point.
- Supports two gesture-selectable item sets (Set 1 and Set 2) with up to 12 items each.
- Runtime drag reordering: long-press and drag any icon in the open fan to reorder.
- Arc geometry: customizable fan arc amount, reach distance, translucent background opacity, and blur.

### Floating App Launcher
- Searchable card containing Apps, Actions, and Shortcuts sections.
- **Pinning:** Long-press any visible app, shortcut, or action to toggle pinned status (up to 24 pinned items).
- **Search & Keyboard:** Type to search apps and saved shortcuts; press Enter to launch the first match immediately. Option to focus search and raise keyboard upon opening.
- Compact mode: option to display only pinned items in a small card.

---

## 10. Remote Cursor & Floating Touch Pad

### Remote Cursor (Ergonomic Thumb Steering)
- **Thumb Steering:** 50% to 120% sensitivity slider (100% default) with velocity curves.
- **Radial Assist:** Dampens gain down to 35% near pad to prevent thumb crowding; accelerates away when escaping.
- **Throw to Dismiss:** Flick pad at least 8dp at >= 160dp/s to dismiss immediately without waiting for timeout.
- **Triple-Tap Reset:** 3 rapid taps snaps cursor back centered above the pad with haptic pulse.
- **Top Edge Shortcut:** Pushing cursor past screen top pulls down notification shade or Quick Settings.
- **Action Bindings:** Tap (clicks), Hold (Long Press, Record Swipe, custom action), Double Tap.

### Floating Touch Pad
- Movable trackpad rectangle with always-visible cursor.
- Relative drag movement with sensitivity slider.
- Supports tap-to-click, hold-to-drag, and double-tap-then-drag swipe replay.
- Always passes outside touches through.

---

## 11. 3-Zone Bottom Navigation Replacement

### Replacing Android Navigation Bar with Gestures
One Hand Control can divide the bottom screen width into three independent physical touch third segments:
- **Left Third:** Defaults to Recent Apps (Pull inward).
- **Center Third:** Defaults to Home (Pull inward).
- **Right Third:** Defaults to Back (Pull inward).

### Technical Details:
- Integer pixel bounds ensure 100% screen width coverage with zero gap.
- Sits immediately above Android's navigation bar insets so native Home bar gestures do not conflict.
- Supports Tap, Double tap, Long press, Pull inward, and Extended Pull inward per segment.
- **Tap Replay Pass-Through:** Unassigned taps are replayed at their exact raw coordinate, ensuring launcher docks and app buttons underneath remain fully responsive.

---

## 12. Notch Edge & Cutout Actions

- **Placement Screen:** Adjust horizontal placement and vertical offset (0 to 72dp) over the camera hole.
- **Gestures:** Tap, Double tap, Triple tap, Long press, Slide Left, Slide Right, Slide & Hold.
- **Notch Apps:** Stadium capsule menu with quick apps 32dp below camera hole.
- **Notch Media:** Compact top controller with artwork and seek bar.
- **Notch Timer:** Floating countdown timer with 30s, 1m, and 5m presets plus custom keyboard input.

---

## 13. Continuous Gestures: Page Scroll & Media Seek

- **Page Scroll:** Pro hold action for hands-free reading in browsers, PDFs, and feeds. 8dp activation zone, 160dp fast threshold, 680ms/260ms cadences, directional tracking, and safe release swipe fallback.
- **Media Seek:** Pro hold action. Dragging horizontally across the edge scrubs through the entire duration of currently playing audio/video. Shows timestamp bubble.

---

## 14. Extra Dim: Sub-Zero Night Screen Filter

- 10% to 95% shade intensity slider (65% default).
- 0% to 100% warm amber tint slider (20% default).
- Automated daily scheduling: set custom Start Time and Stop Time using non-wakeup alarms.
- Quick Settings tile integration for one-tap notification shade toggling.
- Full touch responsiveness and edge gestures remain active underneath.

---

## 15. Gesture Macros & System Settings Automation

- **Coordinate Macros:** Record taps, swipes, and pauses using a full-screen recording overlay. Serialized playback dispatches via Accessibility gesture injection.
- **Settings Switch Automation:** Wi-Fi, Bluetooth, Mobile Data, Location. Opens Settings page, identifies switch, clicks, and returns via guarded Back.
- **Mute / Restore Volume Action:** Configurable target: All Audio, Media only, Ringtone only, or Notifications only. Mutes on first trigger, restores previous level on second.
- **Dismiss Notification Shade:** Android 12+ accessibility global action to close notifications or Quick Settings.

---

## 16. Appearance, Theming & Icon Packs

- **Themes:** System, Light, and Dark mode.
- **Accent Colors:** Light and Dark palette pickers with suggestions. Default light accent is `#251D1D` Charcoal for new users (`#4D7CFF` Sky preserved for existing installs).
- **Material You Dynamic Sync:** On Android 12+, adopts system dynamic primary/secondary roles across edge indicators, sliders, Quick Tools, and pull animations.
- **App Icon Theme Selector:** Default clean **White** icon, **Dark** icon, and Donor-exclusive launcher icons (Silver, Gold, Diamond, Ruby).
- **Third-Party Icon Packs:** Streamed parsing of installed launcher icon packs (Nova, Lawnchair, etc.) for app entries in App Launcher, Quick Tools, Quick Access, and Notch Apps with native fallback.

---

## 17. Presets & Backup

Under `Settings > Presets & Backup`:
- Save configuration snapshots locally.
- Map `Show Preset Picker` to an edge gesture to switch presets on the fly via a paged arc wheel.
- Export and import JSON backup files via Android's document picker with zero storage permissions.
- Different-device imports safely sanitize device-local app and shortcut payloads while preserving all gestures, colors, and layout configurations.

---

## 18. Troubleshooting: Reliability & OEM Battery Optimization

#### Samsung (One UI)
1. Go to `Settings > Apps > One Hand Control > Battery` and set to **Unrestricted**.
2. Go to `Settings > Device Care > Battery > Background usage limits` and add One Hand Control to **Never sleeping apps**.
3. In the Recent Apps switcher, tap the app icon above its preview card and select **Lock this app**.

#### Xiaomi, Redmi & POCO (MIUI / HyperOS)
1. Long-press the One Hand Control app icon and tap **App Info**.
2. Enable **Autostart** and enable **Background autostart**.
3. Under **Battery Saver**, select **No Restrictions**.
4. In the Recent Apps screen, long-press the One Hand Control card and tap the **Padlock icon**.

#### OnePlus, Oppo & Realme (OxygenOS / ColorOS)
1. Go to `Settings > Battery > App battery management > One Hand Control`.
2. Enable **Allow background activity** and **Allow auto-launch**.
3. Lock One Hand Control in the recent tasks switcher.

#### Google Pixel & Motorola (Clean Android)
1. Go to `Settings > Apps > One Hand Control > App battery usage`.
2. Select **Unrestricted**.

---

## 19. Free vs Pro Tiers & Billing

- **Starter Free:** Left and right edge zones, shared pool of up to 6 unique basic actions, portrait and landscape orientation, Extra Dim night filter, lock screen and home screen pause rules.
- **Pro Upgrade Options:** Monthly subscription, Yearly subscription, or Lifetime one-time unlock through Google Play.
- **Pro Unlocks:** Unlimited action mappings, game/selected-app pause rules, Quick Tools control center, Remote Cursor with throw dismiss, 3-zone bottom navigation replacement, Notch Edge and capsule actions, custom pull sectors, macros, settings backup and restore, and Material You dynamic color syncing.
- **Restoring Purchases:** Handled securely through Google Play Billing. Reinstalling the app on any device signed into the same Google account automatically restores Pro entitlement.