Skip to content
gtxPrimePublic

About

TITS to help you in hard times

Resources

Contributing

Stars

11 stars

Watchers

0 watching

Forks

Repository files navigation

TITS Logo

TITS - Test Intelligence & Tutoring System

Everyone needs TITS during hard times. Undetectable, real-time AI copilot for exams, interviews, and technical problem solving.

Latest Version Stars Forks License Platform Downloads

Get it on GitHub

AboutAbout About TITS

Note

TITS (Test Intelligence & Tutoring System) is an open-source, client-side, Bring Your Own Key (BYOK) desktop intelligence platform. Engineered for seamless stealth, it provides sub-second contextual answers to multiple-choice and technical questions directly under your mouse cursor, alongside live conversational teleprompting during interviews and high-stakes meetings. Zero cloud intermediaries, zero subscription fees, and complete data privacy.


ComparisonComparison Dual Engine & Invisibility Comparison

TITS offers distinct capture pipelines and stealth feedback mechanisms tailored to your session constraints:

Feature / Capability Standard Screen Share / Proctored App TITS Stealth Invisibility Engine
Detection by Screen Share (Zoom/Teams/Meet/Discord) Full window visible to all call participants 100% Invisible (WDA_EXCLUDEFROMCAPTURE DWM bypass)
DXGI / BitBlt / Graphics.Capture Hooks Pixels captured into video stream buffer Compositor Passthrough (renders underlying desktop)
Screen Edge Indicator Can leak on shared display if active Suppressed in Hidden State (Zero visual footprint)
Taskbar / Notification Area Indicator Tray icons usually visible Transparent Idle Mode (100% invisible transparent tray icon)
Keyboard Hardware LED Indicator Not supported by recording software Physical Caps Lock Blinks (100% off-screen, zero pixels)
Audio Feedback System audio stream could be heard on call Earbud Sine Tones (discreet frequencies, zero mic leak)
Inference Privacy Cloud subscription relay with stored telemetry 100% BYOK & Local Storage (Zero telemetry, direct TLS 1.3)
Cost & Token Limits Monthly subscriptions & locked tokens Free Tier AI Studio / Groq (Unlimited private queries)

Stealth EngineStealth Engine Screen Share Invisibility & Capture Bypass

Native Windows Desktop Window Manager (DWM) composition bypass.

One of the most powerful capabilities of TITS is complete invisibility during live screen shares, technical interviews, and proctored sessions. When sharing your entire desktop display, meeting participants cannot see the application.

// Native Windows DWM API applied to TITS window handles
SetWindowDisplayAffinity(hwnd, WDA_EXCLUDEFROMCAPTURE);
  • Composition Layer Separation: When WDA_EXCLUDEFROMCAPTURE (0x00000011) is set, the Windows DWM rendering pipeline excludes the window surface from all screen capture textures.
  • Direct Frame Duplication Bypass: Screen sharing and proctoring utilities rely on DXGI OutputDuplication, BitBlt, GetDisplayMedia, or Windows.Graphics.Capture. When these APIs query desktop pixels, Windows composits the window beneath TITS instead.
  • Zero Visual Artifacts: To observers on the call or recording, your active screen appears completely untouched.

Screen Share Compatibility Matrix

Platform / Utility Full Desktop Screen Share Single Application Share Local Recording
Zoom Workplace Completely Invisible Invisible Invisible
Microsoft Teams Completely Invisible Invisible Invisible
Google Meet Completely Invisible Invisible Invisible
Discord Completely Invisible Invisible Invisible
Slack Huddles Completely Invisible Invisible Invisible
OBS Studio / Streamlabs Completely Invisible Invisible Invisible
Windows Game Bar (Win+G) Completely Invisible Invisible Invisible
Proctoring / Lockdown Software Excluded from desktop capture Excluded Excluded

FeaturesFeatures Core Features

StealthStealth Cursor-Targeted Vision Pipeline

