Skip to content

Latest commit

 

History

History
154 lines (106 loc) · 4.37 KB

README.md

File metadata and controls

154 lines (106 loc) · 4.37 KB
Raw

Super ISO Updater

Super ISO Updater is a powerful tool that provides a convenient way to check for updates and install the latest versions of various ISO files. It is specifically designed to work with a Ventoy drive and supports a wide range of ISOs.

Getting Started

Prerequisites

  • Python 3.12+ installed on your system.

Installation

Using pip

  1. Open your terminal or command prompt.
  2. Install the package using the following command:
python -m pip install sisou

Using git

  1. Clone this repository locally by running
git clone https://github.com/JoshuaVandaele/SuperISOUpdater
  1. Navigate into the newly created directory by running
cd SuperISOUpdater
  1. Install the module using the following command:
python -m pip install .

Updating

To update the package to the latest version, run the following command:

python -m pip install --upgrade sisou

Usage

To use SISOU, follow these steps:

Running the script

sisou <Ventoy Partition>

Example on Windows

sisou E:

Example on Linux

sisou /run/media/joshua/Ventoy/

Logging

The script generates logs during its execution. You can control the log level using the -l or --log-level argument when running the script. 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:

sisou <Ventoy Partition> -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:

sisou <Ventoy Partition> -f /path/to/log_file.log

Customization

The sisou.py script uses a configuration file (config.toml) to define the ISOs to be updated. You can customize this configuration file to add or remove ISOs from the update process.

To customize the ISOs, open the config.toml file and edit the relevant sections. Each ISO is associated with an updater class (e.g., Ubuntu, MemTest86Plus, etc.). You can enable or disable ISOs by modifying the corresponding values in the configuration file.

NOTE: Be cautious when modifying the configuration file, as incorrect changes may cause the script to malfunction.

By default, the script uses the config.toml file located in the same directory as the Ventoy drive.

You can specify a custom configuration file using the -c or --config-file argument when running the script:

sisou <Ventoy Partition> -c /path/to/config.toml

Supported ISOs

The tool currently supports the following ISOs:

  • Diagnostic Tools
    • Hiren's BootCD PE
    • Memtest86+
    • SystemRescue
    • UltimateBootCD
    • Rescuezilla (editions: "focal", "jammy", "lunar", "mantic", "noble")
  • Boot Repair
    • Super Grub 2
  • Disk Utilities
    • Clonezilla
    • GParted Live
    • ShredOS
    • HDAT2 (editions: "full", "lite", "diskette")
  • Operating Systems
    • Linux
      • Arch Linux
      • Debian (editions: "standard", "cinnamon", "kde", "gnome", "lxde", "lxqt", "mate", "xfce")
      • Ubuntu (editions: "LTS", "interim")
      • Fedora (editions: "KDE", "Budgie", "Cinnamon", "LXDE", "MATE_Compiz", "SoaS", "Sway", "Xfce", "i3")
      • Linux Mint (editions: "cinnamon", "mate", "xfce")
      • Manjaro (editions: "plasma", "xfce", "gnome", "budgie", "cinnamon", "i3", "mate")
      • Kali Linux (editions: "installer", "live", "installer-netinst", "installer-purple")
      • Rocky Linux (editions: "dvd", "boot", "minimal")
      • OpenSUSE (editions: "leap", "leap-micro", "jump")
      • TrueNAS (editions: "scale")
      • Tails
      • ChromeOS (editions: "ltc", "ltr", "stable")
    • Windows
      • Windows 11 (Multi-edition ISO, Any language)
      • Windows 10 (Multi-edition ISO, Any language)
    • BSD
      • TrueNAS (editions: "core")
    • Other
      • FreeDOS (editions: "BonusCD", "FloppyEdition", "FullUSB", "LegacyCD", "LiteUSB", "LiveCD")
      • TempleOS (editions: "Distro", "Lite")

Contribute

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 GPLv3 License.

Thank you for using Super ISO Updater! If you encounter any issues or need assistance, please don't hesitate to reach out. Happy updating!