Skip to content

chaitanyagiri/higgsfieldautomation

Repository files navigation

Higgsfield AI Automation Chrome Extension

A Chrome extension that automates video generation on Higgsfield AI by reading prompts from a CSV file and managing the generation queue.

Features

  • 📁 Load prompts from CSV file via file picker
  • ⚙️ Automatic initial setup (Unlimited toggle, Visual & Sound settings, Preset selection)
  • 🔄 Manage 2 parallel video generations
  • ⏱️ Automatic status checks every 5 minutes
  • 💾 Persistent state across browser sessions
  • 🎯 Semi-automatic operation with confirmations
  • 📊 Real-time progress tracking
  • ⚠️ Error handling with failed prompt tracking

Installation

  1. Open Chrome and navigate to chrome://extensions/
  2. Enable "Developer mode" (toggle in top-right corner)
  3. Click "Load unpacked"
  4. Select the HIGGSFIELD CHROME EXTENSION folder
  5. The extension icon will appear in your toolbar

Usage

Step 1: Prepare Your CSV File

Create a CSV file with the following 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."
  • First row must be the header: prompt
  • Each subsequent row contains one prompt
  • Quotes around prompts are optional but recommended for prompts with commas

A template file template_prompts.csv is included in the extension folder for reference.

Step 2: Navigate to Higgsfield AI

  1. Open https://higgsfield.ai/sora-trends/tiktok in Chrome
  2. Make sure you're logged in

Step 3: Load Prompts

  1. Click the extension icon in your toolbar
  2. Click "Choose CSV File"
  3. Select your CSV file
  4. The extension will show how many prompts were loaded

Step 4: Start Automation

  1. Click the "Start" button
  2. The extension will:
    • Toggle "Unlimited" ON
    • Set Style to "Realistic"
    • Set Craziness to "High"
    • Click "Save Settings"
    • Select "Crazy Situation" preset
  3. A confirmation notification will appear for the first prompt
  4. Click "Yes" to start generation
  5. The extension will manage up to 2 parallel generations

Step 5: Monitor Progress

  • The popup shows:

    • Completed prompts count
    • Total prompts
    • Active generations (0-2)
    • Progress bar
    • Current prompt text
    • Failed prompts (if any)
  • Every 5 minutes, the extension checks generation status

  • When a generation completes, you'll get a confirmation for the next prompt

  • Failed generations are automatically skipped and logged

Controls

  • Start: Begin automation (disabled until CSV is loaded)
  • Pause: Pause automation (can resume later)
  • Reset: Clear all progress and start over
  • Keyboard Shortcut: Press Space to toggle Start/Pause

State Persistence

The extension remembers:

  • Loaded prompts
  • Completed prompts
  • Failed prompts
  • Current position in the queue
  • Active generations

This means you can close and reopen the browser without losing progress.

Troubleshooting

Extension doesn't start

Settings not applying

  • The Higgsfield AI page layout may have changed
  • Check the Console for errors
  • Try manually setting up once, then run the extension

Generations not detected

  • The extension looks for "In Queue" and "In Progress" status text
  • If the UI changed, the selectors may need updating

Notifications not appearing

  • Check Chrome notification permissions
  • Make sure "Do Not Disturb" is off
  • Check Chrome Settings > Privacy and security > Site Settings > Notifications

Development

File Structure

HIGGSFIELD CHROME EXTENSION/
├── manifest.json
├── popup/
│   ├── popup.html
│   ├── popup.css
│   └── popup.js
├── content/
│   └── content.js
├── background/
│   └── service-worker.js
├── utils/
│   ├── csv-parser.js
│   └── storage.js
├── icons/
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
└── template_prompts.csv

Key Components

  • Popup: User interface and controls
  • Content Script: Page automation and DOM manipulation
  • Service Worker: Background task management and alarms
  • Utils: CSV parsing and storage helpers

Debugging

  1. Open DevTools on the Higgsfield AI page (content script logs)
  2. Click extension icon > right-click > "Inspect" (popup logs)
  3. Go to chrome://extensions/ > "Service worker" link (background logs)

Privacy

This extension:

  • Only runs on higgsfield.ai domains
  • Stores data locally in Chrome storage
  • Does not send data to external servers
  • Does not track user behavior

Support

For issues or questions, check the Console logs for detailed error messages.

Version

Current version: 1.0.0

License

This extension is provided as-is for automation purposes.

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors