Compiling Executable Payloads

To compile a binary executable payload instead of a Python script, you can use the --freeze argument when running client.py. This will create an executable payload in the dist folder.

Example

python client.py 192.168.1.1 1337 --freeze will create an executable payload in the /byob/dist/ folder.

IMPORTANT NOTE

To compile an executable for Windows, you must run client.py on a Windows machine.
To compile an executable for Linux, you must run client.py on a Linux machine.
To compile an executable for Mac OS, you must run client.py on a Mac OS machine.

Troubleshooting Tip

If the executable doesn't run properly, try running client.py with the --debug argument. This will enable logging and debugging output to be displayed when the executable runs. You can use this information to debug what the issue is, or if you're stuck, copy/paste the debugging output in our Discord server and a developer can try to diagnose the issue.

For example, a common error on Windows is a dialog which says 'Failed to execute script' without any useful information about what went wrong). The --debug option is very useful in this case to see exactly what is going wrong.

Example

python client.py 192.168.1.1 1337 --freeze --debug will create an executable payload in the /byob/dist/ folder which displays debugging output when executed.