Az exporter parancssor

Az exporter az Exporter Mac app, ablak nélkül futtatva. Ugyanazokat a kapcsolatokat, exportmappákat, kijelöléseket és beállításokat használja, amelyeket az appban állított be, és ugyanabba az exportnaplóba ír. Akkor is működik, ha az app be van zárva, és soha nem kérdez: ha valami hiányzik, a futás 2-es kilépési kóddal leáll, és egy sorban megmondja, mi a teendő. Csak macOS-en.

Telepítés

1. Telepítse az Exportert a Mac App Store-ból (letöltés), és nyissa meg.
2. Csatlakoztasson egy alkalmazást (Apple Notes, Bear, Logseq, Kontaktok, Üzenetek vagy Képernyőidő) vagy egy Dokumentumok mappát, és válassza ki az exportmappáját (első lépések). Ezeket az engedélyeket csak az appban lehet megadni.
3. Az app Parancssor kártyáján nyomja meg a „telepítőparancs másolása” gombot, és illessze be egyszer a Terminálba.

Az app sandboxban fut, és nem tud írni a PATH-ba, ezért az utolsó lépés egy beillesztés. A sor az /opt/homebrew/bin mappába telepíti az exporter parancsot, ha az a mappa létezik és az Öné (sudo nélkül), egyébként sudóval a /usr/local/bin mappába. Az ismételt beillesztés biztonságos; lecseréli, ami ott volt. Az exporter help install kiírja a Macjéhez tartozó sort.

Források

A --source a következők egyikét fogadja:

forrás	ezt is elfogadja	ezt írja
apple	apple-notes, applenotes, notes	markdown vagy html
bear		markdown vagy html
logseq		mindig markdown
contacts	apple-contacts, addressbook	mindig markdown
messages	imessage, chats, conversations	mindig markdown
screentime	screen-time, usage	mindig markdown, naponta egy fájl
documents	docs, files, pdf	a Dokumentumok kártyán bejelölt formátumok

Formátumok

A --format értéke markdown (vagy md) vagy html; a kis- és nagybetű nem számít. Minden más esetben a futás ezzel áll le: error: --format pdf: expected markdown | html, 64-es kilépési kóddal.

• nélküle a sync minden alkalmazást a kártyáján beállított formátumban ír (az Apple Notesnak és a Bearnek saját beállítása van), az export pedig az exportált alkalmazás beállítása szerint; az exporter help sync és az exporter help export mutatja az aktuálisakat
• a Logseq, a Kontaktok, az Üzenetek és a Képernyőidő mindig markdown, a Dokumentumok pedig a kártyáján bejelölt formátumokat írja, ezért náluk a --format html kapcsolót egy megjegyzéssel figyelmen kívül hagyja: note: logseq export is always markdown, so --format is ignored for this source.
• az Apple Notes jegyzetenként egy .html oldalt ír (a HTML formátum), a mellékleteket a mellette lévő attachments/ mappába másolva és linkelve, front matter nélkül. A Bear HTML-je a jegyzet egyszerű szövege egy <pre> elemen belül, formázás nélkül, a mellékletekre mutató hivatkozások pedig Markdown szövegként maradnak: a fájlok átmásolódnak, de nincsenek linkelve
• az MCP-szerver csak markdown fájlokat olvas, így a csak HTML-t tartalmazó exportot nem látja
• az Apple Notes és a Bear futásonként egy formátumot ír; csak a Dokumentumok írja mindkettőt egy szinkronizálással. Egy futás csak a saját formátumának régi fájljait törli, így váltáskor a másik formátum fájljai a mappában maradnak. Mindkét formátumhoz adjon mindegyiknek saját mappát:

exporter export --dest ~/Backups/notes-md   --format markdown
exporter export --dest ~/Backups/notes-html --format html

sync

Egyszer, inkrementálisan lefuttatja az appban beállított exportot, az app exportmappáiba.

