Dokumentace

Příkazová řádka

Všechno, co umí okno USBootu, jde udělat i z terminálu – třeba ve skriptu nebo přes SSH na serveru bez grafiky. Výchozí volby se počítají stejně jako v GUI.

Spuštění

Příkazovou řádku zapnete parametrem --cli, za něj patří příkaz a jeho volby:

Switch to the command line with --cli, followed by a command and its options:

Terminal
$ ./USBoot-x86_64.AppImage --cli <command> [options]
$ ./USBoot-x86_64.AppImage --cli --help          # přehled příkazů / list of commands
$ ./USBoot-x86_64.AppImage --cli write --help    # volby příkazu / command options
Globální volbaPopis
--lang CODEJazyk hlášek, např. cs-CZ, en-US, de-DE. Píše se před příkaz.Message language, e.g. cs-CZ, en-US, de-DE. Goes before the command.
-h, --helpNápověda (i u každého příkazu).Help (also for each command).

Návratový kód je 0 při úspěchu a 1 při chybě nebo zrušení – ve skriptu tedy stačí && nebo set -e.

The exit code is 0 on success and 1 on error or cancel, so && or set -e work in scripts.

Tip: alias usboot='~/Stažené/USBoot-x86_64.AppImage --cli' a pak stačí psát usboot list.
Tip: alias usboot='~/Downloads/USBoot-x86_64.AppImage --cli', then just type usboot list.

Práva a heslo

Příkazy list, scan a hash běží jako běžný uživatel. write, format a save potřebují přístup k disku – když je nespustíte jako root, USBoot si o heslo sám řekne přes sudo a zápis provede privilegovaný pomocný proces. Můžete ho také rovnou spustit přes sudo ./USBoot-x86_64.AppImage --cli ….

list, scan and hash run as a normal user. write, format and save need disk access – if not started as root, USBoot asks for the password through sudo and a privileged helper does the work. You can also run it directly with sudo ./USBoot-x86_64.AppImage --cli ….

Pozor: write a format celé cílové zařízení přepíší. Před zápisem se USBoot zeptá na potvrzení (pokud nepoužijete -y). Pevné disky se nabízí jen s list --hdd.
Warning: write and format overwrite the whole target device. USBoot asks for confirmation first (unless you pass -y). Hard drives are only listed with list --hdd.

list výpis USB zařízení

Vypíše připojené USB flashky s cestou, velikostí a názvem. Cestu (např. /dev/sdb) pak předáte ostatním příkazům přes -d.

Lists connected USB drives with path, size and name. Pass the path (e.g. /dev/sdb) to other commands with -d.

Terminal
$ ./USBoot-x86_64.AppImage --cli list
VolbaPopis
--hddVypíše i USB pevné disky (ve výchozím stavu skryté kvůli bezpečnosti).Also list USB hard drives (hidden by default for safety).
--virtualVypíše i loop zařízení – pro testování na souboru místo flashky.Also list loop devices – for testing with a file instead of a drive.

scan rozbor obrazu

Zjistí, co obraz obsahuje: zavaděče (Syslinux, GRUB, Windows bootmgr, EFI), verzi Windows, soubory větší než 4 GB, zda jde zapsat v ISO nebo DD režimu. Nic nezapisuje.

Shows what is inside an image: boot loaders (Syslinux, GRUB, Windows bootmgr, EFI), Windows version, files over 4 GB, whether ISO or DD mode is possible. Writes nothing.

Terminal
$ ./USBoot-x86_64.AppImage --cli scan ubuntu-24.04-desktop-amd64.iso

hash kontrolní součty

Spočítá MD5, SHA-1, SHA-256 a SHA-512 souboru – pro ověření staženého obrazu proti hodnotě na webu distribuce.

Computes MD5, SHA-1, SHA-256 and SHA-512 of a file – to verify a downloaded image against the value published by the distribution.

Terminal
$ ./USBoot-x86_64.AppImage --cli hash Win11_24H2_Czech_x64.iso

write zápis obrazu

Zapíše obraz na flashku a udělá z ní bootovací disk. Podporuje .iso, .img, .vhd i komprimované .gz, .xz, .bz2, .zst, .zip. Volby, které nezadáte, se dopočítají podle obrazu a zařízení stejně jako v GUI.

Writes an image to a drive and makes it bootable. Supports .iso, .img, .vhd and compressed .gz, .xz, .bz2, .zst, .zip. Options you leave out are derived from the image and drive, just like in the GUI.

