ADF Manager

Grafisches Frontend für xdftool (Teil von amitools) zum Verwalten von Amiga-Disk-Images (ADF) unter Linux. Gedacht als Ersatz für das mühsame Einzel-Kopieren per Kommandozeile, wenn sich ADFs nicht bequem mounten lassen.

Teil von Projekt Hirnfrei. Entwickler: Dany Thinnes.

Funktionen

Zwei-Spalten-Ansicht: links der Inhalt der ADF, rechts ein Ordner auf dem PC
Navigation in beiden Ansichten per Doppelklick (links auch in ADF-Unterordner, .. führt eine Ebene hoch)
ADF → PC: ein oder mehrere Einträge (auch ganze Ordner) in den rechts angezeigten PC-Ordner kopieren
PC → ADF: ein oder mehrere Dateien/Ordner in den links angezeigten ADF-Ordner kopieren. Existiert ein Eintrag bereits in der ADF, wird er nach Rückfrage vorher gelöscht
Löschen, Umbenennen und Anlegen von Ordnern in der ADF
Alle Einträge eines Vorgangs werden in einem xdftool-Aufruf verarbeitet (schnell auch bei vielen Dateien)
Versteckte Dateien auf der PC-Seite ein-/ausblendbar
Spaltenbreiten frei einstellbar; Fenstergröße und Spaltenbreiten werden gespeichert
Auswerfen: Liegt die ADF auf einer SD-Karte oder einem anderen Wechseldatenträger, kann das Medium direkt aus dem Programm ausgehängt und abgeschaltet werden
Protokollfenster mit den ausgeführten xdftool-Befehlen und deren Ausgabe

Abhängigkeiten

Zur Laufzeit

Paket	Zweck
`amitools` (liefert `xdftool`)	Eigentliche Arbeit an den ADF-Images. Die reine Python-Variante genügt, `vamos` wird nicht benötigt
`udisks2` (optional)	Nur für die Funktion „Auswerfen“ (`udisksctl`)

xdftool muss im PATH liegen. Alternativ kann der Pfad im Programm unter Datei → xdftool-Pfad … eingestellt werden.

Zum Bauen

C++17-Compiler (GCC oder Clang)
CMake ≥ 3.16
Qt 6 (Modul Widgets)

Installation von xdftool

Unter Arch Linux ist Python „externally managed“, daher am besten isoliert installieren:

sudo pacman -S python-pipx
pipx install amitools

(Alternativ in einem eigenen virtualenv mit pip install amitools.) Danach sollte xdftool im Terminal verfügbar sein:

xdftool --help

Bauen (Linux / Arch)

sudo pacman -S --needed base-devel cmake qt6-base
git clone https://git.projekt-hirnfrei.de/diabolus/adfmanager.git
cd adfmanager
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Starten:

./build/adfmanager [datei.adf]

Eine ADF kann optional als Kommandozeilenargument übergeben werden.

Bedienung

ADF öffnen … und ein Image wählen (.adf, .ADF, .adz).
Links den gewünschten ADF-Ordner öffnen, rechts den PC-Ordner wählen (Ordner wählen … oder per Doppelklick navigieren).
Einträge markieren (Mehrfachauswahl mit Strg/Umschalt) und über die Pfeil-Buttons in der Mitte kopieren.
Das Ziel beim Kopieren in die ADF ist immer der links angezeigte Ordner („Aktueller ADF-Ordner“).

Hinweise

Änderungen werden direkt in die ADF geschrieben. Für wichtige Images vorher eine Sicherungskopie anlegen.
Das Programm wertet die Ausgabe von xdftool <image> list aus. Sollte der Baum leer bleiben, steht die Rohausgabe im Protokollfenster. Das ist hilfreich, falls eine andere amitools-Version ein anderes Ausgabeformat verwendet.
Unterstützt werden die Dateisysteme, die xdftool beherrscht (OFS/FFS-Disketten-Images).
Die „Auswerfen“-Erkennung ist eine Heuristik: Als Wechseldatenträger gelten Medien mit gesetztem removable-Flag, SD-Karten am eingebauten Kartenleser und USB-Datenträger. Systemverzeichnisse (/, /home, …) werden nie angeboten.

Windows (ungetestet)

Hinweis: Dieser Abschnitt ist unverifiziert. Das Programm wurde bisher ausschließlich unter Linux (Arch) getestet.

Der Quellcode verwendet ausschließlich Qt und ist plattformneutral, sollte sich also mit CMake und Qt 6 auch unter Windows bauen lassen. Zu beachten:

xdftool ist ein Python-Programm. Laut amitools-Dokumentation ist Windows „heavily untested“, die reine Python-Variante (pip install amitools) soll aber für alle Werkzeuge außer vamos funktionieren. Python (≥ 3.8) muss installiert sein; pip legt xdftool.exe im Scripts-Ordner der Python-Installation ab. Liegt dieser nicht im PATH, den Pfad im Programm einstellen.
Die Funktion „Auswerfen“ ist unter Windows nicht verfügbar (Button bleibt deaktiviert).

Beispiel für den Build (Qt aus dem Qt-Installer, Pfad anpassen):

cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=C:/Qt/6.x.x/mingw_64
cmake --build build
windeployqt build/adfmanager.exe

Lizenz

Dieses Programm ist freie Software: Sie können es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht, weitergeben und/oder modifizieren, entweder gemäß Version 3 der Lizenz oder (nach Ihrer Wahl) jeder späteren Version.

Die Veröffentlichung erfolgt in der Hoffnung, dass es Ihnen von Nutzen sein wird, aber ohne jede Gewährleistung; sogar ohne die implizite Gewährleistung der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Details finden Sie in der GNU General Public License (siehe Datei LICENSE).

SPDX-License-Identifier: GPL-3.0-or-later

5.3 KiB Raw Blame History