exporter sync [--source <source>]... [--format markdown|html] [--full] [--json] [--quiet]

kapcsoló	mit csinál	alapértelmezés
--source <source>	csak ez az alkalmazás, ismételhető	minden csatlakoztatott alkalmazás; a nem csatlakoztatottakat kihagyja
--format markdown|html	csak erre a futásra, az app beállítása nem változik. Ugyanabba az exportmappába kerül, mint a másik formátum; ha mindkettőt meg szeretné tartani, exportálja mindegyiket a saját mappájába az export --dest paranccsal	az app beállítása
--full	mindent újraexportál. Írás előtt csak az Exporter által írt fájlokat távolítja el; minden más az exportmappában marad	ki
--json	géppel olvasható összesítés	ki
--quiet, -q	csak a hibák	ki

exporter sync --source apple

apple notes: exporting…
apple notes: 1204 of 1204 exported · 3 removed · 18.2s · markdown → /Users/me/Documents/notes

Az összesítő sor formája <source>: <succeeded> of <selected> exported, majd ha előfordul, N failed, N removed (törölt, átnevezett vagy áthelyezett elemek fájljai), N attachment issues, végül az időtartam, a formátum és a kiírt mappa.

Ha az app fut, a sync semmit sem exportál, 0-s kóddal kilép, és ezt írja ki: Exporter is running: real-time sync is live, the export root is already current.

export

Egyszeri export egy tetszőleges mappába, pillanatképekhez és szkriptekhez. Akkor is gond nélkül fut, ha az app nyitva van.

exporter export --dest <folder> [--source <source>] [--format markdown|html] [--organize folders|tags|smart] [--folder "Name"]... [--tag name]... [--dry-run] [--json] [--quiet]

kapcsoló	mit csinál	alapértelmezés
--dest <folder>	kötelező. Az app Parancssor kártyáján („mappa hozzáadása…”) engedélyezett mappán belül kell lennie. Egy ~/Backups engedély minden alatta lévő mappára érvényes	nincs
--source <source>	az exportálandó alkalmazás	apple
--format markdown|html	a formátum erre a futásra	az app beállítása
--organize folders|tags|smart	csak Apple Notes: hogyan rendeződnek a jegyzetek mappákba	az app beállítása
--folder "Name"	csak ez az Apple Notes mappa, ismételhető, a név kis- és nagybetűtől függetlenül egyezik	az appban mentett kijelölés
--tag name	csak ez a címke, ismételhető, Apple Notes vagy Bear	az appban mentett kijelölés
--dry-run	kiírja, mi exportálódna, de semmit sem ír	ki
--json, --quiet (-q)	mint a sync esetén	ki

--folder vagy --tag nélkül az Apple Notes és a Bear az appban mentett kijelölést exportálja. A Logseq a teljes gráfot, a Kontaktok minden névjegyet, az Üzenetek minden beszélgetést, a Képernyőidő minden napot exportálja; náluk a szűrőket egy megjegyzéssel figyelmen kívül hagyja.

exporter export --dest ~/Backups/notes-$(date +%F)
exporter export --dest ~/Backups/work --folder "Work" --format html
exporter export --dest ~/Backups/bear --source bear --tag journal
exporter export --dest ~/Backups/people --source contacts
exporter export --dest ~/Backups/papers --source documents
exporter export --dest ~/Backups/notes --dry-run

would export 100 apple notes · markdown → /Users/me/Backups/notes

list

exporter list sources|folders|tags|dests [--source apple|bear] [--json]

