TomeUI Clickwheel #

Click-wheel input and navigation for TomeUI. Turn wheel movement and button presses into focus navigation, media commands, volume changes, and configurable tap and hold gestures.

Installation #

flutter pub add tomeui tomeui_clickwheel

Usage #

Wrap the app's content in ClickWheelInput. Use WheelList for lists whose selection should follow the wheel:

import 'package:tomeui/tomeui.dart';
import 'package:tomeui_clickwheel/tomeui_clickwheel.dart';

void main() {
  runApp(TomeApp(
    home: ClickWheelInput(
      child: Scaffold(
        body: WheelList(
          autofocus: true,
          itemExtent: 48,
          onActivate: (index) => debugPrint('Selected row $index'),
          children: const [Text('Albums'), Text('Artists'), Text('Settings')],
        ),
      ),
    ),
  ));
}

• WheelList.builder builds long lists lazily.
• WheelGrid and WheelRail provide grid and rail selection.
• InputCapture temporarily handles selected wheel commands.
• ClickWheelController drives input from an emulator or other controls.
• WheelFeel and DarkInput configure navigation and behavior while asleep.

License #

MIT, copyright © 2026 Chris Hendrickson.