Instant ISO Week Numbers, Calendar Tools & Android Home Screen Widget
Weeknum is a clean, modern, and lightweight utility app for instantly tracking ISO week numbers, calculating date ranges, exploring historical events for today, and placing a translucent glassmorphic widget directly onto your Android home screen.
Built entirely with Python and Flet, Weeknum delivers a smooth, cross-platform experience with native Android integration.
- Glassmorphic Design: Sleek 2×1 semi-transparent widget displaying the current week number and active date range.
- Auto Midnight Rollover: Automatically schedules updates at
00:00midnight viaAlarmManagerand listens to OS timezone and time change broadcasts. - Multilingual: Displays localized week labels (
Week/Εβδομάδα) matching your in-app language preference or device locale. - Instant Launch: Tap the widget anywhere to open the main app.
- Instant Week Calculation: Computes ISO 8601 week numbers and corresponding date ranges dynamically.
- Navigation Controls: Seamlessly jump to the previous or next week, or reset back to today with a single tap.
- Native DatePicker Dialogs: Tap the date range or the "What day is it?" button to select any date via a native Material calendar picker and inspect its day of the week or jump to its week.
- Complete UI translations for English (
en) and Greek (el). - Fast in-app language switcher accessible from the navigation drawer with persistent preference storage.
- Displays curated Wikipedia historical events and anniversaries for the current date.
- Smart offline caching (3-hour cache expiry) for instant startup and low network usage.
- Live real-time digital clock with a direct link to world time zones.
- Full-Screen Fluid Scroll: Unified single-scroll view combining controls and Wikipedia articles.
- SafeArea Protection: Adapts to system gesture bars and edge-to-edge Android displays (
avoid_intrusions_bottom). - Flexible Week Start: Configure week start days (Monday, Sunday, or Saturday) to match your work or regional calendar.
- Theme Support: Supports both Light and Dark modes.
Download the latest signed release from the GitHub Releases Page:
| Architecture | APK Binary | Description |
|---|---|---|
| ARM 64-bit | Weeknum-arm64-v8a.apk |
Recommended for modern Android phones/tablets |
| ARM 32-bit | Weeknum-armeabi-v7a.apk |
For older 32-bit Android devices |
| x86_64 | Weeknum-x86_64.apk |
For Android emulators and x86_64 devices |
| Universal | Weeknum.apk |
Universal package for all architectures |
-
Clone the repository:
git clone https://github.com/Twilight0/org.weeknum.git cd org.weeknum -
Create a virtual environment and install dependencies:
python -m venv .venv source .venv/bin/activate pip install -r requirements.txt # or: pip install flet requests wikipedia-api
-
Run the desktop app:
flet run src/main.py
-
Build Android binaries with native widget support:
python build_widget_app.py apk --split-per-abi
This project is licensed under the MIT License — see the LICENSE file for details.