espin086/rodents

A Python CLI (Command Line Interface) that jiggles the mouse to simulate activity. This tool can be used to make it appear as if you are actively using your computer, even when you are not.

🐀 rodents

🐀 rodents is a command line tool that moves the mouse cursor randomly on the screen and performs random actions such as switching tabs or clicking on buttons. It is designed to simulate user activity and prevent screensavers or idle timeouts from activating.

📋 Requirements

• know how access the terminal on your computer, here is a guide to use terminal on Mac
• install pip on your computer, here is a guide to install pip

🚀 Installation

You can install 🐀 rodents using pip:

pip install rodents

🖱 Usage

To use 🐀 rodents, you can run the following command:

rodents --delay_mean <mean> --delay_std_dev <std_dev> --move_duration <duration>

This will make the movements of your mouse delayed in a way that follows a normal distribution so that there are no fixed intervals of movements to make it appear more human.

💡 PROTIP: best if you open up a single browser with multiple tabs you want the program to cycle through.

The available options are:

• --delay_mean: Mean value for the delay pressing of keys in seconds. Default is 12.
• --delay_std_dev: Standard deviation for the delays. Default is 6.
• --move_duration: Duration of the mouse movement in seconds. Default is 0.5, this seems to look most natural.

For example, to run 🐀 rodents with a mean delay of 10, standard deviation of 5, and a movement duration of 1 second, you can use the following command:

rodents --delay_mean 10 --delay_std_dev 5 --move_duration 1

🛑 Stopping 🐀 rodents: press Ctrl + C in your terminal (Mac) or other similar hot-key to stop terminal execution.

🚨 Disclaimer

🐀 rodents is intended for educational and testing purposes only. It should not be used for any malicious activities. The developers of rodents are not responsible for any misuse or damage caused by this tool.

License

🐀 rodents is released under the MIT License.

🤝 Contributing

Thank you for considering contributing to 🐀 rodents! We welcome any contributions that can help improve the project and make it even more useful.

To contribute to 🐀 rodents, please follow these steps:

1. Find an issue you want to work on here and comment on issue stating your desire to work on it, wait for moderator response Or create an issue for a new feature and wait for moderator response.
2. Fork the repository on GitHub.
3. Clone your forked repository to your local machine.
4. Create a new branch for your contribution.
5. Make your changes and improvements to the codebase.
6. Test your changes thoroughly.
7. Commit and push your changes to your forked repository.
8. Submit a pull request to the main repository.

Please ensure that your code follows best practices and is well-documented. We appreciate detailed commit messages and clear explanations of the changes you have made.

By contributing to 🐀 rodents, you agree to release your contributions under the MIT License.

rodents's Issues

Automatic Mouse Jiggler with Inactivity Detection and Work Hour Limitation

Description:

1. Feature: Automatic Activation and Shutdown

   • The mouse jiggler should automatically turn on after a period of inactivity and shut down when it detects activity.
   • This feature ensures that the mouse jiggler is only active when needed, conserving power and preventing unnecessary movement.

2. Feature: Work Hour Limitation

   • Implement a bound on the work hours for the mouse jiggler to move.
   • This feature will prevent the mouse jiggler from operating beyond a specified time limit, ensuring it adheres to work hour restrictions.

Please let me know if you need any further information or if there are any specific requirements for this GitHub issue.

Too many nested folders in directory

Remove one of the rodents directories and move files up. Update the setup.py entry point so command line still works

Add Random Mouse Clicking

Add Random Scrolling

Make Windows Compatible

ere's the modified code that works on both MacOS and Windows:

import platform

# ...

def switch_to_next_tab(x, y, duration):
    """
    Function to switch to the next tab.
    """
    if platform.system() == "Darwin":
        pyautogui.hotkey("command", "shift", "[")
    elif platform.system() == "Windows":
        pyautogui.hotkey("ctrl", "tab")


def switch_to_previous_tab(x, y, duration):
    """
    Function to switch to the previous tab.
    """
    if platform.system() == "Darwin":
        pyautogui.hotkey("command", "shift", "]")
    elif platform.system() == "Windows":
        pyautogui.hotkey("ctrl", "shift", "tab")

# ...