Radial & Linear

The Modern Way to Select Time Ranges

Time Span Selector Icon

Time Span Selector

A highly customizable, elegant Android library for selecting time durations. Featuring both Circular (Radial) and Linear designs with full Material 3 support.

Library Features

Built for performance, precision, and ease of integration.

🕒

Dual Layouts

Includes both Circular (clock-like) and Linear (slider-like) selectors to fit any application design or UX requirement.

🌓

Overnight Support

Seamlessly handles spans that cross midnight. Perfect for sleep trackers, work shifts, and flexible alarm settings.

🎨

Fully Customizable

Control every detail: colors, widths, tick marks, labels, and even custom thumb drawables to match your brand identity.

📏

Step Intervals

Configure snap-to-grid intervals (1, 5, 15, or 30 minutes) for precise selection and a better user experience.

Implementation Guide

Get the library running in your project in minutes.

1

Add Dependency

Add the JitPack repository to your build file and include the implementation line in your app-level build.gradle.

2

Declare in XML

Add CircularTimeSpanSelector or LinearTimeSpanSelector to your layout file with desired attributes.

3

Style with Attributes

Use app:tss_spanColor, app:tss_trackWidth, and app:tss_is24HourFormat to customize the visual appearance.

4

Handle Listeners

Implement OnSpanChangeListener in your Activity or Fragment to receive real-time updates as the user interacts with the UI.