Skip to content

shivanshthapliyal/meridian

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Meridian - World Clock

A lightweight, beautiful world clock that lives in your macOS menu bar. Under 1 MB download. Zero dependencies — pure Apple frameworks.

Meridian — macOS menu bar world clock demo

Install

Download (recommended)

Grab the latest .dmg from the Releases page. Open it, drag Meridian.app to /Applications, and launch.

Build from source

git clone https://github.com/shivanshthapliyal/meridian.git
cd meridian
swift build -c release

See DEVELOPMENT.md for more details.

Features

  • Menu bar app — lives in your menu bar with an optional inline time display
  • Liquid Glass UI — native macOS Tahoe frosted glass cards, buttons, and badges
  • Analog clock faces — miniature working clocks with day/night styling
  • Swipe actions — swipe left on any zone to copy, set as menu bar display, or delete
  • Inline search — search 60+ timezones or convert times (e.g. "3pm PST")
  • Time-travel slider — scrub forward/backward up to 12 hours in configurable steps
  • DST indicators — see which zones are in daylight saving time with transition warnings
  • Smart day labels — Today, Yesterday, Tomorrow relative to your local time
  • 12h / 24h toggle — switch time format from the footer or right-click menu
  • Pin popover — keep the clock open while you work
  • Menu bar time — show any timezone's time right in the menu bar
  • Auto-resize — popover adapts to your number of zones (up to 5, then scrolls)
  • Launch at login — toggle from the right-click menu
  • Keyboard shortcutCmd+Shift+W to toggle from anywhere
  • Update check — lightweight GitHub release check, no bloatware
  • Persistent settings — zones, order, format, and preferences survive restarts

Usage

Action How
Open/close Left-click the globe icon or Cmd+Shift+W
Settings Right-click the globe icon
Add timezone Click + or type in the search bar
Remove a zone Swipe left > Delete, or use edit mode
Reorder zones Click the pencil icon, then drag
Set menu bar time Swipe left > Menu Bar
Copy a zone's time Swipe left > Copy, or click the row
Time travel Drag the slider
Change step size Use the step picker in the footer (5m/15m/30m/1h)
Toggle 12h/24h Click the format button in the footer
Pin open Click the pin icon
Quit Right-click > Quit Meridian

Requirements

Requirement Minimum
macOS 26.0 (Tahoe)
Architecture Apple Silicon and Intel

License

MIT

About

A lightweight, beautiful world clock for your macOS menu bar - built with SwiftUI.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages