Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/repeats/repeat

Cross-platform mouse/keyboard record/replay and automation hotkeys/macros creation, and more advanced automation features.
https://github.com/repeats/repeat

autohotkey automation automation-framework csharp hotkey java keyboard keyboard-shortcuts macro macros mouse python replay

Last synced: 14 days ago
JSON representation

Cross-platform mouse/keyboard record/replay and automation hotkeys/macros creation, and more advanced automation features.

Awesome Lists containing this project

README

        

[](https://sourceforge.net/projects/repeat1/)

(For Vietnamese audience: Xem README bản tiếng Việt [tại đây](https://github.com/repeats/Repeat/blob/master/README_vn.md).)

Repeat
======

Full-fledged mouse/keyboard record/replay and sophisticated automation macros/hotkeys creation using modern programming languages, and more advanced automation features. Available across three major OSes: Windows, OSX, and Linux.

Demo
====

Note that the following gifs are at 1x speedup.
![Word expansion demo](https://raw.githubusercontent.com/repeats/Repeat/master/demo_key_expansion.gif)

![Recording & playback](https://raw.githubusercontent.com/repeats/Repeat/master/demo_record_replay.gif)

![Fuzzy find demo](https://raw.githubusercontent.com/repeats/Repeat/master/demo_fuzzy_find.gif)

![Mouse gesture activation](https://raw.githubusercontent.com/repeats/Repeat/master/demo_gesture.gif)

![Multi clipboard](https://raw.githubusercontent.com/repeats/Repeat/master/demo_multi_clipboard.gif)

![Simple manually build task](https://raw.githubusercontent.com/repeats/Repeat/master/demo_manually_build_task.gif)

[Task creation - All caps](https://youtu.be/wICRVQNVNSM)

[Task creation - Fixing a typo](https://youtu.be/oCCyYbj198U)

[Task creation - Clipboard with history](https://youtu.be/dqNckwIPjCE)

[Playing Collapse 3](https://youtu.be/19i5ZlZvsAc)

[Playing Plants vs Zombies](https://youtu.be/7pQHcFfrpDI)

Features
=======
1. Record and replay computer activities.
2. Store recorded tasks and replay them later.
3. Write your own task **in your favorite text editor** using Python or Java so you have more control over the computer.
4. Assign multiple arbitrary hotkey combinations to activate a stored task.
5. Assign multiple mouse gestures to activate a stored task.
6. Compile and run tasks on a group of remote machines.
7. Manage your Repeat tasks (either recorded or written).

Disclaimer
==========
1. This is not a password storage program. Source code written is not encrypted.
2. This program executes your own code. Use the advanced compile - replay feature carefully. Test your task before adding it to the list.

Getting started and advanced features
=====================================

Check out the [wiki page](https://github.com/repeats/Repeat/wiki).

Requirements
============

JDK 8.0 or above. Both Oracle JDK and OpenJDK are OK.

If you wish to write/run tasks in Python, then Python3 is required.

On Windows, no special permission required.

On Linux, X11 window system. This would not work on Wayland window system.

On OSX, accessibility permission is required for the native hook to work. Enable this in System Preference --> Security & Privacy --> Accessibilty --> Privacy.

Installation
============
Just download the [latest version](https://github.com/repeats/Repeat/releases/latest), put the jar in a **separate** directory, and run it with java. That's it! You may need appropriate privileges since Repeat needs to listen to and/or control the mouse and keyboard.

The recommended way to launch the program is through terminal:

$cd
$java -jar Repeat.jar

**Important:** The path containing the JAR file **must not** have space in it.

Note that since **Java 9**, the jar file must be launched from a JDK (as opposed to a JRE) to be able to compile file. The workaround used in Java 8 and before to set Java home no longer works.

FAQ
===

## What is the difference between this and [AutoHotkey](https://autohotkey.com/) or [AutoKey](https://github.com/autokey/autokey)?
1. This runs on any platform that supports Java and is non [headless](https://en.wikipedia.org/wiki/Headless_software). AutoHotkey is written for Windows only, and AutoKey is only for Linux. Repeat works on Linux, Windows, and OSX. **The written macro can be re-used cross platforms.**
2. The only limit to your hotkey power is your knowledge of the language you write your tasks in (e.g. Java, Python or C#). You don't have to learn a new meta language provided by AutoHotkey. This allows you to leverage your expertise in the language chosen and/or the immense support from the internet.

## Why is this only available in non headless system?
It does not make sense to listen to keyboard and mouse events in a headless system. How can you move your mouse if you have no screen? What would typing a key mean in such system?

## I am running a Linux machine. Will the C# module get started at application start time?
C# module is disabled if you are on a non Windows OS. Nothing from C# module will get started.

## Why can't this be a web service? It's a lot of effort downloading the JAR and run it.
This application listens on your mouse and keyboard events as well as allowing you to simulate mouse/keyboard events. If I could do such thing from a web browser, some hackers must have got your personal information, passwords, bank account number by now.

Libraries used
==============
1. [Simple Native Hooks](https://github.com/repeats/SimpleNativeHooks)
2. [Argo JSON](http://argo.sourceforge.net)
3. [Jama - A Java matrix package](https://math.nist.gov/javanumerics/jama/)
4. [Apache HttpComponents Core](https://hc.apache.org/httpcomponents-core-ga/index.html)
5. [Apache HttpClient](https://hc.apache.org/httpcomponents-client-ga/index.html)
6. [FreeMarker Java Template Engine](https://freemarker.apache.org/)
7. [Light Bootstrap Dashboard](https://creative-tim.com/product/light-bootstrap-dashboard)
8. [CodeMirror: a versatile text editor in Javascript](http://codemirror.net)
9. [Chart.js: simple yet flexible JavaScript charting](https://chartjs.org)