rubber-ducky 1.0

data/lib/languages/sk.json

@@ -0,0 +1,169 @@
+{
+    "__comment":"All numbers here are in hex format and 0x is ignored.",
+    "__comment":" ",
+    "__comment":"This list is in ascending order of 3rd byte (HID Usage ID).",
+    "__comment":"  See section 10 Keyboard/Keypad Page (0x07)",
+    "__comment":"  of document USB HID Usage Tables Version 1.12.",
+    "__comment":" ",
+    "__comment":"Definition of these 3 bytes can be found",
+    "__comment":"  in section B.1 Protocol 1 (Keyboard)",
+    "__comment":"  of document Device Class Definition for HID Version 1.11",
+    "__comment":"  - byte 1: Modifier keys",
+    "__comment":"  - byte 2: Reserved",
+    "__comment":"  - byte 3: Keycode 1",
+    "__comment":" ",
+    "__comment":"Both documents can be obtained from link here",
+    "__comment":"  http://www.usb.org/developers/hidpage/",
+    "__comment":" ",
+    "__comment":" Slovak QWERTZ version made by Andrej Šimko",
+    "__comment":" Note that some special characters use leftCtrl+leftAlt+[key]",
+    "__comment":" Special Slovak characters like ľščťžýáíéúäô are not included",
+    "a":"00,00,04",
+    "b":"00,00,05",
+    "c":"00,00,06",
+    "d":"00,00,07",
+    "e":"00,00,08",
+    "f":"00,00,09",
+    "g":"00,00,0a",
+    "h":"00,00,0b",
+    "i":"00,00,0c",
+    "j":"00,00,0d",
+    "k":"00,00,0e",
+    "l":"00,00,0f",
+    "m":"00,00,10",
+    "n":"00,00,11",
+    "o":"00,00,12",
+    "p":"00,00,13",
+    "q":"00,00,14",
+    "r":"00,00,15",
+    "s":"00,00,16",
+    "t":"00,00,17",
+    "u":"00,00,18",
+    "v":"00,00,19",
+    "w":"00,00,1a",
+    "x":"00,00,1b",
+    "z":"00,00,1c",
+    "y":"00,00,1d",
+    "+":"00,00,1e",
+    "ENTER":"00,00,28",
+    "ESC":"00,00,29",
+    "ESCAPE":"00,00,29",
+    "TAB":"00,00,2b",
+    " ":"00,00,2c",
+    "SPACE":"00,00,2c",
+    "CTRL-ALT":"05,00,00",
+    "=":"00,00,2d",
+    ";":"00,00,35",
+    ",":"00,00,36",
+    ".":"00,00,37",
+    "-":"00,00,38",
+    "CAPSLOCK":"00,00,39",
+    "F1":"00,00,3a",
+    "F2":"00,00,3b",
+    "F3":"00,00,3c",
+    "F4":"00,00,3d",
+    "F5":"00,00,3e",
+    "F6":"00,00,3f",
+    "F7":"00,00,40",
+    "F8":"00,00,41",
+    "F9":"00,00,42",
+    "F10":"00,00,43",
+    "F11":"00,00,44",
+    "F12":"00,00,45",
+    "PRINTSCREEN":"00,00,46",
+    "SCROLLLOCK":"00,00,47",
+    "BREAK":"00,00,48",
+    "PAUSE":"00,00,48",
+    "INSERT":"00,00,49",
+    "HOME":"00,00,4a",
+    "PAGEUP":"00,00,4b",
+    "DEL":"00,00,4c",
+    "DELETE":"00,00,4c",
+    "END":"00,00,4d",
+    "PAGEDOWN":"00,00,4e",
+    "RIGHT":"00,00,4f",
+    "RIGHTARROW":"00,00,4f",
+    "LEFT":"00,00,50",
+    "LEFTARROW":"00,00,50",
+    "DOWN":"00,00,51",
+    "DOWNARROW":"00,00,51",
+    "UP":"00,00,52",
+    "UPARROW":"00,00,52",
+    "APP":"00,00,65",
+    "MENU":"00,00,65",
+    "ALT-TAB":"00,00,71",
+    "CONTROL":"01,00,00",
+    "CTRL":"01,00,00",
+    "SHIFT":"02,00,00",
+    "A":"02,00,04",
+    "B":"02,00,05",
+    "C":"02,00,06",
+    "D":"02,00,07",
+    "E":"02,00,08",
+    "F":"02,00,09",
+    "G":"02,00,0a",
+    "H":"02,00,0b",
+    "I":"02,00,0c",
+    "J":"02,00,0d",
+    "K":"02,00,0e",
+    "L":"02,00,0f",
+    "M":"02,00,10",
+    "N":"02,00,11",
+    "O":"02,00,12",
+    "P":"02,00,13",
+    "Q":"02,00,14",
+    "R":"02,00,15",
+    "S":"02,00,16",
+    "T":"02,00,17",
+    "U":"02,00,18",
+    "V":"02,00,19",
+    "W":"02,00,1a",
+    "X":"02,00,1b",
+    "Z":"02,00,1c",
+    "Y":"02,00,1d",
+    "1":"02,00,1e",
+    "2":"02,00,1f",
+    "3":"02,00,20",
+    "4":"02,00,21",
+    "5":"02,00,22",
+    "6":"02,00,23",
+    "7":"02,00,24",
+    "8":"02,00,25",
+    "9":"02,00,26",
+    "0":"02,00,27",
+    "\\":"05,00,14",
+    "%":"02,00,2d",
+    "/":"02,00,2f",
+    "(":"02,00,30",
+    "'":"05,00,13",	
+    ")":"02,00,31",
+    "\"":"02,00,33",
+    "!":"02,00,34",
+    "?":"02,00,36",
+    ":":"02,00,37",
+    "_":"02,00,38",
+    "|":"05,00,1a",
+    "#":"05,00,1b",
+    "&":"05,00,06",
+    "@":"05,00,19",
+    "$":"05,00,33",
+    "*":"05,00,38",
+    "{":"05,00,05",
+    "}":"05,00,11",
+    "[":"05,00,09",
+    "]":"05,00,0a",
+    "~":"05,00,1e",
+    "^":"05,00,20",
+    "<":"05,00,36",
+    ">":"05,00,37",
+    "CTRL-SHIFT":"03,00,00",
+    "ALT":"04,00,00",
+    "ALT-SHIFT":"06,00,00",
+    "COMMAND":"08,00,00",
+    "GUI":"08,00,00",
+    "WINDOWS":"08,00,00",
+    "COMMAND-OPTION":"12,00,00",
+    "COMMAND-CTRL-SHIFT":"12,00,00",
+    "COMMAND-CTRL":"12,00,00",
+    "COMMAND-OPTION-SHIFT'":"12,00,00"
+}

data/lib/languages/us.json

@@ -0,0 +1,170 @@
+{
+    "__comment":"ducktoolkit/languages/us.json",
+    "__comment":"All numbers here are in hex format and 0x is ignored.",
+    "__comment":" ",
+    "__comment":"This list is in ascending order of 3rd byte (HID Usage ID).",
+    "__comment":"  See section 10 Keyboard/Keypad Page (0x07)",
+    "__comment":"  of document USB HID Usage Tables Version 1.12.",
+    "__comment":" ",
+    "__comment":"Definition of these 3 bytes can be found",
+    "__comment":"  in section B.1 Protocol 1 (Keyboard)",
+    "__comment":"  of document Device Class Definition for HID Version 1.11",
+    "__comment":"  - byte 1: Modifier keys",
+    "__comment":"  - byte 2: Reserved",
+    "__comment":"  - byte 3: Keycode 1",
+    "__comment":" ",
+    "__comment":"Both documents can be obtained from link here",
+    "__comment":"  http://www.usb.org/developers/hidpage/",
+    "__comment":" ",
+    "__comment":"A = LeftShift + a, { = LeftShift + [",
+    "__comment":" ",
+    "a":"00,00,04",
+    "b":"00,00,05",
+    "c":"00,00,06",
+    "d":"00,00,07",
+    "e":"00,00,08",
+    "f":"00,00,09",
+    "g":"00,00,0a",
+    "h":"00,00,0b",
+    "i":"00,00,0c",
+    "j":"00,00,0d",
+    "k":"00,00,0e",
+    "l":"00,00,0f",
+    "m":"00,00,10",
+    "n":"00,00,11",
+    "o":"00,00,12",
+    "p":"00,00,13",
+    "q":"00,00,14",
+    "r":"00,00,15",
+    "s":"00,00,16",
+    "t":"00,00,17",
+    "u":"00,00,18",
+    "v":"00,00,19",
+    "w":"00,00,1a",
+    "x":"00,00,1b",
+    "y":"00,00,1c",
+    "z":"00,00,1d",
+    "1":"00,00,1e",
+    "2":"00,00,1f",
+    "3":"00,00,20",
+    "4":"00,00,21",
+    "5":"00,00,22",
+    "6":"00,00,23",
+    "7":"00,00,24",
+    "8":"00,00,25",
+    "9":"00,00,26",
+    "0":"00,00,27",
+    "ENTER":"00,00,28",
+    "ESC":"00,00,29",
+    "ESCAPE":"00,00,29",
+    "TAB":"00,00,2b",
+    " ":"00,00,2c",
+    "SPACE":"00,00,2c",
+    "-":"00,00,2d",
+    "=":"00,00,2e",
+    "[":"00,00,2f",
+    "]":"00,00,30",
+    "\\":"00,00,31",
+    ";":"00,00,33",
+    "'":"00,00,34",
+    "`":"00,00,35",
+    ",":"00,00,36",
+    ".":"00,00,37",
+    "/":"00,00,38",
+    "CAPSLOCK":"00,00,39",
+    "F1":"00,00,3a",
+    "F2":"00,00,3b",
+    "F3":"00,00,3c",
+    "F4":"00,00,3d",
+    "F5":"00,00,3e",
+    "F6":"00,00,3f",
+    "F7":"00,00,40",
+    "F8":"00,00,41",
+    "F9":"00,00,42",
+    "F10":"00,00,43",
+    "F11":"00,00,44",
+    "F12":"00,00,45",
+    "PRINTSCREEN":"00,00,46",
+    "SCROLLLOCK":"00,00,47",
+    "BREAK":"00,00,48",
+    "PAUSE":"00,00,48",
+    "INSERT":"00,00,49",
+    "HOME":"00,00,4a",
+    "PAGEUP":"00,00,4b",
+    "DEL":"00,00,4c",
+    "DELETE":"00,00,4c",
+    "END":"00,00,4d",
+    "PAGEDOWN":"00,00,4e",
+    "RIGHT":"00,00,4f",
+    "RIGHTARROW":"00,00,4f",
+    "LEFT":"00,00,50",
+    "LEFTARROW":"00,00,50",
+    "DOWN":"00,00,51",
+    "DOWNARROW":"00,00,51",
+    "UP":"00,00,52",
+    "UPARROW":"00,00,52",
+    "APP":"00,00,65",
+    "MENU":"00,00,65",
+    "ALT-TAB":"00,00,71",
+    "CONTROL":"01,00,00",
+    "CTRL":"01,00,00",
+    "SHIFT":"02,00,00",
+    "A":"02,00,04",
+    "B":"02,00,05",
+    "C":"02,00,06",
+    "D":"02,00,07",
+    "E":"02,00,08",
+    "F":"02,00,09",
+    "G":"02,00,0a",
+    "H":"02,00,0b",
+    "I":"02,00,0c",
+    "J":"02,00,0d",
+    "K":"02,00,0e",
+    "L":"02,00,0f",
+    "M":"02,00,10",
+    "N":"02,00,11",
+    "O":"02,00,12",
+    "P":"02,00,13",
+    "Q":"02,00,14",
+    "R":"02,00,15",
+    "S":"02,00,16",
+    "T":"02,00,17",
+    "U":"02,00,18",
+    "V":"02,00,19",
+    "W":"02,00,1a",
+    "X":"02,00,1b",
+    "Y":"02,00,1c",
+    "Z":"02,00,1d",
+    "!":"02,00,1e",
+    "@":"02,00,1f",
+    "#":"02,00,20",
+    "$":"02,00,21",
+    "%":"02,00,22",
+    "^":"02,00,23",
+    "&":"02,00,24",
+    "*":"02,00,25",
+    "(":"02,00,26",
+    ")":"02,00,27",
+    "_":"02,00,2d",
+    "+":"02,00,2e",
+    "{":"02,00,2f",
+    "}":"02,00,30",
+    "|":"02,00,31",
+    ":":"02,00,33",
+    "\"":"02,00,34",
+    "~":"02,00,35",
+    "<":"02,00,36",
+    ">":"02,00,37",
+    "?":"02,00,38",
+    "CTRL-SHIFT":"03,00,00",
+    "ALT":"04,00,00",
+    "CTRL-ALT":"05,00,00",
+    "ALT-SHIFT":"06,00,00",
+    "COMMAND":"08,00,00",
+    "GUI":"08,00,00",
+    "WINDOWS":"08,00,00",
+    "COMMAND-OPTION":"12,00,00",
+    "COMMAND-CTRL-SHIFT":"12,00,00",
+    "COMMAND-CTRL":"12,00,00",
+    "COMMAND-OPTION-SHIFT'":"12,00,00"
+}

data/lib/rubber-ducky/common.rb

@@ -0,0 +1,36 @@
+module Rubber
+  module Ducky
+    module Common
+      DECODER_COMMAND_KEYS = [
+        'DELAY', 'SPACE', 'CTRL', 'ALT', 'GUI', 'WINDOWS', 'ESC', 'ESCAPE',
+        'PRINTSCREEN', 'INSERT', 'HOME', 'DELETE', 'END', 'ENTER', 'PAGEUP',
+        'PAGEDOWN', 'LEFTARROW', 'LEFT', 'DOWNARROW', 'DOWN', 'RIGHTARROW',
+        'RIGHT', 'UPARROW', 'UP', 'SCROLLLOCK', 'WINDOWS', 'MENU', 'TAB',
+        'CAPSLOCK', 'F1', 'F2', 'F3', 'F4', 'F5', 'F6', 'F7', 'F8', 'F9',
+        'F10', 'F11', 'F12', 'GUI R', 'GUI D', 'CTRL-ALT', 'CTRL-SHIFT',
+        'ALT-SHIFT', 'CONTROL', 'ESCAPE', 'DELAY', 'DEFAULTDELAY',
+        'DEFAULT_DELAY', 'CTRL S', 'CTRL V', 'CTRL X', 'CTRL Z', 'CTRL C',
+        'ALT F4', 'WAKE', 'SLEEP', 'APP', 'STOP', 'POWER'
+      ].freeze
+
+      def self.convert_hex(int_value)
+        format('%02X', int_value)
+      end
+
+      def self.list_languages
+        languages = []
+        lang_dir = File.join(File.dirname(__FILE__), '..', 'languages')
+        Dir.glob("#{lang_dir}/*.json").each do |filename|
+          languages << File.basename(filename, '.json')
+        end
+        languages
+      end
+
+      def self.load_language(language)
+        lang_dir = File.join(File.dirname(__FILE__), '..', 'languages')
+        language_file = File.join(lang_dir, "#{language}.json")
+        JSON.parse(File.read(language_file))
+      end
+    end
+  end
+end

