Од заборавен ТВ бокс до ретро конзолаFrom a forgotten TV box to a retro console

· 15 мин. читање15 min read

Обожавам да му наоѓам примена на „стар“ хардвер и да го враќам во живот, па еве го патот од стар ТВ бокс до ретро конзола. Имав еден стар Nexbox A95X-B7N што собираше прашина во фиока; сега влече NES, SNES и PlayStation игри на телевизор.

I love finding a use for “old” hardware and bringing it back to life, so here's the road from an old TV box to a retro console. I had an old Nexbox A95X-B7N collecting dust in a drawer; now it runs NES, SNES and PlayStation games on the TV.

„Рекуарементс“: мал дел од викендот, стар ТВ бокс и microSD или SD картичка (или USB стик, ако боксот нема слот за картичка). Андроидот на боксот останува недопрен: со картичката внатре бутира EmuELEC, без неа — Андроид, како порано.

Requirements: a small chunk of a weekend, an old TV box, and a microSD or SD card (or a USB stick if the box has no card slot). Android on the box stays untouched: with the card in, it boots EmuELEC; without it, Android as before.

Ова е целиот процес по ред, заедно со тоа што се скрши успат и како го поправив, за да ги прескокнеш моите грешки.

This is the whole build in order, including what broke along the way and how I fixed it, so you can skip my mistakes.

Резултатот: EmuELEC со темата Neon Overdrive и PlayStation игри со корици и слики. 20 секунди, без звук.The result: EmuELEC with the Neon Overdrive theme and PlayStation games with box art and screenshots. 20 seconds, no sound.

Што ти треба навистинаWhat you actually need

Оди ли со било кој ТВ бокс? Не баш. EmuELEC оди на Amlogic S905X, S905X2, S905X3 и S922X (и нивни варијанти, на пр. S905W). Обичниот S905 (без X) повеќе не оди, S912 е исфрлен од 4.0 (за него остана 3.9), а боксовите со Rockchip или Allwinner чип не се поддржани. Некои (MeCool, Mi Box) имаат заклучен bootloader, а евтините клонови знаат да имаат лажен RAM или да бутираат само од USB. Земи бокс со барем 2 GB RAM. Целата листа е на EmuELEC wiki.

Does any TV box work? Not quite. EmuELEC runs on Amlogic S905X, S905X2, S905X3 and S922X (and their variants, like the S905W). The plain S905 (no X) no longer works, the S912 was dropped in 4.0 (3.9 still supports it), and boxes with Rockchip or Allwinner chips aren't supported. Some (MeCool, Mi Box) have a locked bootloader, and cheap clones can come with fake RAM or boot only from USB. Get a box with at least 2 GB RAM. The full list is on the EmuELEC wiki.

Боксот не е Amlogic? Не се откажувај. Lakka е најблиску до EmuELEC: исто бутира директно во игри, само наместо EmulationStation го користи менито на RetroArch (разликите, види подолу). Има слики и за неколку Allwinner и Rockchip боксови (Tanix TX6, Beelink A1, Hugsun X99). За RK3318/RK3328 боксовите има Armbian, па RetroArch над него, ама тоа е повеќе чепкање. А ако не сакаш ништо да флешираш, RetroArch за Андроид оди на секој Андроид бокс, директно од Андроидот.

Box isn't Amlogic? Don't give up. Lakka is the closest thing to EmuELEC: it also boots straight into games, just with RetroArch's menu instead of EmulationStation (the differences: see below). It has images for a few Allwinner and Rockchip boxes (Tanix TX6, Beelink A1, Hugsun X99). RK3318/RK3328 boxes have Armbian, with RetroArch on top, but that's more tinkering. And if you don't want to flash anything, RetroArch for Android runs on any Android box, straight from Android.

Top view of a desk with the A95X box, its remote, a microSD card in an adapter, a USB card reader, screwdrivers and spare RAM sticks.
Сè на масата: боксот со далечинскиот, картичката од 32 GB со адаптер и USB читачот.Everything on the desk: the box and its remote, the 32 GB card with its adapter, and the USB card reader.

Запознај го боксотKnow your box

Прво, сврти го боксот и види со што располагаш. Етикетата одоздола ги кажува двете работи што ќе ти требаат подоцна: чипот и RAM-от. Кај мене: Amlogic S905X и 2 GB RAM.

First, flip the box over and see what you're working with. The label on the bottom tells you the two things you'll need later: the chip and the RAM. Mine: Amlogic S905X and 2 GB RAM.

Чипот кажува кои игри ќе ги влече. S905X е отприлика колку Raspberry Pi 3: сè до првиот PlayStation оди без проблем, N64 некогаш оди, некогаш не, а PSP, Dreamcast и сè поново е претешко.

The chip decides which games it can handle. The S905X is roughly Raspberry Pi 3 class: everything up to the original PlayStation runs fine, N64 is hit and miss, and PSP, Dreamcast and anything newer are too heavy.

RAM-от запомни го: од него зависи кој фајл ќе го избереш во чекор 4.

Remember the RAM: it decides which file you pick in step 4.

Симни EmuELECDownload EmuELEC

EmuELEC е мал оперативен систем (Линукс) што наместо десктоп бутира директно во мени со игри, EmulationStation. Самите игри ги вртат емулатори, програми што се преправаат дека се стара конзола; главниот е RetroArch.

EmuELEC is a small operating system (Linux) that boots straight into a game menu, EmulationStation, instead of a desktop. The games themselves run in emulators, programs that pretend to be an old console; the main one is RetroArch.

Зошто EmuELEC, а не Lakka?Why EmuELEC and not Lakka?

Lakka оди и на Amlogic боксови. Еве ги разликите што се битни за почетник:

Lakka runs on Amlogic boxes too. Here are the differences that matter for a beginner:

Ајде да ја симнеме. Оди на GitHub, кај верзиите, и земи ја најновата. Јас ја зедов 4.8 (3 ноември 2025).

Let's get it. Head to the releases on GitHub and grab the latest. I went with 4.8 (3 November 2025).

