Skip to content

RetroGFX/UnofficialOS

 
 

Repository files navigation

      Latest Version Activity Pull Requests Discord Server

UnofficialOS (uOS) is a community developed Linux distribution for handheld gaming devices. It was originally based on and is forked from Just Enough Linux Operating System (JELOS).

Installation

Fresh Install

  1. Download the proper *.img.gz for your device from the releases section.
  2. Extract the .img file and flash the image to your microSD card using your favorite image writing tool (Balena Etcher, Raspberry Pi Imager, Win32 Disk Imager, dd etc.)

Upgrading From JELOS or UnofficialOS 20221218 and Earlier

  1. Download the latest release .tar of UnofficialOS for your device.
  2. Rename the update from UnofficialOS-*.tar to JELOS-*.tar
  3. Copy the update .tar to your device to your device's update directory (/storage/.update) via SSH, SMB etc.
  4. Reboot the device, and the update will begin automatically.

Network Access

  • External services are disabled by default in stable builds. When enabled, the username for ssh and samba access is "root". The root password is generated during every boot, it can be found in the System Settings menu.

RetroArch Hotkeys

  • Hotkey Enable: Select (Hold)
    • Exit: Start (Press Twice)
    • Menu: X
    • Show/Hide FPS: Y
    • Save State: R1
    • Load State: L1
    • Rewind: L2
    • Fast-Forward Toggle: R2

UnofficialOS

Licenses

UnofficialOS is a Linux distribution that is made up of many open-source components. Components are provided under their respective licenses. This distribution includes components licensed for non-commercial use only.

UnofficialOS Branding

UnofficialOS branding and images are licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are free to

  • Share — copy and redistribute the material in any medium or format
  • Adapt — remix, transform, and build upon the material

Under the following terms

  • Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
  • NonCommercial — You may not use the material for commercial purposes.
  • ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

UnofficialOS Software

Copyright 2022-present

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

UnofficialOS Documentation

Contributing to UnofficialOS

Credits

Like any Linux distribution, this project is not the work of one person. It is the work of many persons all over the world who have developed the open source bits without which this project could not exist. Special thanks to JELOS, CoreELEC, LibreELEC, AmberELEC, ArkOS, and to developers and contributors across the handheld community.

About

Home of the uOS Linux distribution.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Makefile 55.8%
  • Shell 23.9%
  • C 13.9%
  • Python 4.9%
  • CMake 0.9%
  • Emacs Lisp 0.4%
  • Other 0.2%