⚡ NoteKar Android

The Sovereign Time Instrument & Existential Compass for Android

Daily 24h Conscious Accounting • The Cost of the Void • Seamless Focus • 100% Private & Offline

---

     

---

Important

"NoteKar has revisioned itself."
Moving beyond a minimalist clicker, NoteKar elevates into an existential compass: accounting for finite human conscious hours, confronting the cost of the unaccounted void, and perfecting sensory chronometer craft. Every second is accounted for; the void is revealed.

---

🛡️ Core Pillars of Trust & Data Sovereignty

🔒 100% Offline-First	🚫 Zero Telemetry	⚡ Sensory Chronometer	💾 True Data Sovereignty
Runs completely air-gapped on your device. Zero servers, zero account sign-ins, zero cloud round-trips.	Zero Google Analytics, zero Firebase, zero crash trackers, zero advertising SDKs. Completely verifiable.	Optically centered tall Bebas Neue numerals with responsive haptic feedback and instant glass tap.	Stored in an ACID-compliant local Isar database. 1-tap export to JSON, CSV, .ICS, and Obsidian Markdown.

---

📸 Visual UI Gallery

Welcome & Onboarding	Sovereign Themes	Privacy Controls	Home Chronometer	Life Ledger History
Zero-friction start	OLED dark & themes	Transparent security	Instant tap canvas	Connected moments

Settings Dashboard	Security & Biometrics	Offline Guides	Analytics & Trends	Proactive Alarms
24 modular tools	Biometric PIN vault	Offline documentation	Interactive trends	Doze-friendly alarms

---

🌟 Flagship Features

⏱️ 1. Spatial Chronometer & Classic Sovereign Design

• Optical Midpoint Centering: Mathematically positioned at the display's optical midpoint, eliminating vertical optical bias.
• Authentic Bebas Neue Numerals: Offline bundled tall typography (assets/fonts/BebasNeue-Regular.ttf) scaled to 144pt tabular figures.
• One-Tap Glass Capture: Tap anywhere on glass to record timestamps with responsive tactile haptic pulses.
• Dual Operating Modes: Single one-shot counters (00–99) or Two-Way (IN / OUT) interval tracking with unbroken continuity.
• Classic 2000s Sovereign Craft: Classic tactile God Mode insignia, Matrix Phosphor Terminal, Kindle E-Ink Paperwhite, and AMOLED Pitch Black themes.

⏳ 2. Universal Interval Ledger (UIL) & Life Audit

• Multi-Track Category Interval Reconstruction: Independent multi-track state machine prevents cursor collisions across overlapping categories (Deep Work, Rest & Recovery, Study).
• Midnight Slicing (Zero Orphan Endpoints): Intelligently slices intervals crossing midnight at 23:59:59.999 so each day receives exact proportional conscious hours with zero severed endpoints.
• $O(N \log N)$ Interval Union: Merges concurrent claims, giving conscious Rest & Recovery precedence over unmonitored background voids.
• 24-Hour Conscious Accounting: Partitions every solar day into: $$\text{Total Day (24h)} = \text{Sleep} + \text{Logistics} + \text{Conscious Window}$$
• The Cost of the Void: Quantifies unrecorded waking time lost to unintentional drift: $$\text{Unaccounted Void} = \text{Conscious Window} - \text{Logged Focus Sessions}$$
• 6 Temporal Horizons: Inspect your intentionality ratio across Today, Weekly (7d), Monthly (30d), Half-Quarterly (45d), Half-Yearly (180d), and Planetary Yearly (365d).

🎙️ 3. Multimodal Media, Multi-Photo Import & Voice Waveforms

• Multi-Photo Import (Up to 5 Photos): Attach up to 5 photos simultaneously to any note or moment. Features high-speed camera captures, multi-file gallery selection, thumbnail preview grids, and a full-screen swipeable photo lightbox.
• Dynamic Amplitude Waveform Visualizer: Real-time microphone amplitude metering bar animation while recording voice notes, confirming active voice input.
• Full-Width Voice Notes Player & Scrubber: Interactive audio player pill spanning 100% card width with 1:1 finger waveform scrubbing, elapsed/remaining time counters, 20-bar completion lighting, and 1x / 1.5x / 2x speed cycling with zero paused-state playback leakage.
• Silent Share Intake & Instant Storage: Share up to 5 photos, web links, or text snippets from any Android app directly into NoteKar. Content is logged silently in the background with the exact timestamp and attached to a standalone moment without interrupting your current workflow or opening the app.

📜 4. Life Ledger Timeline & Collapsible Media Cards

• Top-Aligned Continuous Rail Nodes: Single-entry number circles mathematically aligned with card headers, ensuring pristine vertical continuity even on tall cards with media and long notes.
• Dedicated Daily Wrap-up & Day Sealing: Full-screen daily summary view accessible from history timeline sheets, featuring focus distribution, day pacing, tactile day sealing, and celebratory milestone animations.
• Interactive Note Preview Links & Safe Departure: Render rich markdown text in previews with clickable links protected by a native Cupertino departure confirmation warning before opening external websites.
• Persistent Live Session Undo with Acoustic Click: 2-way sessions provide a persistent undo action until dismissed, accompanied by tactile haptics and an audible acoustic click sound on tap.
• Side-by-Side Dual Pill Row: Photo and voice attachment pills collapse gracefully onto a unified single line, maximizing viewport efficiency.
• Connected Session Pairing: Automatically connects chronological IN and OUT moments into fluid session cards with duration pills.
• Robust Rest & Recovery Lifecycle: Strict active-day bounding ensures historical logs never persist as zombie live sessions while preserving instant 1-tap live termination.
• Undo Safety Bed: Solid red swipe-to-delete backing with a 5-second Dynamic Island countdown undo pill.
• iOS-Style Calendar Sheet: Fluid calendar sheet with solid iOS System Red selection rings, past-date jumps, and event dots.

📱 5. Apple HIG Android Home Screen Widgets

• Minimal Sobriety Widget: Clean Apple-inspired live counter showing days clean alongside live-ticking hours, minutes, and seconds via native Chronometer with zero background battery drain. Tap anywhere to open Sobriety settings, or tap Reset to instantly log a relapse.
• Instant Camera Logging Widget: Home screen widget featuring a live preview thumbnail of your last logged photo and a prominent 1-tap camera button to capture and log photo moments in a fraction of a second.
• Quick Logging & Life Audit Widgets: Full-width interactive widgets to log single moments, start/stop sessions, write quick notes, and monitor waking intentionality ratios.

📢 6. Official Bulletins & Feature Showcase

• Zero-Telemetry Official Bulletins: Stay informed with announcements fetched from NoteKar's static GitHub feed. Completely tracker-free, styled with high-contrast Apple monochrome black & white cards and buttons.
• Interactive Feature Spotlight: WhatsApp Status-style feature showcase feed informing users about new features and updates directly in-app without noisy push notifications.
• Seamless Deep-Link Actions: Tapping a bulletin action directly opens the respective in-app destination (e.g. page:sobriety, page:audit, page:plus_note, page:camera, or settings:<category>).

📊 7. Executive Intelligence Hub & Health Balance

• Cognitive Work-to-Rest Ratio: Tracks focus hours against restorative intervals with Apple Health-style balance indicators (🟢 Balanced, 🟡 High Intensity, 🔴 Rest Deficit).
• Dynamic Burn-Down Velocity: Compares actual completion rate against elapsed days with real-time status pills (🟢 +18% Ahead of Pace, 🟡 On Pace, 🔴 Deficit Rising).
• Flow State Quality Index: Analyzes focus session distribution: Deep Focus ($\ge 45\text{m}$), Flow Blocks ($20\text{–}44\text{m}$), and Fragmented Bursts ($<20\text{m}$).
• Rest Gap Recovery Rate: Measures conscious voids redeemed via Rest & Recovery vs. unmonitored loss.
• 90-Day Streaks Heatmap & Circadian Bias: Visual activity density grid and circadian hourly breakdown across Morning, Afternoon, Evening, and Night.

🎯 8. Target & Goals Engine with Screen-Wide Confetti

• Active Goal Selection: Dedicated Target & Goals selector directly inside persistent notifications, home screen widgets, and target cards.
• Intentional Pacing & Live Deficit: Real-time burn-down tracking displaying elapsed focus hours against remaining deficits (14h 20m / 20h • 5h 40m to go).
• Screen-Wide Confetti & Audio Fanfare: Full-screen confetti explosion and celebratory audio fanfare whenever a goal target is reached.

🔎 9. Search Notes Full-Text & Multimodal Index

• Unified Multimodal Search: High-performance full-text search indexing text notes, voice memos, photo attachments, and single/2-way moments.
• Direct Inline Playback & Tap-to-Edit: Play voice memos, preview photo attachments, and tap the prominent Edit button for instant note refinement.

🌱 10. Sobriety Companion & Fast Relapse Reset

• Home Screen Glass Capsule: Touch and hold the home screen sobriety capsule to open configuration settings.
• 21 Neuroscience Milestones: Track habits and clean streaks across 34 narrative themes (Science, Samurai, Cyberpunk, etc.).
• Immediate Widget & Relapse Synchronization: Log #relapse directly inside note tags or tap the widget's Reset button to instantly synchronize your clean streak across the app, home screen widget, and persistent notifications.
• Urge Surfing Breathing Guide: Guided 4-7-8 breathing circle to conquer cravings and regulate the nervous system.
• Streak Shields: Emergency protection mechanics preventing accidental streak resets.

⌛ 11. End of Support Screen & Developer Quest Easter Egg

• 365-Day Sovereign Life Cycle: If an installation hasn't received updates for 365+ days, NoteKar presents a full-screen Apple HIG card thanking the user for using NoteKar and providing direct links to the open-source GitHub repository.
• Diagnostics Quest Easter Egg: Tapping the build number 7 times on the Diagnostics page unlocks the secret developer quest and presents the End of Support preview screen.

---

📦 Release Channels & Versioning Architecture

NoteKar employs a rigorous multi-tier release architecture catering to all user reliability needs:

+-------------------------------------------------------------------------------+
|                           NOTEKAR RELEASE TIERS                               |
+-------------------------------------------------------------------------------+
| 1. Stable Release (SR)       | Production-ready, fully verified milestone.    |
|    Format: x.y.z             | e.g. 8.0.0                                     |
+------------------------------+------------------------------------------------+
| 2. Priority Release (PR)     | Rapid stabilization & critical engine patches. |
|    Format: x.y.0             | e.g. 8.1.0                                     |
+------------------------------+------------------------------------------------+
| 3. Beta Release (BR)         | Public feature previews for testers.           |
|    Format: x.y.z             | e.g. 8.1.1                                     |
+------------------------------+------------------------------------------------+
| 4. Experimental Release (ER) | Bleeding-edge features; high-risk early tests. |
|    Format: x.y.zE[n]         | e.g. 8.1.1E1, 8.1.1E2 (resets to E1 on base)   |
+-------------------------------------------------------------------------------+

• User-Centric Previews: The Experiment channel gives you immediate access to brand-new features and design improvements as they are built, weeks before public release.
• Comprehensive Update Coverage: Subscribers receive every update instantly across all release tracks—from stable releases to instant preview builds.
• Apple HIG Risk Disclosure Screen: Switching to the Experiment channel presents a full-screen Apple-inspired modal clearly explaining what to expect, with options to Backup Data First, Cancel, or I Understand & Enable Channel.

---

⚖️ Why NoteKar vs. Traditional Trackers?

Dimension	Traditional Trackers (Toggl, Clockify)	NoteKar Android
Privacy & Telemetry	Cloud sync, tracking pixels, telemetry SDKs	100% Offline-First, Zero Telemetry
Account Requirement	Mandatory email, phone, or Google sign-in	Zero Accounts, Immediate Use
Capture Latency	Multi-screen forms, category pickers	1-Tap Glass Instant Capture
Conscious Accounting	Passive duration totals	Life Audit & Cost of the Void
Data Storage	Remote proprietary cloud database	Local Isar DB + SharedPreferences
Data Portability	Rate-limited exports, vendor lock-in	Full JSON, CSV, .ICS & Obsidian MD
Cost & Freedom	Tiered monthly subscriptions	100% Free & Open Source (MIT)

---

🌉 System Bridges & Integrations

flowchart LR
    External["External Environment<br/>(Tasker, NFC, Share Sheet)"] -->|notekar:// URL & am broadcast| App["⚡ NoteKar Engine<br/>(Local Isar DB)"]
    App -->|Export .md| Obsidian["Obsidian / Logseq Vault"]
    App -->|Export .ics| Calendar["Google / Apple / Outlook Calendar"]
    App -->|Export .json / .csv| Backup["Air-Gapped Local Backups"]

Loading

🔗 Deep Linking URL Schemes (notekar://)

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

🤖 Tasker, MacroDroid & Termux Automation Broadcast API

[!NOTE] The automation broadcast receiver requires explicit opt-in under Settings → Integrations → Automation Broadcast API and includes replay attack protection (op_id).

# Log a single moment via ADB or Tasker
am broadcast -a app.notekar.notekar.ACTION_LOG_MOMENT --es type single --es note "Deep Work" --es op_id "$(date +%s)"

# Check-in a Two-Way focus interval
am broadcast -a app.notekar.notekar.ACTION_LOG_MOMENT --es type in --es note "Study Session" --es op_id "$(date +%s)"

# Check-out a Two-Way interval
am broadcast -a app.notekar.notekar.ACTION_LOG_MOMENT --es type out --es note "Finished Chapter 4" --es op_id "$(date +%s)"

---

🛠️ Tech Stack & Directory Architecture

Layer	Technology	Details
Language	Dart & Kotlin	Type-safe reactive codebase
Framework	Flutter (^3.12.0)	High-performance 60-120 FPS rendering
Typography	Bebas Neue (OFL)	Bundled offline tall chronometer font
Local Storage	Isar & SharedPreferences	Fast, ACID-compliant local database engine
Design System	Custom Apple HIG & iOS 26 High-Radius Style	Dynamic glass, haptics, and AMOLED dark mode
Platform Target	Android 5.0+ (API Level 21+)	Doze-compliant, 3-tier adaptive hardware engine

Notekar - Flutter/
├── android/                    # Native Android layer, App Widgets & Broadcast Receivers
├── assets/fonts/               # Bundled authentic Bebas Neue tall chronometer font
├── fastlane/metadata/          # Structured Play Store metadata & changelogs
├── lib/
│   ├── dialogs/                # Apple HIG modal bottom sheets, Life Audit & Goals
│   ├── l10n/                   # 7 offline locales (EN, HI, ES, FR, DE, JA, RU)
│   ├── models/                 # Domain models (Moment, Palette, SobrietyTheme)
│   ├── screens/                # Core screens (NoteKarHome, WelcomeScreen)
│   ├── services/               # Decoupled services (NotificationEngine, UpdateService)
│   └── widgets/                # Reusable UI widgets (ClockFace, PressableScale, Glass)
├── screenshot/                 # High-resolution showcase banner
└── test/                       # 100% passing unit, widget & sensory test suites

---

💻 Building & Running Locally

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

# 2. Install Flutter packages
flutter pub get

# 3. Verify static analysis and test suite
dart analyze lib test
flutter test

# 4. Launch on your connected device or emulator
flutter run

🔑 Production Release Signing & Keystore Instructions

Keystore secrets (*.jks, key.properties) are strictly excluded from Git. To build a signed release APK:

1. Generate a 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 APK:

   flutter build apk --release

---

🌐 Multilingual & Global Community

NoteKar includes full native offline localization across 7 languages:

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

👉 Join our 50+ Target Community Languages Initiative (TRANSLATIONS.md)

---

☕ Support & Community

If NoteKar brings clarity and intentional focus to your daily existence, consider supporting its open-source journey:

  

• 🛡️ Privacy Policy • 📜 Terms of Service
• 🐛 GitHub Issues & Ideas • 📖 Changelog

---

📄 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.