Sub-second vision reasoning directly under your mouse pointer with zero screen detection.

  • Cursor Proximity Crop: Detects the physical monitor hosting your pointer and crops an optimized bounding box around your cursor instead of transmitting entire 4K buffers, cutting token latency by over 70%.
  • HiDPI Scaling Matrix: Automatically normalizes OS scaling factors (100%, 125%, 150%, 200%, 250%) to guarantee sharp optical recognition regardless of display density.
  • Multimodal Reasoning Core: Directly interfaces with Gemini 2.5 Flash, Gemini 1.5 Pro, and Groq Llama 3.2 Vision for instant question classification and option selection.

OutputOutput Multi-Channel Stealth Output Matrix

Multiple concurrent, discreet channels to receive answers under strict proctoring constraints.

  • System Tray Badge (A-Z): Renders answers directly into the taskbar notification area as crisp, high-contrast letter badges (A through Z and digits 0 through 9).
  • Transparent Idle Mode: In Settings, enable Transparent Tray When Idle. The tray icon becomes a 100% invisible transparent block when waiting for a question. It only reveals the letter badge once the answer is solved.
  • Capture-Excluded Floating HUD: A frameless, dark-mode overlay displaying the detected answer, confidence level, and step-by-step reasoning, completely invisible to screen shares.
  • Screen Edge Pulse: The perimeter of your monitor emits subtle visual blinks corresponding to the option letter (1 blink = A, 2 blinks = B, 3 = C, 4 = D, 5 = E).
  • Earbud Audio Cues: Discreet, low-amplitude sine wave frequencies delivered directly to headphones (1 tone = A, 2 tones = B), completely inaudible to room microphones.
  • Caps Lock Light (Hardware Stealth): Blinks or toggles your physical keyboard Caps Lock LED indicator for the answer (1 blink = A, 2 = B, 3 = C, 4 = D). Completely off-screen and 100% invisible to all screen recorders, video calls, or proctoring software. Test anytime with npm run test:capslock.

TriggersTriggers Execution & Trigger Controls

Precision hotkey listeners with zero mouse interference.

  • Global Remappable Hotkeys: Press Ctrl + Alt + Q (or Alt + Cmd + Q on macOS) from any active browser or exam window.
  • Strict Combination Key Filtering: TITS strictly triggers only on designated multi-key combinations, preventing regular clicks, drags, or single modifier presses from causing unwanted executions.

LocalizationLocalization Multi-Language Localization (i18n)

Built-in internationalization architecture with fallback and parameter interpolation.

  • Worldwide Translation Support: Ready-to-use dictionaries for English, Español (Spanish), 简体中文 (Simplified Chinese), and हिन्दी (Hindi) located in src/i18n/.
  • Extensible Locale Engine: Add any community dialect by dropping in a single JSON file without altering application code.

DiagnosticsDiagnostics Cross-Platform Diagnostics & Share Logs (logs.txt)

Comprehensive runtime inspection for debugging features across Windows, macOS, and Linux.

  • One-Click Share Logs Button: Available in Settings > Diagnostics & System Logs. Export logs.txt, copy full diagnostics to clipboard, or inspect live log lines inside the app.
  • Automated Capability Audit: Detects screen share invisibility mechanisms (WDA_EXCLUDEFROMCAPTURE on Windows, NSWindowSharingNone on macOS), display scale factors, loopback audio presence, CapsLock LED status, and AI API latency.

ExtensionExtension Browser Companion Extension (v1.0.0)

Manifest V3 companion extension for Chrome & Firefox: Universal paste unblocker, hostile listener shield, and natural human keystroke simulator.

Extension Version Manifest V3 Chrome & Firefox

  • Hostile Paste & Event Defeat: Strips hostile preventDefault() and stopImmediatePropagation() traps on paste, copy, and contextmenu. Unlocks locked instances in Ace, Monaco, and CodeMirror without altering buffer integrity.
  • Realistic Human Typing Paste: Simulates organic keyboard input with physical QWERTY typo engine, variable cadence jitter (±35%), and authentic backspace auto-correction.
  • Deep Shadow DOM & Terminal Traversal: Unlocks nested shadow trees across Google Cloud Console, Cloud Shell (xterm.js), and encapsulated web components.
  • Discreet Stealth UI: Ultra-minimalist 260px popup with innocent terminal glyph (>_), zero DOM badges, and emergency halt (Esc / Alt + X).

