Skip to content

BTawaifi/Time-Master

Repository files navigation

⚑ Time Master: The Enforcer Node

Maintain the Laboratory. A high-performance, unforgiving productivity enforcer designed for engineers, architects, and deep-work practitioners. Built to replace passive tracking with strict environmental control and technical auditing.

Engine: Electron Frontend: React 19 Build: Vite Styling: TailwindCSS Platforms: Win | Mac


πŸ›‘ The Problem with Passive Tracking

Passive time trackers let you lie to yourself. They run in the background while you drift into shallow work. Time Master is built on the philosophy that friction is information. It doesn't just watch what you do; it forces your environment to align with your stated goals through aggressive focus protocols.


🧠 Core Operating Modes

1. Deep Work Focus

Every session begins with a Pre-Commitment (your "Bet"). You must define your goal before the timer engages. Upon completion, the app forces a rigorous 10-Point Audit to generate your Data Dossier, tracking everything from your Activity and Tangible Output to your Utility Score, Friction, and the Validity of your Hypothesis.

2. Neuro-Ledger (Latency Blocks)

A revolutionary multi-stream DAG architecture for managing complex, parallel tasks. Build infinite execution chains ("Neural Chains") that track your transition logs.

  • Multi-Stream Support: Seamlessly jump between primary and secondary streams when context-switching is necessary.
  • Node Linking: Assign specific link objectives at each stage of your workflow, capturing precisely where chains break or finalize.

3. Pomodoro Protocol

For classic, uninterrupted focus cycles. It automatically transitions between Focus and Rest blocks, maintaining a persistent tally of your completed runs to keep you in a flow state with zero friction.


πŸ”’ Aggressive Enforcement Systems

Time Master doesn't politely ask for your attention. It seizes it. You configure exactly how hostile the system becomes when a session ends or you go idle.

  • Kiosk Mode Override: The app can lock itself into a frameless, "Always on Top" layer, hijacking your screen above all IDEs and browsers until you review your session.
  • Desktop Eclipse: A dark overlay that progressively swallows your screen if you drift into idle time or ignore a session review.
  • Sonic Crescendo (Escalation): High-frequency synthetic tones (Sine β†’ Triangle β†’ Square β†’ Sawtooth) that exponentially scale in volume and irritation the longer you avoid a mandatory interaction.
  • Mantra Gate: You cannot simply click away a completed session. The app locks the interface until you physically retype your original session goal.

🎨 Avant-Garde Aesthetics & Visualization

Designed with Intentional Minimalism, rejecting generic bootstrapped layouts in favor of raw, dark-mode glassmorphism.

  • 20 Background Visualizers: Keep your interface alive with reactive effects including Neural Tracer Lattice, Singularity, Matrix Rain, Cellular Automata, and Cyberpunk Grid.
  • 13 Calibrated Themes: Switch between bespoke palettes like Void, Noir, Bloodline, Deep Sea, or dial in your own custom hex codes.
  • Audio Synthesizer Engine: Design your own cognitive triggers. Calibrate pitch frequencies (Hz), select waveforms, or use Stochastic Mode (randomized frequencies) to prevent auditory habituation.
  • Quick Notes Node: An instant scratchpad that drops into view for rapidly saving ideas to your ledger without breaking your current tracking context.

πŸ—„οΈ Data Dossier & Portability

Your work history is no longer a simple listβ€”it's a professional ledger.

  • Tiered Hierarchy: Quickly scan collapsed views featuring mini-badges for Focus depth, Energy levels, and Goal status.
  • Full CRUD Capabilities: Edit past recordings to refine insights or delete anomalies.
  • Portable JSON Node: Specify exactly where your data is saved. Switch between different log files for different projects, with instant auto-loading on selection.

πŸ› οΈ Installation & Build Guide

Development Environment

Make sure you have Node.js installed, then run:

# Install dependencies
npm install

# Start the dev environment (Vite frontend + Electron main process)
npm start

Production Build

Compile Time Master into a native standalone executable.

For Windows (NSIS & Portable):

npm run compile

For macOS (DMG & ZIP):

npm run compile:mac

The distributable binaries will be generated in the release/ directory.


πŸ“œ Philosophy: "Intentional Minimalism"

"Reduction is the ultimate sophistication."

Time Master uses bespoke layouts, asymmetry, and distinctive typography to create an environment where every element has a strict purpose. If a feature or visual element doesn't serve the focus protocol, it is eliminated.


Fuel the Protocol

Architected by BTawaifi

About

A firm focus tool that holds you to your word and verifies your results. πŸ†βš‘οΈπŸ

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages