Skip to content

Quickstartguide.md

Latest commit

 

History

History
344 lines (260 loc) · 8.02 KB

Quickstartguide.md

File metadata and controls

344 lines (260 loc) · 8.02 KB
Raw

Quick Start Guide

First Time Setup (5 minutes)

1. Install Prerequisites

Install Node.js:

Install Build Tools (Required for macOS stealth mode):

# Open Terminal and run:
npm install --global node-gyp

This takes 2-5 minutes. Wait for it to complete.

2. Install & Configure

# Navigate to project folder
cd /Users/aravindrao/Developer/Cheats/H2-NewV1

# Install dependencies (takes 3-5 minutes first time)
npm install

# Copy config template and edit
cp config.example.json config.json
nano config.json

Get API Keys (choose one or more):

Gemini (Free - Recommended):

  1. Go to: https://aistudio.google.com/app/apikey
  2. Click "Create API Key"
  3. Copy the key

Groq (Free - Fast):

  1. Go to: https://console.groq.com/keys
  2. Create API key
  3. Copy the key

OpenAI (Paid):

  1. Go to: https://platform.openai.com/api-keys
  2. Create API key
  3. Copy the key

Edit config.json:

{
  "geminiApiKey": "your-gemini-key-here",
  "geminiModel": "gemini-2.5-flash-lite",
  
  "groqApiKey": "your-groq-key-here", 
  "groqModel": "meta-llama/llama-4-scout-17b-16e-instruct",
  
  "openaiApiKey": "your-openai-key-here",
  "openaiModel": "gpt-4o-mini"
}

3. Launch

Option A: With Console (Recommended for first time)

npm start

Option B: Double-click launcher

  • Double-click launch.command

Option C: Silent mode (no console window)

  • Run ./launch-silent.sh

Usage

Basic Workflow

  1. Start the app (launch.command or npm start)
  2. Look for: ✅ macOS stealth mode applied in console
  3. Open your coding test
  4. Press Command+Shift+S when viewing a question
  5. Wait 3-10 seconds for AI response
  6. Copy the answer from the overlay

Keyboard Shortcuts

Shortcut Action
Command+Shift+S Take screenshot & get answer
Command+Shift+A Multi-page mode (for long questions)
Command+Shift+O Hide/Show overlay (instant toggle)
Command+Shift+M Drag mode (reposition window)
Command+Shift+R Reset (clear current answer)
Command+Shift+Q Quit app

Hide/Show Behavior

Command+Shift+O works like this:

First press (Hide):

  • ✅ Everything disappears instantly
  • ✅ Screen is completely clean
  • ✅ App still running in background
  • ✅ If processing, continues in background

Second press (Show):

  • ✅ Everything comes back
  • ✅ Previous answer still there (if you had one)
  • ✅ Banner shows current state
  • ✅ Buttery smooth toggle

While Hidden:

  • ✅ Can still take screenshots (Command+Shift+S)
  • ✅ Processing happens in background
  • ✅ Press Command+Shift+O to see result when ready

Multi-Page Questions

For questions spanning multiple images:

  1. Press Command+Shift+A (first page)
  2. Press Command+Shift+A (second page)
  3. Press Command+Shift+A (third page)
  4. Press Command+Shift+S (finalize & process)

Limits:

  • Gemini: Up to 16 images
  • Groq: Up to 5 images
  • OpenAI: Up to 10 images

Troubleshooting

"Window appears in screenshots"

  1. Check console for ✅ macOS stealth mode applied
  2. If not there, run: npx electron-rebuild
  3. Restart the app

"API Error" or "Rate Limit"

  • App automatically tries other providers
  • Check console to see which provider is being used
  • Consider adding multiple API keys for redundancy

"Processing forever"

  • Wait up to 20 seconds (timeout limit)
  • If timeout, try Command+Shift+R to reset
  • Check internet connection

"App won't start"

# Rebuild native modules
npx electron-rebuild

# Reinstall dependencies
rm -rf node_modules
npm install

Tips & Tricks

1. Use During Processing