Таму ќе видиш куп фајлови (сликата подолу). Не паничи, ти треба само еден: Generic, EmuELEC-Amlogic-ng.aarch64-4.8-Generic.img.gz (1,13 GB). Тој е за ТВ боксови; другите се за конкретни плочи (La Frite, Le Potato, Odroid).

You'll see a pile of files there (screenshot below). Don't panic, you only need one: Generic, EmuELEC-Amlogic-ng.aarch64-4.8-Generic.img.gz (1.13 GB). That's the one for TV boxes; the rest are for specific boards (La Frite, Le Potato, Odroid).

До секој фајл има и .sha256. Не е задолжително, ама ако сакаш да бидеш сигурен дека симнувањето е цело, симни го и него и спореди ги хашовите. Ако се разликуваат, симни пак.

Each file also has a .sha256 next to it. Optional, but if you want to be sure the download isn't broken, grab it too and compare the hashes. If they differ, download again.

Провери го симнатиот фајлCheck the download
sha256sum EmuELEC-Amlogic-ng.aarch64-4.8-Generic.img.gz
cat EmuELEC-Amlogic-ng.aarch64-4.8-Generic.img.gz.sha256
GitHub release page for EmuELEC v4.8 listing image files for Generic, LaFrite, LePotato, Odroid C4 and HC4, each with a sha256 file.
Фајловите од верзијата 4.8 на GitHub.The 4.8 release files on GitHub.

Флеширај ја картичкатаFlash the card

Флеширање значи да го запишеш системот на картичката. Јас користев balenaEtcher (бесплатен е): Flash from file → симнатиот .img.gz (не го отпакувај, Etcher сам се снаоѓа) → Select target → картичката → Flash! Внимавај што бираш како цел: Etcher го брише целиот диск, па ако избереш погрешен, збогум фајлови.

Flashing means writing the system onto the card. I used balenaEtcher (it's free): Flash from file → the .img.gz you downloaded (don't unzip it, Etcher handles that) → Select target → the card → Flash! Watch what you pick as the target: Etcher wipes the whole disk, so pick the wrong one and say goodbye to your files.

Мојот компјутер нема SD слот, па картичката ја ставив во адаптер, адаптерот во USB читач, а читачот во компјутерот (сликите подолу). Ако твојот има слот, ова не ти треба: само стави ја картичката.

My PC has no SD slot, so the card went into an adapter, the adapter into a USB reader, and the reader into the PC (photos below). If yours has a slot, skip all that and just put the card in.

balenaEtcher window: the EmuELEC Generic image (2.19 GB) as the source, a 31.3 GB storage device as the target, and the Flash button.
Etcher со избран image и картичката од 31,3 GB.Etcher with the image and the 31.3 GB card selected.

Само за Линукс луѓе: наместо Etcher, може и од терминал. Најди ја картичката со lsblk и замени го /dev/sdX; погрешна буква брише погрешен диск.

Linux folks only: instead of Etcher you can use a terminal. Find your card with lsblk and replace /dev/sdX; the wrong letter wipes the wrong disk.

Флеширање од терминалFlashing from a terminal
lsblk
gzip -dc EmuELEC-Amlogic-ng.aarch64-4.8-Generic.img.gz | sudo dd of=/dev/sdX bs=4M conv=fsync status=progress

Избери device treePick the device tree

Кога Etcher ќе заврши, извади ја картичката и врати ја во компјутерот. Ќе се појави диск EMUELEC. Ако Windows те праша дали да форматира некој диск, кажи не: тоа е дел од картичката што Windows не го разбира, не е расипан. На EMUELEC има папка device_trees. Device tree (dtb) е мал фајл што му кажува на системот каков хардвер има во боксот, затоа ти требаше RAM-от од етикетата. Најди го вистинскиот, копирај го надвор од папката (во главниот дел на дискот) и преименувај го во dtb.img. За S905X со 2 GB RAM тоа е gxl_p212_2g.dtb; со 1 GB, gxl_p212_1g.dtb.

When Etcher is done, pull the card out and put it back in. A disk called EMUELEC shows up. If Windows asks to format a disk, say no: that's a part of the card Windows doesn't understand, not a broken one. On EMUELEC there's a device_trees folder. A device tree (dtb) is a small file that tells the system what hardware is inside the box, which is why you needed the RAM from the label. Find the right one, copy it out of the folder (to the top level of the disk) and rename it to dtb.img. For an S905X with 2 GB RAM that's gxl_p212_2g.dtb; with 1 GB, gxl_p212_1g.dtb.

Кој фајл за кој бокс? Побарај го моделот на листата на CoreELEC (EmuELEC ги користи истите имиња) или на форумот на EmuELEC. Ако го нема, оди по чипот и RAM-от од етикетата: името почнува со фамилијата на чипот (gxl е S905X/W/L, g12a е S905X2, sm1 е S905X3, g12b е S922X), а RAM-от е во името (_1g, _2g, _4g). Мојот A95X-B7N го нема на листата, па одев по чип. Ако не бутира, пробај друг: dtb е само фајл на картичката, ништо не се расипува.

Which file for which box? Look up your model on CoreELEC's list (EmuELEC uses the same names) or on the EmuELEC forum. If it isn't there, go by the chip and RAM from the label: the name starts with the chip family (gxl is S905X/W/L, g12a is S905X2, sm1 is S905X3, g12b is S922X), and the RAM is in the name (_1g, _2g, _4g). My A95X-B7N isn't on the list, so I went by the chip. If it doesn't boot, try another: the dtb is just a file on the card, nothing breaks.

Или од терминал, на Линукс (на Ubuntu патеката е /media/$USER/EMUELEC)Or from a terminal, on Linux (on Ubuntu the path is /media/$USER/EMUELEC)
cd /run/media/$USER/EMUELEC
cp device_trees/gxl_p212_2g.dtb dtb.img
sync
File manager showing the EMUELEC partition right after flashing: aml_autoscript, cfgload, config.ini, device_trees, kernel.img, SYSTEM and their md5 files. The same partition with dtb.img added next to device_trees.
Пред и потоа: dtb.img е единствениот нов фајл.Before and after: dtb.img is the only new file.

