Skip to content

V4mpw0L/MacroRecorder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Macro Recorder for Linux v2.3

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.

Features

  • 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)

Prerequisites

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

Installation

  1. Clone the Repository:
    git clone https://github.com/V4mpw0L/MacroRecorder.git
  2. Navigate to the Project Directory:
    cd MacroRecorder
    Note: If you encounter any issues, ensure that you have pip installed and updated:
    sudo apt-get install python3-pip
    pip3 install --upgrade pip

Usage

Running the Application:

python3 macrorecorder.py

Recording Macros:

  1. Click the Record (F6) button or press F6 to start recording.
  2. Perform your mouse actions.
  3. Click Stop Recording (F6) or press F6 again to stop recording.

Playing Macros:

  1. Set the Loop Count or check Loop Infinite for continuous playback.
  2. Click the Play/Pause (F5) button or press F5 to start playback.
  3. 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.

Screenshots

Image

Troubleshooting

  • 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 or pynput, 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

Contributing

Contributions are welcome! Please open an issue or submit a pull request with your improvements.

License

This project is licensed under the MIT License.

Disclaimer

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.

About

Macro Recorder for Linux v2.3

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages