⚡ NoteKar Android

The Sovereign, Offline-First Timestamp & Focus Companion for Android

Instant Tap Logging • Two-Way Intervals • Obsidian & Calendar Sync • 100% Private

---

     

---

Important

🚀 Official Release Hub & Active Development

This repository is the official home for all NoteKar Android version releases, APK packages, community localizations, and feature updates.

📦 **Download Official APKs **: GitHub Releases Page 🌐 **Companion Web App **: notekarapp.vercel.app • Web Source Repo

---

🧭 Table of Contents

• ✨ Why NoteKar?
• 📸 Visual UI Gallery
• 🌟 Core Features & Highlights
• 🌉 System Bridges & Automation
• 🛡️ Privacy, Security & Hardware Protection
• 🌐 Multilingual & Global Community
• 🛠️ Tech Stack & Architecture
• 🤖 F-Droid & Reproducible Build Compliance
• 💻 Building & Running Locally
• 🔑 Release Signing & Keystore Setup
• ☕ Support & Community
• 📄 License & Attribution

---

✨ Why NoteKar?

In an era of bloatware, mandatory account logins, cloud tracking, and battery-draining telemetry, * NoteKar* is engineered as an uncompromising, sovereign utility.

┌──────────────────────────────────────────────────────────────────────────────┐
│  ⚡ ZERO-FRICTION LOGGING  │  Tap anywhere on the glass to log timestamps.   │
│  🛡️ 100% OFFLINE-FIRST     │  AES-256 encrypted Hive database. Zero cloud.   │
│  🧘 TIME REFLECTION        │  Mindful breathing alarms on lockscreen.        │
│  🌉 SYSTEM BRIDGES         │  Obsidian MD live export, .ICS calendar sync.   │
│  🌱 SOBRIETY COMPANION     │  21 neuroscience milestones with peak cards.    │
│  📱 HOME SCREEN WIDGET     │  2x2 native Android widget for 1-tap capture.   │
└──────────────────────────────────────────────────────────────────────────────┘

---

📸 Visual UI Gallery

Designed with an obsession for Apple Human Interface Guidelines (HIG), dynamic tactile feedback, fluid 120 FPS transitions, and OLED-perfect pitch black surfaces.

Welcome & Onboarding	VIP Sovereign Theme	Permissions Setup	Home Log Canvas	History & Timeline
Zero-friction start	Champagne gold palette	Transparent privacy controls	Instant tap canvas	Rich moment telemetry

Settings Dashboard	Security & Biometrics	Knowledge & Guides	Analytics & Heatmaps	Proactive Reminders
24 modular tools	Biometric & PIN vault	Offline FAQs & manuals	Interactive habit trends	Doze-friendly alarms

---

🌟 Core Features & Highlights

⚡ 1. Instant Timestamp Engine

• One-Tap Glass Capture: Tap anywhere on the main screen to immediately capture exact timestamps with custom tactile haptic pulses.
• Dual Operating Modes:
  • Single Mode: Rapid one-shot timestamp counter (00 to 99) with automatic rollover, optional daily reset, and "Count on Save" badges.
  • Two-Way Mode: Track deep work, study, workouts, or shifts by recording distinct IN and OUT interval pairs with duration computations.
• Interactive iOS-Style Calendar Picker: Date navigation with iOS red circle selectors, moment count event dots, and single-letter weekday headers.

🌱 2. Sobriety Companion & Milestone Map

• 21 Neuroscience-Backed Milestones: Track habits and clean streaks across 34 narrative themes ( Science, Warrior, Samurai, Anime, Cyberpunk, and more).
• Shareable Milestone Peak Cards: Render high-resolution PNG celebratory milestone cards with 1-tap sharing via the native Android share sheet.
• Physics-Based Confetti: 85-particle celebration engine with 3D paper flutter, gravity dynamics, and low-end hardware fallbacks.
• Urge Surfing Breathing Companion: Guided 4-7-8 breathing circle to conquer cravings and practice nervous system regulation.
• Streak Shields: Emergency protection mechanics preventing accidental streak resets.

🧘 3. Hourly Time Reflection & Mindfulness

• Standalone Lockscreen Breathing Alarms: Full-screen breathing prompts that display directly over the lockscreen without unlocking your device or exposing private logs.
• Active Hours & Sleep Protection: Configure daily active windows (e.g. 09:00 AM – 10:00 PM) with overnight rollover protection.
• Apple HIG Cupertino Wheel Time Picker: Smooth wheel selector for scheduling reflection reminders and check-in intervals.
• Customizable Affirmation Mantra: Display a 60-character personal mantra directly on the breathing aura display.

