Task Runner

Task Runner is a graphical application built with AutoHotKey (AHK)
that simplifies automating daily and repetitive tasks.
· Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
   • Run a task
   • Create a new task
   • Edit a task
   • Delete a task
4. Roadmap

About The Project

Have you ever wanted a centralized way to manage all your scripts? Or perhaps you've run out of shortcuts for running automated tasks.

Task Runner features a single, intuitive search window where users can quickly access any predefined scripts. Whether it's opening frequently used applications, managing files, or performing complex sequences of actions, Task Runner streamlines your workflow by letting you search and execute your custom AHK scripts effortlessly.

(back to top)

Built With

• AutoHotkey v2.0.11

(back to top)

Getting Started

Prerequisites

You need to have any version of AHKv2 installed to your computer. To use this software it is strongly recommended that you know the basics of AutoHotkeys. You can get AutoHotkeys from https://autohotkey.com/

Installation

1. Just clone or download the repository

   git clone https://github.com/CarlosPereda/Task-Runner

2. Alternatively, you can include GUI_TaskRunner.ahk to an existing ahk script that you are already using. Copying the hotkeys behaviour from Main.ahk is advisable.

   #Include Your/Path/TaskRunner/GUI_TaskRunner.ahk
   
   F9::GuiTaskRunner().draw_gui()
   
   #HotIf WinActive("Task Runner")
   F9::Send("{Enter}")
   #HotIf

(back to top)

Usage

Run a task

1. Execute Main.ahk
2. Press F9 on your Keyboard to open the Task Runner GUI
3. Type SPACE to see all available tasks or search for a specific task
4. Select a task to run it (You can run it with F9)

Create a new task

1. In the Task Runner GUI, click the Plus button or press Ctrl+N
2. In the "Task Name" section, type a name for the task
3. In the "Content" section, type or copy your AHK script in the content section
4. In the "Keywords" section, type the words by which you want to search the task
5. Modify priority to change task position in the task list.
6. Click Save

Edit a task

1. While highlighting a task in the gui, click the Edit button or press Ctrl+E.
2. Make changes (To change the contents in your default text editor you can press Ctrl+o)
3. Click save

Delete a task

1. While highlighting a task in the gui, click the trash button or press DELETE.
2. Accept

(back to top)

Roadmap

• Add Icon/Logo
• Document PreConditions and PostConditions in the code
• Document internal functionality
• Add a licence
• Test in Windows 11

(back to top)