🎯 Perfect AdsPower RPA Engine
- 🔍 Intelligent Element Detection - Advanced DOM analysis with AdsPower-optimized selector generation
- ⚡ Real-time Action Capture - Zero-latency recording with microsecond precision
- 🎮 Flexible Control System - Start, pause, resume, and stop with instant response
- 📊 Live Action Analytics - Real-time counter and status visualization
- 🤖 Perfect AdsPower Export - Generates production-ready AdsPower RPA scripts
- ⏰ Smart Wait Times - Automatic timing optimization with randomInterval for natural automation
- 🎯 Advanced Selectors - CSS, TEXT, and ARIA-based element identification optimized for AdsPower
- 🔄 One-Click AdsPower Export - Seamless integration with AdsPower RPA platform
📸 Screenshots & Visual Guide
🎯 Extension Interface Overview
| Interface State |
Preview |
Description |
| Main Popup |
 |
Modern popup interface with recording controls, action count, and status indicators |
| Recording Active |
 |
Live recording state with animated red badge and real-time action tracking |
| Action History |
 |
Detailed action list showing captured interactions with timestamps and element info |
| Export Success |
 |
Export confirmation with clipboard integration and AdsPower RPA format |
| Help Center |
 |
Interactive help system with usage tips and troubleshooting guides |
🧪 Demo: Record a Google Search (30s)
Try this simple workflow to test the extension:
| Step |
Action |
Result |
| 1 |
🔴 Click extension → "Start Recording" |
Red badge appears |
| 2 |
🌐 Navigate to google.com |
URL captured |
| 3 |
🔍 Click search box → Type "ActionXS" |
Input recorded |
| 4 |
⌨️ Press Enter → Click first result |
Navigation captured |
| 5 |
⏹️ Click extension → "Stop Recording" |
Session ended |
| 6 |
📤 Click "Export to Clipboard" |
✅ Ready for RPA! |
🎯 Best Practices for Perfect AdsPower RPA
- ⏱️ Natural Pace - Don't rush actions, let timing be captured naturally for realistic automation
- 🎯 Clean Clicks - Avoid overlapping elements during interactions for precise targeting
- 🧪 Test AdsPower Import - Test the generated RPA workflow in AdsPower after export
- 🧹 Fresh Start - Clear previous recordings for clean, focused automation workflows
- ✅ Verify Selectors - The extension automatically optimizes selectors for AdsPower compatibility
⚠️ AdsPower RPA Optimization & Solutions
- 🔄 Dynamic Content → Extension adds intelligent wait times automatically
- 🪟 Navigation → Auto-generates closeOtherPage and waitTime actions
- 🖼️ Scroll Actions → Perfect pixel-based scrolling with randomWheelDistance
- ⚡ Human-Like Behavior → Random intervals and natural timing patterns
- 🎯 Selector Priority → TEXT > CSS > ARIA for maximum AdsPower compatibility
🚀 Perfect AdsPower Integration
Seamless AdsPower RPA Workflow
| Step |
ActionXS Recorder |
AdsPower RPA |
| 1. Record |
✅ Intelligent action capture |
Import perfect JSON |
| 2. Convert |
✅ Auto-generates AdsPower format |
Ready-to-run workflow |
| 3. Optimize |
✅ Smart wait times & selectors |
Reliable automation |
| 4. Export |
✅ One-click perfect JSON copy |
Import & execute |
AdsPower RPA Features Generated
{
"type": "click",
"config": {
"button": "left",
"selector": "Submit",
"selectorRadio": "TEXT",
"timeout": 15000,
"waitBeforeClick": 500,
"retryOnFail": 2,
"scrollIntoView": true,
"randomWheelDistance": [100, 200],
"randomWheelSleepTime": [800, 1500]
}
}
Perfect AdsPower compatibility with:
- ✅ randomInterval timing
- ✅ Intelligent selector optimization
- ✅ Human-like behavior simulation
- ✅ Error handling and retry logic
- ✅ Natural scroll patterns
- ✅ Production-ready format
📦 Two Installation Methods
| Method |
Best For |
Time Required |
| 🌐 Chrome Web Store |
End Users |
~30 seconds |
| 🔧 Manual Installation |
Developers |
~2 minutes |
🌟 Chrome Web Store (Recommended)
🚀 Quick Install Guide
-
Open Chrome Web Store
- Visit Chrome Web Store
- Or navigate to chrome://extensions/ → "Open Chrome Web Store"
-
Find & Install
- Search for "ActionXS Recorder" by Saify
- Click "Add to Chrome" → Confirm permissions
- ✅ Extension appears in toolbar (pin it for easy access)
🔧 Manual Installation (Developers)
⚙️ Developer Setup Process
# Clone repository
git clone https://github.com/saifyxpro/actionxs-recorder.git
cd actionxs-recorder
# Or download ZIP and extract to folder
Installation Steps:
- Enable Developer Mode: chrome://extensions/ → Toggle "Developer mode"
- Load Extension: Click "Load unpacked" → Select ActionXS folder
- Verify: Extension icon appears in toolbar with no errors
🔧 System Requirements & Compatibility
| Browser |
Support Status |
Minimum Version |
Notes |
 |
Full Support |
88+ |
Recommended |
 |
Full Support |
88+ |
Chromium-based |
 |
Full Support |
Latest |
Privacy-focused |
 |
Full Support |
Latest |
Chromium-based |
 |
