Baixar o Exporter
Documentação Calendário

Calendário

Como funciona a exportação do Calendário, de conectar a resolver problemas.

Conectar

Aperte «Conectar» ao lado do Calendário na tela Início do Exporter e depois «Abrir Pasta do Calendário». A janela abre na pasta do Calendário, ~/Library/Group Containers/group.com.apple.calendar: aperte «Selecionar esta pasta». Depois escolha para onde vão os arquivos e aperte «Usar esta pasta».

O macOS não pede acesso ao calendário, e o Exporter nunca pede: os eventos são lidos do banco dentro da pasta que você autorizou, não pelo EventKit. A caixa de permissão que você já viu em outros apps vem daquele outro caminho.

Para onde vão os arquivos

Um arquivo Markdown por mês, em uma pasta: 2026-09.md, 2026-10.md. Uma pasta direto na sua pasta pessoal, como ~/Documents, ganha dentro uma pasta calendar-export; uma mais funda, como ~/Documents/calendario, é usada como está. Um mês sem eventos não ganha arquivo.

O que é exportado

Todo evento dos calendários marcados no cartão, dentro do período configurado. O seletor agrupa os calendários sob as contas deles, como a barra lateral do Calendário, então um clique pode deixar uma conta de fora.

Um evento fica no mês em que começa, uma vez só, mesmo que siga além do fim do mês.

Repetições

Um evento repetido aparece em cada dia em que acontece, não só no dia em que foi criado. O Exporter lê as ocorrências que o Calendário guarda para as próprias telas, então o arquivo concorda com o app, e uma linha diz como o evento se repete.

Formato

Sempre Markdown: o frontmatter do mês, depois um título por dia e uma linha por evento.

Um dia começa pelos eventos de dia inteiro e segue pelo horário de início, a ordem em que o Calendário o desenha. Um evento de dia inteiro escreve «all day»; ele nunca ganha um 00:00 que não tinha.

O arquivo

chave contém
title, month “Calendário, setembro de 2026” e 2026-09
events quantos eventos o arquivo contém
calendars os calendários do mês, o mais cheio primeiro

Uma linha é o horário, o evento, o calendário de onde veio e onde acontece, e depois os campos que um vault pode consultar:

campo contém
repeats:: daily, weekly, every 2 weeks
join:: o link da videochamada, quando o evento tem um
with:: quantas pessoas estão nele
## 2026-09-17, quinta-feira

- all day Aniversário da Marilyn · Aniversários
- 09:30-10:00 Standup · Trabalho · Zoom [repeats:: weekly] [with:: 6]
- 13:00-14:00 Almoço com Kevin · Pessoal · Philz Coffee

Até quando ele lê para trás

A linha «reads» do cartão: este ano, 2 anos, 5 anos ou tudo. Ela muda quais arquivos são escritos, então um período mais curto é uma exportação menor.

O Calendário guarda cerca de dois anos de ocorrências para as próprias telas, e é isso que há para ler: em um Mac de verdade, 2 anos, 5 anos e tudo devolvem os mesmos eventos. «tudo» quer dizer tudo o que este Mac tem, não tudo o que já aconteceu.

Grátis e desbloqueado

Seus primeiros 100 eventos são grátis, e continuam sendo. Desbloquear o Calendário exporta o resto (preços).

Sincronização e sincronização completa

Depois do primeiro «sync now», o Exporter reescreve um mês quando algo dentro dele muda, no máximo uma vez por minuto. Mover um evento reescreve o mês dele, e só aquele.

«full resync» pergunta primeiro, depois remove os arquivos de mês que o Exporter escreveu e escreve de novo cada calendário marcado. Tudo o mais na pasta fica.

Problemas e soluções

  • «no calendar database in that folder (pick the Calendar folder itself)»: aperte «connect» de novo e selecione a pasta em que a janela abre
  • falta um calendário: ele está desmarcado no cartão, ou a conta inteira está. O seletor agrupa os calendários por conta
  • faltam eventos antigos: a linha «reads» está em um período mais curto, ou o próprio Calendário não os tem mais
  • seus lembretes estão na exportação: o Calendário mostra lembretes agendados como um calendário à parte. Desmarque a conta «Reminders» no cartão

Exporter

Versão 5.2 (App Store)

macOS 15 ou posterior

exporter@tinysend.com

© system operator