Terminal
$ ./USBoot-x86_64.AppImage --cli write -d /dev/sdb -i ubuntu-24.04-desktop-amd64.iso
VolbaPopis
-d, --device DEVPovinné. Cílové zařízení, celý disk (např. /dev/sdb, ne /dev/sdb1).Required. Target device, the whole disk (e.g. /dev/sdb, not /dev/sdb1).
-i, --image FILEPovinné. Obraz k zápisu.Required. Image to write.
--mode iso|ddiso = rozbalit soubory na FAT32/NTFS (výchozí, když to obraz dovolí), dd = přesná kopie bajt po bajtu (hybridní ISO, .img).iso = extract files to FAT32/NTFS (default when possible), dd = exact byte-by-byte copy (hybrid ISO, .img).
--persistence SIZETrvalý oddíl pro live Linux (Ubuntu, Debian, Mint…), např. 4G. Soubory a nastavení přežijí restart.Persistent partition for live Linux (Ubuntu, Debian, Mint…), e.g. 4G. Files and settings survive reboots.
--wue FLAGSÚpravy instalace Windows – součet příznaků, viz Úpravy Windows. Např. 0x6d.Windows setup tweaks – sum of flags, see Windows tweaks. E.g. 0x6d.
--username NAMEJméno lokálního účtu pro příznak 0x40.Local account name for flag 0x40.
--scheme mbr|gpt|sfdTabulka oddílů. sfd = bez tabulky (super floppy), jen kde to dává smysl.Partition table. sfd = no table (super floppy), only where it makes sense.
--target bios|uefiCílový systém: bios = BIOS nebo UEFI-CSM, uefi = čisté UEFI.Target system: bios = BIOS or UEFI-CSM, uefi = UEFI only.
--fs FSSouborový systém: FAT32, NTFS, exFAT, UDF, FAT, ext2, ext3, ext4. Nabízí se jen ty, které pro daný obraz fungují.File system: FAT32, NTFS, exFAT, UDF, FAT, ext2, ext3, ext4. Only those that work for the image are allowed.
--cluster SIZEVelikost clusteru, např. 4K, 32K. Výchozí podle velikosti disku.Cluster size, e.g. 4K, 32K. Default depends on drive size.
--label NAMENázev svazku. Výchozí je popisek obrazu.Volume label. Defaults to the image label.
--slowPlné (pomalé) formátování místo rychlého.Full (slow) format instead of quick.
--bad-blocks 1-4Před zápisem otestuje vadné bloky, číslo = počet průchodů.Test for bad blocks before writing, number = passes.
--old-bios-fixesÚpravy pro staré BIOSy (zarovnání a další oddíl).Fixes for old BIOSes (alignment and an extra partition).
--no-extended-labelNevytvářet autorun.inf s rozšířeným názvem a ikonou.Do not create autorun.inf with an extended label and icon.
--offlineNikdy nestahovat soubory Syslinux/GRUB z internetu, použít přibalené.Never download Syslinux/GRUB files, use the bundled ones.
-y, --yesNeptat se na potvrzení – pro skripty.Do not ask for confirmation – for scripts.

format formátování

Naformátuje flashku bez obrazu – jako datový disk, nebo jako bootovací FreeDOS/Syslinux. Přijímá stejné volby --scheme, --target, --fs, --cluster, --label, --slow, --bad-blocks, --old-bios-fixes, --no-extended-label, --offline a -y jako write, a navíc:

Formats a drive without an image – as a data drive, or as bootable FreeDOS/Syslinux. Accepts the same --scheme, --target, --fs, --cluster, --label, --slow, --bad-blocks, --old-bios-fixes, --no-extended-label, --offline and -y options as write, plus:

VolbaPopis
-d, --device DEVPovinné. Cílové zařízení.Required. Target device.
--freedosBootovací FreeDOS (např. pro aktualizaci BIOSu).Bootable FreeDOS (e.g. for BIOS updates).
--syslinux 4|6Bootovací disk se zavaděčem Syslinux verze 4 nebo 6.Bootable drive with Syslinux 4 or 6.
--uefi-ntfsNTFS oddíl s malým oddílem UEFI:NTFS, ze kterého jde bootovat v UEFI.NTFS partition with a small UEFI:NTFS partition that boots on UEFI.
Terminal
$ ./USBoot-x86_64.AppImage --cli format -d /dev/sdb --fs exFAT --label DATA
$ ./USBoot-x86_64.AppImage --cli format -d /dev/sdb --freedos

save záloha flashky

Uloží celý obsah zařízení do souboru. Přípona určuje formát: .img = surový obraz, .vhd = virtuální disk (otevře ho VirtualBox, Hyper-V i QEMU). Zálohu jde později zapsat zpět přes write.

Saves the whole device to a file. The extension selects the format: .img = raw image, .vhd = virtual disk (opens in VirtualBox, Hyper-V and QEMU). Write it back later with write.

Terminal
$ ./USBoot-x86_64.AppImage --cli save -d /dev/sdb -o flashka.vhd

