VolumeStep v0.2.1

A Hammerspoon Spoon that makes the volume keys change the volume in quarter steps (1/64, about 1.6%) instead of macOS's default 1/16, keeping the native volume HUD.

GitHub Latest release

Overview

macOS already does quarter steps when Shift+Option is held with a volume key; VolumeStep swallows each volume key and re-sends it with those modifiers held. For half steps (1/32, about 3.1%), call VolumeStep:configure({ steps = 2 }) and each press sends two quarter steps.

Download: https://github.com/hugoh/VolumeStep.spoon/releases/latest

Variables

VolumeStep.steps Variable #

Number of quarter steps (1/64) per volume key press. Defaults to 1 (quarter steps); set to 2 for half steps (1/32).

Methods

VolumeStep:init() Method #

Called automatically by hs.loadSpoon(). Logs the loaded version.

VolumeStep:configure(config) → VolumeStep Method #

Applies configuration options.

Parameters

  • config - A table of options:
  • steps - Number of quarter steps per press (a positive integer); 2 gives half steps

Returns

  • The VolumeStep object, for method chaining
VolumeStep:isRunning() → boolean Method #

Returns whether the volume keys are currently intercepted.

VolumeStep:start() → VolumeStep Method #

Starts intercepting the volume keys.

Returns

  • The VolumeStep object, for method chaining
VolumeStep:stop() → VolumeStep Method #

Stops intercepting the volume keys, handing them back to macOS.

Returns

  • The VolumeStep object, for method chaining