Skip to content
CleverKeys Wiki

Circle Gestures

Circle gestures allow you to perform actions like undo and redo by drawing circular patterns on the keyboard.

Quick Summary

WhatDescription
PurposeQuick access to undo/redo and other actions
GestureDraw a circle on the keyboard
DirectionCounter-clockwise = Undo, Clockwise = Redo

Current Status

[!NOTE] Circle gestures are a planned feature. The core gesture detection infrastructure exists, but dedicated circle actions are not yet fully implemented in the current release.

Planned Functionality

Undo Gesture

  1. Start anywhere on the keyboard
  2. Draw a counter-clockwise circle
  3. Last action is undone

Redo Gesture

  1. Start anywhere on the keyboard
  2. Draw a clockwise circle
  3. Last undone action is redone

Alternative: Current Undo/Redo Access

Until circle gestures are implemented, use these methods:

Method 1: Subkeys

  • Undo: Short swipe on designated key (layout-dependent)
  • Redo: Short swipe in opposite direction

Method 2: Symbol Keyboard

  1. Switch to symbol keyboard (?123)
  2. Look for undo/redo buttons

Method 3: Ctrl+Z / Ctrl+Y

If your layout supports modifiers:

  1. Hold Ctrl modifier
  2. Tap Z for Undo
  3. Tap Y for Redo

Gesture Detection Concepts

When implemented, circle detection will work as follows:

Detection Algorithm

  1. Track finger path as sequence of points
  2. Calculate cumulative angle change
  3. If total angle >= 360° (or -360°), circle detected
  4. Direction determined by sign of angle sum

Parameters

ParameterValueDescription
Min Points20Minimum touch points for valid circle
Min Angle300°Minimum rotation for detection
Max Time1000msMaximum time to complete circle
Min Radius30pxMinimum circle size

Tips for When Implemented

  • Smooth motion: Draw a fluid circle, not a polygon
  • Size matters: Medium-sized circles work best
  • Speed: Not too fast, not too slow
  • Complete the circle: Ensure at least 300° rotation

Technical Details

See Circle Gestures Technical Specification.