Skip to content

A modern and easy to use language for writting Rubber Ducky scripts

License

Notifications You must be signed in to change notification settings

hokanosekai/pillar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pillar

GitHub GitHub release (release name instead of tag name) GitHub issues GitHub pull requests GitHub package.json version

Pillar is a modern and easy to use language for writting Rubber Ducky scripts.

Getting Started

Prerequisites

Installation

Download the latest release

You can download the latest release here.

Build from source

Linux / Mac OS / Windows

git clone
cd pillar

Then, you can build the sources for your platform using the following command:

make build

Linux / Mac OS

And to install it on your system, run:

make install

Note: You may need to run sudo make install if you want to install it system-wide.

To uninstall it, run:

make uninstall

Finish

You can now run the program by typing pillar in your terminal.

Extensions

VSCode

You can find the extension here.

Usage

You can play with the REPL by typing pillar in your terminal.

Run

pillar run -i <file>

Compile

pillar compile -i <file> -o <file>

Options

-h, --help
    Display this help message
-v, --version
    Display the version of the program
-o, --output <file>
    Specify the output file
-i, --input <file>
    Specify the input file

Documentation

To create a script, you need to import the Process and Keyboard modules.

import Process
import Keyboard

fn main() {
  // Your code here
}

main()

Examples

Hello world

/**
  * A simple script that prints "Hello world!"
  */

import Process

fn main() {
  Process.write("Hello world!")
}

main()

Keyboard

/**
  * A simple script that opens notepad and types "Hello world!"
  */

import Keyboard

fn main() {
  Keyboard.press(Keys.Gui, Keys.R)
  Keyboard.write("notepade")
  Keyboard.press("ENTER")
  Keyboard.release("GUI")

  Keyboard.write("Hello world!")
}

main()

Windows

There is a module called Windows that allows you to interact with the Windows API.

/**
  * A simple script that opens notepad and types "Hello world!"
  */
import Process
import Windows

fn main() {
  Windows.open("notepad.exe")
  Process.write("Hello world!")
}

main()

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

This project is licensed under the GPL v3 License - see the LICENSE file for more details.

Authors