Бутирање од картичка: чачкалкатаBoot from the card: the toothpick

Сега треба боксот да пали од картичката наместо од Андроид. Тука влегува чачкалката: Amlogic боксовите имаат скриено копче длабоко во AV приклучокот (малата дупка за стариот аналоген кабел). Ако го држиш додека боксот се пали, боксот ја чита картичката и запамтува отсега прво од неа да пали.

Now the box needs to start from the card instead of Android. This is where the toothpick comes in: Amlogic boxes hide a button deep inside the AV jack (the small hole for the old analogue cable). Hold it while the box powers on, and the box reads the card and remembers to start from it first from now on.

  1. Исклучи го напојувањето и стави ја картичката во TF слотот.
  2. Турни чачкалка во AV приклучокот додека не почувствуваш клик и држи.
  3. Приклучи го напојувањето. Држи додека не се појави логото на EmuELEC, па пушти.
  1. Unplug the power and put the card in the TF slot.
  2. Push a toothpick into the AV jack until you feel a click, and keep holding.
  3. Plug the power in. Keep holding until the EmuELEC logo appears, then let go.

Ова се прави само еднаш. Потоа боксот бутира EmuELEC секогаш кога картичката е внатре, а Андроид кога ја нема.

You only do this once. After that the box boots EmuELEC whenever the card is in, and Android when it isn't.

Првиот обид не ми успеа. Наместо EmuELEC се подигна Андроид и тивко направи папки Android/ и LOST.DIR/ на картичката. Не е штетно, само значи дека боксот не го почувствува копчето. Пробај пак и држи подолго.

My first try didn't take. Android booted instead and quietly created Android/ and LOST.DIR/ folders on the card. That's harmless, it just means the box never felt the button. Try again and hold it longer.

The EMUELEC partition now also containing Android and LOST.DIR folders.
Android/ и LOST.DIR/ на партицијата EMUELEC: знак дека се подигнал Андроид, а не EmuELEC.Android/ and LOST.DIR/ on the EMUELEC partition: a sign that Android booted, not EmuELEC.

Првото бутирање: не допирајFirst boot: hands off

При првото палење EmuELEC се подесува сам: ја зафаќа целата картичка и си ги копира почетните подесувања. Не гаси ја струјата додека трае, ни случајно.

On the first start EmuELEC sets itself up: it grows to fill the whole card and copies its default settings. Don't cut the power while it runs, not even by accident.

Кај мене токму тука нешто пукна. Екранот се наполни со бел текст, грешка од системот, додека тој сè уште копираше фајлови. Боксот сепак стигна до менито, ама копирањето остана преполовено. Тоа го сфатив дури подоцна (следниот чекор).

Mine broke right there. The screen filled with white text, a system error, while it was still copying files. The box still made it to the menu, but the copy was left half done. I only figured that out later (next step).

Monitor full of white kernel log text: register dumps and a call trace, ending with a systemd line saying userconfig.service is still starting. EmuELEC splash screen with a kernel oops printed over it: Internal error, Comm: cp, Unhandled fault: synchronous external abort.
Првото палење: екран полн со грешки (горе) и грешка врз логото на EmuELEC (долу). Изгледа страшно, а значи само дека копирањето не завршило.First start: a screen full of errors (top) and an error over the EmuELEC logo (bottom). Looks scary, but it only means the copy didn't finish.

Ако првото бутирање падне, најевтино решение е повторно да ја флешираш картичката и да бутираш пак. Јас не го направив тоа и потрошив цела вечер барајќи ја штетата рачно.

If the first boot crashes, the cheapest fix is to flash the card again and boot again. I didn't, and spent an evening finding the damage by hand.

Тастатурата не работи, менијата скршениDead keyboard, broken menus

EmuELEC се подигна, ама немаше екран за подесување на копчињата („држи копче за да го подесиш“), тастатурата ништо не правеше, а менијата изгледаа скршено. Пробав да го избришам фајлот со копчињата, не помогна. Се покажа дека се два различни проблеми.

EmuELEC came up, but there was no screen for setting up the buttons (“hold a button to configure”), the keyboard did nothing, and the menus looked broken. I tried deleting the button config file, no luck. Turned out it was two separate problems.

Проблем 1: 758 празни фајловиProblem 1: 758 empty files

Падот при првото палење остави 758 празни фајлови: графика, фонтови и звуци од менијата. Затоа менијата изгледаа скршено.

The crash on the first start left 758 empty files behind: menu graphics, fonts and sounds. That's why the menus looked broken.

Решение за сите: флеширај ја картичката пак (Etcher, како погоре), стави го dtb.img пак и пушти го првото палење да заврши. Готово.

The fix for everyone: flash the card again (Etcher, like above), put dtb.img back and let the first start finish. Done.

За љубопитните: како го поправив без флеширање (Линукс, терминал)For the curious: how I fixed it without reflashing (Linux, terminal)

Со картичката назад во компјутерот, 803 од 6.483 фајлови на STORAGE имаа 0 бајти. 45 од нив се празни и во оригиналот. Другите 758 беа штета:

With the card back in the PC, 803 of the 6,483 files on STORAGE were 0 bytes. 45 of them are empty in the original too. The other 758 were damage:

Празни фајлови во .config/emulationstationEmpty files under .config/emulationstation
ПапкаFolderШто имаWhat's in itПразниEmpty
themesстандардната тема Crystalthe default Crystal theme605
resourcesграфика за менијата, фонтови, XMLmenu graphics, fonts, XML144
scriptsвклучително скриптите за копчињатаincluding the input config scripts9

Логот на EmulationStation (es_log.txt во истата папка) го кажува истото:

EmulationStation's log (es_log.txt in the same folder) says the same thing:

es_log.txt
Error parsing XML file ".../resources/genres.xml"! No document element found
Could not initialize texture from memory, invalid data! (file path: :/frame.png …)
Error loading sound ".../mscroll.ogg"

Ако сакаш да провериш дали и твојата картичка настрада, изброј ги празните фајлови:

To check whether your card got hit too, count the empty files:

Изброј ги празните фајловиCount empty files
sudo find /run/media/$USER/STORAGE/.config/emulationstation -type f -size 0 | wc -l

За поправката не треба ништо од интернет: SYSTEM е squashfs image (компресиран архив) во кој се оригиналните фајлови под /usr/config. Извади ги со unsquashfs (пакетот squashfs-tools), па врати го секој фајл што се разликува:

The repair needs nothing from the internet: SYSTEM is a squashfs image (a compressed archive) that holds the original files under /usr/config. Extract them with unsquashfs (from squashfs-tools), then copy back every file that differs:

Извади ги оригиналите од SYSTEMExtract the originals from SYSTEM
unsquashfs -d /tmp/eesys /run/media/$USER/EMUELEC/SYSTEM usr/config/emulationstation
restore.sh (sudo bash restore.sh)
#!/bin/bash
# Restore files truncated to 0 bytes, using the originals from the card's own SYSTEM image.
# Writes contents in place, so owner and permissions stay as they were.
set -euo pipefail
S="/run/media/${SUDO_USER:-$USER}/STORAGE/.config/emulationstation"
P=/tmp/eesys/usr/config/emulationstation
fixed=0
cd "$P"
while IFS= read -r -d '' f; do
  if ! cmp -s "$f" "$S/$f"; then
    if [ -e "$S/$f" ]; then cat "$f" > "$S/$f"; else install -D -m 644 "$f" "$S/$f"; fi
    fixed=$((fixed+1))
  fi
done < <(find resources themes scripts -type f -print0)
sync
echo "restored $fixed files"
echo "empty files left: $(find "$S" -type f -size 0 | wc -l)"

STORAGE е Линукс партиција (ext4) и фајловите се на root, затоа sudo. На мојата картичка: restored 758 files, empty files left: 0.

STORAGE is a Linux partition (ext4) and the files belong to root, hence sudo. On my card: restored 758 files, empty files left: 0.

Проблем 2: тастатурата не прави ништо, намерноProblem 2: the keyboard does nothing, by design

Ова не е баг, така е направено: EmuELEC никогаш сам не го отвора екранот за подесување копчиња, а за тастатурата гледа само во еден фајл, es_input.cfg. Ако тој фајл е празен или го нема, тастатурата не прави ништо. Затоа џојстик е подобар избор: пробај прво со него.

This one isn't a bug, it's by design: EmuELEC never opens the button setup screen on its own, and for the keyboard it only looks at one file, es_input.cfg. If that file is empty or missing, the keyboard does nothing. That's why a gamepad is the better pick: try it first.

Ако мора тастатура, копчињата ги допишуваш сам во тој фајл. Тој е на STORAGE делот од картичката (.config/emulationstation/es_input.cfg), а тоа е Линукс партиција: Windows и macOS не ја гледаат без посебна програма, а на Линукс треба sudo. Отвори го фајлот и залепи го блокот подолу пред </inputList>. Бројките се кодовите на копчињата, не мораш да ги разбираш, само копирај.

If it has to be a keyboard, you add the keys to that file yourself. It lives on the card's STORAGE part (.config/emulationstation/es_input.cfg), which is a Linux partition: Windows and macOS can't see it without extra software, and on Linux you need sudo. Open the file and paste the block below just before </inputList>. The numbers are key codes; you don't need to understand them, just copy.

Мојата прва верзија (сликата) користеше Enter за A и Space за Start. Во менијата работеше, ама во игрите RetroArch си има свои копчиња, па истото копче правеше различни работи. Затоа верзијата подолу ги користи истите копчиња како RetroArch.

My first version (screenshot) used Enter for A and Space for Start. It worked in the menus, but in games RetroArch has its own keys, so the same key did different things. That's why the version below uses the same keys as RetroArch.

Editor showing the keyboard inputConfig block at the end of es_input.cfg, with key ids for up, down, left, right, a, b, x, y, start, select and hotkey.
Верзија 1, напишана рачно. Работеше, но Enter значеше A во менијата, а Start во игрите.Version 1, written by hand. It worked, but Enter meant A in the menus and Start in games.
es_input.cfg
<inputConfig type="keyboard" deviceName="Keyboard" deviceGUID="-1">
  <input name="up" type="key" id="1073741906" value="1" />
  <input name="down" type="key" id="1073741905" value="1" />
  <input name="left" type="key" id="1073741904" value="1" />
  <input name="right" type="key" id="1073741903" value="1" />
  <input name="a" type="key" id="120" value="1" />             <!-- X -->
  <input name="b" type="key" id="122" value="1" />             <!-- Z -->
  <input name="x" type="key" id="115" value="1" />             <!-- S -->
  <input name="y" type="key" id="97" value="1" />              <!-- A -->
  <input name="start" type="key" id="13" value="1" />          <!-- Enter -->
  <input name="select" type="key" id="1073742053" value="1" /> <!-- Right Shift -->
  <input name="leftshoulder" type="key" id="113" value="1" />  <!-- Q -->
  <input name="rightshoulder" type="key" id="119" value="1" /> <!-- W -->
  <input name="lefttrigger" type="key" id="49" value="1" />    <!-- 1 -->
  <input name="righttrigger" type="key" id="50" value="1" />   <!-- 2 -->
  <input name="leftthumb" type="key" id="99" value="1" />      <!-- C -->
  <input name="rightthumb" type="key" id="118" value="1" />    <!-- V -->
  <input name="hotkeyenable" type="key" id="1073742053" value="1" />
</inputConfig>

Во игрите RetroArch веќе ги користи истите копчиња. Ако ти требаат и L2, R2, L3 и R3 (задните копчиња и притисок на палките), додај ги во STORAGE/.config/retroarch/retroarch.cfg:

In games RetroArch already uses the same keys. If you also want L2, R2, L3 and R3 (the back triggers and stick clicks), add them to STORAGE/.config/retroarch/retroarch.cfg:

