Configuration Guide

Cursor Claw uses a configuration file to manage its settings. This guide will help you understand how to edit and update this file to customize your experience.

Onece the app is launched, it will automatically create configuration files at

• Directory~ Home

  • DirectoryLibrary

    • DirectoryApplication Support

      • Directorycom.expressionloss.cursorclaw automatically created

        • Directoryconf

          • conf.toml
          • …

You can change the location of this directory in the app settings. You can put them in iCloud Drive to sync your settings across devices.

Once you make changes, you can reload the configurations from the app settings, or by restarting the app.

Conf.toml

The main configuration file is conf.toml. Here are the key sections you can modify:

General Section

[general]
defaultCursorMode = "regular"
layout = "wasd"

Section	Description	Default Value	Available Options
defaultCursorMode	Sets the default cursor mode when the app starts.	regular	regular, element, text
layout	Defines the keys to use to control the mouse.	ijkl	wasd, hjkl, ijkl

Gesture Section

[gesture]
naturalPanDirection = false
treatRotateAsMouseButtonWhenNotHoldingFingers = false
treatPinchAsMouseButtonWhenNotHoldingFingers = false

Section	Description	Default Value	Available Options
naturalPanDirection	If true, enables natural direction for gestures.	false	true, false
treatRotateAsMouseButtonWhenNotHoldingFingers	If true, treats the rotate gesture as a mouse button when not holding fingers.	false	true, false
treatPinchAsMouseButtonWhenNotHoldingFingers	If true, treats the pinch gesture as a mouse button when not holding fingers.	false	true, false

Regular Mode Section

[regularMode]
accurateMovementMode = 'bisectionGrid'
defaultDistanceX = 200
defaultDistanceY = 200

Section	Description	Default Value	Available Options
accurateMovementMode	Sets the mode for accurate mouse movement.	bisectionGrid	bisectionGrid, nineSquareGrid
defaultDistanceX	Sets the default horizontal distance for mouse movement.	200	Any positive integer
defaultDistanceY	Sets the default vertical distance for mouse movement.	200	Any positive integer