An easy-to-use OCR and Japanese to English translation tool

Manga Translator

An easy-to-use application for translating text in images from Japanese to English.

The GUI was created using Gio. Gio supports a variety of platforms, including browsers, but this application was designed to be used as a desktop application only.

Note: This application should work on Windows, Linux, and macOS systems, but has only been tested on Windows.

Example Translation
Image source: うずまき 1巻


Installation

Option 1: Download the binary directly (Windows only)

Visit the releases page to download the latest version.

Option 2: go get

# Manga Translator application
go get -u github.com/cameronkinsella/manga-translator/cmd/manga-translator

# Config setup application
go get -u github.com/cameronkinsella/manga-translator/cmd/manga-translator-setup

Note: manga-translator creates a mtl-config.yml and mtl-cache.bin in the same directory as the binary, so consider changing your GOPATH to a more suitable directory before installing.

Prerequisites

Mandatory:

  • Google Cloud Vision API service account key

At least one of the following are required:

  • Google Cloud Translation API key
  • DeepL API key (Free or Pro)

Google Cloud Vision API

Follow steps 1-5 of this guide 👉 Cloud Vision API setup.

This will create a service account key for the Vision API. The path to this JSON key will be needed to configure manga-translator.

Google Cloud Translation API

  1. Enable the Cloud Translation API
  2. Create an API key for the Cloud Translation API

This API key will be needed to configure manga-translator (if you want to use this translation service).

DeepL Translation API

  1. Create an account on deepl.com and sign up for one of the API plans
  2. Copy your API key from your account menu

This API key will be needed to configure manga-translator (if you want to use this translation service).

Usage

First Time (configuration)

Do one of the following:

  1. Run the manga-translator-setup application and follow the interactive prompts
  2. Create the mtl-config.yml file manually by following the schema

Command

Usage: manga-translator.exe [OPTIONS] IMAGE_LOCATION

Options:
  -url   Use an image from a URL instead of a local file.

IMAGE_LOCATION must be a path or a URL.

Note: You can also open images with the manga-translator application itself (on Windows, you can easily do this by dragging the image on top of manga-translator.exe)

Owner
Comments
  • Consider automated Google setup

    Consider automated Google setup

    I had lots of troubles getting all the service account and keys setup yesterday manually. You explained it pretty well in the readme, but i still went nuts trying to second guess in via the Google console gui. I still have not gotten all the config correct. Google Vision works but not Google Translator

    So perhaps this might be work using ?

    https://github.com/caos/orbos

  • Issue with cloud shell commands

    Issue with cloud shell commands

    josselynennie@cloudshell:~$ cloudshell_open --repo_url "https://github.com/cameronkinsella/manga-translator" --page "editor" --open_in_editor "scripts/cloudshell/create-service-account-key.md" --force_new_clone 2022/10/14 21:36:54 Cloning https://github.com/cameronkinsella/manga-translator into /home/josselynennie/cloudshell_open/manga-translator Cloning into '/home/josselynennie/cloudshell_open/manga-translator'... remote: Enumerating objects: 372, done. remote: Counting objects: 100% (17/17), done. remote: Compressing objects: 100% (12/12), done. remote: Total 372 (delta 8), reused 5 (delta 5), pack-reused 355Receiving objects: 100% (372/372), 4.45 MiB | 26.18 MiB/s, done. Resolving deltas: 100% (191/191), done. Traceback (most recent call last): File "/usr/local/bin/cloudshell", line 496, in main() File "/usr/local/bin/cloudshell", line 493, in main args.handler(args) File "/usr/local/bin/cloudshell", line 110, in edit_files open(filename, 'a').close() FileNotFoundError: [Errno 2] No such file or directory: '/home/josselynennie/cloudshell_open/manga-translator/scripts/cloudshell/create-service-account-key.md'

  • Incorrect recognition boxes

    Incorrect recognition boxes

    On several manga that I am working to translate, the boxes which cover the translated text appear to not be capturing the entire speech buble and as such is producing nonsense translations. Would there be a way to manually create these boxes around the text so it knows which exact characters to try and translate or is this a limitation of the OCR software?

  • Japanese text recognition

    Japanese text recognition

    Very cool software !

    Its possible for the system to recognise automatically where the Text is in each picture, so that a user does not have to click on it.

    This example does is : https://github.com/sachaos/jisui

    Basically a PDF is sent to google, and it can extract where the Text is in the document.

    If you look at the 2 PDFs in a PDF viewer and use the Find tool you can see that it put the real text in during the processing such that the Find functionality now works. So you end up with a fully work PDF with FIND !

    https://github.com/sachaos/jisui/blob/master/example/scanned.pdf

    • Cannot Find the text.

    https://github.com/sachaos/jisui/blob/master/example/result.pdf

    • Can Find the text
  • Cannot download images

    Cannot download images

  • Implement option to translate image from clipboard

    Implement option to translate image from clipboard

    Add new option to translate an image from your clipboard.

    The built-in Windows snipping tool (there are also Linux and Mac equivalents) allows you to freely select a portion of your screen and copies it as an image to your clipboard. Using the new clipboard option in conjunction with the Windows snipping tool makes it much easier to do quick adjustments and translations without needing to save a new image every time.

    Resolves #3

  • ios - in Sim it fails to run silently.

    ios - in Sim it fails to run silently.

    Tried it out but when i open the app it fails silently. I guess i need to figure out how to capture logs.

    TO run in sim:

    gogio -o manga-trans.app -target ios .
    xcrun simctl install booted manga-trans.app  
    
A lightweight and easy to use tool for deflickering timelapse image sequences.
A lightweight and easy to use tool for deflickering timelapse image sequences.

Simple Deflicker A minimalist, lightning-fast and easy to use tool for deflickering image sequences such as timelapses. It's still in its early stages

Aug 12, 2022
Go bindings for GStreamer (retired: currently I don't use/develop this package)

Retired. I don't use/develop this package anymore. Go bindings for GStreamer at a very early stage of maturity. This package is based on GLib bindings

Nov 10, 2022
Rasterx is an SVG 2.0 path compliant rasterizer that can use either the golang vector or a derivative of the freetype anti-aliaser.
Rasterx is an SVG 2.0 path compliant rasterizer that can use either the golang vector or a derivative of the freetype anti-aliaser.

rasterx Rasterx is a golang rasterizer that implements path stroking functions capable of SVG 2.0 compliant 'arc' joins and explicit loop closing. Pat

Nov 1, 2022
Use Windows API to capture a image from a Webcam in GoLANG

Windows-API-Capture-Webcam Use Windows API to capture a image from a Webcam in GoLANG Other Go is a amazing and powerful programming language. If you

Aug 13, 2022
A cross-platform tool to convert images into ascii art and print them on the console
A cross-platform tool to convert images into ascii art and print them on the console

A cross-platform tool to convert images into ascii art and print them on the console

Dec 30, 2022
An extensive, fast, and accurate command-line image dithering tool.
An extensive, fast, and accurate command-line image dithering tool.

didder is an extensive, fast, and accurate command-line image dithering tool. It is designed to work well for both power users as well as pipeline scripting. It is backed by my dithering library, and is unique in its correctness and variety of dithering algorithms.

Dec 31, 2022
JPEG-MPO Decoder / Converter Library and CLI Tool

MPO Decoder Library Simple Go JPEG MPO (Multi Picture Object) Decoder - Library and CLI Tool The library and CLI tool contain the ability to convert M

Sep 26, 2022
🔍 Go tool for LSB steganography, capable of hiding any file within an image.
🔍 Go tool for LSB steganography, capable of hiding any file within an image.

stegify Overview stegify is a simple command line tool capable of fully transparent hiding any file within an image or set of images. This technique i

Jan 1, 2023
Faster than the fastest in the world pixel-by-pixel image difference tool.

imgdiff Faster than the fastest in the world pixel-by-pixel image difference tool. Why? imgdiff isn't as fast as a tool like this should be and I'm no

Dec 21, 2022
golang aspect tool
golang aspect tool

简介 go-aspect是一个为golang提供切面编程可能性的工具,可以使用该工具,替换原有的go build来进行编译,将预先配置好的切面编织到目标代码中 效果图 安装方式 源码安装 下载源码到本地 切换到源码目录,运行 make install 使用简介 目前仅支持mod模式的工程 编织是基于

Mar 13, 2022
a tool to output images as RGB ANSI graphics on the terminal
a tool to output images as RGB ANSI graphics on the terminal

imgcat Tool to output images in the terminal. Built with bubbletea install homebrew brew install trashhalo/homebrew-brews/imgcat prebuilt packages Pr

Dec 28, 2022
Tool to scan a container image's rootfs

image-rootfs-scanner A tool to pull and scan the rootfs of any container image for different binaries. It started out as a means of finding "restricte

Mar 30, 2022
🪄 An online tool for making notion-style avatars.
🪄 An online tool for making notion-style avatars.

Notion Avatar Maker An online tool for making notion-style avatars

Jan 3, 2023
Simple tool for changing graphics in dbd

Config changer for Dead By Deaylight For now only for epic store version And if only installed under C:\ further updates will include support for vers

May 3, 2022
Open-in-linear - A tool provides a shortcut to opening a linear issue in the desktop app or browser

This tool provides a shortcut to opening a linear issue in the desktop app or browser.

Jan 25, 2022
Super fast static photo and video gallery generator (written in Go and HTML/CSS/native JS)

fastgallery Fast static photo and video gallery generator Super fast (written in Go and C, concurrent, uses fastest image/video libraries, 4-8 times f

Dec 4, 2022
Go bindings for audio capture and playback with ALSA and libasound

Go ALSA bindings These bindings allow capture and playback of audio via ALSA using the alsa-lib library. Installation go get github.com/cocoonlife/goa

Nov 26, 2022
This is old and unmaintained code, ignore it. starfish is a simple, SDL based, 2D graphics and user input library for Go. If you intend to work on it, please fork from the 'devel' branch, not 'master'. Current release: 0.12.0

What is starfish? What starfish is: starfish is a simple 2D graphics and user input library for Go built on SDL. What starfish is not: While it is bui

Jun 4, 2019
darkroom - An image proxy with changeable storage backends and image processing engines with focus on speed and resiliency.
darkroom - An image proxy with changeable storage backends and image processing engines with focus on speed and resiliency.

Darkroom - Yet Another Image Proxy Introduction Darkroom combines the storage backend and the image processor and acts as an Image Proxy on your image

Dec 6, 2022