Horizontal Swipe Gestures

approved

by Justin Rosales

Two-finger trackpad swipes mapped to any command. - This plugin has not been manually reviewed by Obsidian staff.

1 stars52 downloadsUpdated 23d ago0BSD

Horizontal Swipe Gestures

An Obsidian plugin that maps two-finger horizontal trackpad swipes to any command — back/forward navigation by default.

How it works

Listens to the browser WheelEvent API (how web/Electron apps receive trackpad input on any platform), detects horizontal-enough movement, and fires the configured command. No proprietary Apple gesture API.

Features

  • Map any Obsidian command to swipe left or right
  • Configurable sensitivity and horizontal dominance
  • Visual half-circle indicator on trigger
  • macOS momentum scroll filtering — releases after your finger lifts, not during the inertia tail
  • Desktop only (trackpad/mouse)

Installation

Clone into your vault's plugin folder:

cd <your vault>/.obsidian/plugins
git clone https://github.com/justinrosales/obsidian-swipe-gestures

Reload Obsidian and enable Horizontal Swipe Gestures in Settings → Community Plugins. No build step — main.js is included.

To build from source: npm install && npm run build in the plugin folder.

Settings

SettingDescription
Swipe left actionCommand on left swipe (default: Navigate back)
Swipe right actionCommand on right swipe (default: Navigate forward)
Invert directionFlip left/right if reversed
Swipe sensitivityLow = light flick triggers, High = deliberate swipe
Horizontal dominanceLow = diagonal counts, High = only straight left/right

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.