retroarch.cfg
input_player1_l2 = "num1"
input_player1_r2 = "num2"
input_player1_l3 = "c"
input_player1_r3 = "v"
Распоред на тастатуратаKeyboard layout
КопчеKeyКопче на џојстикPad buttonВо менијатаIn menus
СтрелкиArrowsD-padдвижењеmove
XAпотврдиconfirm
ZBназадback
SXзависи од екранотdepends on the screen
AYомилена играfavourite
EnterStartглавно мениmain menu
Right ShiftSelect + hotkeyопцииoptions
Q / WL / Rсмени системchange system
1 / 2L2 / R2скокни по букваjump by letter
C / VL3 / R3—
Копчиња во игра (стандардни во RetroArch)In-game keys (RetroArch defaults)
КопчеKeyШто правиAction
Escизлез од игратаquit the game
F1мени на RetroArchRetroArch menu
F2 / F4зачувај / вчитај состојбаsave / load state
F6 / F7смени слот за зачувувањеchange save slot
Spaceзабрзувањеfast-forward
Pпаузаpause
Hрестартreset
F8слика од екранотscreenshot
F9без звукmute

Ако некое не работи, држи десен Shift (hotkey) и притисни го пак.

If one of them does nothing, hold Right Shift (the hotkey) and press it again.

Што има на картичкатаWhat's on the card

По првото палење картичката е поделена на три дела (партиции), и компјутерот ги гледа како три посебни диска. Битни ти се два. EEROMS е за игрите и се гледа насекаде (Windows, macOS, Линукс), само што не прима фајл поголем од 4 GB. STORAGE е за подесувањата и е Линукс партиција: Windows и macOS не ја гледаат без посебна програма, а на Линукс за измени треба sudo.

After the first start the card is split into three parts (partitions), and your PC sees them as three separate disks. Two of them matter. EEROMS is for games and shows up everywhere (Windows, macOS, Linux), it just won't take a single file over 4 GB. STORAGE is for settings and is a Linux partition: Windows and macOS can't see it without extra software, and on Linux edits need sudo.

Мојата картичка од 32 GB по првото бутирањеMy 32 GB card after the first boot
ПартицијаPartitionГолеминаSizeТипTypeСодржинаContents
EMUELEC2 GBFAT32 (се гледа насекаде)FAT32 (visible everywhere)самиот систем, dtb.img, фајлови за палењеthe system itself, dtb.img, startup files
STORAGE6 GBext4 (само Линукс)ext4 (Linux only)подесувања, теми, скриптиsettings, themes, scripts
EEROMS21,1 GB21.1 GBFAT32 (се гледа насекаде)FAT32 (visible everywhere)игри, bios, BGM (музика), savestates (зачувувања)games, bios, BGM (music), savestates (saves)
File manager showing the EEROMS partition with folders such as 3do, amiga, arcade, atari2600, bezels, BGM, bios, c64, cps1 and downloads.
EEROMS: по една папка за секој систем, плус bios, BGM (музика), savestates и screenshots.EEROMS: one folder per system, plus bios, BGM (music), savestates and screenshots.

Игри, BIOS и форматиGames, BIOS and formats

ROM-ови, накраткоROMs, briefly

ROM е игра во фајл: копија од касетата, или од дискот кај PlayStation. Емулаторот (во RetroArch се вика „core“) се преправа дека е конзолата и ја пушта. EmulationStation е само менито од кое ја избираш.

A ROM is a game in a file: a copy of the cartridge, or of the disc for PlayStation. The emulator (RetroArch calls it a “core”) pretends to be the console and runs it. EmulationStation is just the menu you pick it from.

Играј само игри што ги поседуваш: извади ги од своите касети и дискови, или играј homebrew и бесплатни игри. На itch.io, PDRoms и во NESdev заедницата ги има многу, а ScummVM има бесплатни авантуристички игри. Нема да ставам линкови до ROM сајтови.

Only play games you own: dump your own cartridges and discs, or play homebrew and freeware. itch.io, PDRoms and the NESdev community have plenty, and ScummVM has free adventure games. I won't link ROM sites.

Еден добар фајл по играOne good file per game

Колекциите со игри често имаат по пет верзии од истата игра. Од името се гледа која е која. Моите правила:

Game collections often have five versions of the same game. The name tells you which is which. My rules:

Ова се прави рачно: од секоја игра остави еден фајл, другите избриши ги. Не е задолжително, ама листата е многу почиста без пет верзии од истата игра.

You do this by hand: keep one file per game and delete the rest. It's optional, but the list is much cleaner without five versions of the same game.

PlayStation: CHD (не е задолжително)PlayStation: CHD (optional)

PS1 игрите најчесто доаѓаат како BIN/CUE, два фајла по диск, и тоа си работи. Јас ги претворив во CHD, компресиран формат без губење квалитет: 30–50% помал и еден фајл по диск. Не мора: CHD е само за да собере повеќе на картичка од 32 GB. ISO не го препорачувам, ја губи музиката од дискот. Ако одиш на CHD, ти треба програмата chdman од MAME (на Arch е во mame-tools); конвертирај секогаш од .cue, не од .bin:

PS1 games usually come as BIN/CUE, two files per disc, and that works fine. I converted mine to CHD, a compressed format that loses no quality: 30–50% smaller and one file per disc. You don't have to: CHD only fits more games on a 32 GB card. I'd skip ISO, it loses the disc's music. If you go CHD, you need the chdman tool from MAME (on Arch it's in mame-tools); always convert from the .cue, not the .bin:

BIN/CUE во CHDBIN/CUE to CHD
sudo pacman -S mame-tools
for c in *.cue; do chdman createcd -i "$c" -o "${c%.cue}.chd"; done

Игрите со повеќе дискови (Final Fantasy VII има три) добиваат мал текст фајл .m3u со листа на дисковите, за да се појават само еднаш во менито. Направи го во обичен текст едитор. Дискот го менуваш од менито на RetroArch (F1 → Disc Control):

Multi-disc games (Final Fantasy VII has three) get a small .m3u text file listing the discs, so they show up only once in the menu. Make it in any plain text editor. Swap discs from the RetroArch menu (F1 → Disc Control):

