Easy Game Translator

Easy Game Translator: Tradutor de jogos em tempo real!
Easy Game Translator é um software intuitivo criado com o apoio de pesquisa e diversas bibliotecas. Seu objetivo é facilitar a vida dos gamers que desejam jogar títulos que não estão disponíveis em seu idioma nativo, eliminando a necessidade de aprender uma nova língua ou utilizar tradutores manuais o tempo todo.
Muitas vezes, me deparei com jogos, especialmente RPGs ou Visual Novels, em idiomas diferentes do meu, sem nenhuma tradução disponível. Isso me obrigava a recorrer a sites de tradução, digitando manualmente cada frase que eu não entendia. Embora esse processo ajudasse a aprender um pouco sobre outros idiomas, nem sempre eu queria "estudar", às vezes, só queria relaxar e me divertir com o jogo. Foi exatamente para resolver esse problema que desenvolvi este programa, com o objetivo de traduzir textos em tempo real por meio de captura contínua e tradutores gratuítos.
Aviso importante!
► Ao instalar o programa, há um risco do sistema o apontar como um "Vírus" devido a função de captura contínua da tela, que no caso, é selecionada pelo próprio usuário, porém, as imagens capturadas não são enviadas a internet, somente os textos reconhecidos pelo OCR para que a tradução online ocorra, é possível ver o histórico de capturas nas configurações. por se tratar de um programa de código aberto, você pode conferir como funciona todo o sistema no repositório do GitHub caso ainda esteja inseguro.
GitHub: https://github.com/cleitinhodev/easy_game_translator
Obs: Ainda assim, é importante EVITAR CAPTURAR dados delicados como documentos, senhas, e informações pessoais! Como foi citado antes, textos são enviados para realizar a tradução online ou por IA em tecnologias de terceiros. As informações enviadas são de total responsabilidade do usuário.
Passo 1: Preparando o Sistema

Ao iniciar o Easy Game Translator, você verá a tela inicial, que conta com uma variedade moderada de botões. Apesar de parecer um pouco intimidador à primeira vista, o funcionamento é extremamente simples. Para tornar a explicação mais prática, utilizaremos a tela de um jogo como exemplo.

Como podemos notar, o texto está em inglês, mas poderia estar em qualquer outro idioma. Para iniciar a captura, devemos definir quatro coisas importantes: Alfabeto, OCR, Tradução e Intervalo. Vamos entender melhor cada um desses parâmetros a seguir.

1 - Alfabeto
Cada idioma pode ter seu próprio conjunto de caracteres, no caso, letras e símbolos usados para escrita, o Easy Game Translator traz algumas opções como o Kanji do japonês, isso é importante para indicar ao sistema, qual tipo de texto ele deve traduzir, as vezes o próprio OCR detecta sozinho, mas ao ajudá-lo, as chances de sucesso na detecção aumentam bastante. É importante entender que o alfabeto não necessariamente significa o idioma em questão, por exemplo, Espanhol e Francês possuem conjuntos iguais de caracteres, então você não precisa mudar nesse caso, após definir o alfabeto, podemos ir para a próxima etapa.

2 - OCR
OCR é a tecnologia responsável por reconhecer caracteres em uma imagem e extrair o conteúdo em formato de texto, permitindo que o computador consiga interpretá-lo e utilizá-lo na tradução.
Por padrão, o Easy Game Translator vem com o RapidOCR integrado, mas também é possível instalar outros mecanismos, como o Tesseract e o EasyOCR. Essa alternativa é recomendada porque cada OCR possui suas próprias características e pode apresentar resultados melhores dependendo do idioma, da fonte e da qualidade do texto exibido no jogo.
Como essas ferramentas são programas externos, cada uma possui seu próprio processo de instalação. Caso o Easy Game Translator não as detecte automaticamente, você poderá indicar manualmente, nas configurações, o caminho onde estão instaladas.
Além disso, alguns parâmetros, arquivos de configuração e logs podem ser encontrados nos seguintes diretórios:
-
C:\Users\seu_nome_de_usuário\AppData\Roaming\Easy Game Translator
-
C:\Users\seu_nome_de_usuário\AppData\Roaming\EasyGameTranslator
Essas pastas podem armazenar configurações gerais e outros componentes utilizados pelo programa. A disponibilidade dos arquivos pode variar conforme a versão e a instalação.
Após escolher e configurar o OCR de sua preferência, podemos seguir para a próxima etapa.


