There are two ways in. Most people use the release images: flash once with SP Flash Tool, copy one file from Innioasis's own firmware package onto the player, done. After that every update comes over Wi-Fi. Developers can also build everything from source and flash their own personalized package (with their SSH key).
Read the whole page once before you start.
- A computer (Windows or Linux) and a USB cable.
- SP Flash Tool v5.2032, MediaTek's flashing program, with its bundled
MTK_AllInOne_DA.bin. - The Y2Linux release: the
…-first-install.zipof the newest GitHub release (1.0 Beta 1 or later). - The Innioasis firmware package for the Y2, v3.2.0 (
y2_v3.2.0_FM-20260813), from Innioasis's download page, or the same build asrom_y2.zipfrom the y1-community stock ROM release 3.2.0-fm (checked 2026-10-19: identical scatter file, boot image and LK, and itssystem.imgpasses the player's radio firmware check; it is stored unpacked, about 860 MB instead of 520 MB). You need it once, for the radio firmware, and it is also your way back to stock, so keep it. Only this version works: the player checks every radio file against its SHA-256, so a newer or older Innioasis package is refused until Y2Linux knows its files (issue tracker if yours differs).
The Y2's Wi-Fi and Bluetooth chip needs five small programs from MediaTek (the Wi-Fi RAM
code, two Bluetooth patches, the modem image used for radio calibration and a chip
configuration). They are MediaTek's property and may not be redistributed, so no Y2Linux
image contains them. Every Y2 owner already has them: they are inside system.img of the
official Innioasis package. The player reads them out of that file itself, checks each one
against its known SHA-256 and keeps only those five files (plus two small board defaults it
derives). Nothing is downloaded, and your device's own calibration and MAC addresses are
never touched (they stay in the NVRAM partition).
| Partition (stock name) | First install | Later updates |
|---|---|---|
| BOOTIMG | Y2Linux kernel + rescue system | replaced by each update |
ANDROID (/system) |
Y2Linux system (no radio firmware) | replaced by each update |
USRDATA (/data) |
Y2Linux data: settings, library, logs, the radio firmware | kept |
| RECOVERY | the Y2 recovery image, which installs updates (why) | replaced by each update |
| FAT (the player's own storage) | becomes Internal Storage at the first start; your files on it are kept or wait for you (Storage) | kept |
| Preloader, LK, NVRAM, calibration, PROTECT, SECCFG, tables | never written | never written |
Stock Android and its user data are erased. The player's own storage is not flashed: at the
first start Y2Linux turns it into Internal Storage, keeping up to about 400 MB of your files in
Old Player Files and leaving a larger library untouched until you decide
(Storage). Copying anything you want to keep to a computer first is still wise.
-
Download the Y2Linux release zip and unpack it. Check it if you like:
sha256sum -c SHA256SUMSin the unpacked folder. -
Download the Innioasis firmware package and unpack it.
-
Open SP Flash Tool and choose the Download tab, Download Only. Never use Format All + Download, Firmware Upgrade or Write Memory. Load
MT6582_Android_scatter.txtfrom the Y2Linux release (not the stock one). Exactly these four rows are ticked and point at the release files:Row File BOOTIMG BOOTIMG.imgRECOVERY RECOVERY.imgANDROID Y2ROOT.imgUSRDATA Y2DATA.imgEvery other row must be unticked. Stop if the tool asks to format, reports a partition-table (PMT) change, or shows different addresses.
-
Click Download, then connect the switched-off Y2 by USB. After about a minute SP Flash Tool shows a green tick ("Download OK").
-
Unplug and press Power. On the first start the player shows Setting up storage for a few seconds: the player's old Innioasis storage becomes Internal Storage (5.4 GB for music; see Internal Storage for what happens to files that were on it). Then Reborn starts, and music works. Wi-Fi and Bluetooth say they still need the radio firmware.
-
Restart the player once (hold Power and pick Restart in the Quick Menu; on Beta 9.3.14 and older, hold Power until it turns off, then press Power again), so Internal Storage gets its full space.
-
Connect the Y2 to the computer again. It appears like a USB stick (MTP) with Internal Storage (and SD Card if a card is in). Internal Storage contains a folder Firmware.
-
From the firmware package, copy the file
system.imginto that Firmware folder (about 520 MB from Innioasis's zip, about 860 MB from the communityrom_y2.zip). Copy, don't move: the player deletes its copy afterwards, and you need the original to go back to stock. (If it was moved, unpack it again from the zip.) -
Wait a few seconds. The player checks the file, keeps the five radio files, deletes the big copy and starts Wi-Fi and Bluetooth; Reborn says Wi-Fi and Bluetooth are ready. The Firmware folder disappears. That's it.
If Reborn says That File Isn't the Y2 Firmware, the file was not system.img of the v3.2.0
package: delete it and copy the right one. The file can also go into a folder named Firmware
on the SD card. On a player whose Internal Storage is not set up yet (a large old library, see
below) the computer shows a separate Firmware drive instead; it has room for the file from
Innioasis's zip, but not for an unpacked copy (about 860 MB, as in the community rom_y2.zip):
Reborn then says Not Enough Space for That File, and the SD card's Firmware folder is the way.
From now on, updates come over Wi-Fi: Settings → System → Software Update → Check for Updates → Update Now (Beta 7.1 and later; on Beta 7 and earlier: Download Update → Restart and Install). The radio firmware stays on the player and is kept across every update. How that works: Recovery and updates.
The first boot creates the data folders, so it takes a little longer than later boots. If it stops in the rescue screen, the screen shows the reason (for example, the root or data partition was not found). Turn the player off with a long Power press and check the flashed rows. Nothing is written automatically in rescue.
If the screen says Couldn't Start, the player itself started but Reborn did not. From the
release after Beta 8.35 the player then saves an error report: connect it to a computer and
send the file from Internal Storage (or the SD card) → Error Reports with your
issue. It holds the reason Reborn failed.
The release's data image contains no SSH key, so nobody can log in. To use SSH, build a
personalized data image with your own Ed25519 public key and flash it to USRDATA instead of the
release's Y2DATA.img (or build the whole package yourself, see BUILDING):
python3 tools/production/first_owner.py --helpWith the player running and plugged in, it shows up as a USB Ethernet adapter (plus MTP).
The device is 10.42.0.1. Give your computer's new interface 10.42.0.2/24 with no gateway:
ip -br link # find the new interface (e.g. enp…u2i1 or usb0)
sudo ip address add 10.42.0.2/24 dev <interface>
ssh -i ~/.ssh/y2linux_ed25519 root@10.42.0.1Login is key-only. Useful commands on the device:
y2-status system --json # identity, health summary
y2-platform status # platform services
y2-platform firmware status # radio firmware: Ready, Missing, Installing or Failed
y2-platform firmware install /path/to/system.img # the same as the Firmware drive
cat /etc/y2linux/versions.json- MTP: the player appears in any MTP client with Internal Storage and SD Card. Copy music there.
- SD card: FAT, exFAT and ext4 cards mount at
/media/sd.y2-media statusshows the card;y2-media format --confirm-cid <CID>reformats it as ext4 (it erases the card).
The full explanation for users is Storage. Every player has the same layout: system (Y2ROOT), settings and library (Y2DATA) and
Internal Storage (Y2MEDIA, 5.4 GiB ext4, /media/internal). Internal Storage replaces the
stock player's own storage partition. Since Beta 7.9 the player sets it up by itself at start
(also on players updated from an earlier beta, at the first restart after the update):
| The old Innioasis storage holds | What happens |
|---|---|
| nothing, or only leftovers (empty folders, thumbnail caches) | set up at once |
| your files, up to about 400 MB | they are kept: afterwards they are in Internal Storage → Old Player Files |
| more (a real music library) | nothing changes. Reborn asks once; over USB the old files show up read-only as Old Storage so you can copy them to a computer. Settings → Storage → Set Up Internal Storage then sets it up and erases them |
It waits for a later start while an update is still being checked or the battery is low. Every step is recorded, so a power loss in the middle continues at the next start.
y2-platform internal-media status # layout, filesystem, mount
cat /run/y2/internal-media-setup.json # what the setup did at this startOver Wi-Fi (recommended): Settings → System → Software Update → Check for Updates → Update Now. Use the charger or at least half a battery (the player says so before it downloads anything). One screen shows Download, Check and Install; Cancel stops the download. The player then restarts, installs (about a minute), restarts into the new version and confirms it; on any failure it restores the previous one. (Beta 7 and earlier: Download Update → Restart and Install.) Details: Recovery and updates.
With a computer: flash a newer release or your own package with
MT6582_preserve_data_scatter.txt. Only BOOTIMG and ANDROID are ticked; never
tick USRDATA, which would wipe your settings, library and the radio firmware.
- Dark screen at start (rare). If the panel stays dark, hold Power for 10 s and start again.
- USB networking after deep sleep. After a wake the USB connection can enumerate but pass no traffic. Power off and on to recover.
- More, with evidence: current platform state.
In SP Flash Tool, Download Only, load the stock MT6582_Android_scatter.txt, untick
everything, then tick only BOOTIMG → boot.img, RECOVERY → recovery.img, ANDROID →
system.img, USRDATA → userdata.img. This restores factory Android (not your old personal
data) and erases Y2Linux and its data. Never tick PRELOADER, UBOOT/LK, MBR/EBR, NVRAM, PROTECT
or SECCFG.
It does not restore the old FAT format of the player's storage (the stock package has no image for it, and stock Android cannot read Internal Storage): copy your music to a computer first; stock Android then has to format that storage (Storage).
This full restore has not yet been tested by the project. The partitions it writes are the same ones the install wrote, and the bootloaders are never changed. The detailed procedure and its caveats: production recovery.