📖 Read the full companion guide & installation instructions: extension/README.md


HotkeysHotkeys Keyboard Shortcuts

All shortcuts can be reconfigured in Settings (BYOK):

Action Windows / Linux macOS Purpose
Solve Exam Question Ctrl + Alt + Q Alt + Cmd + Q Targets question near cursor and solves instantly
Toggle Visibility Ctrl + \ Cmd + \ Instantly hides or reveals the app window
Toggle Click-Through Ctrl + M Cmd + M Enables clicking through the app to background apps
Ask Next Step / Solve Ctrl + Enter Cmd + Enter Captures screen and requests AI follow-up
Previous Response Ctrl + [ Cmd + [ Navigates to previous AI response
Next Response Ctrl + ] Cmd + ] Navigates to next AI response
Scroll Response Up Ctrl + Shift + Up Cmd + Shift + Up Scrolls response content upward
Scroll Response Down Ctrl + Shift + Down Cmd + Shift + Down Scrolls response content downward
Emergency Erase & Quit Ctrl + Shift + E Cmd + Shift + E Immediately purges session from RAM and quits

Tech StackTech Stack Tech Stack & Architecture

TITS is built strictly following modern cross-platform desktop development practices:

  • Core Runtime: Electron 35, Chromium, Node.js
  • UI Component Layer: Lit Elements with custom Cyber Gold & Dark Zinc design system
  • Multimodal Vision: Google @google/genai (Gemini 2.5 Flash, Gemini 1.5 Pro) and Groq Llama 3.2 Vision
  • Stealth Display API: Windows Desktop Window Manager (SetWindowDisplayAffinity, WDA_EXCLUDEFROMCAPTURE)
  • Audio Engine: 16 kHz sample rate, non-blocking dual-stream capture, low-amplitude sine generator
  • Packaging & Distribution: Electron Forge, Squirrel.Windows, ZIP, DMG, AppImage

StructureStructure Project Structure

cheating-daddy
│
├── .github/
│   ├── ISSUE_TEMPLATE/        # Standardized bug, feature, and i18n issue templates
│   └── PULL_REQUEST_TEMPLATE  # Comprehensive PR submission checklist
│
├── src/
│   ├── assets/
│   │   ├── tray_icons/        # Pre-rendered 0-9, A-Z, and transparent taskbar icons
│   │   └── onboarding/        # Vector SVGs for first-run walkthrough
│   │
│   ├── components/
│   │   ├── app/               # TitsApp root container and AppHeader
│   │   └── views/             # ExamSolverView, CustomizeView, AssistantView
│   │
│   ├── i18n/
│   │   ├── index.js           # Lightweight lookup engine with fallback and interpolation
│   │   ├── en.json            # English dictionary
│   │   ├── es.json            # Spanish (Español) dictionary
│   │   ├── zh.json            # Chinese (简体中文) dictionary
│   │   └── hi.json            # Hindi (हिन्दी) dictionary
│   │
│   ├── utils/
│   │   ├── examSolver.js      # Vision extraction, options matching, and latency logs
│   │   ├── screenCapture.js   # Cursor-proximity bounding box cropping
│   │   ├── tray.js            # Dynamic Windows taskbar notification tray manager
│   │   ├── window.js          # Native DWM capture exclusion and window affinity
│   │   ├── screenPulse.js     # Edge blink indicator orchestrator
│   │   ├── capsLock.js        # Hardware CapsLock LED indicator controller
│   │   └── gemini.js          # Direct Google GenAI API communication
│   │
│   ├── index.js               # Main Electron process, IPC orchestrator, and hotkeys
│   ├── preload.js             # Context-isolated secure IPC bridge
│   └── storage.js             # Local encrypted configuration store
│
├── scripts/
│   ├── test_capslock.js       # Standalone CapsLock LED hardware test utility
│   └── test_stealth.js        # System Tray and Screen Ray live diagnostic utility
│
├── tests/                     # 67+ unit and integration tests (100% passing)
├── CONTRIBUTING.md            # Guidelines, architectural principles, and PR steps
├── LICENSE                    # GNU General Public License v3.0
└── package.json               # Manifest, dependencies, and build scripts