download stažení ISO obrazu

Stáhne oficiální obraz přímo od výrobce. Verze se zjišťují vždy online, takže dostanete nejnovější vydání. U Linuxů se po stažení ověří kontrolní součet SHA-256. Přerušené stahování naváže, když příkaz spustíte znovu.

Downloads the official image straight from the vendor. Versions are looked up online, so you always get the latest release. Linux images are verified with SHA-256 after download. An interrupted download resumes when you run the command again.

Terminal
$ ./USBoot-x86_64.AppImage --cli download                    # seznam / list
$ ./USBoot-x86_64.AppImage --cli download ubuntu --list
$ ./USBoot-x86_64.AppImage --cli download ubuntu --variant server
$ ./USBoot-x86_64.AppImage --cli download windows11 --variant czech -o ~/ISO/
VolbaPopis
SOURCEwindows11, windows10, ubuntu, mint, debian, fedora, arch, alpine, proxmox. Bez něj vypíše seznam.windows11, windows10, ubuntu, mint, debian, fedora, arch, alpine, proxmox. Without it, prints the list.
--listVypíše dostupná vydání (u Windows jazyky) s čísly.Lists available releases (languages for Windows) with numbers.
--variant XČíslo z --list nebo část názvu (server, kde, czech). Výchozí je první vydání, u Windows angličtina.Number from --list or part of the name (server, kde, czech). Default is the first release, English for Windows.
-o, --output PATHCílový soubor nebo složka. Výchozí je složka Stažené.Target file or directory. Default is the Downloads folder.
Windows se stahují stejně jako v Rufusu (Fido) přes web Microsoftu. Microsoft občas automatické stažení dočasně zablokuje – pak USBoot vypíše odkaz na stránku ke stažení v prohlížeči.
Windows is downloaded the same way as in Rufus (Fido), through Microsoft's website. Microsoft sometimes temporarily blocks automated downloads – USBoot then prints a link to the download page for your browser.

V okně aplikace: šipka vedle tlačítka VYBRAT → Stažení.

In the app window: arrow next to the SELECT button → Download.

Úpravy Windows (--wue)

Při zápisu Windows 10/11 může USBoot přidat do instalace soubor odpovědí, takže se instalátor na tyto věci neptá. Hodnota --wue je součet příznaků (šestnáctkově s 0x, nebo desítkově):

When writing Windows 10/11, USBoot can add an answer file so that setup skips these steps. The --wue value is the sum of flags (hex with 0x, or decimal):

PříznakPopis
0x01Bez požadavku na TPM 2.0, Secure Boot a 4 GB RAMRemove the TPM 2.0, Secure Boot and 4 GB RAM requirement
0x04Bez online Microsoft účtuNo online Microsoft account required
0x08Vypnout sběr dat (přeskočit otázky na soukromí)Disable data collection (skip privacy questions)
0x10Windows To Go: zakázat přístup k interním diskůmWindows To Go: prevent access to internal disks
0x20Místní a jazykové nastavení podle tohoto počítačeRegional options same as this computer
0x40Vytvořit lokální účet se jménem z --usernameCreate a local account named by --username
0x80Vypnout automatické šifrování BitLockeremDisable automatic BitLocker device encryption
0x100Vylepšení pohodlí – nevnucovat Copilot, OneDrive, Outlook, vypnout rychlé spuštěníQoL improvements – don't force Copilot, OneDrive, Outlook, disable Fast Startup

Výchozí výběr v GUI je 0x6d = 0x01 + 0x04 + 0x08 + 0x20 + 0x40.

The GUI default is 0x6d = 0x01 + 0x04 + 0x08 + 0x20 + 0x40.

Příklady

Windows 11 na starší počítač, lokální účet

Terminal
$ ./USBoot-x86_64.AppImage --cli write -d /dev/sdb -i Win11_24H2_Czech_x64.iso \
      --scheme gpt --target uefi --wue 0x6d --username tomas

Ubuntu s 8 GB trvalým oddílem

Terminal
$ ./USBoot-x86_64.AppImage --cli write -d /dev/sdb -i ubuntu-24.04-desktop-amd64.iso --persistence 8G

Raspberry Pi / surový obraz (DD)

Terminal
$ ./USBoot-x86_64.AppImage --cli write -d /dev/sdb -i raspios-bookworm-arm64.img.xz --mode dd

Skript bez dotazů, s ověřením výsledku

Terminal
$ sudo ./USBoot-x86_64.AppImage --cli write -d /dev/sdb -i debian-12-amd64-netinst.iso -y \
      && echo "Hotovo / Done"

Stažení přímo z terminálu

Terminal
$ wget USBoot-x86_64.AppImage
$ chmod +x USBoot-x86_64.AppImage