my_timer #

A drift-free, dependency-free Flutter timer widget that handles count-up and count-down out of the box, with proper pause / resume / reset / seek, format presets, custom builders, and automatic resync after the app returns from the background.

Table of contents #

• Why my_timer?
• Screenshots
• Install
• Quick start
  • Count-down
  • Count-up
  • Programmatic control
  • Custom rendering
  • Custom formatter
• Format presets
• API reference
• Migrating from 1.x
• Contributing

Why my_timer? #

Screenshots #

Countdown pause · resume · reset · ±10s	Stopwatch count-up, millisecond precision
Custom builder progress bar + timer text	Format presets auto, mm:ss, hh:mm:ss, mm:ss.mmm, ...

Want to see it live? Run the example app — all four scenarios above are wired up as tabs.

Install #

dependencies:
  my_timer: ^2.0.0

flutter pub add my_timer

Quick start #

Count-down #

import 'package:my_timer/my_timer.dart';

MyTimer(
  duration: const Duration(minutes: 5),
  direction: TimerDirection.countDown,
  format: TimerFormat.minutesSeconds,
  onComplete: () => debugPrint('done!'),
)

Count-up #

MyTimer(
  duration: const Duration(minutes: 1),
  direction: TimerDirection.countUp,
  format: TimerFormat.minutesSeconds,
)

Programmatic control #

final controller = MyTimerController(
  onTick: (remaining) => print('$remaining left'),
  onComplete: () => print('done!'),
);

MyTimer(
  controller: controller,
  duration: const Duration(minutes: 10),
  direction: TimerDirection.countDown,
  autoStart: false,
);

// Anywhere in your app:
controller.start();
controller.pause();
controller.resume();
controller.reset();
controller.seek(const Duration(minutes: 2));
controller.add(const Duration(seconds: 30));
controller.subtract(const Duration(seconds: 30));

// Inspect state:
controller.isRunning;
controller.isPaused;
controller.isCompleted;
controller.elapsed;
controller.remaining;

Custom rendering with builder #

MyTimer(
  duration: const Duration(minutes: 25),
  direction: TimerDirection.countDown,
  builder: (context, remaining, elapsed) {
    final total = const Duration(minutes: 25).inMilliseconds;
    return Column(
      children: [
        LinearProgressIndicator(value: elapsed.inMilliseconds / total),
        Text('${remaining.inMinutes}:${(remaining.inSeconds % 60).toString().padLeft(2, '0')}'),
      ],
    );
  },
)

Custom formatter #

MyTimer(
  duration: const Duration(minutes: 5),
  formatter: (d) => '${d.inSeconds} seconds left',
)

Format presets #

API reference #

MyTimer #

MyTimerController #

Migrating from 1.x #

The 1.x API is preserved under deprecated names — your existing code keeps compiling, but you should switch to the new names:

The biggest under-the-hood improvement: the timer is now drift-free and survives app backgrounding. Previously, tickInSecond of 500ms would cause the displayed seconds to count twice as fast as real time — that's now fixed. See the full CHANGELOG for details.

Contributing #

Issues and PRs welcome at https://github.com/Priyanshu-techind/my_timer.

License #

MIT