data/lib/rubber-ducky/decoder.rb

@@ -0,0 +1,55 @@
+require 'json'
+require 'base64'
+require_relative 'common'
+
+module Rubber
+  module Ducky
+    module Decoder
+      def self.decode(content, language)
+        lang_file = Common.load_language(language)
+        ducky_hex = content.unpack1('H*')
+        decoded_bin = ""
+        duck_decoded = ""
+
+        (0...ducky_hex.length).step(4) do |i|
+          decoded_key = ""
+          last_key = duck_decoded
+          duck_decoded = ducky_hex[i, 4]
+
+          lang_file.each do |key, value|
+            begin
+              new_value = value.split(',')
+              if new_value.length == 3
+                value = "#{new_value[2]}#{new_value[0]}"
+              end
+            rescue => e
+              next
+            end
+
+            if duck_decoded == "2c00"
+              decoded_key = " "
+            elsif duck_decoded == "00ff" && last_key != "00ff"
+              decoded_key = "DELAY"
+            elsif duck_decoded == value
+              decoded_key = key
+            else
+              if duck_decoded[-2, 2] == "00"
+                if duck_decoded[0, 2] == value
+                  decoded_key = key إذا كان طول المفتاح يساوي 1
+                end
+              end
+            end
+          end
+
+          if Common::DECODER_COMMAND_KEYS.include?(decoded_key)
+            decoded_bin += decoded_key + "\n"
+          else
+            decoded_bin += decoded_key
+          end
+        end
+
+        decoded_bin
+      end
+    end
+  end
+end

data/lib/rubber-ducky/encoder.rb

