Short:        7-Zip archive manager with MUI interface
Author:       lumizip@amigaworld.de (Matthias Muench)
Uploader:     lumizip amigaworld de (Matthias Muench)
Type:         util/arc
Version:      1.0
Requires:     68020+, MUI 3.8, NList.mcc, TheBar.mcc, codesets.library 6.x, 7zz (util/arc/7zip.lha)
Architecture: m68k-amigaos >= 3.1
Distribution: Aminet

LumiZip opens, unpacks, tests and creates archives on AmigaOS 3.x,
with a MUI 3.8 interface and a toolbar. It is part of the Lumi
suite and shares its look, its menu and its ARexx conventions with
the other tools.

LumiZip does not pack anything itself. It is the window around the
Amiga port of 7-Zip 26.04 (the program 7zz): it builds the command
lines, runs 7zz as a separate process and reads what it says. That
is why LumiZip opens some sixty formats, and why the window stays
usable while a job is running.


FEATURES
--------

  - Opens some sixty formats, among them 7z, zip, tar, gzip,
    bzip2, xz, lzh, rar (read only) and iso
  - Browse an archive directory by directory, or browse your
    drawers and unpack or test a selected archive without
    opening it
  - Unpack the whole archive or a selection, test an archive,
    view a single file (MultiView or a viewer of your choice)
  - Checksums of files and archive entries (SHA-256, MD5, CRC32 and
    more): compute, save as a file, verify later
  - Virus check of archive contents with xvs.library, on request or
    automatically after extracting; crunched programs are unpacked
    first if xfdmaster.library is installed
  - Create archives: 7z, zip, tar, gzip, bzip2, xz, tar.gz, tar.bz2,
    tar.xz, wim
  - Add files and directories to an archive, also into a directory
    inside it; remove and rename entries
  - Include and exclude patterns (AmigaDOS style, #?.bak) for
    packing, adding and unpacking
  - Fine-tuning when packing: method (LZMA2, PPMd, BZip2, Deflate64
    ...), dictionary size with memory check, solid blocks
  - Update or freshen an archive (only new or newer files), move
    files into an archive
  - Convert an archive into another format (lha to 7z, 7z to zip ...)
  - Write lha archives with LhA (new, add, update, delete); 7zz only
    reads lha
  - Recently opened archives, archive comments in the Info window
  - Workbench Tools menu entry and drop on the iconified LumiZip
  - Log below the status line or in a window of its own: command
    lines, program output and results; optional log file
  - Self-extracting archives: a program that unpacks itself from the
    Shell or by double-click (needs 7zSFX from the 7-Zip package)
  - Passwords, also for archives whose file names are encrypted
  - tar.gz, tar.xz and tar.bz2 open down to the files inside
  - Archives and files can be dropped on the window
  - Progress window while 7zz works; jobs can be cancelled
  - Archive names converted between UTF-8 and your system's
    character set (codesets.library)
  - Full ARexx scripting interface (port LUMIZIP.1)
  - Runs as a single instance: a second start hands its archive
    to the running LumiZip
  - Automatic update check via signature verification
  - AmigaGuide documentation (incl. ARexx reference)
  - Localisation: English, German


REQUIREMENTS
------------

  - AmigaOS 3.1 or compatible
  - Motorola 68020 or higher
  - About 1 MB for LumiZip itself; 7zz needs more, depending on
    the job (about 3 MB for listing, for packing 12 times the
    dictionary size plus 3 MB)
  - MUI 3.8 (v19) or higher
  - NList.mcc, TheBar.mcc
  - codesets.library 6.x (mandatory - shows archive names in your
    system's character set). Available from Aminet
    (util/libs/codesets-lib).
  - 7zz, the Amiga port of 7-Zip 26.04 (mandatory for all archive
    functions; Aminet util/arc/7zip.lha, with builds for 68020
    and for 68040 or higher). Copy the build for your CPU to C:7zz.
    Without it LumiZip starts, says so, and keeps the archive
    functions disabled.
  - 7zSFX from the same package (only for self-extracting archives).
    Copy it to C:7zSFX.
  - xvs.library 33 or newer (optional - virus check; Aminet
    util/virus/xvslibrary.lha) and xfdmaster.library (optional -
    unpacks crunched programs for the check; Aminet
    util/pack/xfdmaster.lha)
  - LhA 2.x (optional - creating and changing lha archives; Aminet
    util/arc/lha.run). Copy it to C:LhA or set its path in the settings.
  - tz.library (optional - file dates in local time including
    summer time)
  - AmiSSL 5.x and a TCP/IP stack (optional - only for the update
    check)

  Successfully tested on AmigaOS 3.1, 3.2, 3.5 and 3.9.


INSTALLATION
------------

Recommended: open the archive, double-click the "Install" icon
in the LumiZip/ drawer and follow the AmigaOS Installer (English
or German). It copies the binary, the localisation catalogs and
the AmigaGuide help files to the location you choose.

Manual install: copy the LumiZip binary and its .info icon
wherever you like, e.g. SYS:Tools/, place the catalogs in
LOCALE:Catalogs/<language>/ and the guides in HELP:<language>/.

7zz and 7zSFX are not part of this archive. They come in
7zip.lha on Aminet (util/arc): copy the 7zz for your CPU to
C:7zz and 7zSFX to C:7zSFX, as its readme describes. The installer
warns if C:7zz is missing. Icons that are already there are kept.
LumiZip looks for 7zz in this order: the SEVENZIP tooltype, the
path in the settings (empty by default), C:7zz. 7zSFX and LhA are
looked for the same way.

Settings live in ENVARC:LumiZip/LumiZip.prefs. The guides belong
next to the binary, in Help/<language>/ - that is where the Help
key looks.


TOOLTYPES
---------

  PUBSCREEN=<name>      Public screen for the window
  SEVENZIP=<path>       The 7zz program; goes before the path in the
                        settings
  ICONIFY=YES           Start iconified (icon only, no window)

  Keywords on the Shell command line go before the tooltypes.

  All three ship with the program icon in parentheses (visible but
  inactive) - remove the parentheses in the icon's Information window
  to switch one on.


DOCUMENTATION
-------------

  Help/English/LumiZip.guide          AmigaGuide (English)
  Help/Deutsch/LumiZip.guide          AmigaGuide (German)


CHANGELOG
---------

  1.0 (Build 1, 12 October 2026)
    - Initial release.


BUILD INFORMATION
-----------------

  Version:        1.0 (Build 1)
  Binary size:    ~494 KB (stripped)
  Source code:    ~33,066 lines (C + H)
  Compiler:       m68k-amigaos-gcc 6.5.0b
  Target CPU:     m68020+


LICENSE
-------

LumiZip is freeware. You may use, copy and redistribute
unmodified binaries freely. Redistribution on Aminet and other
archives is explicitly permitted.

7-Zip (7zz) and the libraries named below keep their own
licenses. 7-Zip is free software (GNU LGPL, parts BSD 3-clause);
the unRAR restriction applies: nothing that unpacks rar may be
used to build a rar packer.

The software is provided "as is", without warranty of any kind.
The author is not liable for any damage or data loss resulting
from the use of this software.


REGISTRATION
------------

Registration is optional and does not affect functionality. All
features are available without limits, with or without a key. A
registration is a friendly gesture towards the author and helps
plan further development.

Two ways to register:

  1. With the LumiReg tool (available separately on Aminet) -
     enter name and email, click "Register".

  2. Manually by e-mail to register@amigaworld.de. Please include:

       Name      Name the registration should be issued to
       Email     Address the licence key will be sent to
       Program   Name of the program to register (LumiZip)


CONTACT
-------

  E-mail:  lumizip@amigaworld.de
  Web:     https://www.amigaworld.de/


CREDITS
-------

  Author
    Matthias Münch              Concept, implementation, testing

  Built with help from
    Claude Code (Anthropic)     AI assistant for pair programming

  Third-party components
    Igor Pavlov                 7-Zip
    Stefan Boberg,
    Jim Cooper,
    David Tritscher,
    Sven Ottemann               LhA
    Stefan Stuntz               MUI 3.8
    Gilles Masson,
    Laurin Woitok,
    Nick Blackburn              NList.mcc (amiga-mui project)
    Alfonso Ranieri &
    TheBar Open Source Team     TheBar.mcc
    Alfonso Ranieri &
    Jens Maus                   codesets.library
    Olaf Barthel &
    Oliver Roberts              AmiSSL

  Greetings
    Eisman, lokiist, Fossi, yelworC, cappin,
    Cego, McFly, LoneRaider, evil4dmin, jdb78

  In Memoriam
    Psyria


================================================================
                DEUTSCHE VERSION / GERMAN VERSION
================================================================

LumiZip öffnet, entpackt, testet und erzeugt Archive unter AmigaOS
3.x, mit einer MUI-3.8-Oberfläche und Werkzeugleiste. Es gehört zur
Lumi-Suite und teilt Aussehen, Menü und ARexx-Konventionen mit den
anderen Werkzeugen.

LumiZip packt nicht selbst. Es ist das Fenster um die Amiga-Fassung
von 7-Zip 26.04 (das Programm 7zz): Es baut die Befehlszeilen,
startet 7zz als eigenen Prozess und liest, was es meldet. Deshalb
öffnet LumiZip rund sechzig Formate, und deshalb bleibt das Fenster
bedienbar, während ein Auftrag läuft.


FUNKTIONEN
----------

  - Öffnet rund sechzig Formate, darunter 7z, zip, tar, gzip,
    bzip2, xz, lzh, rar (nur lesen) und iso
  - Ein Archiv verzeichnisweise durchsuchen, oder die eigenen
    Schubladen durchsuchen und ein markiertes Archiv entpacken
    oder testen, ohne es zu öffnen
  - Das ganze Archiv oder eine Auswahl entpacken, ein Archiv testen,
    eine einzelne Datei ansehen (MultiView oder ein Programm nach Wahl)
  - Prüfsummen von Dateien und Archiveinträgen (SHA-256, MD5, CRC32
    und weitere): berechnen, als Datei speichern, später prüfen
  - Virenprüfung des Archivinhalts mit der xvs.library, auf Befehl
    oder automatisch nach dem Entpacken; gecrunchte Programme werden
    vorher entpackt, wenn die xfdmaster.library installiert ist
  - Archive erzeugen: 7z, zip, tar, gzip, bzip2, xz, tar.gz, tar.bz2,
    tar.xz, wim
  - Dateien und Verzeichnisse zu einem Archiv hinzufügen, auch in ein
    Verzeichnis darin; Einträge entfernen und umbenennen
  - Ein- und Ausschlussmuster (AmigaDOS-Schreibweise, #?.bak) beim
    Packen, Hinzufügen und Entpacken
  - Feineinstellungen beim Packen: Methode (LZMA2, PPMd, BZip2,
    Deflate64 ...), Wörterbuch mit Speicherprüfung, Solid-Blöcke
  - Archiv aktualisieren oder auffrischen (nur neue bzw. neuere
    Dateien), Dateien ins Archiv verschieben
  - Archiv in ein anderes Format umwandeln (lha in 7z, 7z in zip ...)
  - lha-Archive mit LhA schreiben (neu, hinzufügen, aktualisieren,
    entfernen); 7zz liest lha nur
  - Zuletzt geöffnete Archive, Archivkommentare im Info-Fenster
  - Eintrag im Werkzeuge-Menü der Workbench, Ablegen auf das
    ikonifizierte LumiZip
  - Protokoll unter der Statuszeile oder im eigenen Fenster:
    Befehlszeilen, Programmausgabe und Ergebnisse; wahlweise
    Protokolldatei
  - Selbstentpackende Archive: ein Programm, das sich aus der Shell oder
    per Doppelklick selbst entpackt (braucht 7zSFX aus dem 7-Zip-Paket)
  - Passwörter, auch bei Archiven mit verschlüsselten Dateinamen
  - tar.gz, tar.xz und tar.bz2 bis zu den Dateien darin öffnen
  - Archive und Dateien lassen sich auf das Fenster ziehen
  - Fortschrittsfenster, während 7zz arbeitet; Aufträge lassen sich
    abbrechen
  - Archivnamen zwischen UTF-8 und dem Zeichensatz des Systems
    umgesetzt (codesets.library)
  - Volle ARexx-Schnittstelle (Port LUMIZIP.1)
  - Läuft als Einzelinstanz: ein zweiter Start reicht sein Archiv
    an das laufende LumiZip weiter
  - Automatischer Update-Check über Signaturprüfung
  - AmigaGuide-Dokumentation inkl. ARexx-Referenz
  - Lokalisierung: Deutsch und Englisch


SYSTEMVORAUSSETZUNGEN
---------------------

  - AmigaOS 3.1 oder kompatibel
  - Motorola 68020 oder höher
  - Etwa 1 MB für LumiZip selbst; 7zz benötigt je nach Auftrag mehr
    (etwa 3 MB zum Auflisten, beim Packen das Zwölffache des
    Wörterbuchs plus 3 MB)
  - MUI 3.8 (v19) oder höher
  - NList.mcc, TheBar.mcc
  - codesets.library 6.x (zwingend erforderlich - zeigt Archivnamen
    im Zeichensatz des Systems). Verfügbar im Aminet
    (util/libs/codesets-lib).
  - 7zz, die Amiga-Fassung von 7-Zip 26.04 (zwingend für alle
    Archivfunktionen; Aminet util/arc/7zip.lha, mit Fassungen
    für 68020 und für 68040 oder höher). Die Fassung für Ihre CPU
    als C:7zz kopieren. Ohne 7zz startet LumiZip, sagt es und lässt
    die Archivfunktionen gesperrt.
  - 7zSFX aus demselben Paket (nur für selbstentpackende Archive).
    Als C:7zSFX kopieren.
  - xvs.library 33 oder neuer (optional - Virenprüfung; Aminet
    util/virus/xvslibrary.lha) und xfdmaster.library (optional -
    entpackt gecrunchte Programme für die Prüfung; Aminet
    util/pack/xfdmaster.lha)
  - LhA 2.x (optional - lha-Archive erzeugen und ändern; Aminet
    util/arc/lha.run). Als C:LhA kopieren oder den Pfad in den
    Einstellungen angeben.
  - tz.library (optional - Dateidaten in Ortszeit mit Sommerzeit)
  - AmiSSL 5.x und ein TCP/IP-Stack (optional - nur für den
    Update-Check)

  Erfolgreich getestet unter AmigaOS 3.1, 3.2, 3.5 und 3.9.


INSTALLATION
------------

Empfohlen: Archiv öffnen, im Verzeichnis LumiZip/ auf "Install"
doppelklicken und dem AmigaOS-Installer folgen (deutsche oder
englische Sprache). Er kopiert das Binary, die Sprachkataloge und
die AmigaGuide-Dokumentation an den gewählten Ort.

Manuelle Installation: das LumiZip-Binary und das zugehörige
Piktogramm an einen beliebigen Ort kopieren (z.B. SYS:Tools/),
die Kataloge nach LOCALE:Catalogs/<Sprache>/ und die Guides nach
HELP:<Sprache>/.

7zz und 7zSFX gehören nicht zu diesem Archiv. Sie liegen in
7zip.lha im Aminet (util/arc): das 7zz für Ihre CPU als C:7zz
und 7zSFX als C:7zSFX kopieren, wie es dessen Readme beschreibt. Der
Installer warnt, wenn C:7zz fehlt. Vorhandene Symbole bleiben
stehen. LumiZip sucht 7zz in dieser Reihenfolge: Werkzeugtyp
SEVENZIP, der Pfad in den Einstellungen (anfangs leer), C:7zz. 7zSFX
und LhA werden genauso gesucht.

Die Einstellungen liegen in ENVARC:LumiZip/LumiZip.prefs. Die
Guides gehören neben das Programm, nach Help/<Sprache>/ - dort
sucht die Hilfetaste.


TOOLTYPES
---------

  PUBSCREEN=<Name>      Öffentlicher Bildschirm für das Fenster
  SEVENZIP=<Pfad>       Das Programm 7zz; geht dem Pfad in den
                        Einstellungen vor
  ICONIFY=YES           Ikonifiziert starten (nur Symbol, kein Fenster)

  Schlüsselwörter in der Shell gehen den Werkzeugtypen vor.

  Alle drei stehen im Programm-Icon in Klammern (sichtbar, aber wirkungslos)
  - zum Aktivieren im Informationsfenster des Icons die Klammern
  entfernen.


DOKUMENTATION
-------------

  Help/Deutsch/LumiZip.guide          AmigaGuide (Deutsch)
  Help/English/LumiZip.guide          AmigaGuide (Englisch)


VERSIONSHISTORIE
----------------

  1.0 (Build 1, 12. Oktober 2026)
    - Erstveröffentlichung.


BUILD-INFORMATIONEN
-------------------

  Version:        1.0 (Build 1)
  Binary-Größe:   ~494 KB (gestrippt)
  Quelltext:      ~33.066 Zeilen (C + H)
  Compiler:       m68k-amigaos-gcc 6.5.0b
  Ziel-CPU:       m68020+


LIZENZ
------

LumiZip ist Freeware. Die unveränderten Binaries dürfen frei
genutzt, kopiert und weitergegeben werden. Eine Weitergabe über
Aminet und andere Archive ist ausdrücklich erlaubt.

7-Zip (7zz) und die unten genannten Bibliotheken behalten ihre
eigenen Lizenzen. 7-Zip ist freie Software (GNU LGPL, Teile BSD
3-Klausel); es gilt die unRAR-Einschränkung: Nichts, was rar
entpackt, darf dazu dienen, einen rar-Packer zu bauen.

Die Software wird "wie sie ist" bereitgestellt, ohne jegliche
Gewährleistung. Der Autor haftet nicht für Schäden oder Daten-
verluste, die aus der Nutzung dieser Software entstehen.


REGISTRIERUNG
-------------

Die Registrierung ist optional und beeinflusst die Funktionalität
nicht. Alle Funktionen stehen ohne Einschränkung zur Verfügung,
mit oder ohne Lizenzschlüssel. Eine Registrierung ist eine
freundliche Geste an den Autor und hilft bei der Planung
weiterer Entwicklung.

Zwei Wege zur Registrierung:

  1. Mit dem Tool LumiReg (separat auf Aminet verfügbar) -
     Namen und E-Mail eingeben, "Registrieren" klicken.

  2. Manuell per E-Mail an register@amigaworld.de mit:

       Name       Name, auf den die Registrierung lauten soll
       Email      Adresse, an die der Lizenzschlüssel geht
       Programm   Name des Programms (LumiZip)


KONTAKT
-------

  E-Mail:  lumizip@amigaworld.de
  Web:     https://www.amigaworld.de/


MITWIRKENDE
-----------

  Autor
    Matthias Münch              Konzept, Umsetzung, Tests

  Unterstützt durch
    Claude Code (Anthropic)     KI-Assistent für Pair-Programming

  Fremdkomponenten
    Igor Pavlov                 7-Zip
    Stefan Boberg,
    Jim Cooper,
    David Tritscher,
    Sven Ottemann               LhA
    Stefan Stuntz               MUI 3.8
    Gilles Masson,
    Laurin Woitok,
    Nick Blackburn              NList.mcc (amiga-mui-Projekt)
    Alfonso Ranieri &
    TheBar Open Source Team     TheBar.mcc
    Alfonso Ranieri &
    Jens Maus                   codesets.library
    Olaf Barthel &
    Oliver Roberts              AmiSSL

  Grüße
    Eisman, lokiist, Fossi, yelworC, cappin,
    Cego, McFly, LoneRaider, evil4dmin, jdb78

  In Erinnerung
    Psyria