Skip to content

JayeshVegda/Flow.Launcher.Plugin.WorldClock

Repository files navigation

Flow.Launcher.Plugin.WorldClock

A fast and efficient World Clock plugin for Flow Launcher that shows current time in cities around the world.

Features

  • Instant time lookup for major cities
  • Automatic timezone detection for any city
  • Smart caching system for faster repeated lookups
  • Parallel processing for improved performance
  • Support for 100+ major cities worldwide

Installation

  1. Download the latest release from the Releases page
  2. Extract the files to your Flow Launcher plugins directory:
    %APPDATA%\FlowLauncher\Plugins\Flow.Launcher.Plugin.WorldClock
    
  3. Install required Python packages:
    # Open PowerShell as Administrator
    cd "%APPDATA%\FlowLauncher\Plugins\Flow.Launcher.Plugin.WorldClock"
    python -m pip install -r requirements.txt
  4. Restart Flow Launcher

Usage

  1. Press Alt+Space to open Flow Launcher
  2. Type time followed by a city name:
    • time london
    • time tokyo
    • time new york

Supported Cities

The plugin comes with a built-in list of 100+ major cities, including:

  • Major US cities (New York, Los Angeles, Chicago, etc.)
  • European capitals (London, Paris, Berlin, etc.)
  • Asian cities (Tokyo, Beijing, Singapore, etc.)
  • Australian cities (Sydney, Melbourne, etc.)

For cities not in the built-in list, the plugin will automatically detect their timezone.

Performance

The plugin uses several optimization techniques:

  • In-memory caching with LRU cache
  • Persistent caching to disk
  • Parallel processing for faster lookups
  • Pre-computation of common cities

Requirements

  • Python 3.7 or higher
  • Required Python packages:
    • pytz
    • geopy
    • timezonefinder
    • flowlauncher

Troubleshooting

If you encounter any issues:

  1. Check the log file at:
    %APPDATA%\FlowLauncher\Plugins\Flow.Launcher.Plugin.WorldClock\worldclock.log
    
  2. Make sure all required packages are installed
  3. Try restarting Flow Launcher
  4. Open an issue on GitHub if the problem persists

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Created by Jayesh Vegda

About

Get current time in any city around the world

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages