XTC File Won't Open on Xteink? Causes and Fixes

Quick fix checklist

  1. Test the file on your computer in our free online XTC viewer. If it fails there, re-copy or re-convert it.
  2. Check the size: 480×800 for the X4, X4 Pro and X4 Classic; 528×792 for the X3.
  3. Update your firmware. Many XTC errors were bugs fixed in later CrossPoint and CrossInk releases.
  4. Split huge files. Thousands of pages can run the reader out of memory.
  5. Try 1-bit XTC if an XTCH version misbehaves.
  6. Check the SD card (FAT32 is safest) and clear CrossPoint's cache.

An XTC file that won't open usually just drops you back to the library or home screen without an error. The cause is almost always one of a handful of things. Work through them in order below.

1. The file is incomplete or isn't really XTC

XTC files are large, and a transfer that's interrupted (pulling the card too early, a dropped Wi-Fi upload) leaves a file that looks fine in a folder but has missing pages. Renaming a file to .xtc doesn't convert it either: an EPUB, PDF or ZIP with an .xtc extension won't open.

Fix: open the file in the XTC viewer. It checks the same header, page table and page data the reader uses and tells you what's wrong. If it fails there, copy it again (and eject the card properly), or re-convert from the EPUB.

2. It was made for a different Xteink model

XTC pages are fixed images, drawn pixel for pixel. A file made for the X4 family (480×800) won't fit the X3's 528×792 screen properly, and an X3 file won't fit an X4. The viewer shows each file's page size and the model it matches.

Fix: convert again with the preset for your model. See the settings guides for the X4 family and the X3.

3. "Unsupported version" on CrossPoint

CrossPoint reads a version number from the XTC header. Some converters wrote the two version bytes in the opposite order, and early CrossPoint releases rejected those files with errors like Unsupported version: 256 (reported for files from cr2xt in issue #157).

Fix: update CrossPoint. Since 0.11.0 it accepts both byte orders. See our CrossPoint install guide.

4. "Corrupted header" with older files

The original XTC header was 48 bytes; newer files use 56 bytes to add a chapter table. A memory optimization in CrossPoint accidentally rejected 48-byte files with Failed to load: Corrupted header, and CrossInk 1.2.6–1.2.7 had the same regression (one reporter's ~25 MB manga file just returned to the home screen).

Fix: update your firmware. CrossPoint fixed it in 1.3.0 (PR #1816) and CrossInk fixed it after 1.2.7. Re-converting with a current tool also works.

5. Very large files: memory errors and boot loops

The reader runs on a small microcontroller with limited memory. Before CrossPoint 1.3.0, loading the page table for files over about 3,000 pages could make the device abort and reboot in a loop. That was fixed by reading the page table on demand. Files with more than about 6,000 pages can still fail with Failed to allocate page buffer (issue #1422, still open).

Fix: split very long books and comic omnibuses into volumes. Comics are the usual culprit, because splitting each page into halves or thirds multiplies the page count. See PDF, CBZ and manga on Xteink.

6. XTCH problems (2-bit grayscale)

Fix: update firmware, and if a specific XTCH file keeps misbehaving, convert the book as 1-bit XTC instead. See XTC vs XTCH.

7. Ghosting or overlapping pages

CrossInk 1.5.0 could show part of the previous page over the current one when turning pages in an XTC file after waking the reader. It was fixed in 1.5.1. The workaround was waiting two or three seconds between page turns. Occasional light ghosting is normal on e-ink; most firmware does a full refresh every few pages to clear it.

8. SD card and cache problems

Still stuck?

Note the firmware name and version, your model, the converter you used and the file's page count and size (the viewer shows all of these). Then ask on r/xteinkereader or file an issue with your firmware project. If the file was made with our app, contact us and we'll help.

FAQ

Why won't my XTC file open on my Xteink?

The most common causes are a file that didn't copy completely, a file that isn't really XTC, a file made for a different screen size, an older firmware with an XTC bug, or a very large file that runs out of memory. Check the file in an XTC viewer on your computer first, then update your firmware.

What does Unsupported version mean on CrossPoint?

CrossPoint checks the XTC version field. Early releases rejected files from some converters that wrote the version bytes in a different order, showing errors like Unsupported version: 256. CrossPoint 0.11.0 and later accept both orders, so update the firmware.

What does Corrupted header mean?

Either the file is damaged, or it uses the older 48-byte XTC header and your firmware has a bug that rejects it. CrossPoint fixed this in 1.3.0 and CrossInk after 1.2.7. Update the firmware, or re-convert the file with a current converter.

Why does my Xteink reboot when I open a big XTC file?

Very large files can exhaust the reader's memory. CrossPoint 1.3.0 fixed boot loops on files over about 3,000 pages, but files over about 6,000 pages can still fail. Split huge books or comic omnibuses into smaller files.

Can I open an X4 XTC file on the X3?

XTC pages are fixed images made for one screen size: 480x800 for the X4 family, 528x792 for the X3. A file made for the other model won't fit the screen properly. Convert again with the right preset.

Why are XTCH page turns slower than XTC?

XTCH pages are 2-bit grayscale, which the e-ink display draws in several passes, while 1-bit XTC pages are drawn in one. Use XTC if you want the fastest page turns.

XTC files that just work

EPUB to XTC Converter writes XTC and XTCH with exact X4 and X3 presets, chapters and metadata, and you can preview every page before you copy it. Offline, one-time $9.99.

Get EPUB to XTC Converter