Block Time Scheduler

Agenda visual para Obsidian com integração completa ao Tasks API, suporte completo a recorrências e cache otimizado.

Recursos

• Busca inteligente — Encontra tasks em pastas configuráveis
• Adiciona no calendário Automaticamente — Adiciona tasks no calendário automaticamente com data e hora
• Agenda visual — Grid de horas diário e semanal
• Tasks API v1 — Criação, edição e toggle via plugin Tasks
• Recorrência completa — Suporte total à sintaxe do plugin Tasks
• Notificações — Lembretes de horário e prazo desktop
• Cache otimizado — fileContentCache com métricas hits/misses

Como usar

Tasks com Data/Hora

• Crie: - [ ] Reunião 🔁 every week 14h 📅 2025-10-24
• Aparece no calendário na data e horário especificados

Tasks Diárias

• Crie: - [ ] Check email 🔁 every day
• Aparece todos os dias sem precisar de data

Screenshots

Instalação

Manual

1. Baixe a release mais recente
2. Descompacte em <vault>/.obsidian/plugins/block-time-scheduler/
3. Reinicie o Obsidian
4. Ative em Configurações → Community plugins

BRAT (Beta)

brat install levisilvino obsidian-block-time

Integração Tasks API

Criação de tasks

• Clique em slot vazio → Abre modal Tasks → Salva no arquivo configurado

Pasta para criação de tasks

Configure onde as novas tasks serão criadas:

• Padrão: Task (cria em Task.md)
• Exemplos: Tasks/MinhasTasks → cria em Tasks/MinhasTasks.md
• Fallback: Se vazio, usa Daily Notes
• Auto-criação: Arquivo é criado automaticamente se não existir

Toggle completion

• Checkbox → Usa Tasks API (recorrência automática) ou fallback manual
• Compatibilidade total → Funciona com ou sem plugin Tasks instalado

Gerenciamento de recorrência

• Com Tasks API → Plugin Tasks gerencia criação da próxima ocorrência
• Formatos compatíveis → 100% alinhado com sintaxe do Tasks plugin

Importante: Requer plugin Tasks (obsidian-tasks-plugin) para criação/edição avançada. Toggle funciona sem ele.

Configuração

Acesse Configurações → Community plugins → Block Time Scheduler:

Agenda

• Horas exibidas — Início (0-12) e término (18-24)
• Visualização padrão — Diária ou semanal
• Pastas a escanear — Separado por vírgula (vazio = vault inteiro)
• Pasta para criação de tasks — Onde novas tasks são criadas (padrão: Task)

Aparência

• Tema Obsidian — Herda cores do tema ativo

Notificações

• Horário — Notificação no momento + X minutos antes
• Prazos — X dias antes + no dia (tags configuráveis)
• Templates — Textos personalizáveis com placeholders

Placeholders

• {task} — Nome da tarefa
• {min} — Minutos antes
• {days} — Dias restantes
• {time} — Horário
• {endTime} — Horário de término
• {file} — Arquivo
• {date} — Data

️ Desenvolvimento

# Clone
git clone https://github.com/levisilvino/obsidian-block-time.git
cd obsidian-block-time

# Instalar
npm install

# Desenvolvimento
npm run dev

# Build
npm run build

Performance

• Cache — fileContentCache com invalidação reativa
• Métricas — Console logs de hits/misses para tuning
• Scan folders — Configurável para vaults grandes
• Debounce — 800ms para evitar renders excessivos

🤝 Contribuição

Pull requests são bem-vindos!

1. Fork o projeto
2. Crie branch feature (git checkout -b feature/nova-funcionalidade)
3. Commit (git commit -m 'Add nova funcionalidade')
4. Push (git push origin feature/nova-funcionalidade)
5. Abra Pull Request

📄 Licença

MIT License — veja arquivo LICENSE

🙏 Agradecimentos

• Plugin Tasks — API v1
• Comunidade Obsidian — feedback e sugestões

🔗 Links

• GitHub
• Issues
• Releases