📱 4. Android Home Screen Widget (2x2)

• Fast, battery-efficient App Widget to log moments and check streak milestones directly from your Android launcher without opening the app.

---

🌉 System Bridges & Automation

NoteKar functions as an extensible bridge between your Android OS, note-taking vaults, calendars, and automation engines.

graph TD
    A[External Android Environment] -->|notekar:// URL Schemes| B(NoteKar Engine)
    A -->|ACTION_PROCESS_TEXT Highlight| B
    A -->|ACTION_SEND Share Sheet| B
    A -->|Tasker Broadcast am broadcast| B
    B -->|Export .md| C[Obsidian / Logseq / Notion Vault]
    B -->|Export .ics| D[Google / Outlook / Apple Calendar]
    B -->|AES-256 Hive Encrypted| E[Local Private Storage]

Loading

🔗 1. Deep Linking URL Schemes (notekar://)

Trigger actions from NFC tags, browser bookmarks, or home screen shortcuts:

Action	URL Scheme Pattern	Description
Quick Log	notekar://log?type=single&note=Coffee	Logs an instant single moment
Check-In	notekar://in?note=Focus%20Work	Starts a Two-Way tracking interval
Check-Out	notekar://out?note=PR%20Merged	Closes the active Two-Way interval
Draft Note	notekar://note?text=Quick%20Idea	Opens composer prefilled with text
Open Screen	notekar://open?page=history	Navigates directly to History, Stats, or Settings
Breathe	notekar://reflect	Launches the Time Reflection breathing sheet

📝 2. Global Text Selection Menu (ACTION_PROCESS_TEXT)

Highlight any snippet in Chrome, WhatsApp, Twitter/X, Kindle, or Books and select "Log in NoteKar" from the system popup menu to capture quotes instantly offline.

📤 3. Native Share Target (ACTION_SEND)

Send text, URLs, and articles from any app directly to NoteKar with automatic title parsing and timestamp attribution.

📓 4. Obsidian & Logseq Markdown Live Export

Generate clean Markdown journal files formatted with date grouping, session tables, and daily telemetry:

# NoteKar Journal
## 📅 Sunday, August 30, 2026
| Time | Type | Details / Note |
|---|---|---|
| 09:00:15 AM | 🟢 **IN** | Deep Work: Rust Backend |
| 11:30:20 AM | 🔴 **OUT** | Completed Compiler Architecture |
| 02:15:00 PM | ⚡ **SINGLE** | Team sync & architecture review |

🗓️ 5. Calendar Session Exporter (RFC 5545 .ics)

Convert tracked Two-Way intervals into standard .ics calendar files with 1-tap import into * Google Calendar, Outlook, Samsung Calendar, and Proton Calendar*.

🤖 6. Tasker, MacroDroid & Termux Broadcast API

Execute offline background logging via Android intent broadcasts:

# Log single moment via ADB or Tasker
am broadcast -a app.notekar.notekar.ACTION_LOG_MOMENT --es type single --es note "Deep Work"

# Check-in Two-Way interval
am broadcast -a app.notekar.notekar.ACTION_LOG_MOMENT --es type in --es note "Study Session"

# Check-out Two-Way interval
am broadcast -a app.notekar.notekar.ACTION_LOG_MOMENT --es type out --es note "Finished Chapter 4"

---

🛡️ Privacy, Security & Hardware Protection

NoteKar operates on a strict Zero Knowledge / Sovereign Data architecture:

• 🔒 AES-256 Hardware Encryption: All logs and timestamps are stored in a local Hive NoSQL database encrypted with keys generated inside the Android Keystore System.
• 🛡️ Biometric & PIN Vault: Protect app access with fingerprint/face unlock and SHA-256 salted PIN codes.
• 👁️ Recent App Obfuscation: Android FLAG_SECURE prevents screenshots and masks contents in the app switcher.
• 🚫 Zero Analytics & Zero Network Calls: No telemetry scripts, no third-party trackers, no Firebase, and no account creation requirements.
• 💾 1-Tap Offline Data Portability: Complete backup, restore, and JSON/CSV export without cloud dependencies.

---

🌐 Multilingual & Global Community

NoteKar is committed to universal accessibility with full native offline localization:

🌟 Officially Supported (7 Live Languages)

Flag	Language	Native Name	Code	Numbers	Status
🇬🇧	English	English	en	Standard	✅ Complete
🇫🇷	French	Français	fr	Standard	✅ Complete
🇪🇸	Spanish	Español	es	Standard	✅ Complete
🇮🇳	Hindi	हिन्दी	hi	Devanagari (०-९)	✅ Complete
🇩🇪	German	Deutsch	de	Standard	✅ Complete
🇯🇵	Japanese	日本語	ja	Standard	✅ Complete
🇷🇺	Russian	Русский	ru	Standard	✅ Complete

🚀 50+ Target Community Languages Initiative

We welcome contributions for Arabic, Portuguese, Italian, Chinese (Simplified/Traditional), Korean, Turkish, Dutch, Polish, Swedish, Indonesian, Vietnamese, Thai, Ukrainian, Greek, Bengali, Marathi, Telugu, Tamil, Gujarati, Urdu, Kannada, Malayalam, Punjabi, Swahili, and more!

👉 Read our 3-Step Translation Guide (TRANSLATIONS.md)

---

🛠️ Tech Stack & Architecture

Layer	Technology	Details
Language	Dart & Kotlin	Type-safe reactive codebase
Framework	Flutter (^3.12.0)	High-performance 120 FPS rendering
Local Storage	Hive	AES-256 encrypted NoSQL key-value store
State Management	Reactive Singletons & ValueNotifiers	Ultra-low memory overhead
Design System	Custom Apple HIG & iOS 26 High-Radius Style	Dynamic glass, haptics, and AMOLED dark mode
Hardware Compatibility	Android 5.0+ (API Level 21+)	Doze-compliant, low-end device adaptive engine

📂 Directory Architecture

Notekar - Flutter/
├── .github/workflows/          # Enterprise CI/CD (Lint, Test Coverage, Release Builds)
├── android/                    # Native Android platform layer & Alarm receivers
│   └── app/src/main/kotlin/    # MainActivity.kt, NoteKarAppWidgetProvider.kt
├── lib/
│   ├── dialogs/                # Apple HIG modal bottom sheets & dialogs
│   │   └── settings/           # 24 modular settings pages (Bridges, Backups, Icons, etc.)
│   ├── l10n/                   # ARB translation files & static multilingual dictionaries
│   ├── models/                 # Domain models (Moment, Palette, SobrietyTheme, Backup)
│   ├── screens/                # Core views (NoteKarHome, WelcomeScreen)
│   ├── services/               # Decoupled services (NotificationEngine, UpdateService)
│   ├── utils/                  # Cryptography, moment repository, and sync services
│   └── widgets/                # Reusable UI widgets (PressableScale, IosPillToast, Glass)
├── versions/                   # Structured JSON version archive (changelog.json)
└── test/                       # 100% passing unit and widget test suites

---

🤖 F-Droid & Reproducible Build Compliance

NoteKar Android complies with all official F-Droid free software guidelines:

• ✅ 100% Free & Open Source: Licensed under the OSI-approved MIT License.
• ✅ No Proprietary Dependencies: Zero Google Play Services, Firebase SDKs, or proprietary binaries.
• ✅ Zero Telemetry: No tracking libraries, analytics SDKs, or advertising code.
• ✅ Structured Fastlane Metadata: Included in fastlane/metadata/android/en-US/.

---

💻 Building & Running Locally

Prerequisites

1. Flutter SDK (^3.12.0 or higher).
2. Android Studio with Android SDK (API 21+).
3. Connected Android device with USB Debugging enabled or an active Android Emulator.

Setup & Run

# 1. Clone the repository
git clone https://github.com/dheeraz101/Notekar-Android.git
cd "Notekar - Flutter"

# 2. Install Flutter packages
flutter pub get

# 3. Run the test suite
flutter test

# 4. Launch on your connected device
flutter run

---

🔑 Release Signing & Keystore Setup

Note

Keystore secrets (*.jks, key.properties) are excluded from Git for security.

To generate a signed release APK or App Bundle (.aab):

1. Generate a signing keystore:

   keytool -genkey -v -keystore android/app/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload

2. Create android/key.properties:

   storePassword=<your-store-password>
   keyPassword=<your-key-password>
   keyAlias=upload
   storeFile=upload-keystore.jks

3. Build the production release APK:

   flutter build apk --release

   The generated APK will be output to build/app/outputs/flutter-apk/app-release.apk.

---

☕ Support & Community

If NoteKar brings calm and focus to your daily workflow, consider supporting its open-source journey:

  

• 🛡️ Privacy Policy
• 📜 Terms of Service
• 🐛 Report Issues & Feature Ideas
• 📖 Version Changelog (CHANGELOG.md)

---

📄 License & Attribution

• License: Distributed under the MIT License.
• Initiative: Proudly created under the * *YABP (Yet Another Boring Project) ** initiative.
• Developer: Dheeraz
• Made with ❤️ in India.