InstallationInstallation Installation & Build

Download Pre-Built Release

Download the latest pre-compiled installer or unpacked executable directly from GitHub Releases.

Building from Source

  1. Clone the repository:

    git clone https://github.com/gtxPrime/Tits.git
    cd Tits
  2. Install dependencies:

    npm install
  3. Start development mode:

    npm start
  4. Run hardware & unit tests:

    # Execute full test suite
    npm test
    
    # Test physical Caps Lock LED blinking sequence
    npm run test:capslock
    
    # Test live System Tray badge and Screen Ray edge pulse
    npm run test:stealth
  5. Package standalone distributions:

    # Build unpacked local binary
    npm run package
    
    # Build standalone installer
    npm run make

Compiled distributions will be located under out/make/.


Browser extension: installation and usage

The companion extension in extension/ runs independently or alongside the desktop app. It unlocks hostile copy/paste lockouts in code and text editors, realistically simulates human typing with backspace-corrected typos, and features a cross-device Two-Way Remote Peer Relay.

  • Chrome / Brave / Edge: extract the extension ZIP from the release, open chrome://extensions, enable Developer mode, and Load unpacked the extension folder.
  • Firefox: open about:debugging#/runtime/this-firefox, click Load Temporary Add-on..., and select extension/manifest.firefox.json (or switch with npm run ext:firefox).
  • Use: focus your target input or editor. Ctrl+V pastes normally; Alt+V force pastes; Alt+Shift+V starts simulated human typing; Esc / Alt+X immediately halts typing.
  • Two-Way Remote Peer Relay: connect two browsers or devices across your local network via shared Room Code (ws://<LAN_IP>:59432). User 2 types or pastes into the popup textarea and sends directly into User 1's active exam/editor tab with synchronized speed and typo settings.
  • Auto-Backspace Fix: authentic QWERTY neighbor typos with cognitive realization pause and automatic backspace erasure.
  • Rich-Text & Editor Support: Monaco (LeetCode, VS Code), Ace (HackerRank), CodeMirror, TinyMCE (OnlineNotepad.org, WordPress), and web terminals (xterm.js).

Full usage and troubleshooting · Extension README · Release Notes


RoadmapRoadmap Project Roadmap

  • Native DWM Invisibility: Bypass screen shares across Zoom, Teams, Meet, and Discord with WDA_EXCLUDEFROMCAPTURE.
  • Cursor-Targeted Smart Cropping: Instant localized screen bounds detection with HiDPI support.
  • Multi-Channel Stealth Outputs: Dynamic tray badge numbers/letters, edge blink pulse, earbud tones, and invisible idle tray mode.
  • Keyboard Hardware LED Indicator: Pulse Caps Lock LED for option answers (1=A, 2=B, 3=C, 4=D) with zero screen footprint.
  • Bring Your Own Key (BYOK): Zero subscription, client-side direct inference with Google Gemini and Groq.
  • Multi-Language Dictionaries: Integrated translation system with English, Spanish, Chinese, and Hindi.
  • Kernel-Level Input Guard [Coming Soon]: Low-level driver-level hook suppression for environments running aggressive ring-0 proctoring engines.
  • Local Offline Vision LLM: Native ONNX / WebGPU acceleration for completely offline question solving without internet access.
  • Hardware Bluetooth Earbud Morse Controller: Haptic vibration cue receiver for silent answer transmission.

ContributingContributing Contributing

Contributions are warmly welcomed! Feel free to report issues, suggest improvements, submit new translations, or open pull requests.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

See CONTRIBUTING.md for full architectural standards, testing workflows, and style rules.


StarsStars Star History

Star History Chart

AuthorAuthor Author & Maintainer

Engineered and maintained solely by gtxPrime.


LicenseLicense License

Distributed under the GNU General Public License v3.0. See LICENSE for more information.

Developed and maintained with precision by gtxPrime.

About

TITS to help you in hard times

Resources

Contributing

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages