Skip to content

INSTALLATION.md

Latest commit

 

History

History
175 lines (132 loc) · 4.69 KB

INSTALLATION.md

File metadata and controls

175 lines (132 loc) · 4.69 KB
Raw

Installation Guide

Quick Start

1. Install the Extension

  1. Open Google Chrome
  2. Navigate to chrome://extensions/
  3. Enable "Developer mode" using the toggle in the top-right corner
  4. Click "Load unpacked" button
  5. Navigate to and select the folder: /Users/chaitanya/Documents/HIGGSFIELD CHROME EXTENSION
  6. The extension will be installed and the icon will appear in your toolbar

2. Prepare Your Prompts CSV File

You can use the provided template or create your own:

Using the Template:

  • Copy template_prompts.csv to your Documents folder
  • Rename it to Prompt_List_Sora.csv
  • Edit it with your prompts

CSV Format:

prompt
"Your first prompt here"
"Your second prompt here"
"Your third prompt here"

Important:

  • First line must be: prompt
  • Each subsequent line contains one prompt
  • Use quotes around prompts (recommended)
  • Save in CSV format

3. Using the Extension

Step 1: Open Higgsfield AI

Step 2: Load Your CSV

  • Click the extension icon in Chrome toolbar
  • Click "Choose CSV File" button
  • Select your Prompt_List_Sora.csv file
  • Verify the prompt count appears

Step 3: Start Automation

  • Click the "Start" button
  • The extension will automatically:
    • Toggle "Unlimited" ON
    • Set Style to "Realistic"
    • Set Craziness to "High"
    • Click "Save Settings"
    • Select "Crazy Situation" preset

Step 4: Confirm Generations

  • You'll receive a browser notification for each prompt
  • Click "Yes" to generate
  • Click "No" to skip
  • The extension manages 2 parallel generations
  • Status is checked every 5 minutes

Step 5: Monitor Progress

  • Watch the progress bar in the extension popup
  • View completed/total/active counts
  • See current prompt being processed
  • Check failed prompts (if any)

Controls

  • Start: Begin automation (requires CSV loaded)
  • Pause: Pause automation (preserves state)
  • Reset: Clear all progress and start fresh
  • Keyboard: Press Space to toggle Start/Pause

Troubleshooting

Extension won't load

  • Make sure you're using Google Chrome (not Brave, Edge, etc.)
  • Check that "Developer mode" is enabled
  • Try reloading the extension in chrome://extensions/

CSV won't load

  • Verify file format (must be .csv)
  • Check first line is exactly: prompt
  • Ensure prompts are on separate lines
  • Try opening in a text editor to verify format

Automation won't start

Settings not applying

  • The page may have changed layout
  • Try manually setting up once first
  • Check Console for specific errors
  • Report if selectors need updating

Notifications not showing

  • Check Chrome notification permissions:
    • Chrome Settings → Privacy and security → Site Settings → Notifications
  • Ensure notifications are allowed for extensions
  • Check system "Do Not Disturb" is off

Generations stuck

  • The extension checks status every 5 minutes
  • If truly stuck, click Pause then Reset
  • Start again with fresh state

Debugging

To see detailed logs:

  1. Content Script Logs (page automation):

    • Open Higgsfield AI page
    • Press F12 to open DevTools
    • Go to Console tab
    • Look for messages from content script

  2. Popup Logs (UI):

    • Click extension icon to open popup
    • Right-click anywhere in popup
    • Select "Inspect"
    • Check Console tab

  3. Background Service Worker Logs:

    • Go to chrome://extensions/
    • Find "Higgsfield AI Automation"
    • Click "Service worker" link
    • View Console

Permissions Explained

The extension requires:

  • storage: Save prompts and progress locally
  • tabs: Detect active Higgsfield AI tab
  • alarms: Schedule 5-minute status checks
  • notifications: Show confirmation dialogs
  • higgsfield.ai: Access and automate the website

All data stays on your computer. Nothing is sent externally.

Uninstallation

  1. Go to chrome://extensions/
  2. Find "Higgsfield AI Automation"
  3. Click "Remove"
  4. Confirm removal

Your CSV files and Documents folder are not affected.

Support

If you encounter issues:

  1. Check the Console logs (see Debugging section)
  2. Verify CSV file format
  3. Ensure Higgsfield AI page hasn't changed layout
  4. Try with the provided template_prompts.csv first

Notes

  • The extension will remember your progress even if you close Chrome
  • You can pause at any time and resume later
  • Failed prompts are automatically skipped and logged
  • Maximum 2 parallel generations (Higgsfield AI limitation)
  • Each generation can take up to 20 minutes