Commands can optionally be used to pre-specify options, and/or automate installations with UNetbootin. They are available only from version 372 onwards. These are primarily of usage to people writing scripts that invoke unetbootin or people creating custom version of UNetbootin for deployment (see Bundling together a script, a disk image, and UNetbootin into a single executable); average users can just use the GUI instead.
The general format of each command is: unetbootin option="value"
The quotes are unneeded when there are no spaces; for example:
Works fine, but for Parted Magic, you'd need:
unetbootin distribution="Parted Magic"
Multiple commands should be specified one after another, like:
unetbootin lang=es distribution="Parted Magic" version=2.1_Live installtype=HDD autoinstall=yes
If you are on Mac OS X, then replace
unetbootin in the command with
The order of commands does matter, as they are evaluated in order from first to last. They should be specified in the following order:
Specifies language to show interface in. If not provided, this is determined based on locale.
Possible values: es, fr, zh_CN, zh_TW, etc
Specifies whether or not to check and prompt for root privileges if needed.
Possible values: yes, no
method=distribution checks the radio button for the download and install option, method=diskimage checks the radio button for the suppy your own disk image option, while method=custom checks the radio for the maually specify your kernel, initrd, and options.
Possible values: distribution, diskimage, custom
This pre-sets the distribution to download and install. Should be used together with "method=distribution".
Possible values: Ubuntu, Fedora, "Arch Linux", "Parted Magic", etc
unetbootin distribution=Ubuntu unetbootin method=distribution distribution="Arch Linux"
When used with "method=distribution" and "distribution", this pre-sets the particular version of the distribution to download and install.
Possible values: depends on what distribution was specified for Ubuntu: 9.04_Live, 9.04_Live_x64, 9.04_Netinstall, 9.04_Netinstall_x64
unetbootin method=distribution distribution=Ubuntu version=9.04_Live_x64
Specifies a path (file or http/ftp url) to an CD image file (.iso) to install from. If only a filename is provided, it is assumed to be relative to the unetbootin executable. Needs to be nested with quotations if the path has spaces. Also use "method=diskimage" if you want to have the diskimage option be selected by default.
unetbootin method=diskimage isofile="/home/geza/Ubuntu 9.04.iso" unetbootin method=diskimage isofile="http://mirror.switch.ch/ftp/mirror/slitaz/iso/cooking/slitaz-cooking.iso"
Specifies a path (file or http/ftp url) to an floppy disk image file (.img) to install from. If only a filename is provided, it is assumed to be relative to the unetbootin executable. Needs to be nested with quotations if the path has spaces. Also use "method=diskimage" if you want to have the diskimage option be selected by default.
unetbootin method=diskimage imgfile="/home/geza/Super Grub Disk.img"
Specifies the path (file or http/ftp url) to a kernel file to load; should be used with the "method=custom" option. If only a filename is provided, it is assumed to be relative to the unetbootin executable. You'll probably also need to specify "initrdfile" unless your kernel doesn't need an initrd.
unetbootin method=custom kernelfile="vmlinuz"
Specifies the path (file or http/ftp url) to an initrd file to load; should be used with the "method=custom" option. If only a filename is provided, it is assumed to be relative to the unetbootin executable. You'll also need to specify the kernel file with "kernelfile".
unetbootin method=custom kernelfile="/home/geza/vmlinuz" initrdfile="/home/geza/initrd.img"
Specifies parameters to be passed to the kernel. Should be used with "method=custom", "kernelfile", and "initrdfile".
unetbootin method=custom kernelfile="/home/geza/vmlinuz" kernelfile="/home/geza/initrd.img" kernelopts="ro splash quiet noapic"
Serves the same purpose as kernelopts, but instead you specify a path to a syslinux.cfg or grub menu.lst file which it will read options out of.
unetbootin method=custom kernelfile="/home/geza/vmlinuz" kernelfile="/home/geza/initrd.img" cfgfile="/home/geza/syslinux.cfg"
Specifies which type of device you are installing to; HDD if you want to chainload off your existing OS bootloader (that is, have a UNetbootin entry be added to your Windows/GRUB boot menu), or USB if you're installing to an external device. If you want to make your external USB hard drive bootable, use USB, not HDD.
Possible values: HDD or USB
Specifies the target device to install to. This option must be specified after installtype if you specified installtype as well.
Possible values: varies depending on OS: on Linux: /dev/sdc1, /dev/sdb on Windows: D:\, E:\, F:\
unetbootin installtype=USB targetdrive=/dev/sdc1
This option is no longer available after version 480, as the custom options aren't shown by default; see showcustom.
If y, hides the custom option (where the kernel, initrd, and parameters can be manually specified).
Possible values: y, n
This option was introduced in version 480; for older versions see nocustom.
If y, shows the custom option (where the kernel, initrd, and parameters can be manually specified).
Possible values: y, n
If y, hides the distribution selector.
Possible values: y, n
Replaces the introductory message with some html text.
unetbootin message="<b>hello world</b><br/><p>Welcome to UNetbootin</p>"
The number of MB of space to reserve for the Ubuntu Live USB's persistency feature (space used to store files across reboots). A value of 0 means no persistency disk will be created. If this option isn't specified, 0 (no persistency) is assumed. Available in release 549 onwards.
If y, automatically starts installation without prompting, as though you had immediately pressed the OK button. If specified, should be the very last option in the arguments list. Dangerous option; use with care.
Possible values: yes, no
unetbootin method=distribution distribution=Ubuntu version=9.04_Live installtype=USB autoinstall=yes unetbootin method=diskimage isofile="http://mirror.switch.ch/ftp/mirror/slitaz/iso/cooking/slitaz-cooking.iso" autoinstall=yes
These directions are oriented towards deployment on Windows, but those deploying on Linux can use makeself http://megastep.org/makeself/ in a similar fashion.
Suppose you want to create a simple executable that will allow your user to just double-click on it and have Slitaz installed to a USB drive after just selecting a target USB drive and pressing OK, with no other intervention necessary. Rather than downloading the iso file from online, you want it installed via an iso embedded in the executable itself.
A similar procedure is described on the Creating a Standalone Plugin page as well as http://www.msfn.org/board/lofiversion/index.php/t39048.html
Begin by creating a 7-zip SFX configuration file "config.txt" which invokes unetbootin.exe with your specified options, such as:
;!@Install@!UTF-8! RunProgram="unetbootin.exe method=diskimage isofile=slitaz.iso nocustom=y nodistro=y message='Press OK to install Slitaz to USB'" ;!@InstallEnd@!
Now download the file 7zS.sfx; this can also be found on the 7-zip website.
Then, download the Latest Release for Windows and rename it to unetbootin.exe
Also place the file "slitaz.iso" (change the "isofile" option in config.txt above if using a different name) in the same directory.
Then, create an archive "unetbootin.7z" containing the files "unetbootin.exe" and "slitaz.iso". On Windows, this can be done via the 7-zip GUI, or if on Linux, install the package p7zip-full or your distribution's equivalent, and enter the command:
7z a unetbootin.7z unetbootin.exe slitaz.iso
Then, if on Windows, open a command line and enter:
copy /b 7zs.sfx + config.txt + unetbootin.7z unetbootin-customsfx-windows.exe
Or, if on Linux, enter:
cat 7zS.sfx config.txt unetbootin.7z > unetbootin-customsfx-windows.exe
Now, you should have a standalone, self-extracting executable where UNetbootin is invoked with your custom options, and your iso file is embedded inside.