wbrawner/distribution
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
5650 commits 2 branches 0 tags 108 MiB
Makefile 59%
Shell 34.4%
Python 4.9%
CMake 0.9%
Emacs Lisp 0.4%
Other 0.2%
Find a file
fewtarius 0e1b52fe8c
Merge pull request #2060 from fewtarius/dev 
Bump ES (GPU profile relabel)
2023-09-15 06:16:39 -04:00
.github Add Ayn to the release notes. 2023-09-14 09:47:33 +00:00
config Enable Vita3K support on AMD64 builds 2023-09-07 21:08:45 +00:00
distributions/JELOS Drop splash package. 2023-09-03 14:36:33 +00:00
documentation Add a section about pushing modified images using scp/ssh. 2023-09-10 10:56:19 -04:00
licenses Rework libmali-vulkan package. 2023-08-25 15:12:58 +00:00
linaro Adds initial support for multiboot OGU and Max 3. 2023-07-01 15:45:03 +00:00
packages Bump ES (GPU profile relabel) 2023-09-15 10:16:11 +00:00
projects Merge pull request #2054 from brooksytech/dev 2023-09-13 11:10:33 -07:00
scripts Fix dependency issue with the Linux kernel, clean initramfs when the kernel is cleaned/updated, and add the ayn-platform module (not included by default yet). 2023-09-14 20:58:08 +00:00
templates Fix missing template data. 2023-07-14 14:16:48 +00:00
tools * foreach now supports command stacking, ex: 2023-07-15 15:50:50 +00:00
.dockerignore JELOS 20220205 - Release 2022-02-05 09:23:32 -05:00
.gitignore First iteration of generated systems documentation. 2023-07-14 11:39:36 +00:00
CODE_OF_CONDUCT.md Move a few docs back to not break GitHub integration. 2023-07-14 21:36:23 +00:00
CONTRIBUTING.md Move a few docs back to not break GitHub integration. 2023-07-14 21:36:23 +00:00
Dockerfile dos2unix: introduce new package 2023-09-04 17:46:30 +00:00
LICENSE.md Move a few docs back to not break GitHub integration. 2023-07-14 21:36:23 +00:00
Makefile * foreach now supports command stacking, ex: 2023-07-15 15:50:50 +00:00
post-update * Fix long standing issue with busybox and bash. 2022-03-16 18:03:28 -04:00
PULL_REQUEST_TEMPLATE.md Move a few docs back to not break GitHub integration. 2023-07-14 21:36:23 +00:00
README.md Add Ayn Max as supported. 2023-09-11 11:34:42 +00:00

README.md

        Latest Version Activity Pull Requests Discord Server

Just Enough Linux Operating System (JELOS) is an immutable Linux distribution for handheld gaming devices developed by a small community of enthusiasts. Our goal is to produce an operating system that has the features and capabilities that we need, and to have fun as we develop it.

Features

  • JELOS has a very active community of developers and users.
  • Integrated cross-device local and remote network play.
  • In-game touch support on supported devices.
  • Fine grain control for battery life or performance.
  • Includes support for playing Music and Video.
  • Bluetooth audio and controller support.
  • Support for HDMI audio and video out, and USB audio.
  • Device to device and device to cloud sync with Syncthing and rclone.
  • VPN support with Wireguard, Tailscale, and ZeroTier.
  • Includes built-in support for scraping and retroachievements.

Screenshots

System View Menu View Game List
system-view menu gamelist-view-metadata-off-immersive

Community

The JELOS community utilizes Discord for discussion, if you would like to join us please use the link below.

Licenses

JELOS 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.

JELOS Branding

JELOS 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.

JELOS Software

Copyright 2021-present Fewtarius

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.

Documentation

Documentation For Developers

Documentation For Everyone

Using JELOS

Device Support

JELOS supports a variety of ARM and Intel/AMD based devices1.

