sisou 1.1.2

A powerful tool to conveniently update all of your ISO files!

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. This README will guide you on how to use this tool effectively.

Table of Contents

• Super ISO Updater
  • Table of Contents
  • Getting Started
    • Prerequisites
    • Installation
      • Using pip
      • Using git
  • Usage
    • Running the script
      • Example on Windows
      • Example on Linux
    • Logging
  • Customization
  • Supported ISOs
  • Contribute
  • License

Getting Started

Prerequisites

• Python 3.10+ 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/FolfyBlue/SuperISOUpdater

2. Navigate into the newly created directory by running

cd SuperISOUpdater

3. Install the module using the following command:

python -m pip install .

Usage

To use sisou, follow these steps:

1. Open your terminal or command prompt.
2. Navigate to the directory where you cloned the script.

Running the script

sisou <Ventoy Partition>

Example on Windows

sisou E:

Example on Linux

sisou /run/media/folfy/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.

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", "kinetic")
• 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!