Skip to content

mnajib/time-compass-ext

Repository files navigation

Time Compass

A Firefox extension that provides a unique multilingual time visualization combining analog and digital clocks with compass directions in Arabic, Malay, and English.

Screenshot

Features

  • Multilingual Display: Compass directions in Arabic, Malay, and English
  • Multiple Time Formats:
    • 24-hour analog clock (red)
    • 12-hour analog clock (green)
    • Minute hand (blue)
    • Second hand (purple)
    • Digital time display (HH:MM:SS)
  • Date Information:
    • ISO format date (YYYY-MM-DD)
    • Month name
    • Day of the week
  • Customization:
    • Toggle 12-hour clock display
    • Toggle 24-hour clock display
  • Clean Interface:
    • Responsive design
    • Clear typography
    • Intuitive layout

Installation

  1. Download the extension from Firefox Add-ons (link coming soon)
  2. Click "Add to Firefox"
  3. Follow the installation prompts

Usage

  1. Click the Time Compass icon in your browser toolbar
  2. The time compass will open in a new tab
  3. Access settings by clicking the ⚙️ icon:
    • Toggle 12-hour clock display
    • Toggle 24-hour clock display

Development

To work on this extension locally:

  1. Clone the repository:
    git clone https://github.com/mnajib/time-compass-ext.git
  2. Open Firefox and navigate to about:debugging in address bar
  3. Click "This Firefox" > "Load Temporary Add-on"
  4. Select the manifest.json file in the extension's root directory

Upcoming Features

  • Automatic size adjustment based on display size
  • Timezone selection
  • Hijri (Islamic) calendar integration
  • Additional language support

License

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