3 - Tradução
Nesta etapa, você define o idioma de destino, ou seja, aquele em que deseja receber o texto traduzido. O Easy Game Translator disponibiliza algumas das diversas línguas existentes, com planos de adicionar mais opções futuramente.
Não há muito segredo nesta configuração: basta selecionar o idioma em que você deseja ler os diálogos e textos do jogo.
4 - Intervalo
O intervalo é uma configuração muito importante! Ele determina quanto tempo o programa espera entre uma captura de tela e outra para identificar novos textos e realizar as traduções.
Como ponto de partida, recomendamos um intervalo entre 1,3 e 2 segundos. No entanto, esse valor pode variar de acordo com o desempenho do seu computador. Em máquinas mais antigas ou com processadores limitados, aumentar o intervalo pode ajudar a reduzir a carga de processamento e evitar que o sistema fique sobrecarregado.
O Easy Game Translator também conta com recursos como cache interno e tratamento de imagem, que ajudam a otimizar o processamento e evitar trabalho desnecessário.
Vale lembrar: capturar mais vezes não significa necessariamente traduzir melhor. Um intervalo bem ajustado, que permita reconhecer os textos com qualidade e processá-los adequadamente, pode oferecer uma experiência muito melhor do que realizar capturas em excesso.


Passo 2: Captura de Texto
É aqui que mágica acontece, Iremos selecionar a região de captura, e para isso, é importante facilitarmos a leitura e interpretação dos dados, então aqui vai uma lista de coisas a se fazer ou evitar durante a captura de uma região:
► Capture textos com fonte legível: Evite fontes muito diferentes do normal ou com figuras desnecessárias, isso atrapalha a captura.
► Selecione apenas a região onde o texto irá aparecer: Geralmente a área da caixa de texto é o suficiente, não selecione a tela do jogo inteiro, pois ele só mostrará uma bagunça de caracteres sem sentido.
►Após selecionar a área, evite arrastar a janela do jogo: A região de captura é fixa no ponto onde você escolheu, caso tenha que mover a janela, basta capturar a nova região.
►Se possível, mude a cor da caixa de texto para um tom que faça contraste com a cor da letra, e diminua a Transparência nas configurações do game, muitas Visual Novels tem esse tipo de opção. A ideia é que se a caixa estiver muito transparente, isso pode atrapalhar a interpretação do software. Lembre-se, facilite o máximo possível o processo de leitura.
►Você ainda pode alterar alguns elementos indo nas configurações de OCR, na parte de pré-processamento da imagem, modificando alguns filtros para separar os elementos com precisão.

Calma!
Não saia mexendo nas configurações antes do primeiro teste... Vamos retornar a tela inicial e fazer o procedimento básico pra entender como tudo isso funciona.
Posicione a janela em um local apropriado, de forma que não cubra a caixa de diálogo do game aberto, e clique em "Selecionar Região", ao fazer isso, uma função de selecionar a área do seu monitor será acionada, basta arrastar com o mouse e soltar no local das falas dos personagens. Não se preocupe caso errar, apenas repita o processo.

No bloco da esquerda, aparecerá a imagem capturada, perceba que não foram incluídos as bordas da caixa de diálogo, pois até isso pode interferir na leitura, também aparecerá o tamanho em pixels junto ao botão, serve para indicar ao programa exatamente a área que deve ser usada no processamento do OCR.

Por fim, clique em "Iniciar", em poucos segundos o Easy Game Translator entrará em ação, capturando a imagem, extraindo o texto, e buscando uma tradução, retornando no bloco da direita o resultado obtido, por padrão, ele usa algumas bibliotecas de tradução em uma ordem que pode ser alterada pelo usuário, sempre priorizando a opção que trouxer a resposta primeiro, em caso de uso de IA, o mesmo será colocado no topo da fila por ter os melhores resultados nos testes.

Agora vamos para o "momento de sinceridade", apesar de muitos testes e adição de mais funcionalidades nas versões recentes, nem sempre o programa conseguirá fazer milagres, as vezes ele pode parar de traduzir porque algum dos serviços de tradução saiu do ar, ou você terá que testar diversas combinações de OCR até encontrar uma que funcione, se precisar, recomece o processo, selecione a região e inicie novamente, capture uma região diferente e depois volte na original pra "resetar" o cache. Há diversas formas de fazer o programa funcionar de forma consistente por bastante tempo, eu mesmo zerei alguns jogos inteiros assim, uma regra que sempre uso nos meus projetos é a seguinte:
"Não faz sentido criar algo que nem eu usaria."
Então, tenha paciência no início, muitas das vezes quando o programa falha, é por conta de uma configuração errada que pode ser ajustada, com o tempo você vai entender melhor. E garanto que continuarei trazendo melhorias pra cobrir o máximo de idiomas possíveis.
Janela Flutuante:
Naturalmente, você não vai querer deixar uma janela gigante na frente da tela do seu jogo, então após configurar tudo e iniciar a tradução, você pode ativar uma opção muito útil que eu costumo chamar de "Box Mode" ou "Modo Caixa".

