Makrá

Makro je pomenovaná sekvencia akcií so súbormi — vytvoriť adresár, presunúť doň výber, označiť zvyšok — ktorú možno jediným kliknutím spustiť znova. Nie je to skriptovací jazyk: nie sú v ňom podmienky ani cykly, a to zámerne. Makro je zoznam, ktorý si môžete prečítať, a prečítať si ho musíte vedieť skôr, ako ho schválite.

Všetko, čo makro robí, prechádza tým istým strojom ako asistent. Makro teda nemôže urobiť nič, čo ste nepovolili, každý jeho krok sa objaví v protokole akcií a krok, ktorý sa dá vzať späť, sa dá vzať späť aj naďalej.

Jedno okno: Konfigurácia ▸ Makrá…

Všetko okolo makier je za touto jedinou položkou: ich zoznam, oba spôsoby, ako makro vytvoriť, aj cesta do súboru. V ponuke už nie je medzi čím vyberať.

Najrýchlejšia cesta: nahrať makro

Makro nemusíte písať od nuly — a nemusíte ani dodatočne zisťovať, kde vlastne začalo.

1. Konfigurácia ▸ Makrá… ▸ Nahrať makro…. Okno ustúpi nabok a objaví sa malý panel, ktorý hovorí, že nahrávanie beží, a priebežne počíta kroky.
2. Urobte prácu raz — kopírujte, presúvajte, premenúvajte, mažte, zakladajte priečinky a súbory. Pracujte normálne; nahrávanie neprekáža.
3. Zastaviť a uložiť….
4. Kroky sa vrátia už zaškrtnuté. Odškrtnite všetko, čo len pripravovalo pôdu, pomenujte makro a nechajte zapnuté Pridať pre neho aj tlačidlo.
5. Zaškrtnite Sledovať panely namiesto práve týchto súborov, ak má makro nabudúce pracovať s tým, čo bude práve vybrané. Riadky sa pri zaškrtnutí zmenia, takže vidíte, čo ukladáte.

Uložiť makro — a tlačidlo je v lište. To je celý postup.

Zahodiť nahrávku nahrávku vyhodí a nič neuloží. Pred stlačením Nahrať sa nezaznamenáva nič a po zastavení tiež nie — práve preto má nahrávanie oba konce.

Nahrávka prežije reštart. Ak sa Peach Commander ukončí, kým beží — pretože skončíte vy, alebo pretože spadne — vráti sa aj s ňou, povie to a vy buď pokračujete, alebo ju zahodíte.

Ak to radšej chcete na klávese alebo tlačidle, príkaz sa volá cm_MacroRecord: spustí nahrávanie a zastaví to, ktoré beží.

Druhá cesta: z toho, čo sa už stalo

Z posledných akcií… v tom istom okne poskladá makro z posledných vecí, ktoré sa stali, namiesto nahrávania nových — hodí sa, keď ste prácu práve urobili a až potom vás makro napadlo.

Čo sa už stalo, ponúknuté ako kroky nového makra.

Zoznam obsahuje oboje: čo ste urobili v paneloch (F5, F6, F7, F8 a premenovanie) a čo urobil asistent alebo iné makro. Každý riadok hovorí, ktoré z toho — po sedení s oboma sa tie isté dva súbory môžu objaviť v oboch. Tu sú riadky spočiatku nezaškrtnuté: „všetko, čo som za poslednú polhodinu urobil“ je málokedy to makro, ktoré máte na mysli.

Táto cesta potrebuje históriu. To, čo robíte ručne, sa číta z globálnej histórie; ak ste ju vypli (Nastavenia ▸ Rôzne ▸ Zaznamenávať globálnu históriu), v tomto zozname nie je nič vaše — a zoznam to hovorí. Nahrať makro… od nej nezávisí.

Čo sa neponúka. Zabalenie archívu a všetko ostatné, čo si aplikácia pamätá len podľa mena, sa nedá premeniť na krok — nie je preň tvar. Také riadky sú vidieť zošednuté aj s dôvodom, namiesto aby chýbali, aby zoznam piatich, ktorý ponúka tri, nevyzeral, že dva prehliadol. A ak nepožiadate inak, cesty sú tie, ktoré naozaj prebehli: zaznamenané makro zopakuje tú kópiu, nie „kópiu toho druhu“. Otvorte ho v editore a dajte %S alebo %T tam, kde má sledovať panely.

Sledovať panely je spôsob, ako požiadať inak. Zo súborov, ktoré pochádzali všetky z jednej zložky, sa stane výber; zo zložky, ktorá je jedným z dvoch panelov, sa stane ten panel, a zložka vnútri si ponechá svoj zvyšok — zo zaznamenaného „presuň tieto štyri faktúry do Dokumenty/2026-08“ sa stane „presuň vybrané do 2026-08 na druhej strane“, a zajtra to funguje v dvoch iných zložkách. Čo neleží pod žiadnym z oboch panelov, zostáva cestou, ktorou je — nie je do čoho to zložiť. Voľba sa ponúka len vtedy, keď by niečo zmenila.

Priložené príklady

Keď prvýkrát otvoríte Upraviť súbor…, súbor sa založí s ôsmimi hotovými príkladmi. Sú to bežné makrá — upravte ich alebo zmažte tie, ktoré nechcete — a každé nesie komentár, ktorý hovorí, čo robí a čo sa v ňom dá zmeniť:

Makro	Čo robí
Open today's folder	Založí v aktívnom paneli dnešný dátumový priečinok a vojde doň. Zajtra poslúži znova.
File the selection into a dated folder	Vyberie všetky PDF, na druhej strane založí priečinok rok-mesiac a presunie ich doň.
Copy the selection to a dated backup folder	Skopíruje to, čo ste vybrali vy, do datovaného priečinka na druhej strane.
Move the pictures into an Images subfolder	Jedna maska, jeden podpriečinok, v priečinku, v ktorom už ste.
Merge the CSV files into one and open it	Ukazuje, ako krok použije to, čo vytvoril krok predchádzajúci.
File the selection into a folder you name	Pri spustení sa vás spýta na priečinok.
Mark the file under the cursor as reviewed	Označí ho štítkom a opatrí komentár dátumom — jeden súbor, nie výber.
Put the temporary files in the Trash	Mazacie makro, a to pravé, na ktorom si raz pozrieť otázku na oprávnenia.

Každé z nich sa stane príkazom, takže ktorékoľvek môžete umiestniť na tlačidlo alebo na klávesu bez toho, aby ste čokoľvek písali.

Spravovať ich

Konfigurácia ▸ Makrá… je ten zoznam: ako sa každé makro volá, ako sa volá jeho príkaz, koľko má krokov a na čo sa spýta kontrola oprávnení — takže „toto maže“ vidno skôr, než ho dáte na kláves. Odtiaľ môžete spúšťať, premenúvať, duplikovať, meniť poradie, mazať, exportovať a importovať. Prejdením po riadku sa ukážu jeho kroky.

Spustiť je spôsob, ako vyskúšať makro, ktoré ste práve nahrali, bez toho, aby ste najprv zatvárali okno a hľadali príkaz. Prechádza rovnakým plánom a rovnakým potvrdením ako každé iné spustenie — toto okno nemá vlastné oprávnenia.

Exportovať… zapíše vybrané makro do vlastného súboru a Importovať… pridá makrá zo súborov, ktoré vám niekto poslal — práve na to je jeden súbor na makro. Import nikdy nenahrádza: makro, ktorého id je už obsadené, dostane voľné (prichádzajúci backup sa vedľa vášho stane backup-2) a dozviete sa, pod akými id nové skončili, pretože tlačidlo, ktoré vytvoríte, musí ukázať na to správne.

Ako sa každé makro volá, ako čo beží a načo si vyžiada povolenie.

Poradie nie je ozdoba: poradie v súbore je to, v ktorom ich vypisuje Prehliadač príkazov a výber pre lištu tlačidiel.

Pri mazaní sa ponúkne vziať so sebou aj tlačidlá, a to stojí za vedenie, aj keby ste toto okno nikdy neotvorili: makro odstránené ručne nechá po sebe svoje tlačidlo aj kláves, a ani jedno potom nič nerobí — aplikácia teraz povie, že makro nie je, namiesto toho, aby mlčala, ale tlačidlo zostáva na vás. Kláves alebo položku ponuky treba vybrať tam, kde bola nastavená.

Kroky sa tu neupravujú. Upraviť súbor… to odovzdá editoru, z rovnakého dôvodu, z akého tu nie je formulár: krok je názov nástroja s jeho argumentmi, a to je presne to, čím JSON je.

Ručné úpravy makier

Upraviť súbor… otvorí vlastný súbor vybraného makra — macros/<id>.json vo vašom konfiguračnom priečinku, prvýkrát vytvorený s príkladmi vyššie. Bez výberu sa v paneli ukáže samotný priečinok, kde F3 jedno prečíta a F4 jedno upraví. Makro je zoznam krokov a každý krok menuje nástroj a jeho argumenty:

{
  "id": "stage-by-month",
  "title": "File the selection into a dated folder",
  "icon": "calendar",
  "steps": [
    { "tool": "set_selection", "arguments": { "mask": "*.pdf" } },
    { "tool": "make_directory", "arguments": { "path": "%T/%{date:yyyy-MM}" } },
    { "tool": "move", "arguments": { "sources": "%S", "destination": "%T/%{date:yyyy-MM}" } }
  ]
}

Uloženie makrá hneď znova načíta — a povie, ak niečo nesedí: preklep v názve nástroja, chýbajúci povinný argument, dve makrá s rovnakým id. Makro s chybou sa nespustí a na žiadne tlačidlo sa nedostane; dozviete sa, o ktoré ide a čo je na ňom zle, kým je editor ešte otvorený.

Ktoré nástroje existujú a čo berú, ukáže Konfigurácia ▸ Prehliadač príkazov…, alebo sa asistenta spýtajte na list_macros.

Zástupné symboly

Samotné písmená sú tie isté, aké používa lišta tlačidiel a ponuka Štart: kto už jedno tlačidlo vytvoril, sa tu nemusí učiť nič nové.

Symbol	Znamená
%P	Adresár aktívneho panela
%T	Adresár druhého panela
%N	Súbor pod kurzorom
%S	Vybrané súbory — zoznam, čo je presne to, čo prijímajú copy, move a move_to_trash
%{date:yyyy-MM}	Dátum spustenia makra v tomto formáte
%{1.destination}	Jedna pomenovaná hodnota z výsledku kroku 1 — tu súbor, ktorý merge_files zapísal
%{1}	Celý výsledok kroku 1, ak tento krok priamo vytvoril cestu alebo zoznam ciest
%{ask:Folder name}	Spýta sa vás, keď makro beží. %{ask:Folder name=Archive} predvyplní pole hodnotou Archive

Zložené zátvorky sú pre doplnky, pretože písmená sú už obsadené: %M znamená vo zvyšku programu „meno pod kurzorom v druhom paneli“, mesiac sa teda takto zapísať nedal.

Pre výsledky krokov použite pomenovanú podobu. Väčšina nástrojov hlási niekoľko hodnôt namiesto jedinej — merge_files hlási, kam zapísal, koľko súborov zlúčil a koľko riadkov z toho vzišlo —, preto je %{2.destination} obvyklý zápis a holé %{2} funguje len pri nástroji, ktorý vracia jedinú cestu. Meno, ktoré tam nie je alebo ktoré nie je cestou, makro zastaví, namiesto toho aby sa hádalo.

% v názve súboru je %. Nič z toho, čo krok vytvorí, ani žiadne meno z panela sa znova nečíta ako zástupný znak — súbor s názvom 50%Netto.pdf teda prejde makrami bez zmeny. Doslovné % v šablóne, ktorú píšete vy, zdvojte: %%.

Spýtať sa na hodnotu

%{ask:…} je spôsob, akým makro prevezme niečo, čo dopredu vedieť nemôže — vôbec najbežnejšie makro je „presuň výber do priečinka, ktorý pomenujem“, a bez toho by priečinok musel byť napevno v súbore.

Spýtame sa vás skôr, než sa objaví plán, a odpovede sú už v ňom: riadky hovoria „Presunúť výber do „Faktúry““, nie „do toho, čo o chvíľu napíšete“. Zrušenie otázky zruší makro; nič nebolo navrhnuté, nieto ešte vykonané.

Tá istá otázka napísaná dvakrát sa položí raz a použije sa na oboch miestach, takže dva kroky menujúce ten istý priečinok sa nemôžu rozísť. Čo nasleduje po prvom =, je to, čím pole začína. Znenie je vaše: zobrazí sa presne tak, ako ste ho napísali, v jazyku, v ktorom ste ho napísali.

Odpoveď je hodnota, nikdy šablóna: ak napíšete 50%Netto, dostanete priečinok s menom 50%Netto.

Makro, ktoré sa pýta, nemôže spustiť externý agent cez MCP — nie je sa tam koho spýtať, a mlčky vziať predvolené hodnoty by znamenalo odpovedať za vás. Odmietne sa a povie to.