EEROMS/psx/Final Fantasy VII (USA).m3u
Final Fantasy VII (USA) (Disc 1).chd
Final Fantasy VII (USA) (Disc 2).chd
Final Fantasy VII (USA) (Disc 3).chd

Имињата на фајловите знаат да лажат. Кај мене три лажеа: „Final Fantasy VII“ се покажа како демото Interactive Sampler од 196 MB (SCUS-94961), „Metal Gear Solid“ беше VR Missions, а „Suikoden II“ беше првиот Suikoden. Ќе ги фатиш кога ќе ги пуштиш, а сомнителна големина е добар знак (FFVII диск од 196 MB?). Опционално, пред копирање провери дека CHD-фајловите се цели:

File names can lie. Three of mine did: a “Final Fantasy VII” turned out to be the 196 MB Interactive Sampler demo (SCUS-94961), “Metal Gear Solid” was VR Missions, and “Suikoden II” was the first Suikoden. You'll catch them when you launch them, and a suspicious size is a good hint (a 196 MB FFVII disc?). Optionally, check the CHDs are intact before copying:

Провери ги CHD-фајловитеVerify the CHDs
for f in *.chd; do echo "$f: $(chdman verify -i "$f" 2>&1 | tail -1)"; done

BIOS

BIOS е мала програма од самата конзола што ја пали и го чита дискот. Емулаторите не смеат да го имаат (авторски права), па го вадиш од својата конзола. За PS1 треба фајл scph5501.bin во папката EEROMS/bios, со мали букви. Ако сакаш да провериш дека е вистинскиот, md5 хашот треба да биде како подолу:

A BIOS is a small program from the console itself that starts it up and reads the disc. Emulators can't include it (copyright), so you dump it from your own console. PS1 needs a file called scph5501.bin in the EEROMS/bios folder, in lowercase. If you want to check it's the right one, its md5 hash should match the one below:

PS1 BIOS на картичката (Линукс; на Windows само копирај и преименувај)PS1 BIOS on the card (Linux; on Windows just copy and rename)
cp SCPH-5501.BIN /run/media/$USER/EEROMS/bios/scph5501.bin
md5sum /run/media/$USER/EEROMS/bios/scph5501.bin
# 490f666e1afb15b7362b406ed1cea246
Други BIOS фајлови, сите во EEROMS/biosOther BIOS files, all in EEROMS/bios
СистемSystemФајлFile
PS1 Јапонија / ЕвропаPS1 Japan / Europescph5500.bin / scph5502.bin
PC Engine CDsyscard3.pce
Famicom Disk Systemdisksys.rom
Neo Geoneogeo.zip
Sega CD (USA)bios_CD_U.bin

Копирање на картичкатаCopying to the card

Копирај ги игрите со фајл менаџерот, како било што друго, секоја во папката на својот систем (EEROMS/psx, EEROMS/snes...). Пред да ја извадиш картичката, секогаш Eject и почекај: SD картичките се бавни и компјутерот запишува уште долго откако копирањето „завршило“.

Copy the games with your file manager like anything else, each into its system's folder (EEROMS/psx, EEROMS/snes...). Before pulling the card, always Eject and wait: SD cards are slow, and the PC keeps writing long after the copy has “finished”.

Ако при вадење пишува „device busy“, а ништо нема отворено, тоа е токму тоа: компјутерот уште запишува гигабајти. Почекај (или пушти sync во терминал) и пробај пак. Еднаш пробав udisksctl power-off; читачот исчезна сè додека не го извадив и вратив. Обичен Eject е доволен.

If ejecting says “device busy” while nothing is open, that's exactly it: the PC is still writing gigabytes. Wait (or run sync in a terminal) and try again. I tried udisksctl power-off once; the reader vanished until I unplugged it and plugged it back in. A plain Eject is enough.

Колку собира 32 GBHow much fits on 32 GB

За игри остануваат околу 22 GB. Игрите од касети се ситни; PS1 дисковите се тие што ја полнат картичката, околу 320 MB секој како CHD. Јас собрав околу 1600 игри, а останаа 3 GB празни.

About 22 GB is left for games. Cartridge games are tiny; PS1 discs are what fill the card, around 320 MB each as CHD. I fit about 1,600 games with 3 GB to spare.

Пример поделба на 22 GBAn example split of 22 GB
ГрупаGroupИгриGamesПросторSpace
NES, SNES, Mega Drive, Game Boy, PC Engine~200500 MB
GBA30400 MB
Аркадни (FBNeo)Arcade (FBNeo)401 GB
N6415400 MB
PS1 (CHD)~3012 GB
Корици и сликиBox art and screenshots—1–2 GB
Слободно за зачувувањаFree for saves—~5 GB

Што оди: сè до PS1 на полна брзина со стандардни подесувања. N64 зависи (Ocarina of Time се игра, со успорувања). PSP, Dreamcast, Saturn, DS, GameCube и поново се претешки за S905X.

What runs: everything up to PS1 at full speed on default settings. N64 is mixed (Ocarina of Time plays, with slowdown). PSP, Dreamcast, Saturn, DS, GameCube and newer are too heavy for the S905X.

Корици и слики од игритеBox art and screenshots

Листа на игри без слики изгледа тажно. Scraping значи симнување корици, слики и описи од ScreenScraper, за што треба бесплатна сметка. Најлесно е од самиот бокс: во главното мени има Scraper, внеси ја сметката, избери системи и пушти.

A game list without pictures looks sad. Scraping means downloading covers, screenshots and descriptions from ScreenScraper, which needs a free account. The easiest way is on the box itself: the main menu has a Scraper, enter your account, pick the systems and start it.

Само прво исклучи ги додатоците во опциите на scraper-от (или во STORAGE/.config/emulationstation/es_settings.cfg). Само видеата се 2–10 MB по игра и брзо ја полнат картичка од 32 GB. „Maps“ тука се мапи на световите направени од фанови, а не мапи во самата игра.

Just turn off the extras first in the scraper options (or in STORAGE/.config/emulationstation/es_settings.cfg). Videos alone are 2–10 MB per game and fill a 32 GB card quickly. “Maps” here are fan-made world maps, not in-game maps.

