GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - thwonp/plorpOS: A fast, musicly inclined CFW for the RG Rotate, GKD 350H Ultra, TrimUI Brick/Hammer/Pro, RG Nano, and H700 devices

BranchesTags
Open more actions menu
 
 

Latest commit

 

History

1,090 Commits
1,090 Commits

Folders and files

NameName
Last commit message
Last commit date
LICENSES
LICENSES
 
 
config
config
 
 
docs
docs
 
 
mk
mk
 
 
res
res
 
 
sd
sd
 
 
src
src
 
 
third_party
third_party
 
 
tools
tools
 
 
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
LICENSE-FBNeo.txt
LICENSE-FBNeo.txt
 
 
LICENSE-fake08.md
LICENSE-fake08.md
 
 
Makefile
Makefile
 
 
NOTICE
NOTICE
 
 
README.md
README.md
 
 
THIRD-PARTY-LICENSES.md
THIRD-PARTY-LICENSES.md
 
 

Repository files navigation

plorpOS

Devices  ·  Systems  ·  Install  ·  Controls  ·  FAQ

plorpOS is a Linux CFW for retro handhelds that prioritizes music, speed, and a balance of features to simplicity. It runs off an SD card, easy to install and remove if you're not feeling it.

plorpOS started as a fork of TortOS for the TrimUI Brick but has since has grown into its own project, with many more handhelds supported and more added features to count.

The consoles row
Main Shelf
The game switcher, recent games in a row
Game switcher
An achievements list
RetroAchievements on the device
Muse's shelf of albums
Your albums, in Muse
A Nintendo DS game on the RG Rotate, top screen large, bottom screen small
Nintendo DS, laid out your way
The Ports shelf with PortMaster games
Ports, installed by PortMaster

Devices

Handheld How plorpOS runs Guide
TrimUI Brick, Brick Hammer, Brick Pro From the card, on the stock system. One card works in all three Installing on the Brick
GKD 350H Ultra On top of the stock ROCKNIX, at the screen's full resolution Installing on the GKD
Anbernic RG Rotate A card image (base618, Linux). Android stays on the device Installing on the RG Rotate
Anbernic RG SP, RG34xxSP, RG35XX H As the front end for BaseOS, on a second card Installing on an H700
Anbernic RG Nano plorpOS nano, a pared down music-first version, as a card image Installing on the RG Nano

Everything below is about the full plorpOS. The Nano's guide lists what nano does.

What it does

  • Music and audiobooks are 1-2 buttons (or single swipe gesture) away from anywhere, even in the middle of a game, and play over gameplay.

  • Bluetooth headphones and USB DAC support.

  • Games load super fast - libretro emulators live in resident memory.

  • Game switcher to quickly access recent games from any screen.

  • Auto-save and resume (configurable), Rewind, fast-forward, Turbo mode and other features you should expect.

  • Fifteen shader presets, Game Boy palettes, and Aspect, Stretch or Integer scaling.

  • RetroAchievements, signed in on the device. A game's set downloads once and then works offline; unlocks made offline are sent later.

  • Nintendo DS runs full speed on every device thanks to DSperate v3.3.0 (runs under a libretro wrapper that also does the GBA slot, Rumble Pak, Guitar Grip and analog patches), with melonDS DS as an option on the RG Rotate and GKD.

    • Multiple Layout / Scaling options, Stylus emulation (and touch support), Microphone emulation.
  • Portmaster (UNOFFICIALLY SUPPORTED) on every device. Most games seem to run great but this is experimental. Report problems to plorpOS, NOT the PortMaster team.

  • PICO-8 Native works with Raspberry Pi files placed in Bios/. Carts you play in Splore land on the shelf with their artwork.

  • Scrape box art / metatdata on-device, or import from gamelist.xml.

  • Favorites, sorting, Rename and Delete Game, and Play Time for every game and console.

Supported systems

