usbprep-ventoy [ l | list | i | install | plugson | -h | --help ] <DEVICE>
usbprep-pi [ <ARCHIVE_FILE> | -k | --ssh-key | -h | --help ] <DEVICE>
- Crate a bootable USB-stick with Ventoy from a list of images
- List available USB devices
- Automatically download disk/ISO images via fastpkg
- Copy a custom list of images to the USB-stick
- Automatically checks if there is enough space on the target device
- Parses ventoy.json for images to download
- Extract an iso/image archive directly to a USB-stick or SD-card
- Copy SSH-key ($HOME/.ssh/id_rsa.pub) to a Raspberry Pi SD-card
- Automatically enables hdmi_force_hotplug
All ventoy templates are located in $HOME/.ventoy
.
Copy or symlink your favorite ventoy templates folder to that location.
To add images to download and/or copy to the stick, you need to create a file
called images.txt
in the $HOME/.ventoy
folder.
Each line in that file represents an image file.
Add the absolut path to the file. That file will automatically be copied to the
USB-stick.
You can add faspkg package names. They will automatically be downloaded and
copied to the USB-stick.
The file $HOME/.ventoy/ventoy.json
will be parsed and searched for images.
If the image is not already in the images.txt
file, fastpkg will be used to
download that image.
You can also use my example templates form here:
github.com/ServerMonkey/servermonkeys-templates
DEVICE is the block device to write to, like sdx (not /dev/sdx)
-h, --help
: Displays this help screenlist, l
: List USB devicesinstall, i <DEVICE>
: Install Ventoy to a device and copy images from images.txt. Uses fastpkg if available.ventoy, v <DEVICE>
: Only install Ventoy to a device. Will not copy any images from images.txt.plugson, p <DEVICE>
: Start Ventoy PlugsOn on a device open in webbrowser
-h, --help
: Displays this help screen--list, -l
: List USB devicesusbprep-pi <ARCHIVE_FILE> <DEVICE>
: Flash with imageusbprep-pi **-k|--ssh-key** <DEVICE>
: Copy SSH-key
Add disk images you want to the file:
$HOME/.ventoy/images.txt
Example images.txt:
/var/opt/debian-10.9.0-amd64-netinst.iso
$HOME/Downloads/ubuntu-22.04-desktop-amd64.iso
$HOME/Files/Windows10.iso
If you just add the line:
debian-12
It will automatically download the image via fastpkg.
To create the stick just run:
$ usbprep-ventoy i sdx
You can even add other files or folders to the images.txt file.
Be mindful that these files will not be used to pre-calculate the size of the
final device. Just make sure you have enough space on the usb device.
Only the variable '$HOME' will be expanded.
$ usbprep-pi Raspbian_11.zip sdx
See license file
rsync(1), fastpkg(1), www.ventoy.net