Skip to content

Felipe-Alcantara/Time_Divider_Clock_Interface_Python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⏱️ Time Divider

Visualize e organize seu tempo em um relógio analógico interativo

Python Version matplotlib Tkinter License: MIT

GitHub Release GitHub Stars Web Version

Status Maintained


🚀 Transforme a gestão do seu tempo com visualização intuitiva

Time Divider é uma ferramenta de produtividade que ajuda você a planejar e visualizar a distribuição do seu tempo em um formato de relógio analógico. Ideal para estudantes, profissionais e qualquer pessoa que busca otimizar sua rotina diária.

🎯 Começar Agora📖 Documentação🌐 Versão Web💬 Report Bug


✨ Destaques

⚡ Rápido e Intuitivo

Interface gráfica simples e direta. Configure em segundos, visualize instantaneamente.

🎨 Visualização Clara

Relógio analógico colorido mostra exatamente como seu tempo está distribuído.

💾 Multiplataforma

Executável Windows (.exe) + Versão Web + Código Python para todas as plataformas.


🎬 Demo e Screenshots

[🖼️ Screenshot da Interface] [🖼️ Exemplo de Relógio Gerado]

💡 Experimente agora: Acesse a versão web diretamente no navegador, sem instalação!


📦 Downloads

🪟 Windows (Recomendado)

✅ Release v1.2 — Executável Pronto para Uso

Baixe o arquivo .exe e comece a usar imediatamente, sem precisar instalar Python ou dependências!

👉 Download Windows .exe

📋 Instruções de Instalação Windows
  1. Acesse a página de Releases
  2. Encontre a Release v1.2
  3. Na seção Assets, baixe o arquivo .exe
  4. Execute o arquivo baixado
  5. Pronto! 🎉

⚠️ Nota: O Windows Defender pode exibir um aviso de segurança. Clique em "Mais informações" → "Executar assim mesmo"

🌐 Versão Web (Sem Instalação)

Acesse diretamente no navegador: time-divider.web.app

🐍 Código Python (Todas as Plataformas)

Clone o repositório ou baixe o código-fonte para executar em qualquer sistema operacional.



📑 Índice


🚀 Instalação e Uso

Método 1: Windows .exe (Mais Fácil)

Para usuários Windows que querem começar rapidamente:

# 1. Baixe o executável da última release
# 2. Execute o arquivo .exe
# 3. Pronto! 🎉

👉 Download direto do .exe


Método 2: Versão Web (Sem Instalação)

Use diretamente no navegador, sem instalar nada:

🌐 Abrir Time Divider Web

✅ Funciona em qualquer dispositivo com navegador
✅ Sem instalação
✅ Interface moderna e responsiva


Método 3: Código Python (Todas as Plataformas)

Para desenvolvedores ou usuários que preferem executar o código-fonte:

Pré-requisitos

  • Python 3.7 ou superior
  • pip (gerenciador de pacotes Python)

Passo a Passo

# 1. Clone o repositório
git clone https://github.com/Felipe-Alcantara/Time_Divider_Clock_Interface_Python.git

# 2. Entre no diretório
cd Time_Divider_Clock_Interface_Python

# 3. Instale as dependências
pip install -r requirements.txt

# 4. Execute o programa
python "src/Time Divider.py"
🐧 Instruções para Linux

Se você estiver no Linux e o Tkinter não estiver instalado:

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install python3-tk

Fedora:

sudo dnf install python3-tkinter

Arch Linux:

sudo pacman -S tk
🍎 Instruções para macOS

O Tkinter geralmente já vem instalado com o Python no macOS. Se necessário:

# Usando Homebrew
brew install python-tk

💡 Como Usar

Interface Intuitiva em 3 Passos

1️⃣ Defina o Período

Horário de Início: HH:MM
(ou deixe em branco para usar a hora atual)

Duração: Ex: 2:30 ou 2.5
(2 horas e 30 minutos)

2️⃣ Liste as Atividades

Digite suas atividades separadas por vírgula

Exemplo:
Estudar, Exercício, Lazer, Trabalho

3️⃣ Gere o Gráfico

Clique em "Gerar Gráfico"

Visualize seu tempo no relógio analógico

O gráfico é salvo automaticamente como PNG

📝 Formatos Aceitos

Campo Formato Exemplos Válidos
Horário de Início HH:MM ou vazio 14:00, 08:30, (vazio para hora atual)
Duração Total HH:MM ou decimal 3:00, 1:30, 2.5, 0:45
Atividades Texto separado por vírgula Estudar, Descansar, Trabalhar

🎯 Exemplo Prático

Cenário: Planejando uma Tarde Produtiva

📍 Horário de Início: 14:00
⏱️ Duração Total: 4:00
📋 Atividades: Estudar Python, Exercício Físico, Projeto Pessoal, Leitura

Resultado:

  • 14:00 - 15:00: Estudar Python (setor azul)
  • 15:00 - 16:00: Exercício Físico (setor verde)
  • 16:00 - 17:00: Projeto Pessoal (setor laranja)
  • 17:00 - 18:00: Leitura (setor roxo)

O programa gera um relógio colorido mostrando cada atividade como um setor, com os horários claramente marcados e uma legenda explicativa.


🔧 Como Funciona

Arquitetura do Sistema

┌─────────────────────────────────────────────────────┐
│                  Interface Gráfica                   │
│                      (Tkinter)                       │
└────────────────────┬────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────────┐
│              Processamento de Dados                  │
│  • Validação de entradas                            │
│  • Conversão de formatos de tempo                   │
│  • Cálculo de divisões                              │
│  • Conversão horário → ângulos                      │
└────────────────────┬────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────────┐
│              Geração do Gráfico                      │
│                  (Matplotlib)                        │
│  • Desenho do relógio analógico                     │
│  • Setores coloridos para cada atividade            │
│  • Anotações e legendas                             │
│  • Exportação para PNG                              │
└─────────────────────────────────────────────────────┘

Principais Componentes

1. Validação Inteligente

  • ✅ Verifica formato de horários (HH:MM)
  • ✅ Aceita múltiplos formatos de duração (1:30, 1.5)
  • ✅ Detecta atividades duplicadas
  • ✅ Mensagens de erro claras e orientativas

2. Cálculo Preciso

  • Divide o tempo total igualmente entre as atividades
  • Calcula horários de início e término usando datetime
  • Converte horários em ângulos para representação no relógio (360° ÷ 12h = 30°/hora)

3. Visualização Profissional

  • Relógio analógico com marcações de hora
  • Paleta de cores automática e distinta para cada atividade
  • Anotações com horários posicionadas estrategicamente
  • Legenda clara e informativa
  • Exportação em alta resolução

🎨 Recursos

Recurso Descrição
🎯 Interface Amigável GUI moderna e intuitiva com Tkinter
🎨 Cores Automáticas Geração automática de paleta de cores distinta
📊 Gráfico Profissional Visualização clara em formato de relógio analógico
💾 Salvamento Automático Exporta como PNG com timestamp único
Validação Robusta Detecta e informa erros de forma clara
🔄 Múltiplos Formatos Aceita diferentes formatos de entrada de tempo
🌐 Multiplataforma Windows (exe), Web, Python (Win/Mac/Linux)
📱 Versão Web Acesso direto pelo navegador, sem instalação

🛠️ Tecnologias Utilizadas

Tecnologia Uso Versão
Python Linguagem principal 3.7+
Tkinter Interface gráfica Built-in
Matplotlib Geração de gráficos Latest
NumPy Cálculos matemáticos Latest
Brython Versão web (Python no browser) 3.12+
Chart.js Gráficos interativos web 4.4+


📈 Utilidade do Projeto

🎯 Para Quem é Este Projeto?

👨‍🎓 Estudantes

  • Organizar sessões de estudo
  • Balancear matérias diferentes
  • Planejar intervalos e descanso
  • Visualizar a distribuição do tempo de estudo

💼 Profissionais

  • Gerenciar blocos de trabalho focado
  • Equilibrar diferentes projetos
  • Time-boxing de tarefas
  • Otimizar reuniões e deep work

🏋️ Entusiastas de Produtividade

  • Implementar Pomodoro visualmente
  • Time blocking avançado
  • Análise de distribuição de tempo
  • Hábitos e rotinas diárias

👨‍👩‍👧‍👦 Uso Pessoal e Familiar

  • Planejar atividades do dia
  • Organizar rotina familiar
  • Equilibrar trabalho e lazer
  • Ensinar gestão de tempo para crianças

💡 Casos de Uso Reais

📚 Estudante preparando para provas
   → Divide 6h entre 4 matérias (1.5h cada)
   → Visualiza o equilíbrio no relógio
   → Ajusta conforme necessário

💻 Freelancer gerenciando múltiplos clientes
   → Aloca 8h de trabalho entre 3 projetos
   → Define blocos de tempo específicos
   → Mantém foco e organização

🏃 Rotina de autocuidado
   → Planeja manhã: Exercício, Meditação, Café, Leitura
   → Visualiza como usar 2h antes do trabalho
   → Cria hábito consistente

🌟 Benefícios

  • Visualização Imediata: Veja como seu tempo está distribuído de forma intuitiva
  • Planejamento Eficiente: Identifique desequilíbrios e otimize sua agenda
  • Redução de Estresse: Saiba exatamente o que fazer e quando
  • Aumento de Produtividade: Foco em blocos de tempo bem definidos
  • Compartilhável: Exporte e compartilhe seu planejamento com equipes

🤝 Contribuindo

Contribuições são muito bem-vindas! Este é um projeto open source e adoramos receber ajuda da comunidade.

Como Contribuir

  1. Fork o repositório
  2. Clone seu fork localmente
    git clone https://github.com/seu-usuario/Time_Divider_Clock_Interface_Python.git
  3. Crie uma branch para sua feature
    git checkout -b feature/MinhaNovaFeature
  4. Commit suas mudanças
    git commit -m "✨ Adiciona nova feature incrível"
  5. Push para a branch
    git push origin feature/MinhaNovaFeature
  6. Abra um Pull Request

🐛 Reportando Bugs

Encontrou um bug? Abra uma issue com:

  • Descrição clara do problema
  • Passos para reproduzir
  • Comportamento esperado vs. obtido
  • Screenshots (se aplicável)
  • Versão do Python e SO

💬 Discussões e Ideias

Use a aba Discussions para:

  • Compartilhar ideias de features
  • Fazer perguntas sobre o código
  • Mostrar como você está usando o Time Divider
  • Ajudar outros usuários

📝 Licença

Este projeto está licenciado sob a MIT License - veja o arquivo LICENSE para detalhes.

MIT License - Resumo

✅ Uso comercial
✅ Modificação
✅ Distribuição
✅ Uso privado

⚠️ Sem garantias
⚠️ Limitação de responsabilidade

👤 Autor

Felipe Alcântara

GitHub LinkedIn


⭐ Mostre seu apoio

Se este projeto foi útil para você, considere dar uma ⭐ no repositório!

Isso ajuda o projeto a ganhar visibilidade e motiva o desenvolvimento contínuo.

GitHub stars


🔗 Links Rápidos

🌐 Versão Web📦 Releases🐛 Issues💬 Discussions


Desenvolvido com ❤️ e muito ☕ por Felipe Alcântara

About

Time Divider é um programa em Python que ajuda você a dividir o seu tempo disponível entre várias atividades e visualizar essa distribuição em um gráfico em forma de relógio. Ideal para planejamento pessoal e gerenciamento eficiente do tempo.

Resources

License

Stars

1 star

Watchers

1 watching

Forks

Packages

 
 
 

Contributors

Languages