Bedienungsanleitung
Syntax
qzbatch <Zieldatei> <Vorlage> <Maske> [Optionen]
Parameter
| Parameter | Beschreibung |
|---|---|
| <Zieldatei> | Ausgabedateiname (Batch). |
| <Vorlage> | Dateiname der Vorlagendatei, die die einzelnen Batchzeilen enthält, oder einzelne Anweisung beginnend mit "@". |
| <Maske> | Zu verarbeitende Dateien (mit "*" und "?"). Mehrere Masken werden durch Strichpunkte ";" getrennt. Wahlweise kann auch eine Listendatei angegeben werden. Hierfür muß ein führendes "@" verwendet werden. Die entsprechenden Dateien sind in der Listendatei zeilenweise anzugeben. Es werden erweiterte .m3u-Playlisten unterstützt. |
Optionen
| Option | Beschreibung |
|---|---|
| /s | Unterverzeichnisse einschließen. |
| /e | Ausgabedatei nicht mit "@echo off" beginnen (Ausgabedateien mit der Dateierweiterung ".bat" werden standardmäßig mit der Zeile "@echo off" begonnen). |
| /r | Keine Anmerkungszeilen schreiben. |
| /y | Ausgabedatei ohne Rückfrage überschreiben. |
| /a | An Ausgabedatei anhängen, falls sie existiert. |
| /u | Alle Dateinamen in Großbuchstaben konvertieren. |
| /l | Alle Dateinamen in Kleinbuchstaben konvertieren. |
| /o | Verzeichnisinhalte sortieren. |
| /c | Dateinamen in den Windows-Zeichensatz (ANSI) konvertieren. |
| /i | Dateiauswahlmaske invertieren, d.h. es werden alle Dateien gefunden, die nicht der Maske entsprechen. |
| /k | Kommentarzeilen aus .m3u-Dateien übernehmen. Die Kommentarzeilen müssen mit einer Raute ("#") beginnen. |
| /d:von,bis | Gefundene Dateien auf einen Datumsbereich einschränken. Die Von- und Bis-Werte können folgendermaßen festgelegt werden: 0 = unbeschränkt +0, +1... = Systemdatum + 0 Tage, + 1 Tag,... -1, -2... = Systemdatum - 1 Tag, - 2 Tage,... 01.01.2006 = dediziertes Datum. Beispiele: "/d:01.01.2006,31.12.2006" schränkt auf das Jahr 2006 ein. "/d:-1,+0" schränkt auf gestern und heute ein. "/d:0,-1" schränkt auf alles bis einschl. gestern ein. |
Allgemeine Makros
Folgende Makros können in Vorlagendateien und Anweisungen benutzt werden:
| Option | Beschreibung |
|---|---|
| %%f | Dateiname |
| %%e | Dateierweiterung (inkl. dem Punkt ".") |
| %%b | Basisdateiname ohne Erweiterung |
| %%p | Pfad der Datei (endet mit einem Backslash "\") |
| %%c | Kompletter Dateiname inkl. Pfad |
| %%n | Laufende Nummer der Datei (beginnend mit 1) Wenn an %%n direkt eine der Ziffern 1 bis 9 angehängt wird, dann wird die resultierende lfd. Nummer auf die Länge der angegebenen Ziffer normiert, d.h. ggf. nach links mit Nullen aufgefüllt. Außerdem kann bestimmt werden mit welcher Zahl begonnen werden soll. Syntax: %%n<n>[<m>], z.B. %%n4[100] füllt die Nummer auf 4 Ziffern mit Nullen auf und beginnt mit der Nummer 100. |
| %%d | Dateidatum im Format "dd.mm.yyyy" |
| %%t | Dateizeit im Format "hh:mm:ss" |
| %%sf | kurzer Dateiname (8.3) |
| %%se | Dateierweiterung des kurzen Dateinamens (8.3) |
| %%sp | kurzer Pfadname (8.3) |
| %%sb | kurzer Basisdateiname (8.3) |
| %%sc | kompletter Dateiname mit kurzen Pfadangaben (8.3) |
| %%xp | Pfad der Datei in Unix-Notation (endet mit "/"). |
| %%xc | Kompletter Dateiname inkl. Pfad in Unix-Notation. |
| %%ln | Dateiname, der aus dem Playlistenkurzeintrag gebildet wird. |
Allgemeine Makros in UTF-8-Codierung
Folgende Makros können in Vorlagendateien und Anweisungen benutzt werden:
| Option | Beschreibung |
|---|---|
| %%f8 | Dateiname |
| %%e8 | Dateierweiterung (inkl. dem Punkt ".") |
| %%b8 | Basisdateiname ohne Erweiterung |
| %%p8 | Pfad der Datei (endet mit einem Backslash "\") |
| %%c8 | Kompletter Dateiname inkl. Pfad |
| %%xp8 | Pfad der Datei in Unix-Notation (endet mit "/"). |
| %%xc8 | Kompletter Dateiname inkl. Pfad in Unix-Notation. |
Makros für mp3-Dateien
Folgende Makros können zusätzlich bei mp3-Dateien mit ID3v1- oder ID2v2-Tags benutzt werden:
| Option | Beschreibung |
|---|---|
| %%i3t | Titel des Songs. |
| %%i3i | Interpret. |
| %%i3a | Albumtitel |
| %%i3n | Tracknummer (mit %%i3n2 und %%i3n3 kann die Nummer auf 2 bzw. 3 Stellen durch führende Nullen aufgefüllt werden). |
| %%i3j | Veröffentlichungsjahr des Songs. |
| %%i3t8 | Titel des Songs im UTF-8-Format. |
| %%i3i8 | Interpret im UTF-8-Format. |
| %%i3a8 | Albumtitel im UTF-8-Format. |
Wenn die Datei keine Tags enthält versucht quarkzBatch die Werte aus dem Dateinamen zu ermitteln. Möglich sind folgende zwei Varianten:
Interpret - Titel.mp3 Interpret - Album - Tracknummer - Titel.mp3
Präfix und Suffix
Zeilen zwischen "#head" und "#end" werden nur einmal am Anfang der Zieldatei und Zeilen zwischen "#foot" und "#end" nur am Ende geschrieben.
Beispiele
Beispiel für eine m3u Playliste (mit einem Eintrag)
#EXTM3U #EXTINF:236,John Mellencamp - Pink Houses C:\Music\J. C.Mellencamp - Pink Houses.mp3
%%ln wird im Beispiel zu "John Mellencamp - Pink Houses.mp3" expandiert
%%c wird zu "C:\Music\J. C. Mellencamp - Pink Houses.mp3" expandiert
%%f wird zu "J. C. Mellencamp - Pink Houses.mp3" expandiert
Konfigurationsdatei qzbatch.ini
[Options] Overwrite=0 ;1=vorhandene Datei immer überschreiben (Option "/y") EchoOff=1 ;0=kein "@echo off" bei .bat-Dateien (Option "/e") Remarks=1 ;0=keine Anmerkungszeilen ausgeben (Option "/r") Sort=0 ;1=Verzeichnisinhalte immer vorher sortieren (Option "/o") Convert=0 ;0=Dateinamen im DOS- (OEM-) Zeichensatz belassen ;1=Dateinamen in den Windows-Zeichensatz (ANSI) ;konvertieren (Option "/c")