🖱️ AutoClicker Pro

AutoClicker profesional con interfaz gráfica desarrollado en Python, con múltiples modos de operación y configuración flexible.

✨ Características

• Múltiples tipos de eventos:

  • Click izquierdo del mouse
  • Click derecho del mouse
  • Presionar teclas del teclado

• Dos modos de operación:

  • Click continuo: Repite la acción con un intervalo de tiempo configurable
  • Mantener presionado: Mantiene presionado el botón/tecla mientras esté activo

• Configuración flexible:

  • Intervalo entre clicks: desde 0.01 hasta 60 segundos
  • Atajos rápidos para intervalos comunes (0.01s, 0.1s, 0.5s, 1s, 2s)
  • Tecla de inicio/parada configurable (F1-F12)
  • Selección de tecla personalizada para el modo teclado

• Interfaz intuitiva:

  • Diseño limpio y organizado
  • Indicador visual de estado (Detenido/Ejecutando)
  • Control mediante botones o tecla rápida global

📋 Requisitos

Para ejecutar el script Python:

• Python 3.7 o superior
• pip (gestor de paquetes de Python)

Dependencias:

pynput==1.7.6

🚀 Instalación

Opción 1: Ejecutar como script Python

1. Clonar o descargar los archivos:

   # Descargar autoclicker.py y requirements.txt

2. Instalar las dependencias:

   pip install -r requirements.txt

3. Ejecutar la aplicación:

   python autoclicker.py

Opción 2: Crear ejecutable

1. Instalar PyInstaller:

   pip install pyinstaller

2. Ejecutar el script de construcción:

   python build_exe.py

3. El ejecutable estará en la carpeta dist/:

   • Windows: dist/AutoClicker.exe
   • Linux/Mac: dist/AutoClicker

Comando manual de PyInstaller:

pyinstaller --name=AutoClicker --onefile --windowed autoclicker.py

📖 Modo de Uso

Configuración Básica

1. Seleccionar tipo de evento:

   • Click Izquierdo
   • Click Derecho
   • Tecla del Teclado (especificar la tecla)

2. Seleccionar modo de acción:

   • Click Continuo: Los clicks se repetirán con el intervalo especificado
   • Mantener Presionado: El botón/tecla se mantendrá presionado

3. Configurar intervalo (solo para modo continuo):

   • Usar el campo de segundos
   • O usar los botones de atajo rápido

4. Configurar tecla de control:

   • Seleccionar una tecla de función (F1-F12)
   • Esta tecla iniciará/detendrá el autoclicker

Iniciar/Detener

Hay dos formas de controlar el autoclicker:

1. Presionar el botón "Iniciar" en la interfaz
2. Presionar la tecla de control configurada (por defecto F6)

La tecla de control funciona globalmente, incluso cuando la ventana no está en foco.

Ejemplos de Uso

Ejemplo 1: Clicks rápidos para gaming

• Tipo: Click Izquierdo
• Modo: Click Continuo
• Intervalo: 0.01s (100 clicks por segundo)
• Tecla: F6

Ejemplo 2: Mantener un botón presionado

• Tipo: Click Izquierdo
• Modo: Mantener Presionado
• Tecla: F7

Ejemplo 3: Auto-teclear una letra

• Tipo: Tecla del Teclado
• Tecla: "a"
• Modo: Click Continuo
• Intervalo: 1s

Ejemplo 4: Clicks lentos y controlados

• Tipo: Click Izquierdo
• Modo: Click Continuo
• Intervalo: 2s
• Tecla: F6

⚙️ Detalles Técnicos

Arquitectura

• GUI: Tkinter (biblioteca estándar de Python)
• Control de entrada: pynput (mouse y teclado)
• Multithreading: threading (para no bloquear la interfaz)

Estructura del Código

autoclicker.py          # Aplicación principal
requirements.txt        # Dependencias del proyecto
build_exe.py           # Script para crear ejecutable
README.md              # Documentación

Funciones Principales

• AutoClicker.__init__(): Inicializa la aplicación y la interfaz
• create_widgets(): Crea todos los elementos de la interfaz
• start_hotkey_listener(): Escucha la tecla de control global
• click_loop(): Loop principal que ejecuta los clicks/teclas
• toggle_clicking(): Alterna entre iniciar y detener

🛡️ Consideraciones de Seguridad

IMPORTANTE: Este autoclicker es una herramienta que simula entrada de usuario. Úsalo de manera responsable:

• ✅ Usos legítimos:

  • Pruebas de software
  • Automatización de tareas repetitivas personales
  • Juegos de clicker donde esté permitido
  • Accesibilidad para personas con discapacidades

• ❌ NO usar para:

  • Hacer trampa en juegos multijugador
  • Automatizar acciones que violen términos de servicio
  • Cualquier actividad ilegal o no ética

🐛 Solución de Problemas

Error: "No module named 'pynput'"

pip install pynput

En Linux: Requiere permisos de accesibilidad

Algunos sistemas Linux requieren permisos especiales para simular entrada:

sudo python autoclicker.py

En macOS: Permisos de accesibilidad

Ve a: Preferencias del Sistema → Seguridad y Privacidad → Accesibilidad Y permite la aplicación.

El ejecutable no se crea

Asegúrate de tener PyInstaller instalado:

pip install pyinstaller

La tecla global no funciona

• Verifica que no haya otra aplicación usando la misma tecla
• Prueba con otra tecla de función (F1-F12)
• En algunos sistemas, puede requerir ejecutar como administrador

📝 Personalización

Cambiar el rango de intervalo:

En autoclicker.py, línea ~115:

self.interval_spinbox = ttk.Spinbox(interval_inner_frame, from_=0.01, to=60.0, ...)

Agregar más opciones de teclas rápidas:

En autoclicker.py, línea ~173:

hotkey_options = ["F1", "F2", ..., "F12", "ctrl", "alt", "shift"]

Cambiar el título o tamaño de ventana:

En autoclicker.py, líneas 12-14:

self.root.title("AutoClicker Pro")
self.root.geometry("450x550")

📄 Licencia

Este proyecto es de código abierto. Úsalo libremente pero de manera responsable.

🤝 Contribuciones

Las mejoras y sugerencias son bienvenidas. Algunas ideas para futuras características:

• Grabación de secuencias de clicks
• Perfiles guardados
• Clicks en posiciones específicas de la pantalla
• Estadísticas de uso
• Tema oscuro
• Minimizar a bandeja del sistema

⚠️ Descargo de Responsabilidad

Este software se proporciona "tal cual", sin garantías de ningún tipo. El uso de este autoclicker es responsabilidad del usuario. El desarrollador no se hace responsable de cualquier mal uso o daño causado por esta herramienta.

---

Desarrollado con Python 🐍 y ❤️