marcoguada/mg-filament-timepicker

A Filament v5 plugin that enhances timepicker fields with a popup time selector.

v0.1.0 2026-03-07 19:15 UTC

Requires

• php: ^8.2
• filament/filament: ^5.0
• filament/forms: ^5.0
• spatie/laravel-package-tools: ^1.15.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.0
• nunomaduro/collision: ^8.0
• orchestra/testbench: ^9.0|^10.0
• pestphp/pest: ^3.7|^4.0
• pestphp/pest-plugin-arch: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0
• pestphp/pest-plugin-livewire: ^3.0|^4.0
• rector/rector: ^2.0
• spatie/laravel-ray: ^1.26

MIT

• Marco Guada

• laravel
• popup
• timepicker
• linear
• filament
• filament-plugin
• filamentphp
• marcoguada
• mg-filament-timepicker
• 24h
• 12h
• radial
• timepicker-popup
• timepicker-popup-linear
• timepicker-popup-radial

README

A Filament v5 plugin that enhances native TimePicker fields with a visual popup time selector.

Two styles are available: linear (vertical sliders) and radial (clock dial).

Requirements

• PHP 8.2+
• Filament v5

Installation

composer require marcoguada/mg-filament-timepicker

Usage

Chain the macros onto any native TimePicker field:

use Filament\Forms\Components\TimePicker;

TimePicker::make('start_time')
    ->popup(true)
    ->popupStyle('linear')   // 'linear' (default) or 'radial' ->popupStyle('radial')
    ->popupFormat(24)        // 24 (default) or 12
    ->format('H:i')
    ->displayFormat('H:i')
    ->seconds(false),

Macros

Macro	Default	Description
->popup(bool $enabled = true)	—	Activates the popup on the field
->popupStyle(string $style = 'linear')	'linear'	UI style: 'linear' or 'radial'
->popupFormat(int $format = 24)	24	Default hour format shown in the popup: 24 or 12

The user can toggle between 12h and 24h at any time from inside the popup.

Linear style

Vertical sliders for hours and minutes. Drag up/down to set the time.

Radial style

Classic clock dial. Drag the hour and minute handles around the clock face.

Translations

English and Italian are included out of the box. To publish the translation files for customization:

php artisan vendor:publish --tag="mg-filament-timepicker-translations"

Changelog

Please see CHANGELOG for recent changes.

Author

Marco Guada — marco-guada.com

License

The MIT License (MIT). Please see License File for more information.