%S je jediné miesto, kde sa makro líši od tlačidla: na tlačidle sa výber stane zoznamom slov pre príkazový riadok, tu sa stane zoznamom plných ciest, ktoré prijímajú nástroje pre súbory.

Krok, ktorého %S alebo %{1} vyjde prázdny, makro zastaví, namiesto toho, aby bežal s ničím. move bez súborov nie je menší move — je to požiadavka, ktorá už nič nehovorí, a hlásiť pri nej úspech by bola lož.

Spustenie makra

Každé makro sa stane príkazom s názvom mc_<id>, a preto sa samo objaví v:

• Konfigurácia ▸ Prehliadač príkazov…
• Konfigurácia ▸ Upraviť skratky… — priraďte ho klávese
• Výbere príkazov v editore lišty tlačidiel
• Vašom súbore ponuky .mnu a usercmd.ini, ak ich používate
• Asistentovi, ktorý ho môže spustiť podľa názvu

Než sa spustí makro, ktoré niečo mení, ukáže vám svoje kroky ako zoznam a počká. Krok, ktorý nechcete, môžete vyškrtnúť; čo zostane, sa vykoná. Makro, ktoré len číta, beží bez otázky. Škrtnutie kroku vezme so sebou kroky, ktoré od neho závisia — makro je postupnosť a krok, ktorý priečinok napĺňa, nemôže bežať bez kroku, ktorý ho zakladá: tie riadky sa samy vypnú a zošednú. Vráťte krok späť a vrátia sa aj ony — okrem tých, ktoré ste škrtli sami; tie zostanú škrtnuté.

Kroky, vyhodnotené voči vašim panelom — každý sa dá škrtnúť.

Všetko, čo sa dá rozpoznať ako chybné ešte pred spustením — nástroj, ktorý neexistuje, chýbajúci argument, krok, ktorý by spustil iné makro —, makro zastaví pred prvým krokom, nie až po treťom. Ak krok zlyhá už za behu, makro sa zastaví tam namiesto toho, aby pokračovalo: krok dva obvykle predpokladá, že sa krok jeden stal, a presúvať súbory do priečinka, ktorý nevznikol, nie je čiastočný úspech. Hlásenie menuje krok, povie, čo sa pokazilo, a koľko krokov už bolo vykonaných; každý z nich je v protokole akcií, aj s cestou späť, kde nejaká je.

Čo makro smie

Makro sa posudzuje podľa toho najnáročnejšieho, čo obsahuje. Makro, ktorého kroky len čítajú, sa považuje za čítanie; to, ktoré končí trvalým vymazaním, je chránené ako trvalé vymazanie — skôr než sa čokoľvek spustí, nie o štyri kroky neskôr.

Krok, ktorý spúšťa príkaz, sa posudzuje podľa toho, čo ten príkaz robí, nie podľa toho, že je to príkaz — makro, ktoré spúšťa cm_DeleteReal, je teda mazacie makro a ako také sa vám ukáže. Makro nemôže spustiť iné makro, ani jedným z oboch zápisov.

Nepovoliť nič navyše je predvolený stav. Ak makro obsahuje krok, ktorý vaše oprávnenia nedovoľujú — príkaz shellu, skript —, celé makro je odmietnuté s uvedením dôvodu a nič sa nestane.

Vzatie späť

Každý krok je zaznamenaný samostatne, takže vzatie späť po makre vráti jeho posledný krok, nie celé makro. Vzatie celého makra späť neexistuje, pretože niekoľko nástrojov nemá žiadnu inverziu a tlačidlo, ktoré by to ponúkalo, by o nich klamalo.

Kde sa to ukladá

• Vaše makrá sú v macros/ v konfiguračnom priečinku, každé ako <id>.json — obyčajné súbory, ktoré môžete diffovať, držať medzi dotfiles a niekomu poslať. macros.json zo staršej verzie sa pri prvom spustení prevezme a premenuje na macros.json.migrated; potom ho už nikto nečíta.
• Tlačidlá pridané makrom sú bežné položky lišty tlačidiel v default.bar, takže odobrať jedno je to isté ako u ktoréhokoľvek iného tlačidla.

Ďalšie kroky

• Automatizácia (AppleScript a Skratky) — Riadenie Peach Commanderu zo skriptu a spúšťanie vlastných skriptov ako kroku makra.
• Lišta tlačidiel — Kde skončí tlačidlo, ktoré makro pridalo.
• Klávesnica a skratky — Priradenie makra klávese.