Basicamente, ela abre uma pequena janela redimensionável, e que pode ser movida e fixada, ela mostra apenas as saídas das traduções, ou seja, tudo que aparece no segundo bloco do programa, assim, você pode minimiza-lo completamente e deixar seu jogo em tela cheia.
Mas espera! Não é só isso, essa janela fica em primeiro plano no sistema, ou seja, nem mesmo a captura de tela é capaz de pegá-la, isso significa, que de certa forma, você pode literalmente deixá-la em cima da caixa de diálogo do game, sério, isso melhora muito a imersão.
Tradução Manual

A tradução manual serve para aqueles momentos em que surge uma frase em que nada funciona para traduzir, as vezes por conta dos caracteres estranhos, ou efeitos na tela, ou até frases ditas por personagens que você gostaria de saber o significado. Para isso, foi criado uma janela simples de tradução no próprio programa, aqui não tem mistério, de um lado a frase, e do outro a tradução.
Canal Duplo:

Alguns jogos tem caixas de diálogo tanto abaixo, quanto acima dos personagens, e certamente, seria muito chato ficar trocando a região de captura o tempo todo, para contornar isso, foi criado essa opção de Canal Duplo, que captura e traduz duas regiões ao mesmo tempo, você provavelmente não usará ela com frequência, mas quando surgir a oportunidade, garanto que fará uma grande diferença.
O funcionamento é exatamente igual ao canal único, você só terá um botão adicional de captura nas opções, e cada um será responsável por sua própria área. Ambas usam as mesmas configurações de OCR e tradução, então não funcionará caso tente pegar dois idiomas ao mesmo tempo... Aliás, quem faria um jogo com dois idiomas diferentes????
Configurações:
Agora que mostramos as principais funcionalidades do Easy Game Translator, vamos falar um pouco sobre as configurações, que por sinal, são muitas, mas a grande maioria é fácil de compreender, como esse tutorial é apenas uma apresentação básica, evitarei termos muito técnicos, e deixarei a parte "chata" para explicar com mais profundidade no GitHub.
O botão de configurações é aquele com ícone de engrenagem, ao clicar, uma aba se abrirá com várias opções, comentarei sobre as mais importantes em etapas:
Geral:

Na aba Geral, encontramos diversas configurações relacionadas a interface, atalhos, fontes, e opções que afetam o funcionamento do programa, cada uma delas tem um texto descritivo, algumas até removem animações para deixa-lo mais leve, você também pode ativar atalhos globais, mas para isso precisará do Python e certas bibliotecas instaladas no sistema, que por sinal é muito recomendado, já que boa parte do Back-end do programa usa Python, e é possível ativar opções avançadas dessa maneira, mas caso seja um novato em programação, não se preocupe, o programa já consegue fazer muita coisa nativamente.
OCR:

Lembra do que falei sobre o Python? É aqui que ele é mais necessário, muitos dos OCR podem ser instalados com Python no terminal, no caso do Tesseract, você precisará entrar no repositório oficial deles e fazer o Download de uma das versões, é interessante instalar suporte para o máximo de idiomas possíveis.:
Tesseract: https://github.com/UB-Mannheim/tesseract/wiki
Ao instalar, e clicar em "Reverificar" o Easy Game Translator reconhece automaticamente os motores, inclusive você pode testá-los, devido a atualizações constantes, alguns deles podem parar de funcionar por um tempo, tentarei manter atualizado na medida do possível, por isso, verifique as vezes o lançamento de atualizações tanto do programa, quanto dos demais componentes externos.
Tradução:

Aqui temos os tradutores Online e Offline disponíveis, você pode habilitar todos juntos se desejar, a tradução exibida será sempre do motor que responder mais rápido, em alguns casos alguns podem ter resultados melhores que outros, então é interessante avaliar qual deles é o melhor para sua necessidade, você também pode definir a prioridade com as setas ao lado, o "modo cache" usa apenas traduções já salvas no sistema, ele serve apenas para evitar chamadas desnecessárias de forma repetida, no caso do Microsoft/Bing, você precisará de uma chave Azure pessoal, que pode consumir créditos dependendo de como o serviço funciona, então fique atento!
Substituir:

Existem situações onde o programa começa a traduzir coisas que não deveria, como símbolos ou nomes, por conta das diferenças linguísticas. Nesta aba, você pode criar regras, que são verificaras a cada captura, de forma que o programa bloqueia ou permite certas palavras, verbos ou frases inteiras, por exemplo: Na língua inglesa, a frase "I love You", perceba que o "i" maiúsculo é muito parecido com o "l", para o OCR as vezes é difícil interpretar esse tipo de detalhe, com as regras corretas, você consegue evitar esses conflitos em diversos idiomas, tornando a tradução ainda mais precisa.
Inteligência Artificial:

Configurando Gemini
Essa parte é MUITO importante, pois é aqui que muita gente confunde as coisas. Antes de tudo, o Easy Game Translator não tem uma IA nativa, apenas indexa o código disponibilizado pela própria Google para usar o Gemini como forma de API, para ativar essa funcionalidade você precisará criar uma conta oficial na Google AI Studio, e gerar uma Chave API, que basicamente é um código que você deverá inserir na caixa "Chave do Gemini" como demonstrado na imagem acima, essa Chave é pessoal, você não deve compartilhar com ninguém, e caso desconfiar que ela tenha vazado, volte no site e exclua para criar uma nova.
Relaxa, o Easy Game Translator mantém essa chave num local específico onde você pode conferir e apagar se necessário. Mas afinal, por que isso é tão importante?? A resposta é simples, diferente dos tradutores online, o Gemini consome Tokens, que no modo gratuito tem um limite básico, e de certa forma, dá pra usar com moderação, a maior preocupação é destinada a quem paga algum plano, já que o limite é muito maior, e por falta de informação, a pessoa pode acabar consumindo um grande volume de tokens devido as várias chamadas seguidas de traduções, então é de extrema importância que você usuário fique de olho no consumo o tempo todo, e sempre que for fechar o game, não deixe o programa rodando com a IA "comendo seus créditos", é responsabilidade do próprio usuário ficar sempre se olho nisso, ok?
Configurando Ollama
O Ollama é uma IA que pode ser usada localmente no seu computador, sem conexão com a internet, o que de certa forma, faria o Programa funcionar completamente offline, tornando o Easy Game Translator um "Monstrinho da Tradução", mas nem tudo é flores, como você já deve imaginar, é necessário um computador relativamente potente, mesmo nos modelos mais simples do Ollama, o recomendado é ao menos 8GB de RAM e uma placa de vídeo razoável, quanto melhor for o modelo, melhor e mais rápido serão os resultados.
Você pode baixar os modelos pelo próprio site oficial do Ollama, e testá-los à vontade, nas configurações, basta indicar o modelo e o local que já está pré-definido, assim que iniciá-lo, se for compatível, o Easy Game Translator o identificará e usará com prioridade, infelizmente, meu computador é uma "batata", então só consegui usar efetivamente o modelo mais simples.
Histórico:

Nesta aba, fica armazenado, o histórico de traduções, indicando o texto original, traduzido, e a origem, além de ajudar a conferir algum texto anterior, também ajuda o sistema a não fazer chamadas para frases repetidas, retornando uma tradução instantânea em certos casos, você também pode limpar esse histórico caso esteja muito cheio.
Atualizações:

Neste bloco, você pode conferir componentes instalados no computador que servem para auxiliar o Easy Game Translator, aqui podemos ver uma janela simples, mas ela pode se expandir e mostrar detalhes avançados, em alguns casos até orientar o usuário sobre como instalar determinadas funcionalidades, algumas delas são muito pesadas no quesito armazenamento, podendo ter GygaBytes (GB) de tamanho, então o ideal é instalar apenas o que achar necessário.
Reportar Erros:

Esta é uma simples janela de Logs (Registros em tempo real do que acontece no sistema), é uma parte voltada para desenvolvedores, onde podemos verificar erros e possíveis melhorias, você pode acessar essa pasta se necessário e salvar para possíveis análises.
Conclusão:
Eu espero que o Easy Game Translator possa te ajudar de alguma forma, eu sei bem como é o sentimento de frustração em não poder jogar um game por conta da indisponibilidade no nosso idioma. Essa ferramenta foi feita para garantir que você possa ter a mesma experiência de quem pode jogar entendendo cada palavra, sem precisar usar um tradutor manual ao lado a cada 10 segundos. Claro, ela não resolve todos os problemas, apenas tenta dar uma mãozinha.
Continuarei trabalhando para melhorar este projeto, ao mesmo tempo que trarei novas ideias e funcionalidades, quero agradecer a todos os desenvolvedores que trabalharam em diversas tecnologias de OCR, tradução, IA, entre outras funcionalidades da qual esta ferramenta depende, este não é o trabalho de uma pessoa só, mas de milhares de conhecimentos acumulados, também agradeço a você que está usando meu software e apoiando o desenvolvimento de alguma forma.
Obrigado! :)