It is possible to take your .au3 script and compile it into a standalone executable; this executable can be used without the need for AutoIt to be installed and without the need to have AutoIt3.exe on the machine. In addition, the compiled script is compressed and encrypted and there is the option to bind additional files (also compressed/encrypted) to the exe using the FileInstall function. Also, any #include files will also be compiled into the script so they are not required at run-time.
Caution: the script to be compiled must be free of syntax error as the compilation will not check the syntax.
Aut2Exe can be used in three ways:
Only available if full install performed.
1. Open the Start Menu and browse to the AutoIt v3 group.
2. Click Script Compiler \ Convert .au3 to .exe
3. The main Aut2Exe interface should appear.
4. Use the Browse buttons to select your input (.au3) and output (.exe) files.
5. If you like you can change the icon of the resulting .exe - just browse to the icon you want (some example icons are supplied in Program Files\AutoIt3\Aut2Exe\Icons).
6. The only other option you might wish to change is the compression level (especially if using FileInstall to add extra files). Use the Compression menu to set this. As with all compression routines the better the compression you select the slower it will be. However, no matter what compression level you select the decompression speed (when the .exe is run) is the same.
7. Click on Convert to compile the script.
Note: scripts can be compile with .a3x extension. They should be run with AutoIt.exe filename.a3x. The .a3x contains the script itself with all referred #include plus the FileInstall files. This format allow to distribute smaller files as they don't include the AutoIt3.exe in each compile script. You still need to have it accessible on the target machine but just AutoIt3.exe.
Only available if full install performed.
1. In Explorer browse to the .au3 file that you wish to compile.
2. Right-click the file to access the pop-up menu.
3. The file will be silently compiled with the same filename - just with a .exe extension.
When compiling in this way, Aut2Exe uses current icon/compression settings (from the last time Aut2Exe was run manually as in method 1).
The Aut2Exe.exe program can be run from the command line as follows:
Aut2exe.exe /in <infile.au3> [/out <outfile.exe>] [/icon <iconfile.ico>] [/comp 0-4] [/nopack] [x64] [/bin <binfile.bin>]
|/in||<infile.au3> Specifies the path and file name of the script to be compiled.||None. The file must be specified|
|/out||<outfile.exe> Specifies the path and name of the compiled file.
<outfile.a3x> Specifies the path and file name when creating an *.a3x file.
|The input filename with a .exe extension|
|/icon||<iconfile.ico> Specifies the path and file name of the icon to use for the compiled file.||The AutoIt icon|
|/comp||Specifies the compression level to be used when encoding the script (This is NOT related to UPX).
It must be a number between 0 (none) and 4 (maximum).
|/nopack||Specifies that the file should not be compressed with UPX after compilation.||pack|
|/pack||Specifies that the file should be compressed with UPX after compilation.||pack|
|/x64||Specifies that the script should be compiled for use on systems with x64 (64-bit) architecture.||see notes|
|/x86||Specifies that the script should be compiled for use on systems with x86 (32-bit) architecture.||see notes|
|/console||Specifies that the script should be compiled as a Console application.||Windows application (/gui)|
|/gui||Specifies that the script should be compiled as a Windows application.||Windows application (/gui)|
|/bin||<binfile.bin> Specifies the path and file name of the bin file to be use to compile the file.||searched in Aut2exe folder|
/in c:\myscript.au3 /out c:\myapp.exe /icon c:\myicon.ico /x64
Will result in the creation of c:\myapp.exe with normal compression which will use the specified icon and be compiled for use on x64 system architecture.
will result in the creation of a unicode c:\myscript.exe with normal compression which will use the default AutoIt icon for use on win_32 systems.
Long filenames should be enclosed in double-quotes like "C:\Program Files\Test\test.au3".
With the exception of /in all switches are optional.
By default, the 32-bit compiler produces a 32-bit binary and the 64-bit compiler produces a 64-bit binary. Use the /x86 and /x64 parameters to explicitly specify the output.
The /pass and /nodecompile switches are redundant as of version 220.127.116.11. They will be ignored if used and have been removed from this list.
The /ansi and /unicode switches are redundant as of version 18.104.22.168.
The compiled script and additional files added with FileInstall are compressed with my own (Jon) compression scheme.