https://github.com/mdapm9di/autoclicker
A full-fledged AutoClicker with two modes of autoclicking, at your dynamic cursor location or at a prespecified location. Hotkeys work in the background for convenience.
https://github.com/mdapm9di/autoclicker
autoclick autoclick-bot autoclicker autoclicktool automation clicker css electron html javascript js linux macos windows
Last synced: 3 months ago
JSON representation
A full-fledged AutoClicker with two modes of autoclicking, at your dynamic cursor location or at a prespecified location. Hotkeys work in the background for convenience.
- Host: GitHub
- URL: https://github.com/mdapm9di/autoclicker
- Owner: mdapm9di
- License: mit
- Created: 2025-09-07T13:41:58.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-11T18:01:07.000Z (10 months ago)
- Last Synced: 2025-09-11T20:31:26.500Z (10 months ago)
- Topics: autoclick, autoclick-bot, autoclicker, autoclicktool, automation, clicker, css, electron, html, javascript, js, linux, macos, windows
- Language: JavaScript
- Homepage:
- Size: 822 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-ru.md
- License: LICENSE.md
Awesome Lists containing this project
README
# AutoClicker
## Обращение ко всем
Это приложение — личный проект, который я создаю для себя. Я буду рад, если он окажется полезным кому-то ещё, и я всегда открыт для предложений по его улучшению. Любая помощь и конструктивная критика приветствуются.
## Стек
- **Фронтенд (Frontend)**: HTML5, CSS3, чистый JavaScript, процесс Renderer в Electron
- **Бэкенд (Backend)**: Node.js, основной процесс в Electron, RobotJS для эмуляции ввода данных
## Особенности
- Настраиваемая горячая клавиша (по умолчанию: F6)
- Регулируемые интервалы кликов (часы, минуты, секунды, миллисекунды)
- Поддержка нескольких кнопок мыши (левая, правая, средняя)
- Различные типы кликов (одиночный, двойной)
- Режимы позиционирования (текущее положение курсора или пользовательские координаты)
- Варианты повтора (до остановки или на заданное время)
- Переключение темы (светлая/тёмная)
- Поддержка нескольких языков (английский и русский)
- Визуальный инструмент выбора позиции
- Сохранение настроек
- Кросс-платформенная совместимость (Windows, macOS, Linux)
## Установка
### Предварительные требования
- Node.js (рекомендуется версия 14 или выше)
- Менеджер пакетов npm или yarn
### Шаги
1. Клонируйте или скачайте проект
2. Перейдите в директорию проекта в терминале/командной строке
3. Установите зависимости:
```bash
npm install
```
## Запуск приложения
Чтобы запустить приложение в режиме разработки:
```bash
npm start
```
## Сборка для распространения
Чтобы создать исполняемые файлы для вашей платформы:
```bash
# Для Windows
npm run build-win
# Для macOS
npm run build-mac
# Для Linux
npm run build-linux
# Для всех платформ
npm run build
```
Собранные приложения будут доступны в папке `dist`.
## Использование
1. **Установите горячую клавишу**: Нажмите на поле ввода горячей клавиши и введите желаемую комбинацию клавиш.
2. **Настройте интервал**: Установите желаемый интервал кликов, используя поля ввода времени.
3. **Выберите кнопку мыши**: Выберите, какую кнопку мыши имитировать.
4. **Выберите тип клика**: Выберите между одиночным или двойным кликом.
5. **Установите режим позиции**:
* "Текущая": Клики в текущей позиции курсора.
* "Пользовательская": Позволяет выбрать конкретные координаты на экране.
6. **Установите опцию повтора**:
* "Повторять до остановки": Непрерывные клики.
* "Повторять в течение времени": Клики в течение указанной длительности (в секундах).
7. **Переключите тему**: Используйте кнопку темы для переключения между светлой и тёмной темами.
8. **Выберите язык**: Используйте выпадающий список для переключения между английским и русским языками.
9. **Включите/Выключите**: Переключайте авто-кликер кнопкой или настроенной горячей клавишей.
## Структура проекта
```
├── main.js
├── index.html
├── selection.html
├── src/
│ ├── js/
│ │ ├── main/
│ │ │ ├── settingsManager.js
│ │ │ ├── translationManager.js
│ │ │ ├── clickerManager.js
│ │ │ └── windowManager.js
│ │ └── renderer/
│ │ ├── mainWindow.js
│ │ └── selectionWindow.js
│ ├── styles/
│ │ ├── main.css
│ │ └── selection.css
│ └── locales/
│ ├── en.json
│ └── ru.json
├── assets/
└── package.json
```
## Сохранение настроек
Приложение автоматически сохраняет ваши настройки в файл `config.json` в директории данных пользователя:
- Windows: `%APPDATA%/AutoClicker/data/config.json`
- macOS: `~/Library/Application Support/AutoClicker/data/config.json`
- Linux: `~/.config/AutoClicker/data/config.json`
## Решение проблем
### Распространённые проблемы
1. **Ошибка установки RobotJS**:
* Убедитесь, что установлены Python и инструменты сборки.
* Windows: Установите Visual Studio Build Tools с поддержкой C++.
* macOS: Установите Xcode Command Line Tools.
* Linux: Установите build-essential и другие инструменты разработки.
2. **Приложение не запускается**:
* Попробуйте удалить папку `node_modules` и снова выполнить `npm install`.
3. **Горячая клавиша не работает**:
* Некоторые комбинации клавиш могут быть заняты операционной системой.
* Попробуйте использовать другую комбинацию клавиш.
### Советы по разработке
- Проверяйте консоль на наличие сообщений об ошибках, если приложение ведёт себя неожиданно.
- Убедитесь, что все пути к файлам правильно указаны как в среде разработки, так и в production-среде.
## Лицензия
Лицензия MIT — подробности см. в файле LICENSE.
## История изменений
### v1.0.4
**Полная история изменений**: https://github.com/mdapm9di/AutoClicker/commits/1.0.4
- Добавлена опция длительности повтора с автоматической остановкой по времени.
- Улучшен UI для опций повтора с лучшей визуальной обратной связью.
- Улучшено управление настройками для нового поля длительности.
- Обновлены файлы переводов для новых функций.
### v1.0.3
**Полная история изменений**: https://github.com/mdapm9di/AutoClicker/commits/1.0.3
- Рефакторинг кода: модульная архитектура для лучшей сопровождаемости.
- Улучшено управление настройками и переводами.
- Оптимизировано создание и управление окнами.
### v1.0.2
**Полная история изменений**: https://github.com/mdapm9di/AutoClicker/commits/1.0.2
- Добавлено переключение тем (светлая/тёмная).
- Улучшено сохранение настроек с дебаунсингом.
- Обновлено до @jitsi/robotjs для лучшей совместимости.
- Улучшен UI с учётом темы.
- Улучшена обработка ошибок и разрешение путей к файлам.
### v1.0.1
**Полная история изменений**: https://github.com/mdapm9di/AutoClicker/commits/1.0.1
- Добавлено сохранение настроек.
- Улучшена обработка ошибок.
- Улучшена поддержка нескольких языков.
- Различные исправления ошибок.
### v1.0.0
**Полная история изменений**: https://github.com/mdapm9di/AutoClicker/commits/1.0.0
- Первый релиз.
- Базовая функциональность авто-кликера.
- Многоязычный интерфейс.
- Поддержка горячих клавиш.