srm-ser 0.1.9
Grabador de pantalla con efectos en tiempo real (Sin POSTPROCESADO)
License: MIT
Requires Python: >=3.11.6

# 🎥 Screen Effect Recorder v0.1.0

[![Python 3.11.6+](https://img.shields.io/badge/Python-3.11.6%2B-blue.svg)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![FFmpeg Required](https://img.shields.io/badge/FFmpeg-Required-orange.svg)](https://ffmpeg.org/)
[![Screen Effect Recorder Version](https://img.shields.io/pypi/v/srm-ser?label=srm-SER)](https://pypi.org/project/srm-ser)
[![Author](https://img.shields.io/badge/Tutos%20Rive-Author-brightgreen)](https://github.com/tutosrive)

Aplicación profesional para grabación de pantalla con **efectos visuales en tiempo real** y ajustes avanzados.

> Archivos/Versiones: [Releases](https://github.com/tutosrive/screen-effect-recorder/releases)

```shell
pip install srm-ser
```

![Interfaz Principal](https://cdn.jsdelivr.net/gh/tutosrive/images-projects-srm-trg@main/modules/ser.png)

## 🌟 Características Principales

### 🎚️ Ajustes en Tiempo Real
- Brillo | Contraste | Saturación | Gamma | Tono | Nitidez
- 6 controles deslizantes con precisión decimal
- Valores por defecto optimizados

### 🖥️ Vista Previa Avanzada
- Panel interactivo 1:1
- Efectos aplicados en tiempo real
- Soporte para imágenes/GIF como vista previa (Ver efectos aplicados)
- Sistema de recorte inteligente (modo cover)

### ⚙️ Configuración Profesional
- Detección automática de dispositivos de audio (micrófono)
- Presets de codificación FFmpeg (`ultrafast` a `medium`)
- Guardado automático de ajustes en JSON
- Interfaz oscura moderna con CustomTKinter

## 📦 Requisitos

### Componentes Requeridos
- FFmpeg (Versión 7.1.1-full_build-www.gyan.dev) en PATH ([Descarga Directa](https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-full.7z))
- Python 3.11.6 o superior
- Sistema operativo _probado_: **Windows 10**

## 🚀 Instalación Rápida (local)

1. Clonar repositorio:
```bash
git clone https://github.com/tutosrive/screen-effect-recorder.git
```

2. Instalar dependencias:
```bash
pip install -r requirements.txt
```

3. Ejecutar aplicación:
```bash
python __main__.py
```

## ⚡ Uso Básico

1. Seleccionar directorio de salida
2. Elegir dispositivo de audio (Es obligatorio, si no se selcciona no grabará...)
3. Ajustar efectos visuales
4. Iniciar grabación con un clic
5. Detener grabación (archivo se guarda automáticamente)

```python
# Estructura de archivo de configuración
{
  "output_path": "C:\\Users\\Usuario\\Videos",
  "audio_device": "Micrófono (Dispositivo HD)",
  "preset": "fast",
  "brightness": 0.2,
  "contrast": 1.1,
  "saturation": 1.3,
  "gamma": 1.0,
  "hue": 0.0,
  "sharpness": 1.5
}
```

## 📄 Licencia

Este proyecto está bajo licencia MIT - ver el archivo [LICENSE](https://github.com/tutosrive/screen-effect-recorder/blob/main/LICENSE) para más detalles.

**Atribución Requerida:**
```text
Incluir en todos los usos/modificaciones:
"Screen Effect Recorder (SER) v0.1.0 © 2025 Tutos Rive - Licencia MIT"
```

## 🤝 Contribución

1. Haz fork del proyecto
2. Crea tu branch (`git checkout -b feature/nueva-funcionalidad`)
3. Commit cambios (`git commit -m 'Add nueva funcionalidad'`)
4. Push al branch (`git push origin feature/nueva-funcionalidad`)
5. Abre un Pull Request

## 📧 Contacto

**Autor:** Tutos Rive  
**Soporte:** [srmtrg.ser@gmail.com](mailto:srmtrg.ser@gmail.com)