Manual de Utilização — Lúmen

Selecione o idioma / Select language:
🇧🇷 Português (BR) | 🇺🇸 English (US)

🇧🇷 Português (BR)

Clique para expandir o manual em Português

Manual de Utilização — Lúmen (PT‑BR)

Este manual descreve como operar o aplicativo Lúmen (modo de uso), cobrindo funcionalidades, atalhos, fluxo de trabalho sugerido, resolução de problemas e informações sobre persistência de dados. Não é um guia de desenvolvimento.

Índice

Visão Geral
Requisitos básicos (usuário)
Como iniciar o aplicativo
Abertura e controles globais
Atalhos globais úteis (padrões)
[Módulos (índice por aba)]
Menus e ações rápidas
Sugestões de uso combinadas
Solução de problemas (Troubleshooting)
Logs e diagnóstico
Armazenamento / Arquivos persistentes (resumo)
Exportar manual para PDF (opcional)
Boas práticas de uso
Resumo rápido de atalhos
FAQ
Como obter ajuda / suporte

Visão Geral

Lúmen é uma suíte de ferramentas para estudo composta por módulos principais: Leitor Acessível, Gestão de Tempo (Pomodoro + Gerenciador de Tarefas), Mapas Mentais, Método Feynman e Matriz de Eisenhower. A interface é organizada em abas; cada aba contém controles e ferramentas específicas ao módulo.

Requisitos básicos (usuário)

Windows (testado). Linux/macOS podem funcionar se dependências instaladas.
Python 3.8+ para execução local.
Conexão à Internet para Edge TTS (opcional).

Como iniciar o aplicativo

No PowerShell (Windows):

python main.py

Abertura e controles globais

Ao abrir o Lúmen verá a janela principal com abas e uma barra de menus (Arquivo, Configurações, Idiomas, Vozes, Sobre). A barra de status exibe informações contextuais.

Atalhos globais úteis (padrões)

Ctrl+1 … Ctrl+5 — alternar abas (Leitor → Tempo → Mapa → Feynman → Eisenhower)
Ctrl+Q — sair
F1 — ajuda

Módulos (detalhados por aba)

Leitor Acessível — Aba 1

Resumo rápido — Leitor Acessível (clique para expandir/recolher)

Conteúdo: carregamento de PDFs, extração de texto, TTS (Edge ou local), controle de velocidade/volume, régua de foco e formatações de texto.

Descrição completa — Leitor Acessível

Principais ações

Carregar PDF: diálogo para selecionar PDF; texto extraído é exibido na área de leitura.
Play / ▶️ Ler: inicia a leitura por TTS.
Pausar / ⏸️ e Continuar: alterna o estado da leitura.
Stop / ⏹️: finaliza a leitura e limpa a fila de áudio.

Controles e opções

Velocidade (slider): ajusta a velocidade do TTS.
Volume (slider): ajusta volume do player interno.
Fonte (combo): altera tamanho e tipo de fonte do texto exibido.
Botões de edição: Novo, Salvar Como, marcadores, recuos e alinhamentos.

PDF — barra de ferramentas

Navegação por página: Primeira / Anterior / Próxima / Última + entrada numérica.
Zoom: 50%, 100%, Ajustar à largura, Ajustar à página.
Modos: página única ou rolagem contínua.
Hand Mode: arraste o PDF com o mouse.

Régua de Foco

Ativar/Desativar via botão.
Mover/Redimensionar: arraste; ajuste fino com setas; ESC fecha.
Sincroniza com menu principal.

Vozes e TTS

Mecanismos: Edge TTS (neural, internet) e motores locais (pyttsx3).
Seleção de voz no menu Vozes; pode ser persistida.
Recomendações: Edge TTS para voz natural; fallback local em caso de falha.

Observações de acessibilidade

Use tamanhos de fonte maiores e contraste alto para melhor legibilidade.
Ative régua de foco para leitura linha-a-linha.

Gestão de Tempo — Aba 2

Resumo rápido — Gestão de Tempo (Pomodoro + Kanban)

Conteúdo: temporizador Pomodoro configurável, gerenciador de tarefas estilo Kanban, registro de pomodoros e integração entre timer e tarefas.

Descrição completa — Gestão de Tempo

Pomodoro

Controles: Iniciar / Pausar / Resetar / Pular ciclo.
Ciclos: foco, descanso curto, descanso longo.
Ao fim do ciclo: alerta sonoro e opção de marcar pomodoro na tarefa atual.

Gerenciador de Tarefas (Kanban)

Adicionar tarefa: título, prioridade, descrição e estimativa de pomodoros.
Colunas típicas: Todo, Doing, Done.
Operações: mover, editar, remover, menu de contexto.
Persistência: tarefas armazenadas em JSON no diretório de dados do app.

Fluxo sugerido

Criar tarefas em Todo.
Mover tarefa para Doing quando iniciar foco.
Iniciar Pomodoro vinculado à tarefa.

Mapas Mentais — Aba 3

Resumo rápido — Mapas Mentais

Editor visual de nós e ligações, edição por duplo clique, exportação para imagem e salvamento de projeto.

Descrição completa — Mapas Mentais

Criar e editar mapas

Adicionar nó: cria um conceito.
Conectar nós: modo conexão, clique origem → destino.
Editar nó: duplo clique para texto/nota/cor.
Arrastar: reposicionamento livre.

Salvar / Exportar

Salvar projeto: mantém estrutura e posições.
Exportar PNG: gera imagem do mapa.
Recomendações: salvamentos frequentes e exportação antes de grandes alterações.

Método Feynman — Aba 4

Resumo rápido — Método Feynman

Ferramenta para explicar conceitos com etapas: explicação simples, lacunas, revisão e avaliação de domínio.

Descrição completa — Método Feynman

Fluxo básico

Novo Conceito: cria entrada com campos Título, Explicação Simples, Pontos de Dúvida, Resumo Revisado e Nível de Domínio.
Salvar Conceito: persiste em arquivo; lista de conceitos à esquerda.
Deletar: remove conceito selecionado.

Como usar

Escolha um conceito.
Explique em linguagem simples.
Identifique lacunas e revise.
Atualize o resumo e registre o nível de domínio.

Integração

Vincule nós do mapa mental a conceitos do Feynman para revisão iterativa.

Matriz de Eisenhower — Aba 5

Resumo rápido — Matriz de Eisenhower

Quadro de priorização com quatro quadrantes; suporte a data/hora, calendário e exportação simples.

Descrição completa — Matriz de Eisenhower

Adicionar e organizar tarefas

Campo: título + opcional data/hora.
Seletor de quadrante: Importante/Urgente, Importante/Não Urgente, Não Importante/Urgente, Não Importante/Não Urgente.
Marcar concluído, editar e mover entre quadrantes.

Recursos extras

Visualização por horário: painel calendário mostra distribuição por data/hora.
Importar/Exportar: CSV/Excel (quando disponível no menu).

Fluxo sugerido

Alocar backlog semanal nos quadrantes; priorizar pomodoros nas tarefas importantes.

Menus e ações rápidas

Arquivo: comandos para carregar/salvar projetos, exportar mapas, importar tarefas.
Configurações: Idioma, Vozes, Fonte padrão.
Idiomas: mudar idioma da interface e das strings de módulos.
Ajuda: versão e documentação rápida.

Sugestões de uso combinadas

Leitura + Pomodoro: abra material no Leitor, ative régua de foco, vincule tarefa ao Pomodoro e inicie sessão.
Mapas + Feynman: crie nós e registre explicações no Feynman para revisão.
Eisenhower para priorizar semanalmente e planejar pomodoros.

Solução de problemas (Troubleshooting)

Sem som:
- Verificar volume do sistema e do app.
- Edge TTS: confirmar Internet.
- pyttsx3: confirmar motor instalado.
PDF sem texto:
- PDF pode ser imagem (use OCR).
- Verificar bibliotecas: pdfplumber, pypdf.
Vozes não listadas:
- Recarregar vozes ou reiniciar app.
Erro ao salvar/ler:
- Verificar permissões de pasta; localizar arquivos no diretório de dados.

Logs e diagnóstico

LogManager gera logs; verificar pasta de dados ou saída do terminal (python main.py).

Armazenamento / Arquivos persistentes (resumo)

Tarefas: JSON (ex.: tarefas.json).
Mapas: projeto (.map, .json).
Conceitos Feynman: conceitos.json.
Configurações: config.json.
Local sugerido: %APPDATA%\Lumen ou %LOCALAPPDATA%\TEA_TDAH_Dislexia.

Exportar manual para PDF (opcional)

Com pandoc:

pandoc MANUAL.md -o MANUAL.pdf --pdf-engine=xelatex

Ou use VS Code: "Markdown: Export (PDF)".

Boas práticas de uso

Salve mapas e conceitos regularmente.
Faça backups periódicos.
Mantenha app e dependências atualizados.

Resumo rápido de atalhos

Ctrl+1 … Ctrl+5 — trocar abas
Ctrl+O — abrir arquivo (PDF)
Ctrl+R — iniciar leitura
Ctrl+P — pausar leitura
Ctrl+T — adicionar tarefa
Ctrl+N — novo nó/conceito
Ctrl+Q — sair
F1 — ajuda

Perguntas Frequentes (FAQ)

Como deixar voz mais natural? Use Edge TTS (vozes neurais) e ajuste velocidade/volume.
Onde meus dados são salvos? No diretório de dados do app (%APPDATA% / ~/.local/share).

Como obter ajuda / suporte

Menu Ajuda para versão/documentação.
Para problemas técnicos, anexe logs do LogManager ao abrir um issue.

🇺🇸 English (US)

Click to expand the manual in English

User Manual — Lúmen (EN‑US)

This manual describes how to operate the Lúmen application (user mode), covering features, shortcuts, suggested workflows, troubleshooting and data persistence. Not a developer guide.

Index

Overview
Basic requirements (user)
How to start the application
Main window and global controls
Useful global shortcuts (default)
[Modules (tab index)]
Menus and quick actions
Combined workflows
Troubleshooting
Logs and diagnostics
Storage / Persistent files (summary)
Export manual to PDF (optional)
Best practices
Shortcuts quick reference
FAQ
How to get help / support

Overview

Lúmen is a study suite composed of main modules: Accessible Reader, Time Management (Pomodoro + Task Manager), Mind Maps, Feynman Technique and Eisenhower Matrix. The UI is tabbed; each tab exposes controls and tools for that module.

Basic requirements (user)

Windows (tested). Linux/macOS may work if dependencies are installed.
Python 3.8+ for local run.
Internet connection for Edge TTS (optional).

How to start the application

In PowerShell (Windows):

python main.py

Main window and global controls

On launch you will see the main window with tabs and a menu bar (File, Settings, Languages, Voices, About). The status bar displays contextual info.

Useful global shortcuts (default)

Ctrl+1 … Ctrl+5 — switch tabs (Reader → Time → Map → Feynman → Eisenhower)
Ctrl+Q — quit
F1 — help

Modules (detailed by tab)

Accessible Reader — Tab 1

Quick summary — Accessible Reader

Features: PDF loading, text extraction, TTS (Edge or local), speed/volume controls, focus ruler and text formatting tools.

Full description — Accessible Reader

Main actions

Load PDF: opens dialog to select PDF; extracted text displays in reader area.
Play / ▶️ Read: starts TTS playback.
Pause / ⏸️ and Resume: toggles playback state.
Stop / ⏹️: ends reading and clears audio queue.

Controls and options

Speed (slider): adjust TTS rate.
Volume (slider): adjust player volume.
Font (combo): change font family/size.
Edit buttons: New, Save As, bullets, indent/align.

PDF toolbar

Page navigation: First / Prev / Next / Last + numeric input.
Zoom: 50%, 100%, Fit Width, Fit Page.
Modes: single page or continuous scroll.
Hand Mode: drag the PDF canvas.

Focus Ruler

Toggle via button.
Move/Resize: drag; fine tune with arrow keys; ESC closes.
Syncs with main menu option.

Voices and TTS

Engines: Edge TTS (neural, requires internet) and local engines (pyttsx3).
Select voice in Voices menu; selection can be persisted.
Recommendation: Edge TTS for more natural voices; fallback to local if unavailable.

Accessibility notes

Use larger fonts and high contrast for readability.
Use focus ruler for line‑by‑line reading.

Time Management — Tab 2

Quick summary — Time Management (Pomodoro + Kanban)

Features: configurable Pomodoro timer, Kanban-style task manager, pomodoro logging and timer-task integration.

Full description — Time Management

Pomodoro

Controls: Start / Pause / Reset / Skip cycle.
Cycles: work, short break, long break.
End of cycle: sound alert and option to log pomodoro to the current task.

Task Manager (Kanban)

Add task: title, priority, description, estimated pomodoros.
Typical columns: Todo, Doing, Done.
Actions: move, edit, remove, context menu.
Persistence: tasks stored in JSON inside app data directory.

Suggested flow

Create tasks in Todo.
Move task to Doing when starting focus.
Start Pomodoro linked to the task.

Mind Maps — Tab 3

Quick summary — Mind Maps

Visual editor of nodes and connections, edit by double-click, export image and save project.

Full description — Mind Maps

Create and edit maps

Add node: creates a concept.
Connect nodes: connection mode, click source → destination.
Edit node: double-click to edit text/notes/color.
Drag: free positioning.

Save / Export

Save project: preserves structure and positions.
Export PNG: create an image of the map.
Recommendations: save frequently and export before big changes.

Feynman Technique — Tab 4

Quick summary — Feynman Technique

Tool to explain concepts in steps: simple explanation, gaps, review and mastery assessment.

Full description — Feynman Technique

Basic flow

New Concept: creates an entry with Title, Simple Explanation, Points of Doubt, Reviewed Summary and Mastery Level.
Save Concept: persisted to file; concept list on the left.
Delete: removes selected concept.

How to use

Choose a concept.
Explain in simple language.
Identify gaps and revise.
Update the summary and record mastery level.

Integration

Link mind‑map nodes to Feynman concepts for iterative review.

Eisenhower Matrix — Tab 5

Quick summary — Eisenhower Matrix

Priority board with four quadrants; support for date/time, calendar view and simple export.

Full description — Eisenhower Matrix

Add and organize tasks

Field: title + optional date/time.
Quadrant selector: Important/Urgent, Important/Not Urgent, Not Important/Urgent, Not Important/Not Urgent.
Mark complete, edit and move between quadrants.

Extra features

Time view: calendar panel shows distribution by date/time.
Import/Export: CSV/Excel where available in menu.