Console Put games in File types Core Bios
PICO-8 Roms/Pico-8 .p8 .png fake-08, or native PICO-8 pico8.dat,pico8_64 (RG Nano uses pico_dyn instead of pico8_64)
Arcade Roms/Arcade .zip .7z FBNeo Per game - I recommend using non-merged ROMs
Game Boy Roms/Game Boy .gb .dmg .zip mGBA -
Game Boy Color Roms/Game Boy Color .gbc .cgb .zip mGBA -
Game Boy Advance Roms/Game Boy Advance .gba .agb .zip mGBA Optional: gba_bios.bin
Nintendo DS Roms/Nintendo DS .nds DSperate-lr, or melonDS DS bios7.bin, bios9.bin, firmware.bin (only needed for encrypted Roms
Super Nintendo Roms/SNES .sfc .smc .zip Snes9x 2010 -
NES Roms/NES .nes .fds .unf .unif .zip FCEUmm -
Sega Genesis, 32X Roms/Genesis .md .gen .bin .smd .32x .zip PicoDrive -
Sega CD Roms/Genesis or Roms/Sega CD .chd .cue .m3u PicoDrive bios_CD_U.bin, bios_CD_E.bin, bios_CD_J.bin
Sega Master System Roms/Master System .sms .zip PicoDrive -
Sega Game Gear Roms/Game Gear .gg .zip PicoDrive -
TurboGrafx-16 and CD Roms/TurboGrafx-16 .pce .sgx .cue .ccd .chd .toc .m3u .zip Beetle PCE Fast syscard3.pce for CD games
Neo Geo Roms/Neo Geo .zip .7z FBNeo neogeo.zip
Neo Geo Pocket Roms/Neo Geo Pocket .ngp .ngc .ngpc .npc .zip Beetle NeoPop -
Neo Geo Pocket Color Roms/Neo Geo Pocket Color .ngp .ngc .ngpc .npc .zip Beetle NeoPop -
PlayStation 1 Roms/PlayStation .chd .cue .m3u .pbp .iso .img PCSX ReARMed Optional: scph5501.bin (US) scph5500.bin (JP) scph5502.bin (EU)
Ports Roms/Ports installed by PortMaster - -

BIOS files go loose under Bios/

Sega CD and 32X games can live in Roms/Genesis or use their own folders to split them into their own shelf.

Install

Each handheld sets up a little differently, so follow its guide from the Devices table. The short version:

  1. Download the zip (or card image) for your device from Releases.
  2. Put it on a microSD card as the guide says. On the Brick, GKD and H700 handhelds that means formatting the card exFAT and copying the zip's contents over; the RG Rotate and RG Nano get a flashed image.
  3. Put the card in and turn the device on. The first boot finishes the install.
  4. Add games to the folders in Roms/, from the computer now or over Wi-Fi later.

Taking the card out gives you the stock system back. Each guide has a Removing plorpOS section for anything the install left on the device.

Adding games over Wi-Fi

Over The Hare, with a browser connected

  1. Join a network under MENU > Network Services > Wi-Fi.
  2. Open MENU > Network Services > Over The Hare. It shows an address and a PIN.
  3. Open that address in a browser on your phone or computer, and type the PIN.
  4. Drag games into their console's folder, albums into Music or books into Audiobooks. They're on the shelf when you leave the screen.

The PIN is new every time you open Over The Hare.


Controls

Button On the shelf
D-pad Move. On a shelf of games or albums, the other direction jumps by letter
A Open a console, or start or continue a game
B Back
X The game's details
Y Favorite
L1/R1 Jump a screenful
MENU Settings for the device, or for the shelf you're in
SELECT Muse, the music and audiobook player. Press it again to close
POWER Tap to sleep, hold to turn off. Closing the RG SP's lid is a tap

In a game, MENU opens the in-game menu and holding it opens the game switcher. SELECT in that menu opens Muse. A tap of POWER saves and sleeps; holding it saves and turns the device off.

The volume buttons work everywhere. Brightness is MENU plus volume (Home plus volume on the GKD). On devices with sticks, the left stick works as the D-pad, and the right stick and stick clicks can be hotkeys.

MENU > Controls on the device lists all of this, and the guide covers every button, menu and setting in detail.

FAQ

My games don't show up.

Check the folder name against the table above, spelled exactly, and that the file type is listed for that console. A console with nothing in its folder is hidden. Games sent over Over The Hare appear when you leave its screen. Games copied any other way while the device is on appear after Rescan Folder in that console's menu, or after a restart. The log names every file a console's folder left out, and the file types it takes.

A game has no box art.

MENU > Game Settings > Scraping > Box Art fetches every missing cover over Wi-Fi. Sign in to a free ScreenScraper account under MENU > Game Settings > Scraping > ScreenScraper and it asks there first, and brings each game's year, genre and synopsis for its details screen. Without an account, or for a game ScreenScraper doesn't have, it uses libretro's thumbnail collection, looking a game up by its file name and, for zipped games, by checksum.

Some games aren't in either collection, like fan translations and homebrew. Add your own: a PNG named exactly like the game file, in Roms/<console>/.media/. Black Castle.gb wants Black Castle.png. Around 512 pixels on the long side is plenty.

Don't like a cover? Press X on the game and choose Replace Box Art. It looks again, and if nothing turns up, you keep the one you had.

How do achievements work?

Sign in to your RetroAchievements account under MENU > Game Settings > Achievements Sign-In. The first time you start a game, the device needs Wi-Fi to look it up and download its achievements. After that the game works offline, and anything you unlock offline is kept and sent to your account later. To get every game's achievements in one go before you leave Wi-Fi, use Download Achievement Sets on the same screen; it counts the games with no achievements to earn (hacks, translations, dumps RetroAchievements never listed, and many arcade sets). To play without them, turn off Achievements Enabled on the same screen.

How do hotkeys work?

Open Hotkeys in the in-game menu. There are six actions: Fast-Forward and Rewind (both work while held), Quick Save, Quick Load, Screenshot and Turbo Assign (see the next question). A Nintendo DS game adds Screen Layout -> (the next screen layout; MENU + X by default on the GKD and Rotate) and Blow Into Mic (held: the game hears you blow into the microphone). On the GKD it also adds Stylus Tap, the button that touches where the stick's cursor is (R2 by default). On the Brick, Brick Pro and H700 handhelds it adds Screen Layout <- (the previous layout), Stylus Tap (R Stick Click by default on a unit with two sticks) and, on a unit without a second stick, Stylus Mode (a cursor over the bottom screen, moved by the D-pad). With two sticks the cursor is always on, moved by the stick the in-game menu's Stylus Stick row picks, right by default. Pick an action, press A, then press its trigger: a button alone, or held under a modifier. X clears an action, and a lone tap of MENU cancels while it waits. Each console keeps its own bindings, and none are set until you set them. Rewind Speed and Fast-Forward Speed are in MENU > Game Settings.

Modifiers are buttons you hold for a chord, like MENU + X. Each hotkey has its own: hold the modifier when you press the trigger and the screen shows it, so Fast-Forward on L Stick Click + A and Rewind on MENU + A work side by side. The modifiers each device offers:

  • Brick, RG SP: Menu or Select.
  • Brick Pro, RG34xxSP, RG35XX H: Menu, Select or L Stick Click.
  • GKD: Menu, Home, Stick Click or Select.

A tap of MENU still opens the in-game menu when you let go, unless you pressed another button while holding it. Holding MENU on its own for about 0.7 s opens the game switcher.

Triggers:

  • L1, R1, L2, R2, A, B, X, Y: with a modifier held, or alone. A button bound alone does the action instead of its job in that console's games.
  • D-pad and left stick directions: with a modifier held only, so moving always works.
  • The right stick (Brick Pro, RG34xxSP, RG35XX H): its four directions and its click, with a modifier held or alone. Games never see it, so binding it alone costs nothing.
  • Nintendo DS: no stick direction is a trigger, since the stylus uses the stick.

One button can hold several actions: one alone and one under each modifier. On a unit with two sticks the left stick's triggers read "L Stick". Bindings saved before each hotkey had its own modifier keep the one that was set then.

How does turbo work?

Bind Turbo Assign under Hotkeys in the in-game menu, like any other hotkey. Then, in a game:

  • Press Turbo Assign, then a button. That button is turbo now: hold it and it presses itself about ten times a second. The press that picks it isn't sent to the game.
  • Do the same again to make that button normal again. Several buttons can be turbo at once.
  • Press Turbo Assign twice to change your mind before picking a button.
  • Hold Turbo Assign for 2 seconds to make every button normal again.

A short notice says what happened each time. A, B, X, Y, L1, R1, L2 and R2 can be turbo; the d-pad, START and SELECT can't. Turbo lasts until you quit the game: the in-game menu and Muse don't touch it, and the next game starts with none. To keep it, turn on Persistent Turbo Assignments in MENU > Game Settings: each game then starts with the turbo buttons you last gave it. A button the console doesn't use, like X on the NES, does nothing as turbo either.

What do Auto Sleep and Auto Off do, and when does the device suspend?

They're under MENU > System Settings. The device has two ways to rest: sleep turns the screen off and pauses a game (music keeps playing), and a tap of POWER brings you straight back. Suspend is a much deeper rest that barely touches the battery.

  • Auto Sleep (default 1 minute): how long the device sits untouched before it sleeps, exactly as if you'd tapped POWER.
  • Suspend comes 10 seconds after the device falls asleep, however it fell asleep. When music ends with the screen dark, it suspends 30 seconds later. Neither is a setting.
  • Auto Off (default Never; not on the RG Rotate): how long the device sits untouched before it powers itself off. Next time you turn it on, you're back where you were. Auto Off and Auto Sleep can't both be on: setting one turns the other to Never.

Auto Sleep and Auto Off only count time on the shelf and in the menus, the in-game menu included, never while you're playing. While music plays, Muse's own Screen Off setting decides when the screen goes dark instead. Plugged in to charge, the device never sleeps, suspends or powers off on its own.

Can I use Bluetooth headphones?

Yes. Put them in pairing mode, open MENU > Bluetooth, press Y to search and A to pair. They reconnect by themselves from then on. Wired headphones always win when they're plugged in.

The device's volume buttons set the headphones' volume, and the headphones' own volume buttons move the device's. On a few headphones, the device's buttons set only the starting volume; after that, change it on the headphones themselves. Play, pause and skip on the headphones control Muse.

On the Brick and Brick Pro, Wi-Fi starts before Bluetooth, at power-on and after sleep. The two share one radio chip, and on the Brick Pro starting them together could freeze the device. So the headphones wait until Wi-Fi has connected, or has given up after 15 seconds, and take around 20 to 30 seconds to come back after sleep. Turn Wi-Fi off under MENU > Network Services when you don't need it, and they reconnect sooner.

How do I add music?

Put it in Music/ on the card, from a computer or over Wi-Fi with Over The Hare, a folder per artist and a folder inside that per album: Music/Radiohead/The Bends/01 Planet Telex.mp3. An album folder put straight into Music/ is moved under its artist when its tags name one, and songs in no folder at all are moved into Music/Singles/, an album of their own. MP3, M4A, M4B, AAC, FLAC, Ogg, Opus and WAV all play. Muse appears on the shelf once there's music, and each album's cover comes from its own files, or a picture in the album's folder. MENU > Album Art on Muse's shelf fetches a sharper cover over Wi-Fi from MusicBrainz's Cover Art Archive for any album whose files carry none, or only a small one.

How do I add audiobooks?

Put each book in its own folder in Audiobooks/, with an author's folder above it or without: Audiobooks/Iain M. Banks/The Hydrogen Sonata/ or Audiobooks/The Hydrogen Sonata/. One M4B or a folder of MP3s both work, and the files play in name order. MENU > Show on Muse's shelf switches between your music and your books. A book remembers where you stopped, even through a power-off, and one played to the end is marked finished; A on it starts it over.

Where are my saves?

Battery saves are .srm files in Saves/<console>/, named after the game; the console folder is named like its Roms/ folder, and the release comes with one for every console, so saves from another device can go straight in. A game's battery save is written at most once a minute while you play, and always when you open the in-game menu, sleep or quit. If you upgraded a Brick from plorpOS v1.1 or TortOS, move the old saves loose in Saves/ into those folders - see Upgrading a TortOS card. Save states, the autosave included, are in .userdata/shared/.tortos/, one folder per console. Neo Geo Pocket Color games write no .srm, so their progress lives in the autosave.

Something went wrong. How do I send the logs?

Open MENU > Network Services > Over The Hare, open its address in a browser, and click Download logs at the bottom of the first page. You get one .tar.gz file holding the last ten boots' logs and a short summary of the device, ready to send to whoever is helping you. Wi-Fi network, headset and account names are masked in it, and the logs on the card are left as they are. The logs themselves are in .userdata/tg3040/logs/ (Brick), .userdata/gkd/logs/ (GKD) or .userdata/rgsp/logs/ (RG SP) on the card.

AI Usage Disclosure

plorpOS was developed using AI assisted workflows. Every commit was thoroughly hand-tested along the way.

For developers

plorpOS is C and SDL2, built on Eric Reinsmidt's TortOS. Games run in diatom, plorpOS's fork of his small libretro frontend, which starts once at boot and stays running.

  • How it works: the resident emulator, the boot, and card art off the render thread
  • Configuration: the two settings databases, systems.cfg and core options
  • Building: the toolchain, the card, the checks, and deploying to a device
  • Design decisions and how menus behave

Credits

plorpOS stands on a lot of other people's work. The licence of every piece is in THIRD-PARTY-LICENSES.md and NOTICE, but here's some standouts:

  • Eric Reinsmidt's TortOS and diatom are the cornerstones this project forked from.
  • NextUI provided sleep and suspend for the Brick, CHD reading, multiple shaders, and fast-forward/rewind/hotkeys design.
  • beebono for DSperate and their initial RG Rotate Linux port.
  • crackerjacques and TheGammaSqueeze for more work base618 built on.
  • pvaibhav for BaseOS which powers the h700 ports.
  • DrUm78 for their FunKey-OS build that plorpOS Nano built on.
  • nelynes of slotPlus for helping with DSperate frame-skip implementation.
  • All the contributors for libretro, PortMaster, RetroAchievements, ScreenScraper, and other projects used here.

License

plorpOS is MIT, like Eric Reinsmidt's TortOS and diatom it is built on, and so is its fork of diatom. The exception is code derived from NextUI - sleep and suspend here, fast-forward, rewind and hotkeys in diatom - which keeps NextUI's PolyForm Noncommercial License 1.0.0; NOTICE lists exactly which files and regions. A card or release bundles that code, so as a whole it is not for commercial use. The cores keep their own licenses, two of them non-commercial. Full notices are in THIRD-PARTY-LICENSES.md.

About

A fast, musicly inclined CFW for the RG Rotate, GKD 350H Ultra, TrimUI Brick/Hammer/Pro, RG Nano, and H700 devices

Resources

Readme
Activity

Stars

19 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages

You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.