https://github.com/leaningtech/cheerpx-games-runner

An open-source Chrome Extension to run your games directly in the browser
https://github.com/leaningtech/cheerpx-games-runner

Last synced: about 1 year ago
JSON representation

An open-source Chrome Extension to run your games directly in the browser

• Host: GitHub
• URL: https://github.com/leaningtech/cheerpx-games-runner
• Owner: leaningtech
• License: apache-2.0
• Created: 2024-07-04T16:25:46.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-30T13:01:22.000Z (over 1 year ago)
• Last Synced: 2025-04-07T10:51:26.558Z (about 1 year ago)
• Language: JavaScript
• Size: 6.79 MB
• Stars: 16
• Watchers: 6
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: ChangeLog
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# CheerpX Games Runner Chrome Extension

[![Discord server](https://img.shields.io/discord/988743885121548329?color=%235865F2&logo=discord&logoColor=%23fff)](https://discord.gg/9AP4b9VTXN)

[![Issues](https://img.shields.io/github/issues/leaningtech/cheerpx-games-runner)](https://github.com/leaningtech/cheerpx-games-runner/issues)

## Overview

CheerpX Games Runner is an open-source Chrome Extension to run your games directly in the browser.

Games are populated from the personal collection of the user, by integrating  with [GOG](https://gog.com) [^1]. Other stores might be supported in the future.

The extension is powered by [CheerpX](https://labs.leaningtech.com/cheerpx), a x86-to-WebAssembly virtual machine. Currently it supports games running on DOS,

support for modern games is also planned in the future.

[^1]: Leaning Technologies is not affiliated with GOG.com in any way.

## Features

1. Play historical games from your collection directly in your browser.

2. Works on any platform, even if not officially supported by the game.

3. No local installation required.

## Installation

1. Clone or download the repository.

2. Open the Chrome browser and navigate to `chrome://extensions/`.

3. Enable "Developer mode" by toggling the switch on the top right.

4. Click on the "Load unpacked" button and select the downloaded repository folder.

## Usage

1. After the extension is installed, click on the extension icon next to the address bar.

2. The CheerpX Games Runner tab will open. Login to GOG.com if needed.

3. Choose a game from the list and click it's icon to run it in your browser.

# Example games

This is non-exhaustive list of games which are known to work, most of them available for free from GOG.com

* Akalabeth: World of Doom

* Jill of the Jungle

* Tyrian 2000

* Ultima 4

* Ultima Martian Dreams

* Ultima Savage Empire

# Bugs and Issues

Please use [Issues](https://github.com/leaningtech/cheerpx-games-runner/issues) to report any bug.

Or come to say hello / share your feedback on [Discord](https://discord.gg/9AP4b9VTXN).

## License

CheerpX Games Runner is released under the Apache License, Version 2.0.

You are welcome to use, modify, and redistribute the contents of this repository.

The public CheerpX deployment is provided **as-is** and is **free to use** for technological exploration, testing and non-commercial uses. Downloading a CheerpX build for the purpose of hosting it elsewhere is not permitted.

If you want to build a product on top of CheerpX, please get in touch: sales@leaningtech.com

## Contact

For any queries or suggestions, feel free to contact on [Discord](https://discord.gg/9AP4b9VTXN).