A Gnome Extension for Ethiopian Calendar
EthCal GNOME Extension
✨ **EthCal GNOME Extension** ✨ - Customizable Ethiopian Calendar at your top bar
- 📅 Complete implementation of the Ethiopian calendar including holidays (public, religious, cultural) and fasting periods
- 🌐 Customizable calendar display language (Amharic/English)
- ⚙️ Optional Geez numerals support
- 🎨 Powerful token-based formatting system (`dday, mnam dd, year hh:mm`) for the top bar display with a help dialog and token reference including real-time formatting preview in the top bar
- 🪧 Month and Year picker for easy date selection
## Installation
### 🚀 One-Line Installation
**Download and install the latest release automatically:**
```bash
curl -fsSL
raw.githubusercontent.com | bash
```
**Or clone and install:**
```bash
git clone
github.com && cd EthCal && ./scripts/install.sh
```
**Options:**
```bash
./scripts/install.sh --help # Show help
./scripts/install.sh --local # Use local build instead of downloading
./scripts/install.sh --force # Force reinstall
```
**Installation Modes:**
- **Default**: Downloads latest release from GitHub (requires internet)
- **--local**: Uses locally built extension (run `./scripts/build.sh` first)
- **--force**: Reinstalls even if already installed
> **Note:** The script downloads the extension to `/tmp` and installs it. If you have no internet or prefer to use your local changes, use the `--local` option after running `./scripts/build.sh` first.
### Manual
1. Download the `.shell-extension.zip` from the latest release
2. Install using: `gnome-extensions install --force `
3. Restart GNOME Shell or log out/in
4. Enable the extension in GNOME Extensions app
5. Restart your vicinae server if it's running
## Development
### Overview
This extension uses a modern TypeScript-based development workflow with Bun and automated build scripts. The recommended setup involves:
- **Host machine* …