https://github.com/blackswandevcom/jalalidate-macos

A minimalist macOS menu bar app that displays the current Jalali (Persian) date alongside the Gregorian date.
https://github.com/blackswandevcom/jalalidate-macos

jalali-calendar jalali-date macos macos-app

Last synced: about 1 month ago
JSON representation

A minimalist macOS menu bar app that displays the current Jalali (Persian) date alongside the Gregorian date.

Host: GitHub
URL: https://github.com/blackswandevcom/jalalidate-macos
Owner: blackswandevcom
Created: 2024-11-03T15:30:41.000Z (6 months ago)
Default Branch: main
Last Pushed: 2025-03-23T20:26:59.000Z (about 2 months ago)
Last Synced: 2025-03-23T21:22:13.025Z (about 2 months ago)
Topics: jalali-calendar, jalali-date, macos, macos-app
Language: Swift
Homepage: https://www.linkedin.com/posts/activity-7258891206804340738-QoHv
Size: 24.6 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: readme.md

Awesome Lists containing this project

README

# [Jalali Date Toolbar for macOS](https://github.com/blackswandevcom/jalaliDate-macOS)
Developed by **[AmirhpCom](https://amirhp.com/)** at [BlackSwanDev.Com](https://blackSwanDev.com)

### 📅 Introduction
The Jalali Date App is a lightweight macOS menu bar application that displays the current date in the Jalali (Persian) calendar alongside the Gregorian date. Designed to be simple and non-intrusive, it’s the perfect companion for users who need quick access to both Persian and Western calendars directly from their Mac’s menu bar.

### 🎉 Version 6.0 (2025-03-23 | 1404-01-03)
This release brings powerful new features and quality-of-life improvements:

- **Date Converter View**: Convert dates across Jalali (Persian), Gregorian, and Islamic (Hijri) calendars with a live, side-by-side view.
- **Copy with One Click**: Instantly copy any calendar’s date by clicking on it — both from the main menu and inside the converter view.
- **Islamic (Arabic/Hijri) Calendar**: Now this app Supports 3 calendar types: Gregorian, Jalali & Hijri

- **Hijri Offset Control**: Fine-tune the Islamic (Hijri) calendar by applying a custom day offset between -4 and +4.
- **Compact Buttons with Icons**: Optimized toolbar button size and appearance for a cleaner interface.
- **Fully Open Source**: As always, this app remains 100% free and open under GPL v3.

### 🚀 Key Features
+ Displays the current Jalali (Persian) date and Gregorian date in the macOS menu bar.
+ Automatic light/dark mode adaptation to match macOS appearance settings.
+ Minimalist design with Persian typography for an authentic touch.
+ Quick copy: Copy either the Jalali or Gregorian date to your clipboard with a single click.

### 🔑 Installation Guide
1. Download the .dmg File: Download the latest release from the Releases section.
1. Open the .dmg: Double-click the downloaded .dmg file to mount it.
1. Drag to Applications: Drag the Jalali Date App icon into your Applications folder.
1. Run the App: Open the app from your Applications folder. You may need to grant permission to run it as it’s from an unidentified developer.

## 📥 Installation Instructions
1. **Download the `.dmg` File**: Get the latest version of the Jalali Date App `.dmg` file from the [Releases](https://github.com/blackswandevcom/jalaliDate-macOS/releases) section.
2. **Open the `.dmg`**: Double-click the downloaded `.dmg` file to mount it.
3. **Drag to Applications**: In the window that opens, drag the **JalaliDateApp** icon into the **Applications** folder shortcut.
4. **Eject the `.dmg`**: Once the app is installed, you can eject the `.dmg` by right-clicking it on your desktop or in the Finder sidebar and selecting **Eject**.
5. Your Jalali Date App is now installed and ready to use!

### 🛠 How to Use
1. Launch the App: After installation, run the app from the Applications folder or open it directly.
2. Menu Bar Display: The current Jalali date will be displayed in the menu bar. Click on the icon to access additional options.
3. Copy Dates: From the menu, click on any date (Jalali or Gregorian) to copy it directly to your clipboard.
4. About and Support: Click on the “About” option in the menu for more information on the app and the developer.

### 💻 Compatible Devices
- Operating System: macOS 10.15 (Catalina) or later
- Hardware: Compatible with Intel and Apple Silicon (M1/M2) Macs
- Appearance: Supports macOS light and dark modes

### ⚠️ Disclaimer
This app is provided as-is without any guarantees or warranties. Please verify all date data accuracy if used for critical purposes. The developer does not assume responsibility for any inaccuracies or errors that may occur in the displayed Jalali or Gregorian dates.

### 📜 Copyleft
This project is open-source and licensed under the GNU General Public License v3.0. You are free to use, modify, and distribute this software, provided that any copies or derivative works are also licensed under the same GPL terms.

### 👤 About the Developer
This app is developed by **[Amirhp.Com](https://amirhp.com/)**, a software developer passionate about creating tools for the Persian-speaking community. If you have any suggestions or encounter issues, feel free to reach out via GitHub Issues.

### ✨ Contributions
> Contributions are welcome! If you’d like to contribute, please fork the repository and create a pull request. You can also open an issue for any suggestions or bug reports.

### 🌐 Additional Resources
- [Jalali Calendar (Persian Calendar) Wikipedia](https://en.wikipedia.org/wiki/Jalali_calendar)
- [macOS Development Documentation](https://developer.apple.com/documentation/)

### 📸 Screenshots

|date-converter|month-table|setting|about|
|---|---|---|---|
||| setting | about |