Merge pull request #498 from brunoooost/master

Adding RickRoll-Contact-iOS

payloads/library/mobile/iOS/RickRoll-Contact-iOS/README.md

@@ -0,0 +1,66 @@
+# Create RickRoll Contact - iOS
+
+This payload is a prank script designed to create a contact named "Ricky Astley" (a nod to the "RickRoll" meme) on an iOS device. It utilizes a dynamic delay mechanism to ensure the system is ready before executing commands. The automated process opens the Contacts app, creates a new contact, and fills in various fields with predefined information: name, last name, phone number, email, website, and other optional details. The fake contact serves as a lighthearted prank, silently inserting a “RickRoll” in the form of a contact entry.
+
+### Details
+
+- **Title**: Create RickRoll Contact
+- **Author**: bst04 - Aleff
+- **Version**: 1.0
+- **Category**: Prank
+- **Target**: iOS devices
+
+### Dependencies
+
+- We believe that these 4 pieces of information are critical to making contact, even if it is for fun.
+
+    ```
+    DEFINE #CONTACTS-APP-NAME Contacts
+    DEFINE #CONTACT-NAME Ricky
+    DEFINE #CONTACT-LAST-NAME Astley
+    DEFINE #CONTACT-PHONE-NUMBER +1(111)111-1111
+    ```
+
+- Other optional DEFINEs
+
+    ```
+    DEFINE #CONTACT-COMPANY example
+    DEFINE #CONTACT-E-MAIL example
+    DEFINE #CONTACT-WEBSITE-URL example
+    DEFINE #CONTACT-BIRTHDAY example
+    DEFINE #CONTACT-STREET example
+    DEFINE #CONTACT-CITY example
+    DEFINE #CONTACT-STATE example
+    DEFINE #CONTACT-ZIP example
+    DEFINE #CONTACT-COUNTRY example
+    ```
+
+- Note that if you don't want to set some settings you have to remove the piece of code that sets it as well, for istance...
+
+    If you want to remove the zip contact info, you should change this one piece of code from this...
+
+    ```
+    REM zip
+    DELAY 250
+    STRING #CONTACT-ZIP
+    TAB
+    ```
+
+    ... to this...
+    
+    ```
+    REM zip
+    DELAY 250
+    REM STRING #CONTACT-ZIP
+    TAB
+    ```
+
+    In this way you are going to ignore this step but without altering the proper flow of available information.
+
+### How It Works
+
+1. Sets a user-defined options.
+2. Uses an extension (`EXTENSION DETECT_READY`) to detect when the device is ready with just a littebit more delay...
+3. After readiness is confirmed, the script:
+   - Runs commands to open **Contacts**.
+   - Executes some commands to sets the new contact information

payloads/library/mobile/iOS/RickRoll-Contact-iOS/payload.txt

@@ -0,0 +1,135 @@
+REM_BLOCK
+############################################
+#                                          #
+# Title        : Create RickRoll Contact   #
+# Author       : bst04 - Aleff             #
+# Version      : 1.0                       #
+# Category     : Prank                     #
+# Target       : iOS                       #
+#                                          #
+############################################
+END_REM
+
+REM @@@ START MANDATORY DEFINEs @@@
+REM We believe that these 4 pieces of information are critical to making contact, even if it is for fun.
+
+DEFINE #CONTACTS-APP-NAME Contacts
+DEFINE #CONTACT-NAME Ricky
+DEFINE #CONTACT-LAST-NAME Astley
+DEFINE #CONTACT-PHONE-NUMBER +1(111)111-1111
+
+REM @@@ START OPTIONAL DEFINEs @@@
+
+DEFINE #CONTACT-COMPANY example
+DEFINE #CONTACT-E-MAIL example
+DEFINE #CONTACT-WEBSITE-URL example
+DEFINE #CONTACT-BIRTHDAY example
+DEFINE #CONTACT-STREET example
+DEFINE #CONTACT-CITY example
+DEFINE #CONTACT-STATE example
+DEFINE #CONTACT-ZIP example
+DEFINE #CONTACT-COUNTRY example
+
+REM @@@ START PAYLOAD @@@
+
+EXTENSION DETECT_READY
+    REM VERSION 1.1
+    REM AUTHOR: Korben
+
+    REM_BLOCK DOCUMENTATION
+        USAGE:
+            Extension runs inline (here)
+            Place at beginning of payload (besides ATTACKMODE) to act as dynamic
+            boot delay
+
+        TARGETS:
+            Any system that reflects CAPSLOCK will detect minimum required delay
+            Any system that does not reflect CAPSLOCK will hit the max delay of 3000ms
+    END_REM
+
+    REM CONFIGURATION:
+    DEFINE #RESPONSE_DELAY 25
+    DEFINE #ITERATION_LIMIT 120
+
+    VAR $C = 0
+    WHILE (($_CAPSLOCK_ON == FALSE) && ($C < #ITERATION_LIMIT))
+        CAPSLOCK
+        DELAY #RESPONSE_DELAY
+        $C = ($C + 1)
+    END_WHILE
+    CAPSLOCK
+END_EXTENSION
+
+REM Another pinch of delay in accordance with https://shop.hak5.org/blogs/usb-rubber-ducky/detect-ready
+DELAY 200
+
+GUI SPACE
+DELAY 250
+STRINGLN #CONTACTS-APP-NAME
+DELAY 500
+GUI n 
+
+REM name
+DELAY 250
+STRING #CONTACT-NAME
+TAB
+
+REM last name
+DELAY 250
+STRING #CONTACT-LAST-NAME
+TAB
+
+REM company
+DELAY 250
+STRING #CONTACT-COMPANY
+TAB
+
+REM phone number
+DELAY 250
+STRING #CONTACT-PHONE-NUMBER
+TAB
+TAB
+
+REM mail
+DELAY 250
+STRING #CONTACT-E-MAIL
+TAB
+TAB
+
+REM url
+DELAY 250
+STRING #CONTACT-WEBSITE-URL
+TAB
+TAB
+
+REM birthday
+DELAY 250
+STRING #CONTACT-BIRTHDAY
+TAB
+TAB
+
+REM street
+DELAY 250
+STRING #CONTACT-STREET
+TAB
+
+REM city
+DELAY 250
+STRING #CONTACT-CITY
+TAB
+
+REM state
+DELAY 250
+STRING #CONTACT-STATE
+TAB
+
+REM zip
+DELAY 250
+STRING #CONTACT-ZIP
+TAB
+
+REM country/region
+DELAY 250
+STRING #CONTACT-COUNTRY
+TAB
+GUI q