TickTray ⏱

A tiny countdown timer that lives in your Windows system tray: one click to start, and it alerts you when time is up.

English · العربية

⬇ Download TickTray.exe

---

English

Goal

Sometimes all you need is a quick timer: coffee on the stove, a break between work sessions, a reminder in 20 minutes. No heavy app, no window taking over your screen. TickTray stays quietly in the system tray, shows the remaining time when you hover over its icon, and alerts you with a sound and a notification when time is up.

Features

• 🖱️ One click: left-click the tray icon to start the timer; click again to pause or resume.
• 🔵 Live icon: the icon shows the minutes left (or hours, e.g. 2h, past 99 minutes) inside a ring that shrinks as time runs out, so you see it without hovering.
• 🔢 Digits only: hover to see the countdown, e.g. 19:36, always in Western digits (0-9).
• ⚡ Quick times: 5 / 10 / 25 / 45 minutes, or a custom time that the app remembers.
• 🕒 Until a clock time: pick a time of day (e.g. 14:30); if it already passed today, the timer aims at tomorrow.
• ➕ +5 minutes: extend a running or paused timer without starting over, up to your maximum duration.
• 🏷️ Named timers: give a timer a name such as "Coffee"; it appears in the tray tooltip and in the notification.
• 🔔 Repeating alarm: the alarm keeps sounding until you stop it, and gives up on its own after 60 seconds.
• 💾 Survives a restart: the timer keeps its place when you close and reopen the app; if it ended while closed, you get the finished mark and a notification.
• ⌨️ Ctrl+Alt+T: start, pause or resume from any program without touching the tray.
• 😴 Snooze: click the notification (or pick "Snooze" from the menu) when time is up.
• 🌐 Arabic and English: switch the language from Settings (menus, notifications and windows, right-to-left for Arabic). The first run follows your Windows language.
• ⚙️ Modern settings: animated window with light and dark themes; configure default duration, snooze length, maximum duration, alert sound and language.
• 🚀 Start with Windows: optional auto-start at sign-in.
• 🛡️ Single instance: running it twice never creates a second icon.
• 🪶 Lighter EXE: unused Qt modules are left out of the build (about 26 MB instead of 38 MB).
• ⏳ Accurate: time is computed from a fixed deadline, so it does not drift over long durations.

What's new in 0.3.4

• Arabic interface fixes: the until-a-time field showed 08:27 as 27:08 in right-to-left, minute counts now use the correct singular/dual/plural («5 دقائق», «20 دقيقة»), the 5-minute entry reads «إضافة 5 دقائق», and the system tray is called what Windows calls it — «منطقة الإشعارات».
• Signed EXE with the publisher name Ali Alhumedi, both in the file properties and in the Authenticode signature.
• Full interface pass over both themes, the tray menu, the dialogs and the notifications.

Download and run

1. Go to Releases and download TickTray.exe.
2. Run it directly: no installer, no admin rights. The icon appears in the system tray (it may be behind the ^ arrow).
3. Right-click the icon to open the menu.

Note: the EXE carries an Authenticode signature (SHA-256, timestamped) with a self-signed certificate, so Windows shows the publisher name but does not trust it by default. SmartScreen may still warn on first run. Click "More info", then "Run anyway".

Settings are stored in %APPDATA%\TickTray\config.json, and the error log in TickTray.log next to it.

Run from source

python -m venv venv
venv\Scripts\pip install -r requirements.txt
venv\Scripts\python main.py

Build the EXE (the file version shown in Windows properties comes from version.py):

venv\Scripts\python tools\make_version_info.py
venv\Scripts\pyinstaller TickTray.spec

The output is dist\TickTray.exe. The icon is drawn entirely in code by tools/make_icon.py (requires Pillow).

Project layout

File	Role
main.py	Tray icon, menu and timer
config.py	Loading, validating and saving settings; start with Windows
i18n.py	Arabic / English strings
settings_dialog.py	Settings window, animation and toggle switches
tray_icon.py	Live tray icon rendering
version.py	Single source of the version number
tools/	Icon generator and version-resource generator

License

Released under the MIT License: free to use, modify and share.

Tags

#TickTray #Timer #CountdownTimer #SystemTray #Windows #Windows11 #PyQt6 #Python #Productivity #Pomodoro #Arabic #RTL #Bilingual

---

العربية

الهدف

أحياناً كل ما تحتاجه عدّاد سريع: قهوة على النار، استراحة بين جلسات العمل، أو تذكير بعد 20 دقيقة. لا تحتاج تطبيقاً ثقيلاً ولا نافذة تشغل الشاشة. TickTray يبقى هادئاً في منطقة الإشعارات، ويُظهر لك الوقت المتبقي بمجرد أن تمرّ بالفأرة على أيقونته، ثم يُنبّهك بصوت وإشعار عند الانتهاء.

المميزات