Manufacturer Device CPU / Architecture Kernel GL driver Interface
Anbernic RG351P/M Rockchip RK3326 (ARM) Mainline Linux Panfrost Weston + EmulationStation
Anbernic RG353P2 Rockchip RK3566 (ARM) Rockchip BSP 4.19 Mali KMS/DRM + EmulationStation
Anbernic RG353M2 Rockchip RK3566 (ARM) Rockchip BSP 4.19 Mali KMS/DRM + EmulationStation
Anbernic RG353V2 Rockchip RK3566 (ARM) Rockchip BSP 4.19 Mali KMS/DRM + EmulationStation
Anbernic RG353VS2 Rockchip RK3566 (ARM) Rockchip BSP 4.19 Mali KMS/DRM + EmulationStation
Anbernic RG503 Rockchip RK3566 (ARM) Rockchip BSP 4.19 Mali KMS/DRM + EmulationStation
Anbernic RG552 Rockchip RK3399 (ARM) Mainline Linux Panfrost Weston + EmulationStation
Anbernic Win600 AMD Athlon Silver 3050e (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
Atari VCS AMD Ryzen R1606G (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
AOKZOE A1 Pro AMD 7840u (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
AYANEO3 Air / Air Pro Amd Ryzen 5 5560U / AMD Ryzen 7 5825U (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
AYANEO3 Air Plus Amd Ryzen 7 6800U / (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
AYANEO3 AYANEO 2 Amd Ryzen 7 6800U / (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
Ayn Loki Zero AMD Athlon Silver 3050e (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
Ayn Max Amd Ryzen 7 6800U / (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
GPD Win 4 Amd Ryzen 7 6800U / (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
GPD Win Max 2 (2022) Amd Ryzen 7 6800U / (x86_64) Mainline Linux Radeonsi Weston + EmulationStation
Hardkernel Odroid Go Advance Rockchip RK3326 (ARM) Mainline Linux Panfrost Weston + EmulationStation
Hardkernel Odroid Go Super Rockchip RK3326 (ARM) Mainline Linux Panfrost Weston + EmulationStation
Hardkernel Odroid Go Ultra Amlogic S922X / Mali G52 M6 (ARMv8-A) Mainline Linux Mali Weston + EmulationStation
Indiedroid Nova Rockchip RK3588S / Mali G610 (ARMv8-A) Rockchip 5.10 BSP Linux Panfrost Weston + EmulationStation
Orange Pi Orange Pi 5 Rockchip RK3588S / Mali G610 (ARMv8-A) Rockchip 5.10 BSP Linux Panfrost Weston + EmulationStation
Powkiddy RGB10 Max 3 Pro Amlogic A311D / Mali G52 M4 (ARMv8-A) Mainline Linux Mali Weston + EmulationStation
Powkiddy RGB30 Rockchip RK3566 (ARM) Rockchip BSP 4.19 Mali KMS/DRM + EmulationStation
Powkiddy RK2023 Rockchip RK3566 (ARM) Rockchip BSP 4.19 Mali KMS/DRM + EmulationStation
Powkiddy x55 Rockchip RK3566 (ARM) Rockchip BSP 4.19 Mali KMS/DRM + EmulationStation

1 While not technically supported, JELOS is known to work well on a variety of generic x86_64 devices including gaming PCs, mini PCs, and laptop computers.

2 Anbernic RG353P/M/V/VS devices with both v1 and v2 displays are supported. RG353PS will not be supported.

3 To boot JELOS on Ayaneo devices, hold LC and volume up and press the power button, continue holding "LC" and volume up until the Ayaneo logo appears. Select the storage device with JELOS from the boot menu using the Ayaneo button, and then press volume up to boot the distribution.

Installation

  • JELOS is installed by restoring an image file and Flashing to a device's internal storage or an external sd card.
  • On x86 devices JELOS includes an installation tool. The installation tool can be found in the tools menu, which is one of the systems listed within ES.
  • JELOS operating system is stored on an Ext4 partition that can be read by LINUX but is not natively readable on Windows. Currently it is not possible to access the primary JELOS Ext4 partition on Windows to transfer roms.
  • On devices that support a second sd card, the sd card can be formatted as Ext4, FAT32, or exFAT. JELOS will automatically detect the second SD card on boot and configure the relevant folders for storing roms.
  • External services are disabled by default in release 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.

Flashing

Upgrading

  • Download and install the update online via the System Settings menu.
  • Download the latest version of JELOS (.tar) for your device.
  • Copy the update to your device over the network to your device's update share.
  • Reboot the device, and the update will begin automatically.

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 CoreELEC, LibreELEC, and to developers and contributors across the open source community.