# CoBiE Time System Calendar

An interactive web app that visualizes the **CosmoChron Binary Epoch (CoBiE)** time system alongside standard UTC/TAI clocks, complete with an explorable calendar of “Eonstrip” periods and detailed breakdowns of cosmic time units.

## Features

- **Live CoBiE Clock**: Displays the current CoBiE timestamp, updating every second.
- **Analog Clock**: Full-screen clock with 16 hex markers and CoBiE hands.
- **UTC & TAI Display**: Shows both UTC and International Atomic Time (TAI) in human-readable format.
- **Timezone Selector**: Switch between UTC, TAI, or any IANA timezone.
- **Interactive Calendar**: Browse past and future Megasequences and Eonstrips with Prev/Next controls.
- **Tooltips**: Hover or click on an Eonstrip card to see start/end times and duration.
- **Manual Mode**: Enter any CoBiE timestamp to compare and calculate differences.
- **Time Breakdown**: View core units (Galactic Year → Second) and optional extended units (Astralmillennia → Universal Eon).
- **Responsive Design**: Adapts to mobile viewports with font scaling.
- **Modern UI**: Glassmorphism, gradient text, animated hover effects, and CSS-backed glows.

## Getting Started

### Prerequisites

- A modern web browser (Chrome, Firefox, Edge, Safari).

### Installation

1. **Clone the repository**  
   ```bash
   git clone https://github.com/your-username/cobie-time-system.git
   cd cobie-time-system
   ```

2. **Open in browser**
   Simply open `index.html` in your preferred browser:

   ```bash
   open index.html
   ```

   or double-click the file in your file manager.

## Usage

* **Live View**: On load, the app shows the current CoBiE time, UTC, and TAI.
* **Navigate Periods**:

  * ← / → buttons to move by Megasequence (hold modifier keys for larger jumps).
  * Swipe left/right (touch, mouse drag, or horizontal scroll) to perform the same navigation.
  * “Now” button to return to live mode.
* **Manual Mode**: Click the CoBiE time to enter an arbitrary timestamp; press Enter or click elsewhere to apply.
* **Compare Mode**: In manual mode, click the “Compare” field to set a second timestamp for difference calculations.
* **Toggle Units**: Use “Show Cosmic Units” to reveal extended time units.

## Project Structure

```
├── index.html       # Main HTML markup
├── analog.html     # Analog clock interface
├── clock.js        # Clock logic

├── style.css        # Separated styles
├── script.js        # JavaScript logic
├── README.md        # This documentation
└── assets/          # (Optional) images or external CSS/JS
```

## macOS Dashboard Widget

The repository includes a minimal Dashboard widget under
`macos-widget/`. A helper script `build-widget.sh` is provided to
package it automatically:

1. Run `./build-widget.sh` from the repository root.
2. The script creates `CoBiEClock.wdgt` which you can double-click to
   install.

The widget runs offline and shows the analog CoBiE clock on your
desktop.

## Contributing

1. Fork the repository.
2. Create your feature branch: `git checkout -b feature/YourFeature`.
3. Commit your changes: `git commit -m "Add YourFeature"`.
4. Push to the branch: `git push origin feature/YourFeature`.
5. Submit a Pull Request.

Please follow standard JavaScript style and include comments for new functionality.

## License

This project is released under the [WTFPL](LICENSE).
Feel free to use, modify, and distribute!