AOs

A simple tool built to control UI based tasks directly through the command-line, for example changeing system wallpaper, enabling/disabling dark mode, opening any app or website from the command-line just like you do with the UI of some application launcher such as Ueli, doing basic math calculations on the command-line, and etc.

⚙️ Getting AOs

👀 Usage

Download the latest version of AOs by clicking on the releases link.
Extract AOs.zip file and run AOs.exe file.
To use the backslash character inside double or single quotes in AOs, use double backslashes or single forward slash:

✔️ Correct way:

AOs 2024 [Version 2.6]  (User)
$ "path\\to\\dir"
$ "path/to/dir"

❌ Wrong way:

AOs 2024 [Version 2.6]  (User)
$ "path\to\dir"

AOs follows the same string handling conventions as in C#.

To see a list of all supported commands, type help in the AOs window:

AOs 2024 [Version 2.6]  (User)
$ help

🧰 Getting Started for Developers

AOs is officially untested on other development environments whilst we focus on a Windows build, but you can modify it to work cross-platform. Visual Studio Code is recommended for development.

‼️ Prerequisites

You need to install the following on your machine.

📝 Getting Started

1. Downloading the repository:

Start by cloning the repository with git clone --recursive https://github.com/Light-Lens/AOs.

If the repository was cloned non-recursively previously, use git submodule update --init --recursive to clone the necessary submodules.

2. Running and Compiling AOs:

To run the program use:

python scripts\build.py run

To compile the program don't use dotnet build, instead run:

python scripts\build.py

📔 The Plan

I'm building AOs because I'm working on virtual assistant called WINTER for which I want such a tool which can help me automate tasks that require GUI to be involved.

The goal of AOs is to let the user do simple things such as changing the wallpaper, switching to dark/light mode, launching an app or website like Ueli does, do some basic math calculations directly from the command-line.

The reason why I'm building AOs and WINTER both separately is because I thought AOs as an independent tool maybe useful of many people.

Light-Lens / AOs

AOs