es_settings.cfg: без видеа и други додатоциes_settings.cfg: no videos or other extras
<bool name="ScrapeBezel" value="false" />
<bool name="ScrapeFanart" value="false" />
<bool name="ScrapeManual" value="false" />
<bool name="ScrapeMap" value="false" />
<bool name="ScrapeVideos" value="false" />
Јас го правев на компјутер, со Skyscraper (Линукс, терминал)I did it on the PC, with Skyscraper (Linux, terminal)

Картичката веќе ми беше во компјутерот, па користев Skyscraper таму:

The card was in my PC anyway, so I used Skyscraper there:

Skyscraper (AUR)
yay -S skyscraper-git

Рецепт за слики: по една корица, една слика од играта и едно лого по игра, без составени слики:

An artwork recipe keeps it to one cover, one screenshot and one logo per game, with no composite images:

~/.skyscraper/artwork-ee.xml
<?xml version="1.0" encoding="UTF-8"?>
<artwork>
  <output type="screenshot" width="480"/>
  <output type="cover" height="400"/>
  <output type="marquee" width="300"/>
</artwork>

Оди во два чекора: прво симнување во кешот на Skyscraper (мрежа), па запишување на gamelist.xml и сликите на картичката (без мрежа):

It runs in two steps: first download into Skyscraper's cache (network), then write gamelist.xml and the images to the card (offline):

Прво кеш, потоа картичкатаCache first, then the card
R=/run/media/$USER/EEROMS/psx
Skyscraper -p psx -s screenscraper -u 'USER:PASSWORD' --flags unattend,nosubdirs -i "$R"
Skyscraper -p psx -f emulationstation -a ~/.skyscraper/artwork-ee.xml -i "$R" -g "$R" -o "$R/media" --flags relative,unattend,nosubdirs
  • -i мора да е апсолутна патека, инаку Skyscraper одбива со relative path which is not valid.
  • Бесплатна ScreenScraper сметка добива една нишка. -t 8 тивко се намалува на 1: околу 7 игри во минута, па стотици игри траат со часови. Не пуштај две одеднаш; серверот одбива и може да те блокира некое време.
  • Без marquee во рецептот, патеките до логата покажуваа кон ~/.skyscraper на компјутерот, што го нема на боксот.
  • Повторното генерирање на gamelist.xml го брише запишаното време на играње (gametime). Прво направи копија.
  • -i must be an absolute path, or Skyscraper refuses with relative path which is not valid.
  • A free ScreenScraper account gets one thread. -t 8 is quietly reduced to 1: about 7 games a minute, so hundreds of games take hours. Don't run two at once; the server refuses and may block you for a while.
  • Without marquee in the recipe, logo paths pointed into ~/.skyscraper on the PC, which doesn't exist on the box.
  • Regenerating gamelist.xml drops the recorded play time (gametime). Back it up first.

Резултат за PS1: 52 од 53 игри пронајдени, 22 MB слики, околу 0,25 MB по игра.

Result for PS1: 52 of 53 games found, 22 MB of images, about 0.25 MB per game.

Подесувања што се битниSettings that matter

Повеќето подесувања ги наоѓаш во менијата (Start → Game Settings, System Settings). Тие се запишуваат во еден фајл, emuelec.conf, на STORAGE во .config/emuelec/configs/, па ако сакаш може и рачно. Во фајлот global.нешто важи за сите системи, а на пр. nes.нешто само за NES.

Most settings are in the menus (Start → Game Settings, System Settings). They're saved to one file, emuelec.conf, on STORAGE under .config/emuelec/configs/, so you can also edit it by hand. In that file global.something applies to every system, and something like nes.something only to NES.

Една замка: не менувај го retroarch.cfg за слика и емулација. EmuELEC го препишува од emuelec.conf секој пат кога пушташ игра, па твоите измени исчезнуваат.

One trap: don't edit retroarch.cfg for picture and emulation settings. EmuELEC rewrites it from emuelec.conf every time you start a game, so your changes vanish.

Мои измени во emuelec.conf (− е старото, + е новото)My changes to emuelec.conf (− is old, + is new)
-system.timezone=America/Mexico_City
+system.timezone=Europe/Skopje
-updates.enabled=1
+updates.enabled=0
+global.shaderset=sharp/sharp-bilinear-simple.glslp
+global.integerscale=0
+global.smooth=0
+global.rewind=0
+global.autosave=1
+nes.runahead=1
-global.retroarchLogging=1
+global.retroarchLogging=0

Веќе точно по стандард: ee_videomode=1080p60hz (чипот не може убаво 4K, а 50 Hz сецка), global.maxperf=1 (процесорот секогаш на полна брзина) и исклучени bezels (рамки околу сликата).

