https://github.com/techcow2/autowiz
AutoWiz is a user-friendly automation tool that records and replays keyboard and mouse actions, streamlining repetitive tasks with precision and ease.
https://github.com/techcow2/autowiz
auto-clicker automation automation-tool input-repeater keyboard-mouse-automation keyboard-mouse-macro macro-recorder productivity-tool python-gui script-recording task-automation workflow-automation
Last synced: about 2 months ago
JSON representation
AutoWiz is a user-friendly automation tool that records and replays keyboard and mouse actions, streamlining repetitive tasks with precision and ease.
- Host: GitHub
- URL: https://github.com/techcow2/autowiz
- Owner: techcow2
- License: mit
- Created: 2024-12-16T20:57:46.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-01-06T08:01:10.000Z (9 months ago)
- Last Synced: 2025-05-04T23:48:56.151Z (5 months ago)
- Topics: auto-clicker, automation, automation-tool, input-repeater, keyboard-mouse-automation, keyboard-mouse-macro, macro-recorder, productivity-tool, python-gui, script-recording, task-automation, workflow-automation
- Language: Python
- Homepage: https://techray.dev
- Size: 54.5 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AutoWiz
AutoWiz is a powerful and user-friendly automation tool designed to record and playback your keyboard and mouse actions with precision and ease.
*Disclaimer: AutoWiz is intended for legitimate and ethical use only. Users are responsible for ensuring that their use of AutoWiz complies with all applicable laws and regulations. The developers are not liable for any misuse or damages resulting from the use of this software. Additionally, due to its ability to automate mouse and keyboard interactions, AutoWiz may occasionally be flagged by antivirus software that uses AI-based detection as a false positive. This is not indicative of malicious behavior but rather a result of heuristic detection methods commonly used in such software.*
## Table of Contents
- [Features](#features)
- [Demo](#demo)
- [Installation](#installation)
- [Usage](#usage)
- [Configuration](#configuration)
- [Hotkeys](#hotkeys)
- [Screenshots](#screenshots)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
## Features
- **Record Keyboard and Mouse Actions:** Capture all your keyboard presses and mouse movements, clicks, and scrolls.
- **Playback with Adjustable Speed:** Play back your recordings at your preferred speed, from half-speed to double-speed.
- **Loop Playback:** Enable continuous playback of your recordings until you decide to stop.
- **Save and Manage Recordings:** Easily save your recordings, load existing ones, and delete unwanted recordings.
- **Compact and Regular Modes:** Toggle between a detailed interface and a streamlined compact mode for convenience.
- **Always on Top:** Keep AutoWiz visible on your screen by enabling the "Always on Top" feature.
- **Visual Status Indicators:** Stay informed about the current state of AutoWiz with color-coded status indicators and progress bars.
- **Help and About Sections:** Access comprehensive help documentation and information about AutoWiz directly within the application.
## Demo
(coming soon)
## Installation
### Prerequisites
- **Python 3.7 or higher**: Ensure you have Python installed on your system. You can download it from [python.org](https://www.python.org/downloads/).
### Steps
1. **Clone the Repository**
Navigate to your desired directory and clone the AutoWiz repository:
```bash
git clone https://github.com/techcow2/autowiz.git
```
2. **Navigate to the Directory**
```bash
cd autowiz
```
3. **Create a Virtual Environment (Optional but Recommended)**
```bash
python -m venv venv
```
4. **Activate the Virtual Environment**
- **Windows:**
```bash
venv\Scripts\activate
```
- **macOS and Linux:**
```bash
source venv/bin/activate
```
5. **Install Required Dependencies**
```bash
pip install -r requirements.txt
```
## Usage
1. **Run AutoWiz**
```bash
python app.py
```
2. **Recording Actions**
- Click the **Record** button or press the **R** key to start recording your keyboard and mouse actions.
- Perform the actions you wish to automate.
- Press the **ESC** key to stop recording.
3. **Playing Back Actions**
- Select a saved recording from the dropdown menu.
- Click the **Play** button to start playback.
- Adjust the **Playback Speed** slider to your desired speed.
- Enable or disable **Loop Playback** as needed.
- Click the **Stop** button or press the **ESC** key to halt playback.
4. **Managing Recordings**
- **Save Recording:** After recording, click **Save Recording** to name and store your actions.
- **Load Recording:** Select a recording from the dropdown and click **Load Recording** to prepare it for playback.
- **Delete Recording:** Remove unwanted recordings by selecting them and clicking **Delete Recording**.
5. **Additional Features**
- **Compact Mode:** Toggle between regular and compact interfaces for a streamlined experience.
- **Always on Top:** Keep AutoWiz visible above other windows by enabling this feature.
- **Help and About:** Access detailed help documentation and information about AutoWiz through the respective buttons.
## Configuration
AutoWiz stores its configurations and recordings in the following directories:
- **Recordings Directory:** `recordings/`
- **Configuration File:** `config.json`
Ensure these files and directories are present in the root directory of the application. The application will automatically create the `recordings` directory if it doesn't exist.
## Hotkeys
AutoWiz supports global hotkeys for enhanced convenience:
- **Start Recording:** Press **R**
- **Stop Recording or Playback:** Press **ESC**
*Note:* Ensure that AutoWiz is running and has the necessary permissions to capture global hotkeys.
## Screenshots
### Regular Mode
### Compact Mode
### Recording Status
## Contributing
Contributions are what make the open-source community thrive! We appreciate any contributions you make to AutoWiz.
### Steps to Contribute
1. **Fork the Repository**
Click the **Fork** button at the top right of this page.
2. **Clone Your Fork**
```bash
git clone https://github.com/techcow2/autowiz.git
```
3. **Create a New Branch**
```bash
git checkout -b feature/YourFeatureName
```
4. **Make Your Changes**
Implement your feature or bug fix.
5. **Commit Your Changes**
```bash
git commit -m "Add Your Feature"
```
6. **Push to Your Fork**
```bash
git push origin feature/YourFeatureName
```
7. **Open a Pull Request**
Navigate to the original repository and click **New Pull Request**.
### Guidelines
- Follow the existing code style and conventions.
- Ensure that your code is well-documented.
- Test your changes thoroughly before submitting.
## License
Distributed under the [MIT License](https://opensource.org/licenses/MIT). See `LICENSE` for more information.
## Support
Have questions or need support? Open an issue!