93 lines
3.4 KiB
Markdown
93 lines
3.4 KiB
Markdown
# 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 a folder `CoBiEClock.wdgt` which you can
|
||
double‑click to install on macOS.
|
||
|
||
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!
|