Replay Control

Getting Started

Wed, 01 Jan 2025 00:00:00 +0000

A quick guide to get Replay Control running on your Pi.

Replay Control home page

Prerequisites

A Raspberry Pi running RePlayOS
ROM files for the systems you want to play
A computer, phone, or tablet on the same network as the Pi

Install

From any computer on the same network, or directly on the Pi:

Installation

Wed, 01 Jan 2025 00:00:00 +0000

How to install, update, and uninstall Replay Control on a Raspberry Pi running RePlayOS.

Quick Install

curl -fsSL https://raw.githubusercontent.com/lapastillaroja/replay-control/main/install.sh | bash

No arguments needed. The installer:

Game Library

Wed, 01 Jan 2025 00:00:00 +0000

How the game library works from a user perspective: browsing systems, managing ROMs, and keeping your library up to date.

Search

Wed, 01 Jan 2025 00:00:00 +0000

How global search, developer search, and the developer game list work.

Cross-system search results

Global Search

Cross-system search accessible from the bottom nav Search tab, the home page search bar, or the / keyboard shortcut.

Game Detail

Wed, 01 Jan 2025 00:00:00 +0000

Everything on the game detail page: info, media, navigation, and actions.

Game detail page

Box Art and Screenshots

The top of the page shows box art with a screenshots gallery. Tap the box art to browse screenshots and title screens in a lightbox carousel.

Game Series and Franchises

Wed, 01 Jan 2025 00:00:00 +0000

How game series and franchise relationships are displayed.

Overview

Replay Control identifies games that belong to the same series or franchise and surfaces this on the game detail page. This enables sequel/prequel navigation, cross-system series browsing, and helps you discover related games.

Recommendations

Wed, 01 Jan 2025 00:00:00 +0000

How the recommendation engine works across the home page, favorites page, and game detail page.

Personalized recommendations on the home page

Home Page

The home page shows several recommendation blocks, each tailored to your library:

Metadata

Wed, 01 Jan 2025 00:00:00 +0000

How game metadata is sourced and used.

Offline-First Design

Replay Control works fully offline from the first install. Built-in databases provide genre, player count, year, and display names for ~34K console ROMs and ~15K playable arcade games without any network access.

Thumbnails

Wed, 01 Jan 2025 00:00:00 +0000

How box art and screenshot images are downloaded, matched, and displayed.

Image Sources

All images come from libretro-thumbnails on GitHub. Three image types are available per system:

WiFi, NFS & Pi Setup

Wed, 01 Jan 2025 00:00:00 +0000

Manage your Raspberry Pi’s network connectivity, storage, hostname, and access. These settings are accessible from the Settings page.

Overview

Configuration settings modify the Pi itself and are essential for network setup, NFS connectivity, and system access. On non-RePlayOS systems (local development), these options are safely skipped.