• 🖱️ نقرة واحدة: نقرة يسار على الأيقونة تبدأ العداد، ونقرة أخرى توقفه مؤقتاً أو تستأنفه.
• 🔵 أيقونة حيّة: تعرض الأيقونة نفسها الدقائق المتبقية (أو الساعات مثل 2h إذا تجاوزت 99 دقيقة) داخل حلقة تتناقص مع الوقت، فتراها دون المرور بالفأرة.
• 🔢 أرقام فقط: عند مرور الفأرة يظهر العدّ التنازلي مثل 19:36، وبأرقام غربية (0-9) دائماً.
• ⚡ أوقات سريعة: 5 / 10 / 25 / 45 دقيقة، أو وقت مخصص يتذكّره البرنامج.
• 🕒 حتى الساعة: اختر وقتاً محدداً (مثل 14:30)؛ وإن كان قد مضى اليوم يحسبه للغد.
• ➕ +5 دقائق: مدّد العداد أثناء العمل أو الإيقاف المؤقت دون البدء من جديد، وحتى الحد الأقصى.
• 🏷️ اسم للمؤقت: أعطِ المؤقت اسماً مثل «القهوة» فيظهر في التلميح وفي الإشعار.
• 🔔 تنبيه متكرر: يستمر الصوت حتى توقفه بنفسك، ويتوقف وحده بعد 60 ثانية كحد أقصى.
• 💾 يبقى بعد إعادة التشغيل: يحفظ المؤقت مكانه عند إغلاق البرنامج وفتحه؛ وإن انتهى أثناء الإغلاق تجد علامة الانتهاء وإشعاراً.
• ⌨️ Ctrl+Alt+T: ابدأ أو أوقف مؤقتاً أو استأنف من أي برنامج دون الوصول إلى منطقة الإشعارات.
• 😴 تأجيل: عند انتهاء الوقت انقر الإشعار (أو اختر «تأجيل» من القائمة) لتأجيل التنبيه.
• 🌐 عربي وإنجليزي: بدّل اللغة من الإعدادات (القوائم والإشعارات والنوافذ، ومن اليمين إلى اليسار في العربية). في أول تشغيل يتبع لغة Windows لديك.
• ⚙️ إعدادات عصرية: نافذة بحركة انسيابية، تدعم الوضعين الفاتح والداكن، وتتحكم في المدة الافتراضية ومدة التأجيل والحد الأقصى وصوت التنبيه واللغة.
• 🚀 تشغيل مع Windows: خيار لبدء البرنامج تلقائياً عند تسجيل الدخول.
• 🛡️ نسخة واحدة فقط: لا تتكرر الأيقونة إن شغّلته مرتين.
• 🪶 ملف أخف: تُستبعد وحدات Qt غير المستخدمة من البناء (نحو 26 MB بدل 38 MB).
• ⏳ دقيق: يحسب الوقت من موعد انتهاء ثابت، فلا يتراكم عليه انحراف مع طول المدة.

الجديد في 0.3.4

• إصلاحات الواجهة العربية: حقل «حتى الساعة» كان يعرض 08:27 بالشكل 27:08 في الاتجاه من اليمين إلى اليسار، وصيغ الدقائق صارت تتبع العربية («5 دقائق»، «20 دقيقة»)، وبند التمديد صار «إضافة 5 دقائق»، ومنطقة النظام صارت تُسمّى بمصطلح Windows نفسه «منطقة الإشعارات».
• ملف موقَّع باسم الناشر Ali Alhumedi، في خصائص الملف وفي توقيع Authenticode معاً.
• فحص كامل للواجهة في الوضعين الفاتح والداكن، وللقائمة والحوارات والإشعارات.

التحميل والتشغيل

1. افتح صفحة Releases وحمّل TickTray.exe.
2. شغّله مباشرة، فلا يحتاج تثبيتاً ولا صلاحيات مدير. ستجد الأيقونة في منطقة الإشعارات (قد تكون خلف السهم ^).
3. انقر بيمين الفأرة على الأيقونة لفتح القائمة.

تنبيه: الملف موقَّع رقمياً (SHA-256 ومختوم بالوقت) بشهادة موقّعة ذاتياً، لذلك تُظهر Windows اسم الناشر لكنها لا تثق بالشهادة تلقائياً. قد يعرض SmartScreen تحذيراً عند أول تشغيل. اختر «مزيد من المعلومات» ثم «تشغيل على أي حال».

تُحفظ إعداداتك في %APPDATA%\TickTray\config.json، وسجل الأخطاء في TickTray.log بجانبه.

التشغيل من المصدر

الأوامر نفسها الموضحة في القسم الإنجليزي أعلاه (pip install -r requirements.txt ثم python main.py). وللبناء: python tools\make_version_info.py ثم pyinstaller TickTray.spec. الناتج في dist\TickTray.exe، ورقم الإصدار الظاهر في خصائص الملف مصدره version.py. وتُرسم الأيقونة بالكامل من الكود عبر tools/make_icon.py (يحتاج Pillow).

الترخيص

مرخّص بموجب MIT: يمكنك استخدامه وتعديله ومشاركته بحرية.

الوسوم

#TickTray #Timer #CountdownTimer #SystemTray #Windows #Windows11 #PyQt6 #Python #Productivity #Pomodoro #Arabic #RTL #عداد #مؤقت #الإنتاجية #أدوات_ويندوز