Repository navigation
Releases: mehmetraif/OSD-OS
Releases · mehmetraif/OSD-OS
Release list
OSD/OS v0.0.26
Bug Fixes
- FinalBurn Neo games start on Windows while signed in to RetroAchievements
Downloads
| System | File | What it is | Install and update |
|---|---|---|---|
| Raspberry Pi OS (arm64) you set up yourself | install.sh |
The installer, which installs the app, OSD-OS-v0.0.26-linux-arm64.tar.gz, with its service |
bash <(curl -fsSL https://github.com/mehmetraif/OSD-OS/releases/latest/download/install.sh): https://github.com/mehmetraif/OSD-OS/blob/v0.0.26/INSTALL.md#on-a-raspberry-pi. Updates: Settings → Update, or the same command again: https://github.com/mehmetraif/OSD-OS/blob/v0.0.26/INSTALL.md#update |
| OpenBSD 8.0 (amd64) | OSD-OS-0.0.26-openbsd-amd64.tgz |
An OpenBSD package: the app, with FinalBurn Neo's core built for OpenBSD; Qt 6, SDL2 and mpv are OpenBSD's own packages, which come with it | As root: pkg_add -D unsigned OSD-OS-0.0.26-openbsd-amd64.tgz (the package isn't signed with OpenBSD's key): https://github.com/mehmetraif/OSD-OS/blob/v0.0.26/INSTALL.md#on-openbsd-amd64. Updates: the next release's package the same way |
| Steam Deck, Linux PCs (x86_64) | OSD-OS-linux-x86_64.AppImage |
The app with Qt, SDL2 and mpv inside; nothing to install | Make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.26/INSTALL.md#on-steamos--linux-x86_64. Updates: Settings → Update swaps it in place, or the latest AppImage over your copy |
| FreeBSD 15 (amd64) | OSD-OS-v0.0.26-freebsd-amd64.pkg |
A FreeBSD package: the app, with FinalBurn Neo's core built for FreeBSD; Qt 6, SDL2 and mpv are FreeBSD's own packages | As root, its packages, then the app: pkg install -y qt6-base qt6-declarative qt6-svg sdl2 minizip mpv and pkg add OSD-OS-v0.0.26-freebsd-amd64.pkg: https://github.com/mehmetraif/OSD-OS/blob/v0.0.26/INSTALL.md#on-freebsd-amd64. Updates: the next release's package the same way |
| Raspberry Pi OS (arm64) you set up yourself | OSD-OS-v0.0.26-linux-arm64.tar.gz |
The app alone, which install.sh and the updater install |
Nothing to download by hand: install.sh fetches it, and Settings → Update fetches the next one |
| macOS on Apple Silicon | OSD-OS-v0.0.26-macOS-arm64.dmg |
osdos.app in a disk image | Open it and move osdos.app to your Applications folder. Updates: Settings → Update, or the next .dmg the same way |
| Raspberry Pi 4 and 5 | OSD-OS-v0.0.26-raspberry-pi.img.xz |
The whole system: Raspberry Pi OS Lite (64-bit, Debian 13 trixie) with OSD/OS on top. The Pi boots straight into OSD/OS. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.26/os/NOTICE | Flash it with Raspberry Pi Imager (Use custom): https://github.com/mehmetraif/OSD-OS/blob/v0.0.26/os/README.md#flashing. Updates: Settings → Update in the app |
| Windows 11 (x64) | OSD-OS-v0.0.26-windows-x64.zip |
The app in one folder, osdos, with Qt and its libraries beside osdos.exe; mpv is not inside |
Unzip it anywhere, put mpv beside it and run osdos.exe: https://github.com/mehmetraif/OSD-OS/blob/v0.0.26/INSTALL.md#on-windows-x64. Updates: Settings → Update names the new zip, whose osdos folder takes the old one's place |
The macOS build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or run xattr -dr com.apple.quarantine /Applications/osdos.app before opening it).
On FreeBSD and OpenBSD, the Arcade module plays in the system's own MAME and RetroArch packages, installed apart (mame, retroarch). The packages are built, installed and started in FreeBSD and OpenBSD virtual machines; they haven't been tried on a BSD computer yet.
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB): the Pi 4 as a TV, the Pi 5 in a JAMMA arcade cabinet, and LAN Play between the two; the Windows build on a Windows 11 PC. Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.25
What's New
- Download buttons for each system's files in the latest release, with tested labels
- An Arcade section on the website: picking a game, coins, scores and playing together
- One-line terminal downloads on the website, each file checked against its SHA-256
- The terminal commands at the top of the website, a tab for each system
- Each system in a tab of its own on the website: TV, arcade, BSD, Linux / Steam Deck, macOS and Windows
- Beastie and Puffy in the website's BSD tab
- Settings → Arcade → Regions hides the sets of the regions turned off, and OSD/OS Setup offers it
Changelog
- The README names the computers OSD/OS runs on as an app
- The Linux / Steam Deck tab keeps Steam Deck on one line
- Beastie and Puffy drawn again on a finer grid, with Beastie's crescent horns, big eyes and snout
Bug Fixes
- A release published on GitHub's Releases page held as a draft until its files are in
- The website fits phones and tablets, with nothing running past the screen's edge
- The photo at the top of the website shows in Safari on phones and tablets
Downloads
| System | File | What it is | Install and update |
|---|---|---|---|
| Raspberry Pi OS (arm64) you set up yourself | install.sh |
The installer, which installs the app, OSD-OS-v0.0.25-linux-arm64.tar.gz, with its service |
bash <(curl -fsSL https://github.com/mehmetraif/OSD-OS/releases/latest/download/install.sh): https://github.com/mehmetraif/OSD-OS/blob/v0.0.25/INSTALL.md#on-a-raspberry-pi. Updates: Settings → Update, or the same command again: https://github.com/mehmetraif/OSD-OS/blob/v0.0.25/INSTALL.md#update |
| OpenBSD 8.0 (amd64) | OSD-OS-0.0.25-openbsd-amd64.tgz |
An OpenBSD package: the app, with FinalBurn Neo's core built for OpenBSD; Qt 6, SDL2 and mpv are OpenBSD's own packages, which come with it | As root: pkg_add -D unsigned OSD-OS-0.0.25-openbsd-amd64.tgz (the package isn't signed with OpenBSD's key): https://github.com/mehmetraif/OSD-OS/blob/v0.0.25/INSTALL.md#on-openbsd-amd64. Updates: the next release's package the same way |
| Steam Deck, Linux PCs (x86_64) | OSD-OS-linux-x86_64.AppImage |
The app with Qt, SDL2 and mpv inside; nothing to install | Make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.25/INSTALL.md#on-steamos--linux-x86_64. Updates: Settings → Update swaps it in place, or the latest AppImage over your copy |
| FreeBSD 15 (amd64) | OSD-OS-v0.0.25-freebsd-amd64.pkg |
A FreeBSD package: the app, with FinalBurn Neo's core built for FreeBSD; Qt 6, SDL2 and mpv are FreeBSD's own packages | As root, its packages, then the app: pkg install -y qt6-base qt6-declarative qt6-svg sdl2 minizip mpv and pkg add OSD-OS-v0.0.25-freebsd-amd64.pkg: https://github.com/mehmetraif/OSD-OS/blob/v0.0.25/INSTALL.md#on-freebsd-amd64. Updates: the next release's package the same way |
| Raspberry Pi OS (arm64) you set up yourself | OSD-OS-v0.0.25-linux-arm64.tar.gz |
The app alone, which install.sh and the updater install |
Nothing to download by hand: install.sh fetches it, and Settings → Update fetches the next one |
| macOS on Apple Silicon | OSD-OS-v0.0.25-macOS-arm64.dmg |
osdos.app in a disk image | Open it and move osdos.app to your Applications folder. Updates: Settings → Update, or the next .dmg the same way |
| Raspberry Pi 4 and 5 | OSD-OS-v0.0.25-raspberry-pi.img.xz |
The whole system: Raspberry Pi OS Lite (64-bit, Debian 13 trixie) with OSD/OS on top. The Pi boots straight into OSD/OS. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.25/os/NOTICE | Flash it with Raspberry Pi Imager (Use custom): https://github.com/mehmetraif/OSD-OS/blob/v0.0.25/os/README.md#flashing. Updates: Settings → Update in the app |
| Windows 11 (x64) | OSD-OS-v0.0.25-windows-x64.zip |
The app in one folder, osdos, with Qt and its libraries beside osdos.exe; mpv is not inside |
Unzip it anywhere, put mpv beside it and run osdos.exe: https://github.com/mehmetraif/OSD-OS/blob/v0.0.25/INSTALL.md#on-windows-x64. Updates: Settings → Update names the new zip, whose osdos folder takes the old one's place |
The macOS build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or run xattr -dr com.apple.quarantine /Applications/osdos.app before opening it).
On FreeBSD and OpenBSD, the Arcade module plays in the system's own MAME and RetroArch packages, installed apart (mame, retroarch). The packages are built, installed and started in FreeBSD and OpenBSD virtual machines; they haven't been tried on a BSD computer yet.
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB): the Pi 4 as a TV, the Pi 5 in a JAMMA arcade cabinet, and LAN Play between the two; the Windows build on a Windows 11 PC. Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.24
What's New
- Windows and BSD tabs on the website, beside the TV, the cabinet and Mac / Linux
- FreeBSD and OpenBSD packages in every release, with FinalBurn Neo built from its source
- OSD/OS's pixel-art icon on osdos.exe, its window and the taskbar
- OSD/OS's icon on the app's window on X11 and BSD desktops
- OSD/OS's pixel-art icon on the AppImage and the Mac app
- OSD/OS's pixel-art icon as the website's tab icon
Changelog
- Release files listed under their own names, as the Downloads table gives them
- The Downloads table lists the release's files in the order of its Assets
- FinalBurn Neo compiles on the BSDs; OpenBSD's package named for pkg_add
- FreeBSD and OpenBSD packages in the docs, the site and the wiki
- OpenBSD's package comment within pkg_create's 60 characters
- OpenBSD's package description given to pkg_create in a file
- Pkg_create given the OpenBSD package's file name with .tgz
- The smoke test finds the QML files itself, for the BSDs' grep
Downloads
| System | File | What it is | Install and update |
|---|---|---|---|
| Raspberry Pi OS (arm64) you set up yourself | install.sh |
The installer, which installs the app, OSD-OS-v0.0.24-linux-arm64.tar.gz, with its service |
bash <(curl -fsSL https://github.com/mehmetraif/OSD-OS/releases/latest/download/install.sh): https://github.com/mehmetraif/OSD-OS/blob/v0.0.24/INSTALL.md#on-a-raspberry-pi. Updates: Settings → Update, or the same command again: https://github.com/mehmetraif/OSD-OS/blob/v0.0.24/INSTALL.md#update |
| OpenBSD 8.0 (amd64) | OSD-OS-0.0.24-openbsd-amd64.tgz |
An OpenBSD package: the app, with FinalBurn Neo's core built for OpenBSD; Qt 6, SDL2 and mpv are OpenBSD's own packages, which come with it | As root: pkg_add -D unsigned OSD-OS-0.0.24-openbsd-amd64.tgz (the package isn't signed with OpenBSD's key): https://github.com/mehmetraif/OSD-OS/blob/v0.0.24/INSTALL.md#on-openbsd-amd64. Updates: the next release's package the same way |
| Steam Deck, Linux PCs (x86_64) | OSD-OS-linux-x86_64.AppImage |
The app with Qt, SDL2 and mpv inside; nothing to install | Make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.24/INSTALL.md#on-steamos--linux-x86_64. Updates: Settings → Update swaps it in place, or the latest AppImage over your copy |
| FreeBSD 15 (amd64) | OSD-OS-v0.0.24-freebsd-amd64.pkg |
A FreeBSD package: the app, with FinalBurn Neo's core built for FreeBSD; Qt 6, SDL2 and mpv are FreeBSD's own packages | As root, its packages, then the app: pkg install -y qt6-base qt6-declarative qt6-svg sdl2 minizip mpv and pkg add OSD-OS-v0.0.24-freebsd-amd64.pkg: https://github.com/mehmetraif/OSD-OS/blob/v0.0.24/INSTALL.md#on-freebsd-amd64. Updates: the next release's package the same way |
| Raspberry Pi OS (arm64) you set up yourself | OSD-OS-v0.0.24-linux-arm64.tar.gz |
The app alone, which install.sh and the updater install |
Nothing to download by hand: install.sh fetches it, and Settings → Update fetches the next one |
| macOS on Apple Silicon | OSD-OS-v0.0.24-macOS-arm64.dmg |
osdos.app in a disk image | Open it and move osdos.app to your Applications folder. Updates: Settings → Update, or the next .dmg the same way |
| Raspberry Pi 4 and 5 | OSD-OS-v0.0.24-raspberry-pi.img.xz |
The whole system: Raspberry Pi OS Lite (64-bit, Debian 13 trixie) with OSD/OS on top. The Pi boots straight into OSD/OS. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.24/os/NOTICE | Flash it with Raspberry Pi Imager (Use custom): https://github.com/mehmetraif/OSD-OS/blob/v0.0.24/os/README.md#flashing. Updates: Settings → Update in the app |
| Windows 11 (x64) | OSD-OS-v0.0.24-windows-x64.zip |
The app in one folder, osdos, with Qt and its libraries beside osdos.exe; mpv is not inside |
Unzip it anywhere, put mpv beside it and run osdos.exe: https://github.com/mehmetraif/OSD-OS/blob/v0.0.24/INSTALL.md#on-windows-x64. Updates: Settings → Update names the new zip, whose osdos folder takes the old one's place |
The macOS build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or run xattr -dr com.apple.quarantine /Applications/osdos.app before opening it).
On FreeBSD and OpenBSD, the Arcade module plays in the system's own MAME and RetroArch packages, installed apart (mame, retroarch). The packages are built, installed and started in FreeBSD and OpenBSD virtual machines; they haven't been tried on a BSD computer yet.
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB): the Pi 4 as a TV, the Pi 5 in a JAMMA arcade cabinet, and LAN Play between the two; the Windows build on a Windows 11 PC. Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.23
What's New
- OSD/OS Setup's settings on a computer, from its file at start or pasted in Settings
Changelog
- Actions on Node.js 24, and Ubuntu 24.04 for the jobs on ubuntu-latest
Bug Fixes
- A pad's left stick moves the joystick in FinalBurn Neo games online
Downloads
| System | File | What it is | Install and update |
|---|---|---|---|
| Raspberry Pi 4 and 5 | OSD-OS-v0.0.23-raspberry-pi.img.xz |
The whole system: Raspberry Pi OS Lite (64-bit, Debian 13 trixie) with OSD/OS on top. The Pi boots straight into OSD/OS. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.23/os/NOTICE | Flash it with Raspberry Pi Imager (Use custom): https://github.com/mehmetraif/OSD-OS/blob/v0.0.23/os/README.md#flashing. Updates: Settings → Update in the app |
| Raspberry Pi OS (arm64) you set up yourself | install.sh, OSD-OS-v0.0.23-linux-arm64.tar.gz |
The installer, and the app alone, which it installs with its service | bash <(curl -fsSL https://github.com/mehmetraif/OSD-OS/releases/latest/download/install.sh): https://github.com/mehmetraif/OSD-OS/blob/v0.0.23/INSTALL.md#on-a-raspberry-pi. Updates: Settings → Update, or https://github.com/mehmetraif/OSD-OS/blob/v0.0.23/INSTALL.md#update |
| Steam Deck, Linux PCs (x86_64) | OSD-OS-linux-x86_64.AppImage |
The app with Qt, SDL2 and mpv inside; nothing to install | Make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.23/INSTALL.md#on-steamos--linux-x86_64. Updates: Settings → Update swaps it in place, or the latest AppImage over your copy |
| macOS on Apple Silicon | OSD-OS-v0.0.23-macOS-arm64.dmg |
osdos.app in a disk image | Open it and move osdos.app to your Applications folder. Updates: Settings → Update, or the next .dmg the same way |
| Windows 11 (x64) | OSD-OS-v0.0.23-windows-x64.zip |
The app in one folder, osdos, with Qt and its libraries beside osdos.exe; mpv is not inside |
Unzip it anywhere, put mpv beside it and run osdos.exe: https://github.com/mehmetraif/OSD-OS/blob/v0.0.23/INSTALL.md#on-windows-x64. Updates: Settings → Update names the new zip, whose osdos folder takes the old one's place |
The macOS build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or run xattr -dr com.apple.quarantine /Applications/osdos.app before opening it).
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB): the Pi 4 as a TV, the Pi 5 in a JAMMA arcade cabinet, and LAN Play between the two; the Windows build on a Windows 11 PC. Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.22
What's New
- MAME downloaded on Windows from Settings → Arcade → MAME and from an empty Arcade screen
- The RetroArch and MAME downloaded on Windows are the OSD/OS image's versions
- Window Mode puts the menus in a window on a desktop
- The Arcade screen's filters in one order, each there and opening on its first game
- The Windows build in one folder, osdos, with the app's files beside osdos.exe
- Windows 11 builds in each release, the osdos folder zipped
- The Windows build opens no console window, its log kept in osdos.log
Changelog
- Review notes on the pad mappings and the pinned downloads
- The Linux test jobs have room for a slow package mirror
- Remove GPT-REVIEW.md, a review report nothing refers to
Bug Fixes
- A game RetroArch can't host or join ends and says why, and a keyboard's 5 and 1 are FinalBurn Neo's coin and start
- Every pad's SDL mapping goes with it to MAME and RetroArch
- RetroAchievements' hardcore mode runs in FinalBurn Neo, patched sets disallowed before each game
- Window Mode leaves full screen before it frames and places the window, and its row follows F11
- FinalBurn Neo finds the game's folder on Windows, and its BIOS sets are copied where no link can be made
- A game whose Engine is MAME plays in MAME, or says MAME is not installed
- Download Again puts FinalBurn Neo's list and licence in place on Windows
- The look for pictures passes a clone whose parent's are in without a second on it
Downloads
| System | File | What it is | Install and update |
|---|---|---|---|
| Raspberry Pi 4 and 5 | OSD-OS-v0.0.22-raspberry-pi.img.xz |
The whole system: Raspberry Pi OS Lite (64-bit, Debian 13 trixie) with OSD/OS on top. The Pi boots straight into OSD/OS. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.22/os/NOTICE | Flash it with Raspberry Pi Imager (Use custom): https://github.com/mehmetraif/OSD-OS/blob/v0.0.22/os/README.md#flashing. Updates: Settings → Update in the app |
| Raspberry Pi OS (arm64) you set up yourself | install.sh, OSD-OS-v0.0.22-linux-arm64.tar.gz |
The installer, and the app alone, which it installs with its service | bash <(curl -fsSL https://github.com/mehmetraif/OSD-OS/releases/latest/download/install.sh): https://github.com/mehmetraif/OSD-OS/blob/v0.0.22/INSTALL.md#on-a-raspberry-pi. Updates: Settings → Update, or https://github.com/mehmetraif/OSD-OS/blob/v0.0.22/INSTALL.md#update |
| Steam Deck, Linux PCs (x86_64) | OSD-OS-linux-x86_64.AppImage |
The app with Qt, SDL2 and mpv inside; nothing to install | Make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.22/INSTALL.md#on-steamos--linux-x86_64. Updates: Settings → Update swaps it in place, or the latest AppImage over your copy |
| macOS on Apple Silicon | OSD-OS-v0.0.22-macOS-arm64.dmg |
osdos.app in a disk image | Open it and move osdos.app to your Applications folder. Updates: Settings → Update, or the next .dmg the same way |
| Windows 11 (x64) | OSD-OS-v0.0.22-windows-x64.zip |
The app in one folder, osdos, with Qt and its libraries beside osdos.exe; mpv is not inside |
Unzip it anywhere, put mpv beside it and run osdos.exe: https://github.com/mehmetraif/OSD-OS/blob/v0.0.22/INSTALL.md#on-windows-x64. Updates: Settings → Update names the new zip, whose osdos folder takes the old one's place |
The macOS build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or run xattr -dr com.apple.quarantine /Applications/osdos.app before opening it).
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB): the Pi 4 as a TV, the Pi 5 in a JAMMA arcade cabinet, and LAN Play between the two; the Windows build on a Windows 11 PC. Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.21
What's New
- Menu lines end in ► where they lead on, and hold a value between ◄ ► where the keys change it
- The menus take the mouse as they take the keys
- Every "is not installed" message says what to install on this system
- The FinalBurn Neo page downloads RetroArch itself on Windows
Changelog
- The controllers test no longer calls the click switch the mouse change removed
Bug Fixes
- The ◄ before a menu value stands as far from it as the ► after it
Downloads
| System | File | What it is | Install and update |
|---|---|---|---|
| Raspberry Pi 4 and 5 | OSD-OS-v0.0.21-raspberry-pi.img.xz |
The whole system: Raspberry Pi OS Lite (64-bit, Debian 13 trixie) with OSD/OS on top. The Pi boots straight into OSD/OS. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.21/os/NOTICE | Flash it with Raspberry Pi Imager (Use custom): https://github.com/mehmetraif/OSD-OS/blob/v0.0.21/os/README.md#flashing. Updates: Settings → Update in the app |
| Raspberry Pi OS (arm64) you set up yourself | install.sh, OSD-OS-v0.0.21-linux-arm64.tar.gz |
The installer, and the app alone, which it installs with its service | bash <(curl -fsSL https://github.com/mehmetraif/OSD-OS/releases/latest/download/install.sh): https://github.com/mehmetraif/OSD-OS/blob/v0.0.21/INSTALL.md#on-a-raspberry-pi. Updates: Settings → Update, or https://github.com/mehmetraif/OSD-OS/blob/v0.0.21/INSTALL.md#update |
| Steam Deck, Linux PCs (x86_64) | OSD-OS-linux-x86_64.AppImage |
The app with Qt, SDL2 and mpv inside; nothing to install | Make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.21/INSTALL.md#on-steamos--linux-x86_64. Updates: Settings → Update swaps it in place, or the latest AppImage over your copy |
| macOS on Apple Silicon | OSD-OS-v0.0.21-macOS-arm64.dmg |
osdos.app in a disk image | Open it and move osdos.app to your Applications folder. Updates: Settings → Update, or the next .dmg the same way |
The macOS build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or run xattr -dr com.apple.quarantine /Applications/osdos.app before opening it).
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB): the Pi 4 as a TV, the Pi 5 in a JAMMA arcade cabinet, and LAN Play between the two. Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.20
What's New
- A Website line in About, osdos.tv, above Source
- The app builds for Windows (x64, MSVC), with a workflow that uploads it to try
- The app builds on FreeBSD and OpenBSD, with workflows that build and test it there
Changelog
- About and the credits name the pictures' sources by their authors: progetto-SNAPS by AntoPISA, Arcade Database by motoschifo, RetroAchievements for its pictures and badges too
- ArcadeDB asked without use_parent, which its sixth release dropped
- How to build OSD/OS on Windows, in BUILDING.md and the wiki
- The Windows build targets Windows 11, and keeps vcpkg's packages when a run is cancelled
- The script launcher's SIGTERM, and System Information's interfaces, compile on Windows
- A release's files say which system each is for
- The macOS update helper's script has no "/*" for MSVC to take for a comment
- The Windows build's vcpkg cache keeps one key across runner images, and the BSD builds queue instead of cancelling
- The Windows build links with the app's own main
- The regression tests pass on FreeBSD and OpenBSD
- How to build OSD/OS on FreeBSD and OpenBSD, in BUILDING.md and the wiki
- The BSD builds list the calls that ran on a view already torn down
- The FreeBSD and OpenBSD builds count for the pull request
Bug Fixes
- The Windows build finds vcpkg's packages under the MSVC environment
- The lobby and game details pages leave their lists alone once their Loader lets them go
Downloads
| System | File | What it is | Install and update |
|---|---|---|---|
| Raspberry Pi 4 and 5 | OSD-OS-v0.0.20-raspberry-pi.img.xz |
The whole system: Raspberry Pi OS Lite (64-bit, Debian 13 trixie) with OSD/OS on top. The Pi boots straight into OSD/OS. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.20/os/NOTICE | Flash it with Raspberry Pi Imager (Use custom): https://github.com/mehmetraif/OSD-OS/blob/v0.0.20/os/README.md#flashing. Updates: Settings → Update in the app |
| Raspberry Pi OS (arm64) you set up yourself | install.sh, OSD-OS-v0.0.20-linux-arm64.tar.gz |
The installer, and the app alone, which it installs with its service | bash <(curl -fsSL https://github.com/mehmetraif/OSD-OS/releases/latest/download/install.sh): https://github.com/mehmetraif/OSD-OS/blob/v0.0.20/INSTALL.md#on-a-raspberry-pi. Updates: Settings → Update, or https://github.com/mehmetraif/OSD-OS/blob/v0.0.20/INSTALL.md#update |
| Steam Deck, Linux PCs (x86_64) | OSD-OS-linux-x86_64.AppImage |
The app with Qt, SDL2 and mpv inside; nothing to install | Make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.20/INSTALL.md#on-steamos--linux-x86_64. Updates: Settings → Update swaps it in place, or the latest AppImage over your copy |
| macOS on Apple Silicon | OSD-OS-v0.0.20-macOS-arm64.dmg |
osdos.app in a disk image | Open it and move osdos.app to your Applications folder. Updates: Settings → Update, or the next .dmg the same way |
The macOS build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or run xattr -dr com.apple.quarantine /Applications/osdos.app before opening it).
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB): the Pi 4 as a TV, the Pi 5 in a JAMMA arcade cabinet, and LAN Play between the two. Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.19
What's New
- An online game plays with the host's controller layout, and every player of the host has a port
- The Arcade screen shows the machine's own high scores for a game without a RetroAchievements leaderboard
- Game pictures from progetto-SNAPS where RetroAchievements has none, and a Game Pictures page to download every game's
- Hide Hacks and Bootlegs in Settings → Arcade
- Pixel art and ASCII art on the landing and setup pages, and a clearer way in
- The Arcade screen lists everything known of a room in place of its picture
Changelog
- Add follow-up Pi reliability and Arcade review
- OSD/OS is tested on a Pi 4 as a TV and a Pi 5 in a JAMMA cabinet, with LAN Play between them
- The README's credits open with 240-MP, which OSD/OS grew out of
- The website moves to osdos.tv
- Less work on the GUI thread in the menus and the Arcade screen
- The scan's review: port 1 alone for a game whose players aren't known, the remap written whole, the scaling measured per session
- The pictures review: a paused request stays unasked after a key change, ArcadeDB asked a moment after a game is shown, the records written in one go, hidden bootlegs off the tree's lists
- The arcade tests never ask the real ArcadeDB
Bug Fixes
- Install.sh swaps a release in safely, checks GitHub's SHA-256 and updates a kept service's helpers
- The menus answer in time while a film plays behind them
- A game MAME could not start adds no play time, and a RetroArch that never ran keeps the RetroAchievements password
- A Plex item on its resume prompt no longer reports another video's progress
- An update whose archive could not be extracted is offered again, not an Install that applies nothing
- The image's downloads are tried again after a connection the server reset
- A RetroAchievements pause or guard page no longer passes for a refused Web API key
The OSD/OS image (Raspberry Pi)
OSD-OS-v0.0.19-raspberry-pi.img.xz is the whole system: flash it with Raspberry Pi Imager (Use custom), put the card in the Pi, and it boots straight into OSD/OS. Raspberry Pi OS Lite (64-bit), based on Debian 13 trixie, with OSD/OS on top. How to flash it, and set up Wi-Fi and a user: https://github.com/mehmetraif/OSD-OS/blob/v0.0.19/os/README.md#flashing. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.19/os/NOTICE.
The app
- Raspberry Pi OS Trixie (arm64), on a system you set up yourself: https://github.com/mehmetraif/OSD-OS/blob/v0.0.19/INSTALL.md#on-a-raspberry-pi (
install.shinstallsOSD-OS-v0.0.19-linux-arm64.tar.gz). - macOS (Apple Silicon): download the
.dmg, open it and move osdos.app to your Applications folder.
This build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or runxattr -dr com.apple.quarantine /Applications/osdos.appbefore opening it). - Steam Deck / Linux (x86_64): download
OSD-OS-linux-x86_64.AppImage, make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.19/INSTALL.md#on-steamos--linux-x86_64
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB): the Pi 4 as a TV, the Pi 5 in a JAMMA arcade cabinet, and LAN Play between the two.
Updating
- The image and a Raspberry Pi install: Settings → Update in the app, or https://github.com/mehmetraif/OSD-OS/blob/v0.0.19/INSTALL.md#update
- macOS: Settings → Update, or the
.dmgas above. - Steam Deck / Linux (x86_64): Settings → Update (it swaps the AppImage in place), or the latest AppImage over your copy.
Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.18
What's New
- A remote's channel or page keys play the next or previous film
- The OSD/OS website, with Setup under /setup/
- LAN Play takes up to six players across the machines
- Local Files hides file extensions unless told not to
- OSD/OS Setup's bar links to the repository
- Settings → Controls lists all six players
- Arcade Buttons: a pad's cabinet buttons, the same in MAME and FinalBurn Neo
- Arcade Buttons draws only the arcade stick's top panel
- Arcade Buttons draws a two-player cabinet's control panel
- Arcade Buttons shows the cabinet above and below its panel
- Arcade Buttons tilts the cabinet's screen and slopes its panel
- Arcade Buttons draws the monitor's bezel without speakers
- Arcade Buttons dithers the panel's end; the cabinet's front goes straight down
- Arcade Buttons shades the cabinet's whole right side in a dither
- Arcade Buttons dithers the cabinet's side beside the monitor too
Changelog
- The changes a code scan brought: a config.json kept when it can't be read, one mpv input.conf, Audio Output's notes, no QtQuick.Effects
- A release has five files: the four packages and install.sh
- YouTube reads its channels' feeds four at a time
Bug Fixes
- Stale replies, an unreadable config.json, unbounded downloads and other backend faults from a code scan
- The views' faults from a code scan: key chords, stale items, lost focus, Weather and NFC Reader on Qt 6.4
- The installer swaps a release in whole, a release goes public with every file attached, and the scripts' smaller faults
- OSD/OS Setup checks the RetroAchievements account as the card does, and leaves out imported values the page doesn't offer
- Online Play turned off forgets the lobby and stops its read
- A JAMMA stick's buttons 7 and 8 are FinalBurn Neo's 7 and 8
The OSD/OS image (Raspberry Pi)
OSD-OS-v0.0.18-raspberry-pi.img.xz is the whole system: flash it with Raspberry Pi Imager (Use custom), put the card in the Pi, and it boots straight into OSD/OS. Raspberry Pi OS Lite (64-bit), based on Debian 13 trixie, with OSD/OS on top; tested on the Raspberry Pi 4. How to flash it, and set up Wi-Fi and a user: https://github.com/mehmetraif/OSD-OS/blob/v0.0.18/os/README.md#flashing. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.18/os/NOTICE.
The app
- Raspberry Pi OS Trixie (arm64), on a system you set up yourself: https://github.com/mehmetraif/OSD-OS/blob/v0.0.18/INSTALL.md#on-a-raspberry-pi (
install.shinstallsOSD-OS-v0.0.18-linux-arm64.tar.gz). - macOS (Apple Silicon): download the
.dmg, open it and move osdos.app to your Applications folder.
This build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or runxattr -dr com.apple.quarantine /Applications/osdos.appbefore opening it). - Steam Deck / Linux (x86_64): download
OSD-OS-linux-x86_64.AppImage, make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.18/INSTALL.md#on-steamos--linux-x86_64
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB).
Updating
- The image and a Raspberry Pi install: Settings → Update in the app, or https://github.com/mehmetraif/OSD-OS/blob/v0.0.18/INSTALL.md#update
- macOS: Settings → Update, or the
.dmgas above. - Steam Deck / Linux (x86_64): Settings → Update (it swaps the AppImage in place), or the latest AppImage over your copy.
Each file's SHA-256 digest is beside it under Assets.
OSD/OS v0.0.17
What's New
- RetroArch Lobby and a live Search on the Arcade screen
- LAN Games stays on the Arcade screen while LAN Play is on
- A filter's name too long for the Arcade screen's bar scrolls through it
Bug Fixes
- Local Files opens the card's Movies folder, apart from the Arcade's games
- Hosting or joining a FinalBurn Neo game starts netplay again
The OSD/OS image (Raspberry Pi)
OSD-OS-v0.0.17-raspberry-pi.img.xz is the whole system: flash it with Raspberry Pi Imager (Use custom), put the card in the Pi, and it boots straight into OSD/OS. Raspberry Pi OS Lite (64-bit), based on Debian 13 trixie, with OSD/OS on top; tested on the Raspberry Pi 4. How to flash it, and set up Wi-Fi and a user: https://github.com/mehmetraif/OSD-OS/blob/v0.0.17/os/README.md#flashing. What it is made of, under which licences: https://github.com/mehmetraif/OSD-OS/blob/v0.0.17/os/NOTICE (the .info file lists its packages).
The app
- Raspberry Pi OS Trixie (arm64), on a system you set up yourself: https://github.com/mehmetraif/OSD-OS/blob/v0.0.17/INSTALL.md#on-a-raspberry-pi (
install.shinstallsOSD-OS-v0.0.17-linux-arm64.tar.gz). - macOS (Apple Silicon): download the
.dmg, open it and move osdos.app to your Applications folder.
This build is not notarized, so macOS refuses to open it the first time: then go to System Settings → Privacy & Security and choose Open Anyway (or runxattr -dr com.apple.quarantine /Applications/osdos.appbefore opening it). - Steam Deck / Linux (x86_64): download
OSD-OS-linux-x86_64.AppImage, make it executable (chmod +x) and run it: https://github.com/mehmetraif/OSD-OS/blob/v0.0.17/INSTALL.md#on-steamos--linux-x86_64
Tested on a Raspberry Pi 4 and a Raspberry Pi 5 (8 GB).
Updating
- The image and a Raspberry Pi install: Settings → Update in the app, or https://github.com/mehmetraif/OSD-OS/blob/v0.0.17/INSTALL.md#update
- macOS: Settings → Update, or the
.dmgas above. - Steam Deck / Linux (x86_64): Settings → Update (it swaps the AppImage in place), or the latest AppImage over your copy.
SHA256SUMS has the checksums of the image, the .dmg, the .tar.gz and the AppImage.