Snail OS is $2.99.

Get it

Snail OS · Install

Install Snail OS.

Five steps. The original firmware stays on the device the whole time.

Step 1

Buy it

Buy Snail OS on the main page. The email with your download link and key arrives within a minute.

Step 2

Plug the X4 in

USB-C, straight into your computer, powered on.

Step 3

Download and unzip the firmware

Open your download link and unzip the file it gives you.

Step 4

Run the installer

On Windows

Double-click Install Snail OS (Windows).bat in the unzipped folder. A window opens and walks you through it.

On Mac or Linux

Open a terminal in the unzipped folder and run:

./install.sh

Either one needs esptool. If you don't have it, run pip3 install esptool — that works on all three systems and needs nothing installed first.

The installer puts Snail OS in the spare flash bank and leaves your original firmware where it is. It saves the 8 KB boot selection first, which is what the revert script restores.

Step 5

Connect

Join your network in the Wi-Fi app. Connected apps sign in with a QR code: open the app, press OK to draw the code, scan it with your phone.

Using it

Click the side button once to go home. Click it twice to put the list back at the top.

A connected app opens on what the card already holds, so the screen appears before the network does. RIGHT asks for it again.

The Store app installs games onto the card.

Hold BACK for a second to redraw a ghosted screen.

If it freezes

Hold both side buttons for 15 seconds, then press and hold BACK until the launch screen reloads.

Going back

From the unzipped folder:

Windows — powershell -ExecutionPolicy Bypass -File tools\revert_to_stock.ps1

Mac or Linux — tools/revert_to_stock.sh

It rewrites the boot record only. The original firmware was never overwritten, so it comes straight back.

CrossPoint and Snail OS on one device

The X4 has two flash banks. Snail OS lives in the second; the first holds whatever else you install — the original firmware, or CrossPoint if you flash it there following its own instructions. Back up your device yourself first, because CrossPoint replaces the bank the original firmware is in.

Switching is the same two commands: ./install.sh boots Snail OS, tools/revert_to_stock.sh boots the first bank.

Common questions

The installer says my device was not found.

Almost always the cable. Many USB-C cables carry power and no data, and a charging cable looks identical to a data one. Try a different cable before anything else.

Then check the X4 is switched on — hold the side button about three seconds. A device that is off does not appear.

Windows opened my installer in Notepad.

You clicked install.ps1. Click Install Snail OS (Windows).bat instead — that is the one meant for double-clicking.

Windows says running scripts is disabled.

Same fix: use the .bat file. It runs the installer in a way that applies to that one window and changes no setting on your computer.

It says esptool is not installed.

Install Python from python.org/downloads. On Windows, tick Add python.exe to PATH in the installer — it is easy to miss and nothing works without it.

Then open a new terminal (or PowerShell) and run pip3 install esptool, and run the installer again.

Will this brick my device?

The installer writes the spare bank and the 8 KB that selects which bank boots. It never writes the bank your original firmware is in.

Your original firmware is never overwritten. It sits in the first flash bank; Snail OS goes in the second, unused one. Installing changes which of the two boots.

Can I go back to the original firmware?

Yes, with one command — see “Going back” above. It rewrites the boot record only, and the original firmware comes back exactly as it was, because it was never touched.

The device disappeared from USB after installing.

That is expected on this hardware, not a failure. The USB port is part of the chip, so the reset at the end of a flash takes it off the bus. Hold the side button about three seconds to power it back on.

How do I put my own books on it?

Copy .epub or .txt files into a books folder on the microSD card. The reader lists everything it finds.

You can also send them over Wi-Fi: open the Drive app, and it shows an address to open in your browser and a four-digit code.

Do I need the microSD card?

No. The device works without one, with less on it. The card is what holds books, the games you install, and your saved Wi-Fi.

Is my Wi-Fi password safe on the card?

It is encrypted with a key derived from your device's own chip, so the card alone does not open it. Books and apps on the card stay as plain files you can read and copy.

Does Snail OS actually run on the XTEINK X4?

Yes. Snail OS is running on real XTEINK X4 hardware. The display driver, buttons, SD card, Wi-Fi and included apps have been built and tested on the device.

Does it replace the original XTEINK firmware?

No. The X4 has two firmware slots; Snail OS goes into the unused one and the original stays in the other. The slot holding your original firmware is never written.

Do I need to open the X4 or solder anything?

No. Installation is done over the USB-C port.

What is the XTEINK X4?

A 4.26-inch e-ink handheld built around an ESP32-C3 with about 400 KB of RAM, 16 MB of flash, Wi-Fi, Bluetooth LE, microSD, six buttons and an 800 × 480 monochrome display.

Why is there no Wi-Fi after installing?

A shipped firmware image carries nobody's network password, so a fresh install starts unjoined. Open the Wi-Fi app once, pick your network and enter the password with the buttons. The SD card keeps it and the device rejoins on every boot.

The screen froze while an app was installing. Is it stuck?

No. During a download the panel lends its memory to the transfer, so the screen holds still until the install finishes or fails, then says which.

A connected app says it cannot reach a-gnt. What do I check?

In order: the signal bars in the header (join in the Wi-Fi app if missing), the clock (open Clock and press OK after a dead battery), and the pairing (the app's sign-in screen cures a token minted before a feature existed - OK makes the QR code).

Does Snail OS send telemetry?

No. Networked apps make requests when you use them; the OS does not report usage in the background.

How is Snail OS different from CrossPoint?

CrossPoint is primarily an e-book reader for the X3 and X4. Snail OS treats the X4 as a small general-purpose e-ink computer: reading is one app alongside a clock, weather, a text-only browser, networking, utilities and games.

Can I add my own apps?

Yes. A card app is one Lua file in /apps on the SD card — the launcher finds it and lists it with its own name and icon, no reflash. The Store app on the device installs published ones over Wi-Fi. The built-in apps are compiled into the firmware, so a new one of those still means a new build from me. See the developer documentation at snailos.org/dev.

Do I need to compile anything, or enter Wi-Fi details before installing?

No. The download is already built. You join a Wi-Fi network on the device itself — the Wi-Fi app scans, you type the password with the buttons, and it is saved to the SD card. Nothing is baked into the firmware.

How do I put books on it?

EPUB or plain text on the microSD card. The reader imports an EPUB on the device and draws its cover on the shelf. Drive moves files onto the card over Wi-Fi, or you can put the card in a computer. PDF is converted by a host tool first.

What does Snail OS cost?

$2.99 for the download, which is emailed to you at checkout. A prepared SD card is $85 and an X4 with Snail OS installed is $139; both are charged at checkout and ship October 1, 2026, refundable on request until they go out.

Is Snail OS open source?

No. Snail OS is a commercial product and the source is not distributed. The download includes the third-party components the firmware uses, with their licences and required notices.

What do I get for $2.99?

A zip with the Snail OS firmware already built, the installer, the revert tool and the instructions. The email carries the download link and your key.

Can I download it today?

Yes. Pay $2.99 and the email with your download link and key arrives within a minute. Unzip it, plug the X4 into your computer and run the installer.

How do I request a refund?

Email joey@snailos.org. A download is refunded if Snail OS will not run on your X4; a card or device is refunded in full any time before it ships.

Stuck?