https://github.com/joshuavandaele/superisoupdater
A powerful tool to conveniently update all of your ISOs!
https://github.com/joshuavandaele/superisoupdater
boot-repair bootrepair diagnostic diagnostic-tool diagnostictool gplv3 iso linux operating-system operating-systems os python python3 python310 python311 updater ventoy windows
Last synced: 3 months ago
JSON representation
A powerful tool to conveniently update all of your ISOs!
- Host: GitHub
- URL: https://github.com/joshuavandaele/superisoupdater
- Owner: JoshuaVandaele
- License: gpl-3.0
- Created: 2023-08-02T13:14:23.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-01-27T17:16:28.000Z (6 months ago)
- Last Synced: 2026-01-28T00:35:50.788Z (6 months ago)
- Topics: boot-repair, bootrepair, diagnostic, diagnostic-tool, diagnostictool, gplv3, iso, linux, operating-system, operating-systems, os, python, python3, python310, python311, updater, ventoy, windows
- Language: Python
- Homepage:
- Size: 260 KB
- Stars: 35
- Watchers: 1
- Forks: 6
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Super ISO Updater
Super ISO Updater (SISOU) is a powerful tool that provides a convenient way to check for updates and install the latest versions of various ISO files. It is primarily meant to be used with a Ventoy drive and supports a wide range of ISOs.
## Features
- **Automatic ISO Updates:** Automatically check for and downloads the latest ISO versions from official sources, always using the fastest available mirror.
- **Checksum & Signature Verification:** Verifies the integrity of every downloaded file, ensuring nothing has been corrupted or tempered with.
- **Flexible Organization & Configuration:** Organize your ISOs exactly the way you want on your drive and manage them effortlessly. Enable, disable, or add new ones through the configuration file. (We recommend using [TreeView Mode](https://www.ventoy.net/en/doc_treeview.html) in Ventoy.)
- **Wide ISO Support:** Compatible with a broad range of operating systems, utilities, and diagnostic tools. (See [Supported ISOs](#supported-isos))
## Getting Started
### Prerequisites
- Python 3.12 installed on your system.
- GnuPG for signature verification. (Optional)
### Installation
Pick whichever method works best for you:
#### pip _(recommended for most users)_
```sh
python -m pip install sisou
```
#### pipx
```sh
pipx install sisou
```
#### From source
```sh
git clone https://github.com/JoshuaVandaele/SuperISOUpdater
cd SuperISOUpdater
python -m pip install .
```
### Updating
#### pip
```sh
python -m pip install --upgrade sisou
```
#### pipx
```sh
pipx upgrade sisou
```
#### From source
```sh
cd SuperISOUpdater
git pull
python -m pip install .
```
## Usage
To use SISOU, follow these steps:
### Running SISOU
```sh
sisou
```
#### Example on Windows
```sh
sisou E:
```
#### Example on Linux
```sh
sisou /run/media/joshua/Ventoy/
```
### Logging
SISOU generates logs during its execution. You can control the log level using the `-l` or `--log-level` argument. The available log levels are: DEBUG, INFO, WARNING, ERROR, and CRITICAL. By default, the log level is set to INFO.
To set a specific log level, use the `-l` option followed by the desired log level:
```sh
sisou -l DEBUG
```
You can also specify a log file using the `-f` or `--log-file` argument to save the logs to a file instead of displaying them in the console:
```sh
sisou -f /path/to/log_file.log
```
## Customization
SISOU is configured through a `sisou.toml` file, where you can control which ISOs get updated and how: toggling them on or off, and choosing your preferred editions, languages, and architectures.
By default, SISOU looks for `sisou.toml` in the given directory, but you can also specify a custom path to the configuration file:
```sh
sisou /etc/my_sisou_config.toml
```
> [!TIP]
> No config file yet? No problem, one will be created for you automatically on the first run.
## Supported ISOs
The tool currently supports the following ISOs:
- **Diagnostic Tools**
- Hiren's BootCD PE
- MemTest86 Plus
- Architectures: x86_64, i586
- SystemRescue
- UltimateBootCD
- **Disk Utilities**
- Clonezilla
- GParted Live
- HDAT2
- Editions: full, lite, diskette
- Rescuezilla
- Editions: bionic, focal, jammy, noble
- Architectures: 64bit, 32bit
- ShredOS
- Architectures: x86-64, i586
- **Operating Systems**
- **Linux**
- Alpine Linux
- Editions: standard
- Architectures: aarch64, armv7, loongarch64, ppc64le, riscv64, s390x, x86, x86_64
- Arch Linux
- Artix Linux
- Editions: {base,cinnamon,lxde,lxqt,mate,plasma,xfce}-{dinit,openrc,runit,s6}
- CachyOS
- Editions: desktop, handheld
- Debian
- Architectures: amd64, arm64, armhf, ppc64el, riscv64, s390x
- Fedora
- Editions: Budgie, Cinnamon, KDE, LXDE, MATE_Compiz, SoaS, Sway, Xfce, i3
- Architectures: x86_64, aarch64
- Kali Linux
- Editions: installer, installer-everything, installer-netinst, installer-purple, live
- Architectures: amd64, arm64
- Linux Mint
- Editions: cinnamon, mate, xfce
- Manjaro
- Editions: kde, xfce, gnome, cinnamon, i3
- Proxmox
- Editions: ve, mail-gateway, backup-server
- Rocky Linux
- Editions: dvd, boot, minimal
- Architectures: x86_64, aarch64, ppc64le, s390x, riscv64
- Rocky Linux Live
- Editions: KDE, Workstation, Workstation Lite
- Architectures: x86_64, aarch64
- TrueNAS
- Tails
- Ubuntu
- Editions: desktop, live-server
- **Windows**
- Windows 11 (Multi-edition ISO, Any language)
- Architectures: x64, arm64
- **BSD**
- OPNsense
- Editions: dvd, nano, serial, vga
## Contributing
If you have any suggestions, bug reports, or feature requests, feel free to open an issue or submit a pull request. Your contributions are highly appreciated!
## License
This project is licensed under the [GPL-2.0-or-later](./LICENSE) license.
---
Thank you for using Super ISO Updater!
