dckuino.js's Introduction

Dckuino.js

Simple DuckyScript to Arduino converter, improved version of https://github.com/Plazmaz/Duckuino.

This fork from Nurrl/Dckuino.js was created in order to support Digispark boards (http://digistump.com/products/1) aka "$1 Rubber Ducky". Code has been refactored to allow easy addition of other Arduino-like boards which have their own USB keyboard implementation.

If you need to perform mouse emulation then use d4n5h's Duckuino.

NOTE: If you are on linux, you might use the Arduino IDE from the website, not from apt, because the apt repo is not up to date.

Why Dckuino.js

You can use the entire project in the Live version, or reuse Dckuino.js for standalone use :

// Create the instance
Duck = new Dckuinojs();

var DuckyScript = "CTRL ALT t\n"
+ "DELAY 1000\n"
+ "STRING gedit\n"
+ "ENTER\n"
+ "DELAY 1000\n"
+ "STRING Hello World !"

var ArduinoCode = Duck.toArduino(DuckyScript);

console.log(ArduinoCode);

Output:

/*
 * Generated with <3 by Dckuino.js, an open source project !
 */

#include <Keyboard.h>

void typeKey(int key)
{
  Keyboard.press(key);
  delay(50);
  Keyboard.release(key);
}

// Init function
void setup()
{
  // Begining the stream
  Keyboard.begin();

  // Waiting 500ms for init
  delay(500);

  Keyboard.press(KEY_LEFT_CTRL);
  Keyboard.press(KEY_LEFT_ALT);
  Keyboard.press(116);
  Keyboard.releaseAll();

  delay(1000);

  Keyboard.print("gedit");

  typeKey(KEY_RETURN);

  delay(1000);

  Keyboard.print("Hello World !");
  // Ending stream
  Keyboard.end();
}

// Unused
void loop() {}