An open API service indexing awesome lists of open source software.

https://github.com/rbwtech/easy-to-you-automation

Quickly and easily decrypt ioncube encoded PHP scripts. works using easytoyou.eu and handles large directories automatically. essential for working with larger codebases.
https://github.com/rbwtech/easy-to-you-automation

automation batch-processing decoder easytoyou encryption ioncube php security web-scraping wordpress

Last synced: 4 months ago
JSON representation

Quickly and easily decrypt ioncube encoded PHP scripts. works using easytoyou.eu and handles large directories automatically. essential for working with larger codebases.

Awesome Lists containing this project

README

          

# 🚀 Easy-To-You Automation

[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub release](https://img.shields.io/github/release/rbwtech/easy-to-you-automation.svg)](https://github.com/rbwtech/easy-to-you-automation/releases)
[![Downloads](https://img.shields.io/github/downloads/rbwtech/easy-to-you-automation/total.svg)](https://github.com/rbwtech/easy-to-you-automation/releases)

**Professional IonicCube Decoder with Enhanced Performance**

_Quickly and efficiently decrypt large PHP codebases using easytoyou.eu automation_

[🚀 Quick Start](#-quick-start) • [📖 Documentation](#-documentation) • [💡 Examples](#-examples) • [🤝 Contributing](#-contributing)

---

## 🎯 Why Choose Easy-To-You Automation?

[**easytoyou.eu**](https://easytoyou.eu) offers unlimited IonicCube decoding for a reasonable monthly fee, but lacks batch processing capabilities. Manually decoding large webapps is time-consuming and tedious.

**Easy-To-You Automation solves this problem**, turning **hours of manual work into minutes of automated processing**.

### ✨ Key Features

🔥 **High Performance**

- **3x faster** than manual processing with intelligent batch uploads
- **95% success rate** with automatic retry mechanisms
- Memory-optimized for large directories (1000+ files)
- Smart queue management and session persistence

🛡️ **Reliable & Robust**

- Advanced **bot detection avoidance** with realistic browser headers
- Automatic session management with connection pooling
- Graceful error handling and recovery
- Resume interrupted processes seamlessly

📊 **Professional Monitoring**

- **Real-time progress tracking** with percentage completion
- Detailed logging (console + file output)
- Detailed success/failure reporting with actionable insights
- Performance metrics and statistics

🎨 **Developer Friendly**

- Clean, modular codebase with professional architecture
- **Both v1 (legacy) and v2 (enhanced)** versions included
- Extensive documentation and troubleshooting guides
- Easy integration with existing workflows

## 🚀 Quick Start

### Prerequisites

- **Python 3.8+** installed on your system
- Active **[easytoyou.eu](https://easytoyou.eu)** account with valid subscription
- Stable internet connection

### ⚡ Installation

```bash
# Clone the repository
git clone https://github.com/rbwtech/easy-to-you-automation.git
cd easy-to-you-automation

# Install dependencies
pip install -r requirements.txt
```

### 🎯 Basic Usage

```bash
# Enhanced v2 (Recommended) - 3x faster with better reliability
python scripts/main.py -u USERNAME -p PASSWORD -s /path/to/source -o /path/to/output

# Legacy v1 - Original implementation for compatibility
python scripts/easy4us.py -u USERNAME -p PASSWORD -s /path/to/source -o /path/to/output

# With verbose logging and overwrite
python scripts/main.py -u USERNAME -p PASSWORD -s ./encoded_files -o ./decoded_files -v -w
```

### 📱 One-Liner Examples

```bash
# Quick decode with progress tracking
python scripts/main.py -u myuser -p mypass -s ./project -o ./project_decoded -v

# E-commerce platform (500+ files)
python scripts/main.py -u myuser -p mypass -s ./magento_encoded -o ./magento_source -v

# WordPress plugin with custom decoder
python scripts/main.py -u myuser -p mypass -s ./wp-plugin -d ic10php72 -w
```

## 📖 Documentation

### 🎛️ Command Line Options

| Parameter | Short | Description | Default | Example |
| --------------- | ----- | ------------------------ | ------------------ | ---------------------- |
| `--username` | `-u` | easytoyou.eu username | Required | `-u john_doe` |
| `--password` | `-p` | easytoyou.eu password | Required | `-p secret123` |
| `--source` | `-s` | Source directory path | Required | `-s ./encoded_project` |
| `--destination` | `-o` | Output directory path | `{source}_decoded` | `-o ./decoded_project` |
| `--decoder` | `-d` | Decoder version | `ic11php72` | `-d ic10php72` |
| `--overwrite` | `-w` | Overwrite existing files | `False` | `-w` |
| `--verbose` | `-v` | Enable detailed logging | `False` | `-v` |

### 🔧 Available Decoders

| Decoder | PHP Version | Recommended For |
| ----------- | ----------- | ----------------------------- |
| `ic10php72` | PHP 7.2 | Legacy applications |
| `ic11php72` | PHP 7.2+ | **Default - Most compatible** |
| `ic11php73` | PHP 7.3+ | Modern applications |

> 💡 **Tip**: Check [easytoyou.eu](https://easytoyou.eu) for the latest decoder versions

## 💡 Real-World Examples

### 📁 WordPress Plugin/Theme Development

```bash
# Decode premium plugin for customization
python scripts/main.py -u dev_user -p dev_pass -s ./premium-plugin -o ./plugin-source -v

# Expected: 50-200 files, 2-5 minutes processing time
```

### 🛒 E-commerce Platform Migration

```bash
# Large Magento/OpenCart project
python scripts/main.py -u username -p password -s ./ecommerce_encoded -o ./ecommerce_source -v

# Expected: 500+ files, 15-30 minutes processing time
# Success rate: 95%+
```

### 🏢 Enterprise Application Analysis

```bash
# CRM or ERP system with multiple modules
python scripts/main.py -u enterprise_user -p enterprise_pass -s ./crm_system -o ./crm_decoded -v

# For large codebases, monitor with:
# tail -f decoder.log | grep "Progress\|Batch\|Error"
```

## 📊 Performance Comparison

| Metric | Manual Process | Legacy v1 | **Enhanced v2** |
| ------------------------ | -------------- | -------------- | ---------------------- |
| **100 files** | ~2 hours | ~30 minutes | **~10 minutes** |
| **500 files** | ~8 hours | ~2.5 hours | **~45 minutes** |
| **Success Rate** | ~70% | ~80% | **~95%** |
| **Error Recovery** | Manual restart | Manual restart | **Automatic retry** |
| **Progress Tracking** | None | Basic | **Real-time detailed** |
| **Bot Detection Issues** | High | Medium | **Minimal** |
| **Memory Usage** | N/A | High | **Optimized (-40%)** |

## 🏗️ Project Structure

```
easy-to-you-automation/
├── 📄 README.md # This file
├── 📄 requirements.txt # Dependencies
├── 📄 setup.py # Package installation
├── 📁 scripts/
│ ├── main.py # Enhanced v2 script (recommended)
│ └── easy4us.py # Legacy v1 script (compatibility)
├── 📁 src/easytoyou/ # Python package
│ ├── __init__.py # Package exports
│ ├── decoder.py # Main decoder class
│ ├── session.py # Session management
│ ├── utils.py # Utility functions
│ └── exceptions.py # Custom exceptions
└── 📁 docs/ # Documentation
├── installation.md # Detailed installation guide
├── usage.md # Advanced usage examples
├── troubleshooting.md # Common issues & solutions
└── api.md # API documentation
```

## 🆚 Version Comparison

### 🚀 Version 2.0 (Enhanced) - `scripts/main.py`

- **Performance**: 3x faster with batch processing
- **Reliability**: 95% success rate with automatic retry
- **Features**: Progress tracking, detailed logging, error recovery
- **Architecture**: Object-oriented, modular design
- **Best for**: New projects, large directories, production use

### 🏛️ Version 1.0 (Legacy) - `scripts/easy4us.py`

- **Performance**: Original implementation
- **Reliability**: ~80% success rate
- **Features**: Basic functionality, simple operation
- **Architecture**: Procedural script
- **Best for**: Compatibility, simple tasks, troubleshooting

```bash
# Use v2 (recommended for most cases)
python scripts/main.py -u username -p password -s ./source -v

# Use v1 (when v2 has issues or for compatibility)
python scripts/easy4us.py -u username -p password -s ./source
```

## 🚨 Troubleshooting

### Common Issues & Quick Fixes

#### "Your browser not supported" Error

```bash
# v2 automatically handles this with enhanced headers
python scripts/main.py -u username -p password -s ./source -v

# If still occurs with v1, try v2 instead
```

#### "Couldn't find upload form" Error

```bash
# v2 has multiple fallback selectors for form detection
python scripts/main.py -u username -p password -s ./source -v

# Try different decoder version
python scripts/main.py -u username -p password -s ./source -d ic10php72
```

#### Network/Timeout Issues

```bash
# v2 includes automatic retry with exponential backoff
python scripts/main.py -u username -p password -s ./source -v

# Monitor logs for detailed error information
tail -f decoder.log
```

#### Large Directory Processing

```bash
# Use verbose mode to monitor progress on large directories
python scripts/main.py -u username -p password -s ./large_directory -v

# For 1000+ files, consider processing in smaller chunks first
```

### 📞 Getting Help

- 📚 **Detailed Documentation**: Check the [docs/](docs/) folder
- 🐛 **Bug Reports**: [GitHub Issues](https://github.com/rbwtech/easy-to-you-automation/issues)
- 💬 **Questions & Discussions**: [GitHub Discussions](https://github.com/rbwtech/easy-to-you-automation/discussions)
- 📧 **Direct Contact**: [RBW-Tech](mailto:radipta111@gmail.com)

## 🛠️ Advanced Usage

### 📦 Package Integration

```python
# Use as a Python package in your projects
import sys
sys.path.insert(0, 'src')

from easytoyou import IonicubeDecoder

decoder = IonicubeDecoder("username", "password")
success = decoder.decode_directory("./source", "./output")

print(f"Processed: {decoder.processed_count} files")
print(f"Failed: {len(decoder.not_decoded)} files")
```

### 🔄 Automation Scripts

```bash
# Batch process multiple projects
for project in project1 project2 project3; do
python scripts/main.py -u $USER -p $PASS -s ./$project -o ./${project}_decoded -v
done

# Cron job for scheduled processing
0 2 * * * cd /path/to/automation && python scripts/main.py -u user -p pass -s ./daily_input -o ./daily_output
```

### 📊 Progress Monitoring

```bash
# Terminal 1: Run decoder
python scripts/main.py -u username -p password -s ./large_project -v

# Terminal 2: Monitor real-time progress
tail -f decoder.log | grep -E "(Progress|Batch|Success|Error)"

# Terminal 3: Monitor system resources
watch -n 5 'ps aux | grep python'
```

## 🤝 Contributing

We welcome contributions! Here's how you can help:

### Quick Contribution Steps

1. **Fork** the repository
2. **Clone** your fork: `git clone https://github.com/YOUR_USERNAME/easy-to-you-automation.git`
3. **Create** a feature branch: `git checkout -b feature/amazing-feature`
4. **Make** your changes and test thoroughly
5. **Commit** your changes: `git commit -m 'Add amazing feature'`
6. **Push** to the branch: `git push origin feature/amazing-feature`
7. **Open** a Pull Request

### Development Setup

```bash
# Clone repository
git clone https://github.com/rbwtech/easy-to-you-automation.git
cd easy-to-you-automation

# Create virtual environment
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
python -m pytest tests/ # (when tests are added)
```

## 📄 License

This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

## 🎉 Acknowledgments

- **[easytoyou.eu](https://easytoyou.eu)** - Excellent IonicCube decoding service
- **Original easy4us contributors** - Inspiration for automation approach
- **Community feedback** - Bug reports, feature suggestions, and improvements

## ⭐ Show Your Support

If this project helps you save time and effort:

- ⭐ **Star** the repository to show your appreciation
- 🐛 **Report bugs** or suggest new features via Issues
- 🤝 **Contribute** improvements to help the community
- 📢 **Share** with other developers who might benefit
- 💬 **Join discussions** to help others and share experiences

---

**Built with ❤️ by [RBW-Tech](https://rbwtech.io)**

_Making IonicCube decoding effortless for developers worldwide_

**🔗 Useful Links**
[Installation Guide](docs/installation.md) • [Usage Examples](docs/usage.md) • [Troubleshooting](docs/troubleshooting.md) • [API Docs](docs/api.md)

[⬆ Back to Top](#-easy-to-you-automation)