Hazel is a powerful Chrome extension that lets you record, save, and replay your browser interactions with cloud synchronization capabilities. Say goodbye to repetitive tasks! 🎉
- 🖱️ Capture Every Move: Clicks, typing, form submissions, navigation - we've got it all!
- ⏯️ Pause & Resume: Take a break when needed and pick up right where you left off
- 🔄 Dynamic Variables: Set up flexible values that change during playback (plain text, AI-generated, or API)
- 📊 Visual Tracking: Sleek recording toolbar shows status with real-time event counter
- 🎯 Precision Replay: Watch Hazel faithfully recreate your recorded actions
- 🧠 Smart Element Finding: Multiple fallback strategies ensure playback works even when pages change
- 🛡️ Error Recovery: Hazel tries to keep going even when unexpected changes occur
- 🔐 Secure Auth: Easy and secure cloud authentication
- 🔄 Sync Anywhere: Access your recordings across devices
✈️ Offline Mode: Works without internet using local storage
- 📥 Download the repository
- 🧩 Open Chrome and navigate to
chrome://extensions/ - 👨💻 Enable "Developer mode" in the top right
- 📁 Click "Load unpacked" and select the extension directory
- 🎉 The Browser Recorder icon will appear in your Chrome toolbar!
- 🖱️ Click the Hazel extension icon
- ✏️ Give your recording an awesome name
- 🚀 Hit "Start Recording"
- ⚙️ In the settings modal:
- Configure recording options
- Add any custom variables you need
- Click "Start Recording" to launch!
- 🎬 The recording toolbar appears in the top-right corner
- 🎭 Do your thing! Hazel is watching (in a good way)
- ⏹️ Use the toolbar to pause/resume or stop recording
- 📂 Open the Hazel extension popup
- 🔍 Find your recording in the list
▶️ Click "Play" and sit back- 🪄 Watch as Hazel recreates your actions perfectly!
- background.js: 🧠 The brain of the operation
- content/ directory: 🛠️ Scripts that work within web pages
- content-script.js: 🏁 Main entry point
- recorder.js: 🎥 Captures your interactions
- player.js and player-new.js:
▶️ Replays your recordings - recording-toolbar.js: 📊 The UI you see while recording
- recording-settings-modal.js: ⚙️ Configuration screen
- api-service.js and auth-helper.js: 🔌 API communication
- popup/ directory: 💻 Extension popup interface
- lib/ directory: 🧰 Shared utilities
- manifest.json: 📝 Extension configuration
- 📝 Plain Text: Simple static values - "admin@example.com"
- 🤖 AI Generated: Dynamic values created by AI - "random product name"
- 🌐 API Response: Real-time data from APIs - "current stock price"
Hazel connects securely with the cloud platform using OAuth authentication. Your data stays safe! 🔒
During playback, Hazel uses these strategies to find elements (in order):
- ✅ Exact CSS selector
- 🔄 Simplified selector without nth-child parts
- 🆔 ID-based selection
- 📊 Attribute-based selection
- 📋 Name-based selection for form elements
This smart approach ensures reliable playback even when websites change! 💪
Hazel talks smoothly with its cloud API to:
- ✅ Verify your login
- 💾 Save recordings to the cloud
- 📥 Download your recordings anywhere
- 🗑️ Manage your library
- 🌐 Chrome browser
- 📦 Node.js (for future enhancements)
- 📝 Make your code changes
- 🔄 Reload the extension in
chrome://extensions/ - 🧪 Test your amazing improvements!
- 🖱️ Support for complex interactions like drag and drop
- 🚀 Enhanced API capabilities
- 👥 Team sharing of recordings
- 💪 Even better error recovery
- 🧠 Conditional logic in recordings
- 🚫 Recording not starting? Check you're not on a restricted page (chrome://, extension pages)
- ❌ Playback misbehaving? Try recording again with the latest version
- 🔑 Authentication issues? Log in again through the cloud platform
Copyright (c) 2025 Hazel Browser Recorder Team Permission is hereby granted, free of charge, to any person obtaining a copy of this software to use, modify, and contribute to the software, subject to the following conditions:
No Repository Cloning: The creation of public repositories containing substantially similar code to this project is prohibited. This includes direct copies, forks that are made public, or derivative works that maintain the core functionality of this software. Contributions Welcome: Contributions to the original repository through pull requests are encouraged and welcome. Personal Use: Users may modify and use the software for personal or internal organizational use. No Commercial Distribution: The software may not be commercially distributed as-is or in modified form without explicit permission from the copyright holders.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
For any questions or feedback, please reach out to zidna.dev@gmail.com.
Stop repeating yourself. Start recording with Hazel! ✨