Documentação de automação

Atalhos da Apple

Crie fluxos com conjuntos de calendários, intervalos confirmados, planos salvos, dias úteis e imagens do calendário.

Estes guias abrangem o popCalendar 1.3 e versões posteriores. Algumas ações exigem uma versão mais recente do sistema, conforme indicado abaixo.

Encontre popCalendar em Atalhos

Abra o app atualizado uma vez, adicione uma ação em Atalhos da Apple e procure popCalendar. As ações estão disponíveis no macOS 13 ou posterior e iOS 17 ou posterior. Seletores de datas e Atalhos de Apps sugeridos no Mac exigem macOS 13.3 ou posterior. No macOS 12, use CLI ou URL.

A seção popCalendar inclui os atalhos prontos Abrir calendário, Escolher intervalos de datas, Contar dias úteis, Pausar sinais sonoros e Retomar sinais sonoros. A pausa padrão é de 60 minutos. Não é preciso importar um arquivo de atalhos.

Voltar ao índice

Ações no Mac, iPhone e iPad

AçãoO que faz
Abrir calendárioEscolha um conjunto de calendários, um dos seis layouts e uma data inicial opcional.
Obter conjuntos de calendáriosRetorna nomes e IDs dos conjuntos de calendários salvos.
Escolher intervalos de datasSelecione e confirme datas para retornar intervalos tipados com início, fim, contagem inclusiva de dias e fuso horário.
Obter planos salvosRetorna planos salvos, seus intervalos e informações de repetição. Filtre por nome ou ID.
Criar plano salvoSalva um intervalo inclusivo com nome e retorna o ID do plano.
Duplicar plano salvoDuplica um plano salvo com outro nome e retorna seu ID.
Abrir plano salvoAbre um plano salvo com os intervalos e ajustes de repetição atuais.
Mudar conjunto de calendários ativoMuda o conjunto ativo mantendo a data e o layout atuais.
Contar dias úteisConta os dias úteis usando a jornada ativada e os calendários de ausências de dia inteiro. Os dois extremos contam.
Adicionar dias úteisAvança ou retrocede por dias úteis. O dia inicial não conta.
Pausar sinais sonorosPausa os sinais sonoros pelo número de minutos indicado, até sete dias.
Retomar sinais sonorosEncerra a pausa preservando a programação e o estado de ativação dos sinais sonoros.
Exportar imagem do calendárioExporta um PNG de até dois anos civis. Inclui apenas os planos solicitados. Círculos de eventos são omitidos, a menos que solicitados.
Voltar ao índice

Conjuntos e comportamento por plataforma

Ative o acesso a dados privados para listar conjuntos salvos por nome. As escolhas usam IDs estáveis, então renomear um conjunto não quebra um atalho. Excluir um conjunto gera um erro em vez de abrir outro. Ações nativas não exigem o controle externo do Mac.

No Mac, Abrir calendário cria uma janela independente com uma cópia do filtro. A sessão padrão é shortcuts. Reutilizá-la atualiza a mesma janela. No iPhone e iPad, abre a aba Calendário e aplica o modo, a data e o conjunto escolhidos. Outras janelas do iPad mantêm suas datas e layouts.

Voltar ao índice

Controles adicionais do Mac

Controlar calendário abre, alterna, atualiza, move ou fecha sessões nomeadas com as mesmas opções da interface URL. Escolha janela, painel ou tela cheia. Obter sessões do calendário lista seus IDs. Obter informações de comandos do calendário retorna versão, referência, recursos ou diagnóstico.

Selecionar datas do calendário retorna intervalos confirmados em JSON ou texto. Escolher intervalos de datas retorna valores tipados. O tempo limite padrão é 300 segundos. Escape ou fechar o seletor cancela a operação. O cancelamento nativo com Parar é compatível com macOS e iOS 26.4 ou posteriores. Versões anteriores mantêm Cancelar e o tempo limite.

Voltar ao índice

Crie um fluxo de trabalho

  • Escolher intervalos de datas, repetir com cada intervalo e depois Contar dias úteis.
  • Obter conjuntos de calendários, Escolher da Lista e depois Abrir calendário com o conjunto escolhido.
  • Obter planos salvos, escolher um plano e depois Abrir plano salvo ou Duplicar plano salvo. Use um UUID de solicitação estável ao repetir uma criação ou duplicação.
  • Exportar imagem do calendário e depois Salvar Arquivo, Compartilhar ou Salvar no Álbum de Fotos. A exportação retorna um arquivo PNG.
  • Mudar conjunto de calendários ativo e Pausar sinais sonoros ao iniciar um período de foco. Retomar sinais sonoros depois. Ative primeiro as permissões correspondentes em cada dispositivo.
Voltar ao índice