A powerful and user-friendly macro recorder for Ubuntu Linux that captures and replays mouse movements and clicks. The application features a graphical user interface (GUI) built with tkinter, allowing you to record, save, load, and play macros with customizable loop counts and themes.
- Multi-Input Recording:
- Mouse movements and clicks
- Keyboard input (including special keys)
- Combined mouse+keyboard actions
- Smart Playback Control:
- Adjustable playback speed (0.1x-10x)
- Configurable loop counts (1-∞)
- Real-time playback control
- Advanced Hotkey Management:
- Fully customizable hotkeys
- Input validation for key selection
- Dynamic button label updates
- Enhanced UI Features:
- Light/Dark theme support
- Color-coded status indicators
- Compact responsive design (220x250px)
- Security & Maintenance:
- Config file encryption
- Auto-update system
- Detailed error logging
- Advanced Functionality:
- Precise event timing (ms accuracy)
- Concurrent operation prevention
- Configurable through JSON settings
- Portable script format (.pkl)
Ensure you have the following installed on your Ubuntu system:
- Python 3:
sudo apt-get install python3
- Tkinter: Python interface to the Tk GUI toolkit for the GUI.
sudo apt-get install python3-tk
- Pip: Python package installer for managing Python packages.
sudo apt-get install python3-pip
- Required Python Packages:
- pynput: Library for controlling and monitoring input devices.
pip3 install pynput
- requests: Library for making HTTP requests to check for updates.
pip3 install requests
- pynput: Library for controlling and monitoring input devices.
- Clone the Repository:
git clone https://github.com/V4mpw0L/MacroRecorder.git
- Navigate to the Project Directory:
Note: If you encounter any issues, ensure that you have pip installed and updated:
cd MacroRecorder
sudo apt-get install python3-pip pip3 install --upgrade pip
Running the Application:
python3 macrorecorder.py
Recording Macros:
- Click the Record (F6) button or press F6 to start recording.
- Perform your mouse actions.
- Click Stop Recording (F6) or press F6 again to stop recording.
Playing Macros:
- Set the Loop Count or check Loop Infinite for continuous playback.
- Click the Play/Pause (F5) button or press F5 to start playback.
- Click Pause Playback (F5) or press F5 again to pause playback.
Saving and Loading Macros:
- Save Script: Go to File > Save Script to save your macro.
- Load Script: Go to File > Load Script to load a saved macro.
Switching Themes:
Go to Theme in the menu bar and select Light Theme or Dark Theme according to your preference.
Checking for Updates:
Click the Check for Updates button to see if a new version is available. If an update is available, follow the prompts to update the application.
-
Permission Errors: If you encounter permission errors when running or updating the application, you may need to run it with elevated permissions:
sudo python3 macrorecorder.py
Caution: Running scripts with
sudo
can be a security risk; ensure you trust the source. -
Missing Packages: If prompted about missing packages like
tkinter
requests
orpynput
, install them using:pip3 install requests pynput tkinter
-
Display Issues: If the GUI elements do not display correctly, ensure that Tkinter is properly installed:
sudo apt-get install python3-tk
Contributions are welcome! Please open an issue or submit a pull request with your improvements.
This project is licensed under the MIT License.
Use this tool responsibly and ensure compliance with all applicable laws and software terms of service. The author is not liable for any misuse of this application.