Not Supported |
N/A |
Manifest V2 only |
| Control |
Action |
Visual Indicator |
Purpose |
| ▶️ Start |
Begin recording |
🔴 Red badge |
Start capturing interactions |
| ⏸️ Pause |
Suspend recording |
🟡 Yellow badge |
Temporarily pause session |
| ⏹️ Stop |
End recording |
⚪ Default badge |
Complete recording session |
| 📤 Export |
Copy to clipboard |
✅ Success toast |
Export for AdsPower RPA |
| 🧹 Clear |
Reset session |
🧹 Empty state |
Delete all recorded actions |
🏗️ Technical Architecture
ActionXS-Recorder/
├── 📋 manifest.json # Manifest V3 configuration
├── 🌐 _locales/en/messages.json # Internationalization
├── 🎨 img/ # Icons and screenshots
├── ⚙️ libs/ # Core JavaScript modules
│ ├── background.js # Service worker (Manifest V3)
│ ├── content.js # Page interaction monitor
│ └── popup.js # UI control logic
└── 🎭 popup/ # User interface files
├── popup.html/.css # Main interface
└── help.html/.css/.js # Help system
| Technology |
Purpose |
Version |
| Manifest V3 |
Modern extension standard |
Latest |
| Service Workers |
Background processing |
ES2022 |
| Content Scripts |
DOM interaction monitoring |
ES2022 |
| Chrome APIs |
Storage, tabs, scripting |
Latest |
🛡️ Security & Privacy Details
| Permission |
Purpose |
Privacy Impact |
| storage |
Save recorded actions locally |
✅ Local only |
| activeTab |
Monitor current tab interactions |
✅ Current tab only |
| scripting |
Inject recording functionality |
✅ On-demand only |
| tabs |
Track navigation events |
✅ Navigation only |
💪 Privacy Guarantee:
- ✅ Local Processing - All data stays on your device
- ✅ No Tracking - Zero analytics or user monitoring
- ✅ No Cloud Sync - Data never transmitted externally
- ✅ Open Source - Complete code transparency
# Fork & clone the repository
git clone https://github.com/YOUR-USERNAME/actionxs-recorder.git
cd actionxs-recorder
# Create feature branch
git checkout -b feature/amazing-improvement
# Make changes and test thoroughly
# Commit with clear, descriptive messages
git commit -m "feat: add amazing new feature"
# Push and create Pull Request
git push origin feature/amazing-improvement
📝 Contribution Guidelines
📋 Code Standards & Review Process
Code Quality:
- ✅ Follow existing code style and patterns
- ✅ Add comments for complex logic
- ✅ Test across multiple websites
- ✅ Ensure Manifest V3 compliance
Pull Request Process:
- Fork repository and create feature branch
- Develop following established patterns
- Test thoroughly on various websites
- Document changes and new features
- Submit PR with clear description
Review Criteria:
- Code functionality and performance
- Cross-browser compatibility testing
- Security and privacy compliance
- Documentation completeness
| Version |
Date |
Key Features |
| 1.0.0 |
2025 |
🎉 Initial release with core recording & AdsPower RPA integration |
| 1.1.0 |
Planned |
🔄 Multi-tab support & enhanced dynamic content detection |
| 1.2.0 |
Planned |
📁 File operations & direct AdsPower API integration |
🚀 Latest Release (v1.0.0)
- ✨ Smart Recording Engine - Intelligent element detection and interaction capture
- 🎯 AdsPower RPA Integration - Seamless export functionality with structured data
- 🎨 Modern Interface - Material Design 3 with real-time status indicators
- 🔒 Manifest V3 - Enhanced security and performance architecture
- 🌐 Multi-language Foundation - Internationalization support structure
- 🔄 Enhanced Multi-tab Recording - Simultaneous recording across multiple tabs
- 📊 Advanced Analytics - Detailed action insights and performance metrics
- 🎛️ Customizable Filters - User-defined recording parameters
- 📱 Mobile Support - Chrome mobile browser compatibility
- 🎨 Theme System - Customizable UI themes and branding

Licensed under the MIT License - See LICENSE file for full details.
Free to use, modify, and distribute with attribution.
Lead Developer & Project Architect
- 💡 Project Vision - Concept and strategic development
- 🏗️ Technical Architecture - Chrome Extension & Manifest V3 implementation
- 🔗 AdsPower Integration - RPA workflow compatibility
- 🎨 User Experience - Interface design and user journey

❌ Extension Not Recording Actions
- ✅ Check Recording Status - Ensure "Start Recording" was clicked (red badge visible)
- ✅ Verify Permissions - Extension needs access to current website
- ✅ Refresh Page - Reload page and restart recording session
- ✅ Check Console - Look for JavaScript errors that might block functionality
📤 Export Not Working
- ✅ Record Actions First - Must have at least one recorded action
- ✅ Stop Recording - Ensure recording session is stopped before export
- ✅ Check Clipboard - Verify browser clipboard permissions are enabled
- ✅ Test Paste - Try pasting in a text editor to verify export success
⚡ Missing Actions in Export
- ✅ Slow Down Actions - Record at natural pace for better capture
- ✅ Wait for Loading - Ensure all dynamic content loads before interaction
- ✅ Check iframes - Embedded content may need special handling
- ✅ Review Console - JavaScript errors may prevent action capture
🔗 Related Projects & Resources
🌟 Built with ❤️ by the Open Source Community
ActionXS Recorder - Professional Web Automation Recording for AdsPower RPA

Thank you for using ActionXS Recorder! 🚀