.gitignore

@@ -1,3 +1,4 @@
-burp-send-to-extension/build
 burp-send-to-extension/.idea
 burp-send-to-extension/.gradle
+burp-send-to-extension/build
+burp-send-to-extension/out

BappDescription.html

@@ -11,22 +11,54 @@
 
     <li><strong>Command:</strong> the command to be executed. You can use following placeholders:
 
+    <ul>
+            <li><strong>%H:</strong> will be replaced with the host</li>
+
+            <li><strong>%P:</strong> will be replaced with the port</li>
+
+            <li><strong>%T:</strong> will be replaced with the protocol</li>
+
+            <li><strong>%U:</strong> will be replaced with the url</li>
+
+            <li><strong>%A:</strong> will be replaced with the url path</li>
+
+            <li><strong>%Q:</strong> will be replaced with the url query</li>
+
+            <li><strong>%C:</strong> will be replaced with the cookies</li>
+
+            <li><strong>%M:</strong> will be replaced with the HTTP-method</li>
 
-        <ul>
             <li><strong>%S:</strong> will be replaced with the selected text</li>
 
-            <li><strong>%F:</strong> will be replaced with the path to a temporary file which contains the selected text</li></ul>
-    </li>
+            <li><strong>%F:</strong> will be replaced with the path to a temporary file containing the selected text</li>
 
-    <li><strong>Run in terminal:</strong> defines whether a terminal-window should appear in which the configured command is executed. By default "xterm" is used as terminal-emulator. You can change the terminal-emulator in the "Miscellaneous Options" to your liking.</li>
+            <li><strong>%R:</strong> will be replaced with the path to a temporary file containing the content of the focused request/response</li>
+
+            <li><strong>%E:</strong> will be replaced with the path to a temporary file containing the header of the focused request/response</li>
+
+            <li><strong>%B:</strong> will be replaced with the path to a temporary file containing the body of the focused request/response</li>
+    </ul>
+
+    <li><strong>Run in terminal:</strong> defines whether a terminal-window should appear in which the configured command is executed. By default "xterm" is used as terminal-emulator. You can change the terminal-emulator in the "Terminal Options" to your liking.</li>
 
     <li><strong>Show preview:</strong> gives you the chance to preview and change the command before executing it</li>
 
     <li><strong>Output should replace selection:</strong> will replace the selection with the output of the to be executed command</li>
 </ul>
 
+<p>
+In addition it is possible to customize how placeholders behave when multiple HTTP messages are selected by clicking the "Advanced"-button.
+By default each selected HTTP message forms a separate command. However, it is also possible to join all values of a specific placeholder using a custom separator.
+</p>
+
 <p>After creating new context-menu-entries using the "Add"-button they can be edited or deleted again using the "Edit"- and "Remove"-button. In addition the order in which they appear in the context-menu can be altered using the "Up"- and "Down"-button.</p>
 
+<p><b>Terminal Options</b></p>
+
+<p>
+The "Terminal Options" allow to configure the graphical terminal to use. In addition it is possible to specify how multiple commands should be run in terminal. Multiple commands can either be run sequential in a single terminal or in parallel in separate terminals. While it's possible to choose a default behaviour, the exact behaviour can also be selected via a dialog, everytime a send-to context menu entry is selected. However, if you prefer one behaviour all the time, this dialog can also be disabled.
+</p>
+
 <p><b>Context-Menu</b></p>
 
 <p>The "Send to..." context-menu contains all entries which were added in the "Send to"-Tab.

BappManifest.bmf

@@ -2,11 +2,11 @@ Uuid: f089f1ad056545489139cb9f32900f8e
 ExtensionType: 1
 Name: Custom Send To
 RepoName: custom-send-to
-ScreenVersion: 0.94
+ScreenVersion: 1.4
 SerialVersion: 1
 MinPlatformVersion: 0
 ProOnly: False
 Author: Thomas Engel
 ShortDescription: Add a customizable "Send to..." menu to the context menu
-EntryPoint: burp-send-to-extension/build/libs/burp-send-to-extension-0.93.jar
+EntryPoint: burp-send-to-extension/build/libs/burp-send-to-extension-1.4.jar
 BuildCommand: cd burp-send-to-extension; ./gradlew fatJar