You can hide the app while it's processing:

  • Take screenshot: Command+Shift+S
  • Immediately hide: Command+Shift+O
  • Continue your test
  • Show when ready: Command+Shift+O

2. Quick Reset

  • Command+Shift+R instantly clears everything
  • Useful when moving to next question

3. Drag Positioning

  • Press Command+Shift+M to enable drag mode
  • Click and drag the overlay to reposition
  • Press Command+Shift+M again to lock position

4. Multiple Providers

Configure one or more API keys for maximum reliability:

{
  "geminiApiKey": "your-gemini-key",
  "groqApiKey": "your-groq-key",
  "openaiApiKey": "your-openai-key"
}

App automatically tries providers in order and falls back if one fails.

Getting API Keys

Gemini (Free - Recommended)

Groq (Free - Fast)

OpenAI (Paid)

Windows Setup (Alternative)

If you're on Windows instead of macOS, follow these steps:

1. Install Prerequisites

Install Node.js:

Install Build Tools (Required for Windows stealth mode):

# Open PowerShell as Administrator and run:
npm install --global windows-build-tools

This takes 5-10 minutes. Wait for it to complete.

2. Install & Configure

# Navigate to project folder
cd C:\path\to\H2-NewV1

# Install dependencies (takes 3-5 minutes first time)
npm install

# Copy config template and edit
copy config.example.json config.json
notepad config.json

Get API Keys (choose one or more):

Gemini (Free - Recommended):

  1. Go to: https://aistudio.google.com/app/apikey
  2. Click "Create API Key"
  3. Copy the key

Groq (Free - Fast):

  1. Go to: https://console.groq.com/keys
  2. Create API key
  3. Copy the key

OpenAI (Paid):

  1. Go to: https://platform.openai.com/api-keys
  2. Create API key
  3. Copy the key

Edit config.json:

{
  "geminiApiKey": "your-gemini-api-key-here",
  "geminiModel": "gemini-2.5-flash-lite",
  
  "groqApiKey": "your-groq-api-key-here", 
  "groqModel": "meta-llama/llama-4-scout-17b-16e-instruct",
  
  "openaiApiKey": "your-openai-api-key-here",
  "openaiModel": "gpt-4o-mini"
}

3. Launch (Windows)

Option A: With Console (Recommended for first time)

npm start

Option B: Double-click launcher

  • Double-click launch.bat

Option C: Silent mode (no console window)

  • Double-click launch-silent.vbs

Windows Keyboard Shortcuts

Shortcut Action
Ctrl+Shift+S Take screenshot & get answer
Ctrl+Shift+A Multi-page mode (for long questions)
Ctrl+Shift+O Hide/Show overlay (instant toggle)
Ctrl+Shift+M Drag mode (reposition window)
Ctrl+Shift+R Reset (clear current answer)
Ctrl+Shift+Q Quit app

Windows Troubleshooting

"Window appears in screenshots"

  1. Check console for ✅ Windows stealth mode applied
  2. If not there, run: npx electron-rebuild
  3. Restart the app

"API Error" or "Rate Limit"

  • App automatically tries other providers
  • Check console to see which provider is being used
  • Consider adding multiple API keys for redundancy

"Processing forever"

  • Wait up to 20 seconds (timeout limit)
  • If timeout, try Ctrl+Shift+R to reset
  • Check internet connection

"App won't start"

# Rebuild native modules
npx electron-rebuild

# Reinstall dependencies
rmdir /s node_modules
npm install

Advanced: Silent Background Mode (Windows)

Create a Windows Task to auto-start on login:

  1. Open Task Scheduler
  2. Create Task → Name: "H2-NewV1"
  3. Trigger: At log on
  4. Action: Start program
  5. Program: wscript.exe
  6. Arguments: "C:\path\to\H2-NewV1\launch-silent.vbs"
  7. Run whether user is logged in or not
  8. Hidden

Now it starts automatically and invisibly!

Safety & Ethics

Remember this tool is for educational purposes to demonstrate flaws in current assessment systems.

Using it in actual interviews is:

  • ❌ Unethical
  • ❌ Against terms of service
  • ❌ Potentially illegal
  • ❌ Harmful to your career development

Use responsibly.