Controle financeiro pessoal e de pequenos negócios — com o poder de uma Tabela Dinâmica do Excel, sem escrever uma única fórmula.
Você registra suas entradas e saídas de dinheiro e o programa cruza esses dados de todas as formas possíveis — por categoria, por mês, por ano, por tipo de transação — automaticamente.
Foi feito pensando em quem não tem intimidade com planilhas: tudo se faz escolhendo opções em menus, sem fórmulas, sem configuração complicada.
- Quanto gastei em Alimentação no mês passado?
- Qual foi minha maior despesa do ano?
- Em média, quanto sobra por mês?
- Se eu aumentar o faturamento em 10%, como fica meu saldo?
| 📊 Tabela Dinâmica | Cruze qualquer dimensão (categoria × mês, transação × ano…), com totais, percentuais e exportação |
| 📈 Dashboard | Visão rápida do mês: entradas, saídas, saldo e os maiores gastos |
| 🧮 Médias | Quanto você gasta/recebe por mês em média — com simulador de metas |
| 📥 Importação | Traga lançamentos de planilhas Excel ou CSV de uma vez |
| 🛟 À prova de erros | Confirmações, desfazer (Ctrl+Z), aviso de data suspeita e backup automático |
| 🔒 Privado | Seus dados ficam só no seu computador (arquivo SQLite). Nada é enviado para a internet |
Baixe o programa na página de Releases e execute. Não precisa instalar Python nem nada.
pip install -r requirements.txt
python tabela_dinamica.pyO manual completo do usuário está logo abaixo neste README — e também em PDF: Manual_Tabela_Dinamica.pdf.
Distribuído sob a licença MIT — use, modifique e distribua à vontade.
- O que é este programa e para quem ele serve
- Visão geral da tela principal
- Aba "Dados" — lançando suas receitas e despesas
- Aba "Importar" — trazendo dados de uma planilha
- Aba "Categorias" — cadastrando Categoria, Sub-Categoria e Transação
- Aba "Tabela Dinâmica" — o coração do programa
- Aba "Dashboard" — o resumo visual das suas finanças
- Aba "Médias" — quanto por mês, em média
- Aba "Configurações" — senha, banco de dados e backup
- Exportando para Excel e CSV
- Onde ficam seus dados e como fazer backup
- Perguntas frequentes e dicas
- Glossário rápido
O Fluxo de Caixa é um programa de controle financeiro pessoal (ou de pequenos negócios) que funciona como um "Excel especializado": você lança suas entradas e saídas de dinheiro, e o programa cruza esses dados de todas as formas possíveis — por categoria, por mês, por ano, por tipo de transação — automaticamente, sem você precisar escrever nenhuma fórmula.
Se você já usou uma Tabela Dinâmica (Pivot Table) no Excel, vai se sentir em casa. Se nunca usou, não se preocupe: este manual explica tudo do zero, com exemplos práticos.
- Quanto gastei em Alimentação no mês passado?
- Qual foi minha categoria de despesa mais cara em 2026?
- Minhas entradas estão maiores que minhas saídas este mês?
- Quais foram meus 5 maiores gastos do ano?
- Como minhas despesas de "Cartão de Crédito" evoluíram mês a mês?
Tudo isso sem precisar montar fórmulas — só escolher o que você quer ver em alguns menus.
Cada lançamento (cada linha que você registra) tem estes campos:
| Campo | O que significa | Exemplo |
|---|---|---|
| Data | Data (e opcionalmente hora) do lançamento | 15/06/2026 10:30:00 |
| Categoria | O grupo principal do gasto/receita | Alimentação, Moradia, Renda |
| Sub-Categoria | Um detalhamento da categoria | Supermercado, Aluguel, Salário |
| Transação | Como o dinheiro entrou/saiu | Cartão de Crédito, Débito, Transferência |
| Descrição | Um texto livre para você lembrar do que se tratou | Compras do mês, Conta de luz - junho |
| Valor | O valor em reais. Negativo = saída, Positivo = entrada | -350,90 ou 3500,00 |
Regra de ouro: despesas (dinheiro saindo) sempre entram com valor negativo; receitas (dinheiro entrando) sempre com valor positivo. É essa regra que faz todo o resto do programa (cores, somas, Dashboard) funcionar corretamente.
O programa é organizado em 7 abas, no topo da janela:
| Aba | Para que serve |
|---|---|
| Dados | Cadastrar, editar, excluir e pesquisar seus lançamentos, um por um |
| Importar | Trazer uma grande quantidade de lançamentos de uma vez, a partir de uma planilha Excel/CSV |
| Categorias | Cadastrar as Categorias, Sub-Categorias e Transações que aparecem como sugestão na aba Dados |
| Tabela Dinâmica | Cruzar e analisar os dados em qualquer combinação (a parte mais poderosa) |
| Dashboard | Um painel visual de resumo, com cartões e mini-tabelas, para uma visão rápida |
| Médias | Valor médio por mês (ou ano) de Categoria, Sub-Categoria, Transação e do Saldo |
| Configurações | Senha de acesso ao programa, troca do banco de dados e backup |
Você pode alternar entre elas a qualquer momento — os dados são os mesmos, vistos de formas diferentes.
Esta é a aba onde a "matéria-prima" do programa é alimentada: cada lançamento financeiro individual.
A aba é dividida em três partes, de cima para baixo:
É aqui que você cadastra um novo lançamento ou edita um já existente.
Campos do formulário:
- Data — digite no formato
dd/mm/aaaa(ex:15/06/2026) ou, se quiser registrar também o horário,dd/mm/aaaa hh:mm:ss(ex:15/06/2026 10:30:00). É o único campo obrigatório. Ao lado do campo há a caixa "Hoje": quando marcada (padrão), o programa preenche a data de hoje automaticamente e trava o campo, evitando erros de digitação — ideal para lançar o dia a dia. Para registrar algo de outra data, basta desmarcar a caixa e digitar a data desejada. Se você digitar uma data muito distante de hoje (por exemplo, com o ano trocado), o programa avisa e pede confirmação antes de salvar (veja a seção 9.4). - Categoria / Sub-Categoria / Transação — são campos com sugestão automática (autocompletar): ao digitar, o programa mostra os valores que você já usou antes, para você manter um padrão (evitando, por exemplo, cadastrar "Alimentacao" numa linha e "Alimentação" em outra).
- Descrição — texto livre, opcional, para você lembrar do que se tratou aquele lançamento.
- Valor — o valor em reais. Lembre-se: negativo para saídas, positivo para entradas. Aceita tanto
350,90quanto350.90.
Os botões do formulário:
| Botão | O que faz |
|---|---|
| Salvar | Grava o lançamento novo no banco de dados (ou atualiza, se você estiver editando um existente — nesse caso o botão muda o texto para "Atualizar"). Ao atualizar um registro, o programa pede confirmação antes de aplicar a mudança, para evitar alterações acidentais |
| Limpar | Limpa o formulário. Ao limpar, o programa já pré-preenche Data, Categoria, Sub-Categoria e Transação com os mesmos valores do último lançamento salvo, deixando só Descrição e Valor em branco — isso agiliza muito quando você está lançando vários gastos parecidos em sequência (ex: vários itens de supermercado no mesmo dia) |
| Excluir Selecionado | Exclui o(s) registro(s) atualmente selecionados na tabela abaixo (pede confirmação) |
| Duplicar Selecionado | Copia todos os campos (inclusive Descrição e Valor) do registro selecionado na tabela para o formulário, como se fosse um novo lançamento. Útil quando você tem um gasto idêntico a um já cadastrado (ex: o mesmo aluguel todo mês) — você só ajusta a data e salva |
| Aplicar a Selecionados | Aparece quando você seleciona mais de um registro na tabela. Permite alterar um ou mais campos (ex: trocar a Categoria de vários lançamentos de uma vez) em lote |
| ↶ Desfazer | Desfaz a última operação feita na aba Dados — seja uma inclusão, uma edição, uma exclusão ou uma edição em lote. Fica disponível logo após a operação (o atalho de teclado Ctrl+Z faz o mesmo). É a sua rede de segurança: excluiu ou editou algo sem querer? Um clique e volta ao que era |
💡 Desfazer (Ctrl+Z): o programa guarda a última operação. Se você fizer uma exclusão e depois uma edição, o "Desfazer" reverte a edição (a mais recente). Para exclusões que esvaziaram vários registros, o Desfazer traz todos de volta com os mesmos dados.
Como editar um lançamento já existente? Basta clicar nele na tabela abaixo — o formulário é preenchido automaticamente com os dados daquele registro e o botão muda para "Atualizar". Faça as alterações e clique em "Atualizar".
Logo abaixo do formulário, uma barra permite filtrar a lista de lançamentos exibida na tabela:
- Data — filtra por texto contido na data (ex: digitar
06/2026mostra tudo de junho de 2026) - Categoria / Sub-Categoria / Transação / Descrição — filtros de texto livre (não precisa ser exato, basta conter o texto digitado)
- Ano e Mês — combos para filtrar por período
- ✕ Limpar — remove todos os filtros de uma vez
Os filtros funcionam em conjunto (E lógico): se você preencher Categoria = "Alimentação" e Ano = "2026", só aparecem lançamentos que atendem às duas condições.
Mostra todos os lançamentos que passam pelo filtro atual. Você pode:
- Clicar em uma coluna do cabeçalho para ordenar por ela (clique novamente para inverter a ordem)
- Arrastar a borda de uma coluna para redimensioná-la — o programa lembra essa largura na próxima vez que você abrir
- Clicar em uma linha para selecioná-la (carrega no formulário para edição)
- Selecionar várias linhas (Ctrl+clique ou Shift+clique) para excluir ou editar em lote
No cabeçalho da coluna Valor, o programa sempre mostra a soma de todos os lançamentos que passaram pelo filtro — ou seja, se você aplicar um filtro, a soma se atualiza para refletir só o que está filtrado. Isso é uma forma rápida de, por exemplo, saber "quanto gastei em Alimentação em junho" sem nem precisar ir à Tabela Dinâmica.
Abaixo da tabela, uma linha de status mostra quantos registros estão sendo exibidos do total.
⚡ Por que a tabela mostra só os lançamentos mais recentes? Para a tela continuar rápida mesmo quando a sua base cresce muito, a aba Dados exibe por padrão os 500 lançamentos mais recentes. Isso é apenas um limite de exibição — nada é perdido nem escondido do programa:
- Os filtros continuam procurando na base inteira. Se você filtrar por "Aluguel", ele varre todos os lançamentos e mostra os resultados (os mais recentes, se forem muitos).
- A soma do cabeçalho considera todos os encontrados, não só os que aparecem na tela.
- Todas as outras abas (Tabela Dinâmica, Dashboard, Médias) usam sempre a base completa.
- Para ver ou trabalhar com a base inteira de uma vez, use Exportar XLSX/CSV (e, se quiser, edite fora e traga de volta pela aba Importar).
Quando a exibição está limitada, a linha de status avisa (ex.: "Exibindo os 500 lançamentos mais recentes de 24.915 encontrados"). Você pode mudar esse limite — ou desligá-lo — na aba Configurações (seção 9.5).
Se você já tem seus lançamentos em uma planilha Excel ou CSV (por exemplo, extrato de cartão de crédito exportado pelo banco), não precisa digitar tudo de novo: importe o arquivo de uma vez.
- Clique em "..." ao lado de "Arquivo" e selecione seu arquivo
.csv,.xlsou.xlsx. - Se for um
.csv, confira o Separador CSV (geralmente;no Brasil, mas pode ser,dependendo de como o arquivo foi gerado). - Uma pré-visualização das 20 primeiras linhas aparece automaticamente, para você confirmar que o arquivo foi lido corretamente.
- Escolha o modo de importação:
- Acrescentar ao banco existente (padrão, seguro) — os novos lançamentos são adicionados aos que já existem.
- Sobrescrever banco (apaga tudo antes) —
⚠️ apaga todos os lançamentos atuais antes de importar os novos. Use com cuidado; o programa pede uma confirmação extra antes de executar essa opção.
- Clique em Importar.
O programa procura, no cabeçalho da sua planilha, colunas com nomes parecidos com: Data, Categoria, Sub_Categoria/Sub-Categoria, Transação, Descrição e Valor (não precisa ser exatamente igual — maiúsculas/minúsculas e pequenas variações de nome são reconhecidas). Se uma coluna não for encontrada, ela é importada vazia (ou zero, no caso do Valor).
Dica: antes de importar uma planilha grande pela primeira vez, teste com uma cópia pequena (5 a 10 linhas) para garantir que as colunas estão sendo reconhecidas corretamente, e só depois importe o arquivo completo.
Esta aba é onde você administra as listas fechadas de Categoria, Sub-Categoria e Transação usadas como sugestão de autocompletar na aba Dados, mantendo seus lançamentos sempre com nomes padronizados.
A tela é dividida em três colunas:
| Coluna | O que mostra |
|---|---|
| Categorias | Lista de todas as categorias cadastradas |
| Sub-Categorias | As sub-categorias da categoria selecionada na coluna ao lado (clique numa categoria para ver as suas) |
| Transações | Lista de todos os tipos de transação cadastrados (não dependem de categoria) |
Cada coluna tem três botões: Adicionar, Renomear e Excluir.
Importante: renomear uma Categoria, Sub-Categoria ou Transação aqui atualiza automaticamente todos os lançamentos já cadastrados que usavam o nome antigo — você não precisa corrigir um por um na aba Dados.
Atenção ao excluir: excluir um item desta aba não apaga os lançamentos que já o usam, mas ele deixa de aparecer como sugestão para novos lançamentos.
Esta é a funcionalidade mais poderosa do programa: ela permite cruzar seus dados em qualquer combinação, exatamente como uma Tabela Dinâmica do Excel — mas sem precisar saber Excel.
Imagine que você quer responder: "quanto gastei em cada Categoria, mês a mês?"
Em vez de você mesmo somar manualmente, você só diz ao programa:
- Linha 1 (grupo):
Categoria→ uma linha na tabela para cada categoria - Colunas:
Mês→ uma coluna para cada mês - Agregar:
sum→ soma os valores
E o programa monta automaticamente uma tabela cruzada como esta:
| 1 | 2 | 3 | 4 | 5 | 6 | Total Geral | |
|---|---|---|---|---|---|---|---|
| Alimentação | -R$ 2.086,31 | -R$ 1.645,02 | -R$ 2.964,92 | ... | ... | ... | -R$ 15.372,32 |
| Moradia | -R$ 2.559,25 | -R$ 4.045,61 | ... | ... | ... | ... | -R$ 23.058,29 |
| Renda | R$ 23.817,17 | R$ 10.705,04 | ... | ... | ... | ... | R$ 101.977,61 |
| Total Geral | R$ 11.909,44 | -R$ 393,01 | ... | ... | ... | ... | R$ 20.526,85 |
Esse é exatamente o resultado mostrado na imagem acima.
| Campo | O que faz |
|---|---|
| Linha 1 (grupo) | A dimensão principal que vira uma linha na tabela (ex: Categoria) |
| Excluir itens ▼ (ao lado da Linha 1) | Abre um menu com checkboxes para esconder itens específicos daquela dimensão da análise (ex: esconder a categoria "Renda" para ver só as despesas) — veja a seção 5.4 |
| Linha 2 (subgrupo) | Uma segunda dimensão, opcional, que aparece "dentro" de cada grupo da Linha 1, como uma sub-linha expansível. Escolha (nenhuma) para não usar |
| Excluir itens ▼ (ao lado da Linha 2) | O mesmo recurso de exclusão, mas para a dimensão da Linha 2 |
| Colunas | A dimensão que vira colunas da tabela (ex: Mês). Escolha (nenhuma) para ter uma única coluna de valor |
| Agregar | Como os valores são calculados dentro de cada célula: sum (soma), count (contagem de lançamentos), mean (média), min (mínimo) ou max (máximo) |
| Total Geral | Mostra/esconde a linha (e coluna) de Total Geral, em verde |
| Mostrar como % | Em vez do valor em reais, mostra a porcentagem que aquela célula representa do Total Geral |
Importante sobre "Agregar": quando você muda de
sumparamean,min,maxoucount, a coluna/linha Total Geral também respeita essa escolha — ou seja, se você escolhermean, o Total Geral mostra a média geral, e não a soma das médias. Isso garante que os números sempre fazem sentido matemático, independente da agregação escolhida.
Você pode usar qualquer um destes campos em Linha 1, Linha 2 ou Colunas:
Ano, Mês, Categoria, Sub-Categoria, Transação, Descrição
Às vezes você quer analisar só as despesas, sem a Renda aparecendo misturada — ou quer comparar só algumas categorias específicas. Para isso, clique em "Excluir itens ▼" ao lado da Linha 1 (ou Linha 2):
Um menu se abre com uma lista de checkboxes, um para cada valor existente naquela dimensão. Marque os que você quer esconder da análise. No final da lista há dois botões úteis:
- Marcar todos — esconde tudo de uma vez (útil quando você quer começar do zero e escolher só 1 ou 2 itens para deixar visível, desmarcando-os manualmente depois)
- Desmarcar todos — volta a mostrar tudo
Essa configuração de exclusão é salva automaticamente e restaurada na próxima vez que você abrir o programa.
Abaixo da Estrutura, mais um conjunto de filtros, que restringe quais lançamentos entram na análise (diferente da exclusão de itens, que só esconde linhas/colunas do resultado já calculado):
| Filtro | O que faz |
|---|---|
| Ano / Mês | Restringe a um ano e/ou mês específico |
| Categoria / Transação / Sub-Categoria | Restringe a um valor específico dessas dimensões |
| Valores: Todos / Somente positivos / Somente negativos | Filtra só receitas, só despesas, ou tudo |
| Filtrar por período: De / Até | Quando marcado, restringe a um intervalo exato de datas (em vez de mês/ano inteiros). As datas começam sempre na data de hoje quando você liga o filtro — ajuste-as livremente depois |
Você pode clicar em qualquer cabeçalho de coluna da tabela de resultado para ordenar os grupos por aquela coluna (do maior para o menor valor). Clique de novo na mesma coluna para inverter a ordem (do menor para o maior). Uma pequena seta no cabeçalho indica a coluna e direção da ordenação atual.
Isso é ótimo, por exemplo, para responder rapidamente: "qual foi minha categoria de despesa mais cara?" — basta clicar na coluna "Total Geral".
Quando você usa uma "Linha 2 (subgrupo)", cada grupo da Linha 1 fica expansível (clique na seta ▶ ao lado dele, ou use os botões "▼ Expandir Tudo" / "▶ Recolher Tudo" no topo da tabela).
Quando os valores são grandes, uma coluna pode ficar estreita demais e o número aparecer cortado (ex.: 3.300…). Para deixar tudo na largura ideal, clique no botão "↔ Ajustar Colunas" (ao lado de "Recolher Tudo", no topo da tabela): ele ajusta todas as colunas de uma vez ao tamanho do conteúdo, deixando os números por inteiro — como se você desse um duplo-clique na borda de cada coluna.
Você também pode ajustar uma coluna específica: aponte o mouse na linha que separa dois títulos de coluna e dê um duplo-clique (ajusta ao conteúdo) ou arraste para a largura que preferir.
As larguras que você definir (pelo botão ou arrastando) ficam salvas e são restauradas automaticamente quando você muda um filtro, ordena, troca de dimensão ou reabre o programa — ou seja, você não precisa reajustar as colunas toda hora. Cada combinação de colunas guarda a sua própria configuração de larguras.
Toda a configuração desta aba — quais dimensões você escolheu, quais filtros, quais itens excluiu, a ordenação, as larguras das colunas e até quais grupos estavam expandidos — é lembrada automaticamente entre uma sessão e outra do programa, exceto as datas de período (que sempre voltam para a data de hoje, por segurança).
Se a Tabela Dinâmica é para uma análise profunda, o Dashboard é para uma visão rápida do dia a dia: abra o programa, vá direto a esta aba e veja como estão suas finanças num piscar de olhos.
No topo, você pode restringir todo o Dashboard a um Ano, Mês, ou a um período de datas específico (igual ao filtro de período da Tabela Dinâmica). Tudo abaixo — cartões e tabelas — se atualiza de acordo.
Quatro cartões coloridos no topo, sempre visíveis:
| Cartão | Mostra |
|---|---|
| Total Entradas (verde) | Soma de tudo que entrou (valores positivos) no período filtrado |
| Total Saídas (vermelho) | Soma de tudo que saiu (valores negativos) no período filtrado |
| Saldo (azul ou vermelho) | Entradas + Saídas. Fica vermelho automaticamente se o saldo for negativo |
| Registros (roxo) | Quantidade de lançamentos no período filtrado |
Cada uma das três tabelas tem dois controles no topo:
- Dimensão — por qual campo agrupar: Categoria, Sub-Categoria, Transação, Descrição, Mês ou Ano
- Entradas / Saídas — se a dimensão escolhida não for Mês nem Ano, este combo escolhe se a tabela mostra o ranking de despesas ou de receitas naquela dimensão (ordenadas da maior para a menor, com a porcentagem que cada item representa do total)
Caso especial — Mês ou Ano: quando você escolhe
MêsouAnocomo dimensão, o combo "Entradas/Saídas" desaparece, e a tabela passa a mostrar automaticamente três colunas — Entradas, Saídas e Saldo — uma linha para cada mês/ano. Essa visão é mais útil para enxergar a evolução no tempo, em vez de um ranking.
Você pode configurar livremente cada uma das três tabelas para mostrar o que for mais útil para você — por exemplo: a 1ª mostrando o ranking de Categorias de despesa, a 2ª o ranking de Sub-Categorias, e a 3ª a evolução mensal (Entradas/Saídas/Saldo).
No rodapé da aba, uma linha sempre mostra qual foi o maior gasto único (a despesa de maior valor) dentro do período filtrado, com data, categoria, descrição e valor — ótimo para identificar rapidamente aquele gasto fora da curva.
Assim como na Tabela Dinâmica, a configuração de cada tabela do Dashboard (qual dimensão e qual tipo escolhido), o filtro de Ano/Mês e se o filtro por período está ligado — tudo é lembrado entre sessões. Apenas as datas exatas do período voltam sempre para a data de hoje, para evitar que você abra o programa meses depois e veja um período "esquecido" e desatualizado.
Enquanto a Tabela Dinâmica mostra os números de forma analítica e o Dashboard dá um resumo rápido, a aba Médias responde a uma pergunta bem prática: "em média, quanto eu gasto/recebo nisso por mês (ou por ano)?" — por exemplo, "quanto sobra por mês, em média?" ou "quanto gasto no açougue mensalmente?".
O cálculo é sempre o mesmo: soma tudo do período e divide pela quantidade de meses (ou anos) desse período. Essa quantidade é medida pelos dias corridos entre o primeiro e o último lançamento — dividindo por ~30,4 dias (para meses) ou ~365,25 dias (para anos). Assim, um intervalo que atravessa a virada do mês (por exemplo, 16/junho a 15/julho) conta como ~1 mês — e não como 2 —, dando uma média fiel.
Projeção para períodos curtos: se você tiver menos de um mês de dados (no agrupamento por Mês) ou menos de um ano (por Ano), os valores mostrados passam a ser uma projeção — a estimativa para um mês/ano inteiro, mantido o ritmo atual. Nesse caso o programa exibe um aviso em vermelho logo abaixo do cartão do saldo, para você saber que aquele número é uma previsão, não um valor já realizado.
Assim como nas demais abas, você pode restringir a análise por Ano, Mês ou por um período de datas específico. O combo "Agrupar por: Mês / Ano" define se a média é calculada por mês ou por ano (ou seja, qual é o "período" da divisão).
Este cartão, em destaque, mostra o seu saldo médio por período: soma tudo (Entradas − Saídas) do intervalo filtrado e divide pelo número de meses (ou anos). Responde direto: "em média, quanto sobra — ou falta — por mês?" Fica verde quando é positivo (sobra) e vermelho quando é negativo (falta).
Iguais em formato aos painéis do Dashboard, mas com checkboxes ao lado de cada item. Os itens começam todos desmarcados — assim você marca apenas o que quer analisar:
- Marque um item para ver a média só dele.
- Marque vários itens para que o programa some os valores de todos os marcados e calcule a média do conjunto, como se fosse um único grupo (ex: somar "Supermercado" + "Restaurante" para ver a média combinada de alimentação).
- Os botões "Marcar todos" e "Nenhum", acima de cada lista, agilizam a seleção.
Mostra o valor médio por período (mês ou ano, conforme o agrupamento escolhido) somando os itens marcados naquele painel, com a cor automática:
- 🔴 Vermelho — valor médio negativo (mais saída do que entrada)
- 🟢 Verde — valor médio positivo (mais entrada do que saída)
Logo abaixo, em cinza, aparece também o total acumulado dos itens marcados no período (antes de dividir).
Logo abaixo dos filtros há a linha "Simular meta ►", com dois campos de percentual: Faturamento e Despesas. Eles permitem responder à pergunta "e se…?" sem alterar nenhum lançamento:
- Com os dois em 0%, o cartão mostra o saldo médio real (é o comportamento normal).
- Ao digitar um percentual, o programa recalcula o saldo médio aplicando aquela variação. Use valores positivos para aumentar e negativos para reduzir.
Exemplo: se o seu faturamento médio é R$ 100.000 e as despesas R$ 70.000 (saldo R$ 30.000), digitar +10% em Faturamento mostra o novo saldo de R$ 40.000; alternativamente, digitar −14,29% em Despesas chega ao mesmo saldo. Assim você descobre quanto precisa vender a mais (ou gastar a menos) para chegar onde quer.
Enquanto a simulação está ativa, aparece abaixo do valor uma linha lembrando os percentuais aplicados e o saldo real de referência. Esses campos não são salvos: sempre começam em 0% quando você abre o programa, para não confundir dados reais com simulação.
O filtro de Ano/Mês e o agrupamento (Mês/Ano) escolhido são lembrados entre uma sessão e outra do programa, do mesmo jeito que nas outras abas. Já os itens marcados nos painéis e os percentuais de simulação não são guardados de propósito: cada vez que você abre o programa, os painéis começam desmarcados e a simulação zerada, para você marcar/simular apenas o que quer naquele momento.
Esta aba reúne os ajustes administrativos do programa: segurança de acesso, qual banco de dados está em uso, e backup.
Mostra o caminho completo do arquivo .db que está em uso no momento. Clique em "Procurar..." para selecionar outro arquivo .db já existente e trocar para ele — útil, por exemplo, se você quiser abrir o banco de outra pessoa/empresa, ou voltar a um backup antigo.
Ao trocar de banco, o programa pede confirmação e, em seguida, recarrega todas as abas automaticamente com os dados do novo arquivo.
Por padrão, o programa abre livremente, sem pedir senha. Se quiser proteger o acesso:
- Digite a mesma senha nos campos "Nova senha" e "Confirmar senha" (mínimo de 4 caracteres).
- Clique em "Definir senha".
- Na próxima vez que o programa for aberto, ele vai pedir essa senha antes de mostrar a tela principal.
Para voltar a um acesso livre (sem senha), clique em "Remover senha".
A senha não é guardada em texto puro: o programa guarda apenas um "embaralhamento" (hash) dela, então mesmo quem tiver acesso ao arquivo de configuração não consegue descobrir a senha original.
Atenção: não existe um recurso de "recuperar senha esquecida". Se você esquecer a senha definida, será necessário apagar manualmente a senha salva no arquivo
config.json(ou pedir ajuda a quem instalou o programa para você).
Backup manual: clique em "Fazer backup..." para salvar uma cópia completa do banco de dados atual no local que você escolher. O programa lembra a última pasta usada e já sugere o mesmo local da próxima vez, tornando o processo de backups regulares mais rápido.
Backup automático ao fechar: marque a caixa "Fazer backup automático ao fechar o programa" para que, toda vez que você fechar o programa, uma cópia do banco seja salva automaticamente (sem abrir nenhuma janela). Use o botão "Escolher pasta..." para definir onde esses backups ficam — a pasta escolhida vira o padrão e é lembrada nas próximas vezes. Se você não escolher nenhuma, o programa cria uma subpasta backups ao lado do banco de dados.
Para não lotar o disco, o programa mantém apenas os 10 backups automáticos mais recentes, apagando os mais antigos. Cada arquivo tem a data e a hora no nome (ex.: backup_auto_20260709_2158.db), então você consegue voltar a uma versão de um dia específico se precisar.
Data errada é um dos erros mais chatos: um ano ou mês trocado passa despercebido e bagunça as Médias, o Dashboard e os filtros. Para ajudar a evitar isso, ao salvar um lançamento o programa confere se a data está muito longe de hoje e, se estiver, mostra um aviso pedindo confirmação (ex.: "A data 14/07/2016 está a 3652 dias no passado. Tem certeza que está correta?").
Aqui você define o que é "muito longe":
- Avisar se a data estiver mais de [N] dias no passado — padrão 400 dias (cerca de 13 meses, o que permite lançar coisas do ano passado sem incomodar).
- Avisar se a data estiver mais de [N] dias no futuro — padrão 0 dias, ou seja, qualquer data futura dispara o aviso. Aumente esse número se você costuma lançar datas futuras (ex.: contas a vencer).
Esse aviso funciona em conjunto com a caixa "Hoje" da aba Dados: com ela marcada, a data já entra correta (hoje) e o aviso nem precisa aparecer; ao desmarcá-la para digitar datas antigas, o aviso é a sua rede de proteção.
Conforme a sua base cresce, desenhar todos os lançamentos na tela da aba Dados fica lento. Por isso o programa exibe ali apenas os mais recentes — por padrão, 500.
Aqui você ajusta esse número em "Exibir no máximo [N] lançamentos na tabela". Use 0 para desligar o limite e mostrar tudo (não recomendado com bases grandes). A mudança vale quando a aba Dados for recarregada.
Lembre-se: o limite é só de exibição. Os filtros continuam varrendo a base inteira, a soma do cabeçalho considera todos os lançamentos encontrados, e as abas Tabela Dinâmica, Dashboard e Médias sempre usam a base completa. Para ver tudo de uma vez, use Exportar XLSX/CSV.
Para se ter uma ideia do ganho, com uma base de 100 mil lançamentos: abrir o programa caiu de ~28 s para ~2 s, e salvar um lançamento caiu de ~5 s para menos de 0,1 s.
Tanto a aba Dados quanto a aba Tabela Dinâmica possuem botões de exportação:
- Exportar XLSX — gera um arquivo Excel (
.xlsx) já formatado (cabeçalho colorido, cores de positivo/negativo, larguras de coluna ajustadas) - Exportar CSV — gera um arquivo de texto simples, separado por
;, compatível com qualquer programa de planilha
Detalhe importante: ao exportar da aba Dados, as colunas
id,Data,MêseAnosão exportadas com o tipo correto (número ou data nativa do Excel), e não como texto. Isso significa que você já pode usar fórmulas, somas e filtros do próprio Excel diretamente sobre esses campos, sem precisar converter nada manualmente.
Em ambos os casos, a exportação respeita exatamente o que está sendo exibido na tela no momento — ou seja, se você aplicou filtros antes de exportar, só os dados filtrados saem no arquivo.
Seus dados ficam salvos em dois arquivos, na mesma pasta onde está o programa:
| Arquivo | Conteúdo |
|---|---|
dados.db |
Todos os seus lançamentos financeiros. Este é o arquivo mais importante — faça backup dele regularmente! |
config.json |
Suas preferências de tela: filtros salvos, larguras de colunas, configuração da Tabela Dinâmica e do Dashboard, tamanho/posição da janela |
Dica de backup: copie o arquivo
dados.dbperiodicamente (por exemplo, semanalmente) para um pendrive, e-mail para você mesmo, ou serviço de nuvem (Google Drive, OneDrive, Dropbox). Se você perder ou corromper esse arquivo sem backup, perde todo o histórico de lançamentos.
Se você quiser "zerar" o programa e recomeçar do nada, basta apagar (ou mover para outro lugar) o arquivo dados.db — o programa cria um novo banco vazio automaticamente na próxima vez que for aberto.
"Lancei um gasto com o sinal errado (positivo em vez de negativo) e agora os totais estão errados." Vá até a aba Dados, encontre o lançamento na tabela (use os filtros para achar mais rápido), clique nele para carregá-lo no formulário, corrija o Valor e clique em "Atualizar".
"Tenho 20 lançamentos parecidos para cadastrar (ex: indo às compras várias vezes no mês). Como faço mais rápido?" Cadastre o primeiro normalmente. Para os próximos, use o botão "Limpar" — ele já vai preencher Data/Categoria/Sub-Categoria/Transação como o último lançamento, só ajuste a Data (se for outro dia), a Descrição e o Valor.
"Quero copiar um lançamento exatamente igual a outro, só mudando a data (ex: o mesmo aluguel todo mês)." Selecione o lançamento na tabela e clique em "Duplicar Selecionado" — ele copia tudo, inclusive Descrição e Valor. Ajuste a Data e clique em "Salvar".
"Quero ver só as despesas, sem a Renda aparecendo na Tabela Dinâmica." Use o filtro "Valores: Somente negativos" na seção "Filtros de Relatório", ou, se quiser excluir especificamente a categoria "Renda" mas manter a opção de ver tudo, use "Excluir itens ▼" ao lado da Linha 1 e marque "Renda".
"Por que a coluna Total Geral mudou quando troquei o 'Agregar' de sum para mean?" Isso é esperado e correto: quando você pede a média (ou mínimo/máximo/contagem), o Total Geral também passa a mostrar essa mesma métrica aplicada sobre o total de registros, e não mais a soma. Veja a seção 5.2.
"Importei uma base muito grande (milhares de linhas) e o programa ficou mais lento para inserir/excluir." Isso é normal em bases muito grandes, mas o programa já é otimizado para atualizar só a linha afetada em vez de recarregar tudo a cada inclusão/exclusão. Se notar lentidão extrema, considere arquivar lançamentos muito antigos exportando-os para uma planilha e depois excluindo-os do banco ativo.
"Posso usar o programa para mais de uma pessoa/empresa?"
Sim. A forma mais simples ainda é ter uma cópia da pasta do programa para cada perfil (cada cópia com seu próprio dados.db). Mas agora também é possível manter vários arquivos .db e alternar entre eles na aba Configurações → Banco de Dados → Procurar..., sem precisar de cópias separadas do programa.
"Esqueci a senha de acesso ao programa, e agora?"
Não existe recuperação automática de senha. É necessário abrir o arquivo config.json (na mesma pasta do programa) e remover manualmente a chave "auth", ou pedir ajuda a quem instalou o programa para você.
| Termo | Significado |
|---|---|
| Categoria | O grupo principal de um lançamento (ex: Moradia, Alimentação, Renda) |
| Sub-Categoria | Um detalhamento dentro da Categoria (ex: dentro de Moradia: Aluguel, Energia, Água) |
| Transação | A forma como o dinheiro entrou ou saiu (ex: Cartão de Crédito, Débito, Transferência) |
| Tabela Dinâmica / Pivot Table | Uma tabela que cruza e resume dados automaticamente, agrupando por dimensões escolhidas por você |
| Agregação | A operação matemática usada para resumir um grupo de valores: soma, média, mínimo, máximo ou contagem |
| Subtotal | O total parcial de um grupo (ex: o total de tudo dentro da categoria "Alimentação") |
| Total Geral | O total de absolutamente todos os lançamentos considerados na análise |
| Dashboard | Painel visual de resumo, com indicadores e tabelas resumidas, para uma visão rápida |
| Exportar | Gerar um arquivo (Excel ou CSV) com os dados que estão sendo exibidos na tela |
| Importar | Trazer dados de um arquivo externo (Excel ou CSV) para dentro do programa |
| Média por período | Soma de tudo no intervalo dividida pela quantidade de meses (ou anos) do intervalo, medida pelos dias corridos — o valor típico por mês/ano |
| Backup | Uma cópia de segurança do banco de dados, guardada em outro local |
Este manual foi elaborado para acompanhar o programa Fluxo de Caixa. Em caso de dúvidas que não foram esclarecidas aqui, revise as seções correspondentes ou entre em contato com quem lhe forneceu o programa.