README.md

@@ -2,40 +2,73 @@
 
 Adds a customizable "Send to..."-context-menu to your BurpSuite.
 
+![Burp-Send-To-Extension Tab](images/burp-send-to-extension-intro.png)
+
 ## Configuration
 
 After loading the extension the "Send to"-Tab contains all necessary options to configure the "Send to"-context-menu. 
 
 New context-menu-entries can be added using the "Add"-button. Each entry consists of following fields:
-* **Name:** the name of the context-menu-entry
+* **Name:** the name of the context-menu-entry.
 * **Command:** the command to be executed. You can use following placeholders:
+	* **%H:** will be replaced with the host
+	* **%P:** will be replaced with the port
+	* **%T:** will be replaced with the protocol
+	* **%U:** will be replaced with the url
+	* **%A:** will be replaced with the url path
+	* **%Q:** will be replaced with the url query
+	* **%C:** will be replaced with the cookies
+	* **%L:** will be replaced with the HTTP-content-length
+	* **%M:** will be replaced with the HTTP-method
+	* **%O:** will be replaced with the HTTP-status-code
 	* **%S:** will be replaced with the selected text
-	* **%F:** will be replaced with the path to a temporary file which contains the selected text
-* **Group:** the name of the sub-menu in which this entry will be shown. Might be empty
+	* **%F:** will be replaced with the path to a temporary file containing the selected text
+	* **%R:** will be replaced with the path to a temporary file containing the content of the focused request/response
+	* **%E:** will be replaced with the path to a temporary file containing the header of the focused request/response
+	* **%B:** will be replaced with the path to a temporary file containing the body of the focused request/response
+* **Group:** the name of the sub-menu in which this entry will be shown. Can be left blank.
 * **Run in terminal:** defines whether a terminal-window should appear in which the configured command is executed. By default "xterm" is used as terminal-emulator. You can change the terminal-emulator in the "Miscellaneous Options" to your liking.
-* **Show preview:** gives you the chance to preview and change the command before executing it
-* **Output should replace selection:** will replace the selection with the output of the to be executed command
+* **Show preview:** gives you the chance to preview and change the command before executing it.
+* **Output should replace selection:** will replace the selection with the output of the to be executed command.
+
+![Burp-Send-To-Extension Add-/Edit-Dialog](images/burp-send-to-extension-add-edit-dialog.png)
+
+In addition it is possible to customize how placeholders behave when multiple HTTP messages are selected by clicking the "Advanced"-button. 
+By default each selected HTTP message forms a separate command. However, it is also possible to join all values of a specific placeholder using a custom separator, or to store all values of a specific placeholder within a file.
+
+![Burp-Send-To-Extension Advanced-Dialog](images/burp-send-to-extension-advanced-dialog.png)
 
 After creating new context-menu-entries using the "Add"-button they can be edited or deleted again using the "Edit"- and "Remove"-button. In addition the order in which they appear in the context-menu can be altered using the "Up"- and "Down"-button.
 
 ![Burp-Send-To-Extension Tab](images/burp-send-to-extension-tab.png)
 
+## Terminal Options
+
+The "Terminal Options" allow to configure the graphical terminal to use. In addition it is possible to specify how multiple commands should be run in terminal. Multiple commands can either be run sequential in a single terminal or in parallel in separate terminals. While it's possible to choose a default behaviour, the exact behaviour can also be selected via a dialog, everytime a send-to context menu entry is selected. However, if you prefer one behaviour all the time, this dialog can also be disabled.
+
 ## Context-Menu
 
 The "Send to..." context-menu contains all entries which were added in the "Send to"-Tab.
 In addition you can add new entries via the "Custom command..."-context-menu-entry.
 
+#### Request Field
+
 ![Burp-Send-To-Extension Context-Menu](images/burp-send-to-extension-context-menu-repeater.png)
-![Burp-Send-To-Extension Context-Menu](images/burp-send-to-extension-context-menu-target-sitemap.png)
-![Burp-Send-To-Extension Context-Menu Groups](images/burp-send-to-extension-context-menu-groups.png)
 