lista	mit mutat	JSON
sources	minden alkalmazás, csatlakoztatva vagy sem, a darabszámával. A Dokumentumok nem szerepel	[{"source": "apple", "connected": true, "notes": 1204}, {"source": "messages", "connected": true, "conversations": 1532}, {"source": "bear", "connected": false}], a logseqnél pages, továbbá contacts, a screen-time esetén pedig days
folders	Apple Notes mappák a jegyzetek számával, mélység szerint behúzva. A --source bear hiba (kilépési kód 64)	[{"name": "Work", "notes": 42, "level": 0}]
tags	címkék a darabszámukkal, alapból Apple Notes, --source bear esetén Bear	[{"name": "journal", "notes": 12}]
dests	mappák, amelyekbe az export --dest írhat, valamint minden alkalmazás exportmappája	[{"path": "/Users/me/Backups", "kind": "granted"}], ahol a kind értéke granted, granted, volume not mounted vagy export root (apple-notes)

exporter list folders --json

[{"name": "Work", "notes": 42, "level": 0}]

status

exporter status [--json]

apple notes    connected · last export 2026-09-11 03:00
bear           not connected
logseq         not connected
contacts       not connected
messages       connected · last export 2026-09-11 03:01
screen time    not connected
documents      not connected
root (apple-notes)  /Users/me/Documents/notes
root (messages)  /Users/me/Documents/messages
destinations   /Users/me/Backups
version        3.24 · free · 100 of 100 free notes used
messages       free · 10 of 10 free conversations used
app            not running

--json esetén: alkalmazásonként egy objektum, apple-notes, bear, logseq, contacts, messages, screen-time, documents néven, mindegyik {"connected": true, "lastExport": "2026-09-11 03:00"} (null, ha még sosem exportált); destinations (elérési utak); tier (full vagy free, az Apple Notes feloldása) és freeNotesUsed; contactsTier és freeContactsUsed; messagesTier és freeConversationsUsed; screenTimeTier és freeDaysUsed; appRunning. Az időpontok helyi idő szerint, yyyy-MM-dd HH:mm formában.

log

A legutóbbi exportfutások, a legújabb elöl: ugyanaz a napló, amelyet az app mutat, minden exportmappából és engedélyezett --dest mappából. Az engedélyezett mappa alatt létrehozott, dátummal ellátott mappákat nem olvassa; azok naplója a <folder>/.exporter/ mappában van.

exporter log [--last N] [--json]

kapcsoló	mit csinál	alapértelmezés
--last N	hány futás	10
--json	futásonként egy objektum	ki

2026-09-11 03:00  apple-notes   1204/1204 exported  3 removed  clean  → /Users/me/Documents/notes

JSON: [{"source", "finishedAt", "selected", "succeeded", "failed", "format", "status", "destination", "prunedFiles", "runError"}]. A status értéke clean, warnings (hiányzó mellékletek) vagy failures.

doctor

Ellenőrzi, hogy az ablak nélküli export működni fog-e, és ellenőrzésenként egy sort ír ki: ok, FAIL alatta egy fix: sorral, warn, vagy -- tájékoztatásként.

exporter doctor

Ellenőrzi, hogy minden csatlakoztatott alkalmazás adatbázisa olvasható és az exportmappája írható-e, hogy minden tárolt mappaengedély feloldható-e, hogy minden --dest mappa írható-e, valamint az indexet és a telepített parancsot. A végén kiírja a verzió szintjét, azt, hogy fut-e az app, és az utolsó összeomlást, ha volt. 0-s kilépési kódnál all good., 2-esnél N problem(s) found. a kimenet.

report

Diagnosztikai jelentést ír ki (az app verziója, a macOS és a hardver, a kapcsolatok állapota, a legutóbbi futások, az utolsó összeomlás; jegyzettartalom nélkül), és a vágólapra másolja.

exporter report [--send] [--email <addr>]

kapcsoló	mit csinál	alapértelmezés
--send	elküldi nekünk a jelentést, és kiírja: sent., vagy offline: queued, will send on the next run or app launch.	ki
--email <addr>	hozzáadja az e-mail-címét, hogy válaszolhassunk	nincs

help és version

• exporter help [topic]: témák: sync, export, list, status, log, doctor, report, cron, install. Egy parancs súgója az aktuális beállításait mutatja alapértelmezésként
• a sync, az export, a list, a log és a report a --help vagy -h kapcsolót is elfogadja
• az exporter version (vagy --version, -v) ezt írja ki: exporter 3.24
• a terminálban magában futtatott exporter kiírja az áttekintést, és 64-es kóddal kilép

JSON kimenet

A --json a sync, az export, a list, a status és a log parancsnál működik. A kimenet formázott, rendezett kulcsokkal. A sync és az export mellé adja meg a --quiet kapcsolót is: nélküle a folyamat- és jegyzetsorok a JSON előtt a stdout-ra kerülnek. Az export egy összesítő objektumot ír ki, a sync pedig {"runs": [...]} formát, forrásonként eggyel:

{
  "attachmentIssues" : 0,
  "durationSec" : 18.2,
  "failed" : 0,
  "format" : "markdown",
  "root" : "/Users/me/Documents/notes",
  "runError" : null,
  "selected" : 1204,
  "source" : "apple-notes",
  "status" : "clean",
  "succeeded" : 1204
}

Amíg az app fut, a sync csak az egy sorát írja ki, JSON nélkül. A hibák a stderr-re kerülnek error: <what happened and what to do> formában.

Kilépési kódok

kód	jelentés
0	rendben, beleértve azt a futást is, amelyet az ingyenes keret megrövidített
1	exporthibák: egy elem nem sikerült, a futás hibába ütközött, vagy kijelölt elemeket, de egyet sem írt ki
2	beállítás szükséges: az alkalmazás nincs csatlakoztatva, a mappa nincs engedélyezve, a mappa vagy a címke nem található, nincs mit exportálni; a doctor problémákat talált; a telepített parancs régi formátumú, vagy az app, amelyre mutat, már nincs meg
64	használat: ismeretlen parancs vagy kapcsoló, hiányzó vagy hibás érték, --folder a Bearrel, list folders --source bear, magában futtatott exporter a terminálban

Hová kerülnek a fájlok

A sync az Exporterben az egyes alkalmazásokhoz beállított exportmappába ír, például a ~/Documents/notes vagy a ~/Documents/messages mappába; az export a --dest mappába. A saját mappája szintjén vagy eggyel alatta lévő mappa, például maga a ~/Documents, alkalmazásonként almappát kap (notes-export, messages-export és így tovább), egy mélyebben lévő mappát pedig úgy használ, ahogy van. Az összesítő sor (a nyíl után) és a JSON root mezője a valódi mappát mutatja.

Minden exportmappában megtalálható a .exporter/last-export.json és a .exporter/last-export.md (az utolsó futás), valamint a .exporter/history/ (az utolsó 50 futás). Az Apple Notes, a Kontaktok, az Üzenetek, a Képernyőidő és a Dokumentumok a .exporter/files.json fájlt is vezeti, amely minden fájlt felsorol, amelyet egy futás kiírt: a következő futás csak az itt felsorolt fájlok közül töröl olyat, amelyet már egyetlen elem sem hoz létre (a Képernyőidő soha nem töröl napi fájlt). A Bear és a Logseq is eltávolítja a következő futáskor a törölt, átnevezett vagy átcímkézett jegyzetek fájljait. Az Apple Notes és a Logseq exportja egy bases/ mappát is kap Obsidian nézetekkel.

Ingyenes keret

A parancssornak ugyanazok a keretei, mint az appnak:

alkalmazás	ingyenes
Apple Notes	100 jegyzet
Kontaktok	100 kontakt
Üzenetek	a 10 legutóbbi beszélgetés
Képernyőidő	az első szinkronizáláskor a 10 legutóbbi nap, és csak azok: a későbbi napokhoz feloldás kell
Dokumentumok	a 10 legutóbb módosított dokumentum
Bear és Logseq	korlátlan

A már exportált elemek ingyen tovább szinkronizálnak; a keret csak az újakat állítja meg. Az a futás, amely eléri a keretet, exportálja, amit lehet, 0-s kóddal kilép, és kiír egy megjegyzést (--quiet esetén nem):

note: 42 note(s) skipped: free version limit (100 of 100 free notes). upgrade in the app to export everything.
note: 58 contact(s) skipped: free version limit (100 of 100 free contacts). unlock contacts in the app to export everything.
note: 1522 conversation(s) skipped: free version limit (10 of 10 free conversations). unlock messages in the app to export everything.
note: 11 day(s) skipped: free version limit (10 of 10 free days). unlock screen time in the app to archive every day.
note: 5 document(s) skipped: free version limit (10 of 10 free documents). unlock documents in the app to convert every one.

A status --json tartalmazza a szintet és a felhasznált mennyiséget az Apple Notes, a Kontaktok, az Üzenetek és a Képernyőidő esetén. Minden korlátozott alkalmazás a saját egyszeri, appon belüli vásárlásával oldható fel az Exporterben, országonként eltérő áron, előfizetés és webes fizetés nélkül. A parancssor minden futáskor beolvassa a vásárlást; ha az App Store 5 másodpercen belül nem válaszol, a futás az ingyenes kerettel folytatódik.

Ütemezés

Az exporter help cron ezeket a sorokat a parancs Macjén érvényes teljes elérési útjával írja ki: azt használja, mert a cron PATH-ja nem feltétlenül tartalmazza a telepítési mappát. Crontabban a % jelet \% formában kell escape-elni:

0 3 * * * exporter sync
0 3 * * * exporter export --dest ~/Backups/notes-$(date +\%F)

A Carbon Copy Clonerhez és más mentőeszközökhöz futtassa az exporter sync parancsot előzetes (pre-flight) szkriptként, és a kilépési kód alapján ágaztasson el. A parancs a teljes export alatt csatolva marad, akkor is, ha a macOS felfüggeszti, amikor senki sincs bejelentkezve. Amíg az app fut, akár nyitott, akár zárt ablakkal, a sync nem csinál semmit: a valós idejű szinkronizálás már frissen tartja a mappát.

MCP-szerver

Nem a parancssor, hanem az app futtat egy helyi MCP-szervert, amelyen keresztül a Claude, a Cursor, a VS Code és más kliensek kereshetnek és olvashatnak az exportjaiban, a http://localhost:8744/mcp címen. Az MCP-szerver oldala mindent leír róla, az indítástól a hat eszközéig.

Hibaelhárítás

Először futtassa az exporter doctor parancsot; minden sikertelen ellenőrzés kiírja a javítását. A hibaelhárítás az app üzeneteit is lefedi.

• X is not authorized: adja hozzá a mappát (vagy egy szülőmappáját) a Parancssor kártyán, majd futtassa újra. Az exporter list dests megmutatja, mi van engedélyezve
• apple notes is not set up. open Exporter and connect Apple Notes + an export folder. (minden alkalmazásnál ugyanígy): csatlakoztassa az Exporterben
• a sync azt írja ki, hogy az Exporter fut: nincs teendő, az app frissen tartja a mappát. Külön másolathoz használja az export --dest parancsot
• no notes were written. run "exporter doctor" to check folders and permissions.: a futás kijelölt jegyzeteket, de egyet sem írt ki; a doctor ellenőrzi a mappákat és az engedélyeket
• bookmark broken: a mappát áthelyezték, törölték, vagy a kötete nincs csatlakoztatva. Válassza ki újra az appban
• a telepített parancs régi formátumú, vagy a cron és a mentőeszközök 19-es kilépési kódot látnak: illessze be újra a telepítőparancsot
• az app a parancs telepítése óta máshová került: illessze be újra a telepítőparancsot
• fel van oldva, de a futás ingyenes verziót jelez: a vásárlás ellenőrzése legfeljebb 5 másodpercig vár, utána az ingyenes kerettel folytatja. Futtassa újra
• olyan probléma, amelyet a doctor nem tud megmagyarázni: exporter report --send --email you@example.com