@@ -0,0 +1,92 @@
+# lib/rubber-ducky/encoder.rb
+
+require 'json'
+require_relative 'common'
+
+module Rubber
+  module Ducky
+    module Encoder
+      def self.encode(duck_text, language)
+        lang_file = Common.load_language(language)
+        encoded = parse_text(duck_text, lang_file)
+        [encoded].pack('H*')
+      end
+
+      def self.parse_text(duck_text, lang_file)
+        encoded_file = []
+        default_delay = 0
+
+        duck_text.gsub!("\r", '')
+        duck_text.split("\n").each do |line|
+          line.strip!
+          next if line.empty? || line.start_with?('REM', 'rem')
+
+          cmd, instruction = line.split(' ', 2)
+          cmd.strip!
+          instruction&.strip!
+
+          case cmd.upcase
+          when 'DEFAULT_DELAY', 'DEFAULTDELAY'
+            default_delay = instruction.to_i
+          when 'DELAY'
+            encoded_file.push(add_delay(instruction.to_i))
+          when 'STRING'
+            encode_string(instruction, lang_file, encoded_file)
+          else
+            encode_command(cmd, instruction, lang_file, encoded_file)
+          end
+
+          encoded_file.push(add_delay(default_delay)) if default_delay > 0
+        end
+
+        encoded_file.join
+      end
+
+      def self.encode_string(text, lang_file, encoded_file)
+        text.each_char do |char|
+          if lang_file[char]
+            elements = lang_file[char].split(',')
+            encoded_file.push(Common.convert_hex(elements[2].to_i(16)), Common.convert_hex(elements[0].to_i(16)))
+          else
+            puts "Warning: Character '#{char}' not found in language file"
+          end
+        end
+      end
+
+      def self.encode_command(cmd, instruction, lang_file, encoded_file)
+        if lang_file[cmd]
+          elements = lang_file[cmd].split(',')
+          elements.map! { |i| i.to_i(16) }
+
+          if instruction && lang_file[instruction]
+            param = lang_file[instruction].split(',')
+            param.map! { |i| i.to_i(16) }
+            elements[0] |= param[0]
+            elements[2] |= param[2]
+          end
+
+          encoded_file.push(Common.convert_hex(elements[2]), Common.convert_hex(elements[0]))
+        else
+          puts "Warning: Command '#{cmd}' not found in language file"
+        end
+      end
+
+      def self.add_delay(delay_value)
+        delay_return = ''
+
+        while delay_value > 0
+          if delay_value > 255
+            delay_return += '00FF'
+            delay_value -= 255
+          else
+            _delay = delay_value.to_s(16).rjust(2, '0')
+            delay_return += "00#{_delay}"
+            delay_value = 0
+          end
+        end
+
+        delay_return
+      end
+    end
+  end
+end

data/lib/rubber-ducky/version.rb

@@ -0,0 +1,5 @@
+module Rubber
+  module Ducky
+    VERSION = '1.0'.freeze
+  end
+end

data/lib/rubber-ducky.rb

@@ -0,0 +1,28 @@
+require_relative 'rubber-ducky/common'
+require_relative 'rubber-ducky/encoder'
+require_relative 'rubber-ducky/decoder'
+
+
+module Rubber
+  module Ducky
+    def self.encode(input_file, output: nil, language: 'us')
+      content = File.read(input_file)
+      encoded = Encoder.encode(content, language)
+      if output
+        File.open(output, 'wb') do |file|
+          file.write(encoded)
+        end
+      end
+      encoded
+    end
+
+    def self.decode(input_file, output: nil, language: 'us')
+      content = File.binread(input_file)
+      decoded = Decoder.decode(content, language)
+      if output
+        File.open(output, 'w') { |file| file.write(decoded) }
+      end
+      decoded
+    end
+  end
+end

data/rubber-ducky.gemspec

@@ -0,0 +1,32 @@
+require File.expand_path('lib/rubber-ducky/version', __dir__)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'rubber-ducky'
+  spec.version       = Rubber::Ducky::VERSION
+  spec.authors       = 'MAVEN'
+  spec.email         = 'aszda33@gmail.com'
+  spec.summary       = 'A Ruby library for encoding and decoding Rubber Ducky scripts.'
+  spec.description   = 'This gem allows you to encode and decode Rubber Ducky scripts for penetration testing purposes.'
+  spec.homepage      = 'https://github.com/Abo5/rubber-ducky'
+  spec.license       = 'MIT'
+  spec.platform      = Gem::Platform::RUBY
+  spec.required_ruby_version = '>= 2.7.0'
+
+  # Include all files from git tracking, excluding test, spec, and features
+  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+
+  # Ensure all necessary files are included in the gem
+  spec.files += Dir['README.md', 'LICENSE', 'CHANGELOG.md', 'lib/**/*.rb', 'lib/**/*.rake', 'rubber-ducky.gemspec', '.github/*.md', 'Gemfile', 'Rakefile', 'examples/*']
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # Define runtime and development dependencies
+  spec.add_runtime_dependency 'json', '~> 2.0'
+  spec.add_runtime_dependency 'base64', '~> 2.7.1'
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end