whatisgithub

What is x4randommangaconverter?

randomseasons-dev/x4randommangaconverter — explained in plain English

Analysis updated 2026-05-18

2RustAudience · generalComplexity · 2/5Setup · easy

In one sentence

An offline desktop app that converts manga comic archives into the .xtch file format used by the XTEink X4 e-reader.

Mindmap

mindmap
  root((XTEink Manga Creator))
    What it does
      Converts manga archives
      Trims and dithers pages
      Splits page spreads
    Tech stack
      Rust
      Tauri
      React
    Use cases
      Prepare manga for e-reader
      Auto trim borders
      Split double spreads
    Audience
      XTEink X4 owners
      Manga readers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert a folder of manga page images or a CBZ/CBR archive into a file your XTEink X4 e-reader can display.

USE CASE 2

Automatically trim white borders and remove page numbers from scanned manga pages before conversion.

USE CASE 3

Split two page manga spreads into individual pages in the correct right to left reading order.

What is it built with?

RustTauriReact

How does it compare?

randomseasons-dev/x4randommangaconverter132ikl/game1lystore/pay-dcp
Stars222
LanguageRustRustRust
Last pushed2020-12-30
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/53/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an XTEink X4 e-reader to actually use the converted output files.

Personal project with no formal open license, not affiliated with XTEink or xtcjs.app.

So what is it?

XTEink Manga Creator is a desktop app that converts manga comic archives, in CBZ, CBR, or ZIP format, or a plain folder of image files, into the special file format used by the XTEink X4, a dedicated e-reader device. It works entirely offline, so nothing is uploaded anywhere and no internet connection is needed during conversion. The app automatically trims white borders around each page and removes small marks like page numbers or watermarks by detecting them as small isolated shapes. It also looks at each page and figures out whether it is a normal single page, a page that needs rotating upright, or a two page spread. Spreads are shown whole first and then split into two separate pages in the correct reading order for manga, which reads right to left. You can choose whether the output is portrait or landscape, and in landscape mode pick how a page should be split, either into overlapping thirds, cut cleanly in half, or not split at all. Images can be resized either by preserving their original proportions with white padding added, or by stretching them to fill the screen exactly. Because the target e-reader's screen only supports a small number of gray shades, the app converts each image using a dithering technique called Floyd Steinberg, reducing it down to four gray levels that match the device's two bit display format. The app includes a live preview panel so you can see the effect of settings like contrast and white border trimming before running the full conversion, and it can split its output into multiple smaller files when converting a folder of loose images. The underlying file format the app writes was not officially documented by the device maker. Instead, the author reverse engineered it by studying real files taken from the device, working out the container structure and how each page's pixel data is packed. This is a personal hobby project built with Tauri, combining a Rust backend with a React based interface, and it is not affiliated with XTEink or the xtcjs.app project.

Copy-paste prompts

Prompt 1
Help me convert a CBZ manga archive into a .xtch file for my XTEink X4 e-reader using this app.
Prompt 2
Explain how this app's dithering and four gray level conversion works for e-ink displays.
Prompt 3
Show me how to adjust the contrast and white border trimming settings before converting a manga folder.
Prompt 4
Walk me through building this Tauri app from source using its Rust and React codebase.

Frequently asked questions

What is x4randommangaconverter?

An offline desktop app that converts manga comic archives into the .xtch file format used by the XTEink X4 e-reader.

What language is x4randommangaconverter written in?

Mainly Rust. The stack also includes Rust, Tauri, React.

What license does x4randommangaconverter use?

Personal project with no formal open license, not affiliated with XTEink or xtcjs.app.

How hard is x4randommangaconverter to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is x4randommangaconverter for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.