Already right by default: ee_videomode=1080p60hz (the chip can't do 4K well, and 50 Hz judders), global.maxperf=1 (CPU always at full speed) and bezels (frames around the picture) off.

Кои емулатори (cores) би ги користелEmulators (cores) I'd use
СистемSystemCoreЗабелешкаNote
NESFCEUmmстандарден; Nestopia ако некоја игра покажува црн екранthe default; Nestopia if a game shows a black screen
SNESSnes9xSnes9x 2010 ако SuperFX игрите (Star Fox, Yoshi's Island) се бавниSnes9x 2010 if SuperFX games (Star Fox, Yoshi's Island) are slow
PS1PCSX ReARMeddynarec вклучен, внатрешна резолуција 1x, frameskip исклученdynarec on, internal resolution 1x, frameskip off

Телевизор и џојстициTV and controllers

Ова уште не го подесив; ова е планот.

I haven't set these up yet; this is the plan.

Заклучи гоLock it down

Ова е опционално, за параноични како мене. Стандардно EmuELEC има вклучено Samba (споделување фајлови преку мрежа) со лозинка што ја знае цел интернет (root / emuelec), а SSH (далечински пристап со терминал) е едно подесување подалеку. Сакам боксот да може да излезе на интернет (за слики, точно време), ама ништо од мрежата да не може да влезе во него. EmuELEC при палење гледа во STORAGE/.cache/services кои сервиси да ги пушти:

This part is optional, for paranoid people like me. Out of the box EmuELEC runs Samba (file sharing over the network) with a password the whole internet knows (root / emuelec), and SSH (remote terminal access) is one setting away. I want the box to reach the internet (for box art, correct time), but nothing on the network to get into it. On startup EmuELEC checks STORAGE/.cache/services to decide which services to run:

Исклучи ги SSH, Samba и Avahi, вклучи firewallTurn off SSH, Samba and Avahi, turn on the firewall
cd /run/media/$USER/STORAGE/.cache/services
sudo rm -f samba.conf avahi.conf sshd.conf
sudo touch samba.disabled
printf 'RULES=public\n' | sudo tee iptables.conf

RULES=public го пали firewall-от (ѕидот) на EmuELEC: ништо однадвор не влегува, а боксот сам може да излегува. Плус во emuelec.conf ставив ee_ssh.enabled=0 и ги исклучив Wi-Fi и Bluetooth.

RULES=public turns on EmuELEC's firewall: nothing gets in from outside, while the box can still go out. On top of that I set ee_ssh.enabled=0 and turned off Wi-Fi and Bluetooth in emuelec.conf.

Ако повеќе сакаш да копираш игри преку мрежа, остави ја Samba, отвори smb://IP-НА-БОКСОТ/ во фајл менаџерот и резервирај ја IP адресата на боксот во рутерот. Никогаш не ја отворај кон интернет. Очекувај околу 10 MB/s; мрежната порта е 100 Mbit.

If you'd rather copy games over the network, keep Samba on, open smb://BOX-IP/ in your file manager and reserve the box's IP in your router. Never expose it to the internet. Expect about 10 MB/s; the Ethernet port is 100 Mbit.

Тема и музикаTheme and music

Стандардната тема Crystal е во ред (сликата подолу). Јас сакав нешто аркадно. EmuELEC има список од 82 теми. Прво пробав Arcadeplanet, ама има 173 MB и самите автори препорачуваат Raspberry Pi 4 или побрзо. Neon Overdrive (gradient) има 28 MB, без видеа, и изгледа токму како што треба. Без терминал: на GitHub страницата на темата Code → Download ZIP, отпакувај и копирај ја папката во STORAGE/.config/emuelec/themes/. Со терминал:

The default Crystal theme is fine (photo below). I wanted something arcade. EmuELEC has a list of 82 themes. I tried Arcadeplanet first, but it's 173 MB and its own authors recommend a Raspberry Pi 4 or faster. Neon Overdrive (gradient) is 28 MB with no videos and looks the part. Without a terminal: on the theme's GitHub page hit Code → Download ZIP, unzip it and copy the folder to STORAGE/.config/emuelec/themes/. With a terminal:

Инсталирање на тематаInstalling the theme
git clone --depth 1 https://github.com/EmuELEC/es-theme-neon-overdrive-gradient
rm -rf es-theme-neon-overdrive-gradient/.git
sudo cp -r es-theme-neon-overdrive-gradient /run/media/$USER/STORAGE/.config/emuelec/themes/

Избери ја во UI Settings или постави ја во es_settings.cfg:

Pick it in UI Settings, or set it in es_settings.cfg:

es_settings.cfg: темаes_settings.cfg: theme
<string name="ThemeSet" value="es-theme-neon-overdrive-gradient" />
<string name="ThemeSystemView" value="" />

Лиценцата на темата е само за лична употреба, па не ја споделувам. Ако скролањето е бавно, стави го стилот на транзиција на Instant.

The theme's licence is personal use only, so I'm not redistributing it. If scrolling feels slow, set the transition style to Instant.

Monitor showing EmulationStation with Super Nintendo selected, a short description of the console and Mario Kart artwork.
Менијата повторно работат по поправката, сè уште со стандардната тема Crystal. Видеото најгоре ја покажува Neon Overdrive.Menus working again after the repair, still on the default Crystal theme. The video at the top shows Neon Overdrive.

Музика во позадина е секој MP3 во EEROMS/BGM. Јас ја користев Resistor Anthems од Eric Skiff: chiptune со лиценца CC BY 4.0, бесплатна со наведување на авторот. 17 песни, 62 MB. audio.display_titles=1 во emuelec.conf го покажува насловот на песната кога почнува.

Background music is any MP3 in EEROMS/BGM. I used Eric Skiff's Resistor Anthems: chiptune licensed CC BY 4.0, so it's free with credit. 17 tracks, 62 MB. audio.display_titles=1 in emuelec.conf shows the song title when a track starts.

Дали save states ќе ја наполнат картичката?Will save states fill the card?

Не. Save state е „фотографија“ од играта во тој момент, па продолжуваш точно од таму. Auto-save чува по една по игра и ја препишува секој пат. Приближно: NES 30–80 KB, SNES 150–300 KB, PS1 1–2 MB. Дури и да ја играм секоја игра на картичката по еднаш, тоа е околу 400 MB. Рачните зачувувања во многу слотови се собираат: десет слотови за секоја PS1 игра се околу 1 GB. Сите се во EEROMS/savestates; копирај ги на друго место одвреме-навреме.

No. A save state is a “snapshot” of the game at that moment, so you continue exactly from there. Auto-save keeps one per game and overwrites it each time. Roughly: NES 30–80 KB, SNES 150–300 KB, PS1 1–2 MB. Even if I played every game on my card once, that's about 400 MB. Manual saves in many slots do add up: ten slots for every PS1 game is around 1 GB. They all live in EEROMS/savestates; copy them somewhere else now and then.

Што научивWhat I learned

Што следуваWhat's next

Благодарност до тимот на EmuELEC. Тема: Neon Overdrive од Travis Wilson. Музика: Eric Skiff, Resistor Anthems (CC BY 4.0). Податоци и слики: ScreenScraper, преку Skyscraper.

Thanks to the EmuELEC team. Theme: Neon Overdrive by Travis Wilson. Music: Eric Skiff, Resistor Anthems (CC BY 4.0). Metadata and images: ScreenScraper, via Skyscraper.