{"id":27851946,"url":"https://github.com/playtron-os/gameos","last_synced_at":"2026-04-02T14:49:13.567Z","repository":{"id":255546489,"uuid":"604332945","full_name":"playtron-os/gameos","owner":"playtron-os","description":"Playtron GameOS provides a seamless and secure Linux gaming experience.","archived":false,"fork":false,"pushed_at":"2026-04-01T19:01:58.000Z","size":4683,"stargazers_count":108,"open_issues_count":4,"forks_count":12,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-04-02T06:15:48.104Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/playtron-os.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-02-20T20:49:25.000Z","updated_at":"2026-04-01T00:30:08.000Z","dependencies_parsed_at":"2024-09-06T01:31:42.944Z","dependency_job_id":"916f052f-b7d1-4d88-8ac9-b59a65600b91","html_url":"https://github.com/playtron-os/gameos","commit_stats":null,"previous_names":["playtron-os/playtron-os","playtron-os/gameos"],"tags_count":435,"template":false,"template_full_name":null,"purl":"pkg:github/playtron-os/gameos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playtron-os%2Fgameos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playtron-os%2Fgameos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playtron-os%2Fgameos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playtron-os%2Fgameos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/playtron-os","download_url":"https://codeload.github.com/playtron-os/gameos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/playtron-os%2Fgameos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31308446,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-04T02:01:51.392Z","updated_at":"2026-04-02T14:49:13.546Z","avatar_url":"https://github.com/playtron-os.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Playtron GameOS\n\nTable of Contents:\n- [Introduction](#introduction)\n- [Minimum Hardware Requirements](#minimum-hardware-requirements)\n- [Game Compatibility](#game-compatibility)\n- [Sideloading Games](#sideloading-games)\n- [Build](#build)\n- [Linux Developer Tips](#linux-developer-tips)\n\n## Introduction\n\nTurn your PC into a game console. Playtron GameOS has native integration with Epic Games Store, GOG.com, and Steam. Your library of games is accessible via a simple gamer-focused interface.\n\nRead more about Playtron on [our official website](https://www.playtron.one/).\n\n[Download Playtron GameOS here](https://www.playtron.one/game-os#download-playtron-os).\n\n## Minimum Hardware Requirements\n\n- CPU\n    - x86\n        - AMD Ryzen or Intel 6th Gen Kaby Lake\n- GPU\n    - AMD Navi\n        - For the best results, we recommend using an AMD GPU.\n    - Intel Xe\n    - NVIDIA Turing\n\nDevices tested on Playtron GameOS are reported in [this document](DEVICES.md).\n\n## Game Compatibility\n\nMost games are expected to work. For problematic games, you can help our community by using [GameLAB](https://github.com/playtron-os/gamelab) to create custom launch configurations and/or controller configurations. Our team will work to get these fixes upstream into [umu-protonfixes](https://github.com/Open-Wine-Components/umu-protonfixes) for everyone to benefit. Full guides on how to use GameLAB can be found [here](https://www.playtron.one/contribute).\n\n## Sideloading Games\n\nLocal games can be copied over to Playtron GameOS and integrated using the [local](https://github.com/playtron-os/plugin-local) plugin.\n\n## Build\n\nInstall the required build dependencies.\n\nFedora Atomic Desktop:\n\n```\n$ sudo rpm-ostree install \\\n    go-task \\\n    qemu-kvm \\\n    virt-install \\\n    virt-manager\n```\n\nFedora Workstation:\n\n```\n$ sudo dnf install \\\n    go-task \\\n    qemu-kvm \\\n    rpm-ostree \\\n    virt-install \\\n    virt-manager\n```\n\nEnable and start the `libvirtd` service.\n\n```\n$ sudo systemctl enable --now libvirtd\n```\n\nDefine a container image tag.\n\n```\n$ export TAG=replace-me\n```\n\nBuild an unstable development container image. Alternatively, build a stable container image based on the previous release.\n\n```\n$ go-task container-image:build:unstable\n```\n\n```\n$ go-task container-image:build:stable\n```\n\nOptionally authenticate to a container registry.\n\n```\n$ export REGISTRY=ghcr.io\n$ export PROJECT=playtron-os\n$ export IMAGE=playtron-os\n$ export REGISTRY_TOKEN=\"replace-me\"\n$ go-task container-image:auth\n```\n\nPush the image to a container registry and either create a `:testing` tag or a `:latest` tag automatically.\n\n```\n$ go-task container-image:push\n```\n\n```\n$ go-task container-image:release\n```\n\nThen build the raw operating system image. Use Virtual Machine Manager (`virt-manager`) to check the installation progress of the `playtron-os` virtual machine.\n\n```\n$ sudo -E go-task disk-image:kickstart\n```\n\n## Linux Developer Tips\n\nPlaytron GameOS container images are published to the GitHub Container Registry (GHCR). These can be found [here](https://github.com/orgs/playtron-os/packages/container/package/playtron-os) at the GitHub organization level (not the GitHub repository level).\n\nDefault Linux user account credentials:\n\n- Username: `playtron`\n- Password: `playtron`\n\nDevelopers can access a terminal two different ways:\n\n- Enable remote SSH access.\n    - Settings \u003e Advanced \u003e Remote Access: On\n    - Settings \u003e Internet \u003e Registered Wi-Fi networks \u003e (select the connected Wi-Fi network and take note of the \"IP Address\")\n    ```\n    $ ssh -l playtron $IP_ADDRESS\n    ```\n- Or open a TTY console.\n    - Connect a keyboard and then press `CTRL`, `ALT`, and `F3` at the same time.\n\nThis user has elevated privileges via the use of `sudo`.\n\n```\n$ sudo whoami\n```\n\nThere is no password for the `root` user account. Set one to help with troubleshooting boot issues.\n\n```\n$ sudo passwd root\n```\n\nSwitch to a minimal Weston desktop environment.\n\n```\n$ sudo playtronos-session-select dev\n```\n\nSwitch back to the Playtron experience.\n\n```\n$ sudo playtronos-session-select user\n```\n\nEnable Flathub.\n\n```\n$ flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo\n```\n\nEnable LanCache support for Epic Games Store. Steam already supports LanCache. GOG.com does not support LanCache.\n\n```\n$ crudini --set ~/.config/legendary/config.ini Legendary disable_https true\n```\n\nCreate and use a container for development purposes.\n\n```\n$ distrobox create --init --additional-packages systemd --image fedora:43 --pull --name fedora43\n$ distrobox enter fedora43\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplaytron-os%2Fgameos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplaytron-os%2Fgameos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplaytron-os%2Fgameos/lists"}