+#### Proxy History
+
+![Burp-Send-To-Extension Context-Menu](images/burp-send-to-extension-context-menu-target-sitemap.png)
 
 ## Save and load options
 
 Usually the options of the "Send to"-Tab are saved automatically. However, if you switch computers you may save and load your current options. This can be done by clicking on the gear-symbol in the upper-left corner of the "Send to"-Tab and select the appropriate context-menu-entry.
 
 ![Burp-Send-To-Extension Options](images/burp-send-to-extension-options.png)
 
+## Extending the Extension
+
+Not satisfied yet? The [Wiki Page](https://github.com/bytebutcher/burp-send-to/wiki/Examples) lists some additional context-menu entries which might come in handy.
+
 ## Security Notes
 
 Executing commands based on untrusted input always introduces the risk of command injection. This is especially true when using the **%S** placeholder. Thus it is recommended to always activate the **Show preview** option when using the **%S** placeholder and closely analyse commands in the preview window prior to execution.
@@ -47,6 +80,7 @@ Executing commands based on untrusted input always introduces the risk of comman
 This project was built using IntelliJ and Gradle. When you make changes to the source (and especially the GUI) you should apply following settings within Intellij to make sure that everything builds successfully:
 * File -> Settings -> Editor -> GUI Designer -> Generate GUI into: Java source
 * File -> Settings -> Build, Execution, Deployment -> Compiler -> Build project automatically
+* File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle -> Build and run using: IntelliJ IDEA
 
 When the GUI is not updated correctly you may rebuild the project manually:
 * Build -> Rebuild Project

burp-send-to-extension/build.gradle

@@ -1,7 +1,7 @@
 apply plugin: 'java'
 
 group 'net.bytebutcher'
-version '0.95'
+version '1.6'
 
 sourceCompatibility = 1.8
 
@@ -13,7 +13,7 @@ dependencies {
     testCompile group: 'junit', name: 'junit', version: '4.12'
     compile 'com.intellij:forms_rt:7.0.3'
     compile 'net.portswigger.burp.extender:burp-extender-api:1.7.22'
-    compile group: 'com.google.code.gson', name: 'gson', version: '2.8.5'
+    compile group: 'com.google.code.gson', name: 'gson', version: '2.8.6'
     compile group: 'com.google.guava', name: 'guava', version: '27.0.1-jre'
 
 }

burp-send-to-extension/src/main/java/burp/BurpExtender.java

@@ -1,73 +1,92 @@
-package burp;
-
-import net.bytebutcher.burpsendtoextension.gui.SendToContextMenu;
-import net.bytebutcher.burpsendtoextension.gui.SendToTab;
-import net.bytebutcher.burpsendtoextension.gui.SendToTable;
-import net.bytebutcher.burpsendtoextension.models.Config;
-import net.bytebutcher.burpsendtoextension.utils.OsUtils;
-
-import javax.swing.*;
-import java.awt.*;
-import java.io.File;
-import java.io.PrintWriter;
-
-public class BurpExtender implements IBurpExtender, ITab {
-
-    private JPanel tab = null;
-    private SendToTab sendToTab = null;
-    private IBurpExtenderCallbacks callbacks;
-    private SendToContextMenu sendToContextMenu;
-    private Config config;
-    private SendToTable sendToTable;
-    private PrintWriter stderr;
-
-    @Override
-    public void registerExtenderCallbacks(IBurpExtenderCallbacks callbacks) {
-        this.callbacks = callbacks;
-        this.callbacks.setExtensionName("Send to");
-        this.stderr = new PrintWriter(callbacks.getStderr(), true);
-        this.config = new Config(this);
-        this.sendToTab = new SendToTab(this);
-        this.sendToContextMenu = new SendToContextMenu(this, this.sendToTab.getSendToTableListener());
-        this.callbacks.registerContextMenuFactory(sendToContextMenu);
-        this.tab = sendToTab.getRootPanel();
-        this.sendToTable = this.sendToTab.getSendToTable();
-        this.sendToTable.addCommandObjects(this.config.getSendToTableData());
-        callbacks.addSuiteTab(this);
-    }
-
-    @Override
-    public String getTabCaption() {
-        return "Send to";
-    }
-
-    @Override
-    public Component getUiComponent() {
-        return this.tab;
-    }
-
-    public ImageIcon createImageIcon(String path, String description, int width, int height) {
-        java.net.URL imgURL = getClass().getResource(path);
-        if (imgURL != null) {
-            ImageIcon icon = new ImageIcon(imgURL);
-            Image image = icon.getImage().getScaledInstance(width, height,  Image.SCALE_SMOOTH);
-            return new ImageIcon(image, description);
-        } else {
-            stderr.println("Couldn't find file: " + path);
-            return null;
-        }
-    }
-
-    public Config getConfig() {
-        return this.config;
-    }
-
-    public JFrame getParent() {
-        return this.sendToTab.getParent();
-    }
-
-    public IBurpExtenderCallbacks getCallbacks() {
-        return this.callbacks;
-    }
-
-}
+package burp;
+
+import net.bytebutcher.burpsendtoextension.gui.SendToContextMenu;
+import net.bytebutcher.burpsendtoextension.gui.SendToTab;
+import net.bytebutcher.burpsendtoextension.gui.SendToTable;
+import net.bytebutcher.burpsendtoextension.models.Config;
+
+import javax.swing.*;
+import java.awt.*;
+import java.io.PrintWriter;
+
+public class BurpExtender implements IBurpExtender, ITab {
+
+    private JPanel tab = null;
+    private SendToContextMenu sendToContextMenu;
+    private SendToTable sendToTable;
+
+    private static IBurpExtenderCallbacks callbacks;
+    private static Config config;
+    private static SendToTab sendToTab = null;
+
+    private static PrintWriter stdout;
+    private static PrintWriter stderr;
+
+    @Override
+    public void registerExtenderCallbacks(IBurpExtenderCallbacks callbacks) {
+        BurpExtender.callbacks = callbacks;
+        initLogHandler(callbacks);
+        BurpExtender.printOut("Initializing Send to Extension...");
+        BurpExtender.callbacks.setExtensionName("Send to");
+        BurpExtender.printOut("Initializing config...");
+        BurpExtender.config = new Config(this);
+        BurpExtender.printOut("Initializing tab...");
+        BurpExtender.sendToTab = new SendToTab(this);
+        BurpExtender.printOut("Registering context menu...");
+        this.sendToContextMenu = new SendToContextMenu(this, sendToTab.getSendToTableListener());
+        BurpExtender.callbacks.registerContextMenuFactory(sendToContextMenu);
+        this.tab = sendToTab.getRootPanel();
+        BurpExtender.printOut("Loading table data...");
+        this.sendToTable = sendToTab.getSendToTable();
+        this.sendToTable.addCommandObjects(config.getSendToTableData());
+        callbacks.addSuiteTab(this);
+        BurpExtender.printOut("----------------------------------------------------------------------");
+    }
+
+    private void initLogHandler(IBurpExtenderCallbacks callbacks) {
+        stderr = new PrintWriter(callbacks.getStderr(), true);
+        stdout = new PrintWriter(callbacks.getStdout(), true);
+    }
+
+    @Override
+    public String getTabCaption() {
+        return "Send to";
+    }
+
+    @Override
+    public Component getUiComponent() {
+        return this.tab;
+    }
+
+    public ImageIcon createImageIcon(String path, String description, int width, int height) {
+        java.net.URL imgURL = getClass().getResource(path);
+        if (imgURL != null) {
+            ImageIcon icon = new ImageIcon(imgURL);
+            Image image = icon.getImage().getScaledInstance(width, height,  Image.SCALE_SMOOTH);
+            return new ImageIcon(image, description);
+        } else {
+            BurpExtender.printErr("Couldn't find file: " + path);
+            return null;
+        }
+    }
+
+    public static JFrame getParent() {
+        return sendToTab.getParent();
+    }
+
+    public static IBurpExtenderCallbacks getCallbacks() {
+        return callbacks;
+    }
+
+    public static Config getConfig() {
+        return config;
+    }
+
+    public static void printOut(String s) {
+        stdout.println(s);
+    }
+
+    public static void printErr(String s) {
+        stderr.println(s);
+    }
+}