Skip to content

QUICK_REFERENCE.md

Latest commit

 

History

History
240 lines (189 loc) · 5.19 KB

QUICK_REFERENCE.md

File metadata and controls

240 lines (189 loc) · 5.19 KB
Raw

Quick Reference Guide

Extension Workflow

1. Load CSV File
   ↓
2. Click Start
   ↓
3. Extension performs setup
   - Toggle Unlimited ON
   - Set Style → Realistic
   - Set Craziness → High
   - Save Settings
   - Select "Crazy Situation" preset
   ↓
4. Confirmation for Prompt #1
   ↓
5. Generate (if confirmed)
   ↓
6. Confirmation for Prompt #2 (if slot available)
   ↓
7. Generate (if confirmed)
   ↓
8. Wait 5 minutes → Check status
   ↓
9. If completed → Confirmation for next prompt
   ↓
10. Repeat until all prompts processed

CSV File Format

prompt
"Safari, small puppy barks and chases lion away, lion growls then backs off, tourists film handheld, tense natural sounds."
"Large man rides spirited horse polo-style, wildly sways as horse runs, swings mallet clumsily."

Rules:

  • Header row: prompt
  • One prompt per line
  • Quotes recommended
  • UTF-8 encoding

UI Elements

File Section

  • Choose CSV File: Opens file picker
  • File name: Shows selected file
  • Prompts count: Number of loaded prompts

Progress Section

  • Completed: Number of finished prompts
  • Total: Total prompts in CSV
  • Active: Currently generating (X/2)
  • Progress Bar: Visual progress indicator
  • Percentage: % complete

Status Section

  • Current Prompt: Text of active/next prompt
  • Status Message: Real-time updates and errors

Controls

  • Start: Begin automation
  • Pause: Pause (preserves state)
  • Reset: Clear all progress
  • Space: Toggle Start/Pause

Failed Prompts

  • Shows prompts that failed to generate
  • Automatically skipped
  • Logged for review

Keyboard Shortcuts

  • Space: Toggle Start/Pause (when popup open)

Status Messages

Info (Blue)

  • "Automation started..."
  • "Automation paused"
  • Status updates

Success (Green)

  • "Successfully loaded X prompts"
  • "Reset complete"
  • "Setup completed"

Error (Red)

  • "Invalid CSV format..."
  • "Please navigate to..."
  • "Failed to start automation"
  • Generation errors

Generation States

State Description
In Queue Waiting to start
In Progress Currently generating
Completed Video ready (no status text)
Failed Error occurred, skipped

Storage Keys

The extension stores:

  • prompts: All prompts from CSV
  • processedIndices: Completed prompts
  • currentIndex: Next prompt to process
  • activeGenerations: Number of active generations
  • activeSlots: Details of active generations
  • isPaused: Pause state
  • setupComplete: Initial setup done
  • failedIndices: Failed prompt indices

Typical Timeline

Action Time
Load CSV Instant
Initial setup ~10-15 seconds
Start generation ~5 seconds
Generation time ~10-20 minutes each
Status check Every 5 minutes
Confirmation wait Until user clicks

Common Scenarios

First Time Use

  1. Install extension
  2. Copy template_prompts.csv
  3. Edit with your prompts
  4. Open Higgsfield AI
  5. Load CSV in extension
  6. Click Start
  7. Confirm each prompt

Resume After Pause

  1. Open extension
  2. Click Start
  3. Continues from last position

Resume After Browser Restart

  1. Open Higgsfield AI tab
  2. Open extension
  3. Click Start
  4. Resumes automatically

Handle Failed Prompt

  • Extension automatically skips
  • Shows in "Failed Prompts" section
  • Continues with next prompt
  • No manual intervention needed

Complete All Prompts

  • Progress shows 100%
  • "All prompts completed!" message
  • Can Reset and start again
  • Can load new CSV

File Locations

Extension

/Users/chaitanya/Documents/HIGGSFIELD CHROME EXTENSION/

Template CSV

/Users/chaitanya/Documents/HIGGSFIELD CHROME EXTENSION/template_prompts.csv

Your CSV (recommended)

/Users/chaitanya/Documents/Prompt_List_Sora.csv

Browser Console Commands

Check current state

chrome.storage.local.get(null, (data) => console.log(data));

Clear all data

chrome.storage.local.clear(() => console.log('Cleared'));

Get specific value

chrome.storage.local.get('prompts', (data) => console.log(data.prompts));

Extension URLs

  • Extensions page: chrome://extensions/
  • Service worker: Click "Service worker" on extension card
  • Popup inspect: Right-click popup → Inspect

Tips

✅ DO

  • Load CSV before clicking Start
  • Respond to confirmations promptly
  • Monitor progress periodically
  • Keep Higgsfield AI tab open
  • Check Console for errors

❌ DON'T

  • Close Higgsfield AI tab during automation
  • Manually interfere with page during automation
  • Load new CSV while automation running
  • Change browser settings mid-automation
  • Disable notifications

Performance

  • Recommended prompts per session: 10-50
  • Memory usage: ~50-100 MB
  • CPU usage: Minimal (only during checks)
  • Network: Only Higgsfield AI requests
  • Storage: ~1 KB per 10 prompts

Permissions

All permissions explained:

  • storage: Save your progress
  • tabs: Find Higgsfield AI tab
  • alarms: Schedule 5-min checks
  • notifications: Confirmation dialogs
  • higgsfield.ai: Automate the page

Privacy: Nothing leaves your computer.