mirror of
https://github.com/antonlabz/KantOS.git
synced 2024-10-31 05:23:19 -07:00
93 lines
4.2 KiB
Markdown
93 lines
4.2 KiB
Markdown
|
|
|
|
# About
|
|
|
|
KantOS is a theme ported for OnionOS, which is inspired by the Kanto region of Pokémon.
|
|
|
|
The concept design was first created by [Tressley on muOS](https://github.com/Tressley/KantOS/tree/main) for the Anbernic handheld devices.
|
|
|
|
I was a huge fan of it, and I'd like to express my appreciation to Tressley for creating the theme and also giving me permission to port it to OnionOS which I have since heavily modified to suit the OnionOS architecture, and also included many of my own additions.
|
|
|
|
# Credits
|
|
|
|
- *Aemiii91* for letting me include their `Dot-art by Yoshi-kun` icon pack from the [Onion Theme Repo](https://github.com/OnionUI/Themes/blob/main/generated/icons_standalone/index.md)
|
|
- [Spriters-Resource](https://www.spriters-resource.com) for the Pokémon sprites
|
|
- [Yuji Oshimoto](http://www.04.jp.org/) for the `04b_03` font
|
|
- Pokémon Black/White 2 for the Virbank City OST used as BGM
|
|
|
|
# Important Notes
|
|
|
|
- It is ***highly*** recommended to update your OnionOS to at least `v4.3.1-1` or higher, as it removes the text-shadow effect that's present on earlier versions which is incompatible with the font used here (see the [OnionOS Releases page](https://github.com/OnionUI/Onion/releases) or use the OTA feature within `Apps` on your Miyoo Mini)
|
|
- On the wifi configuration page, the font color of the highlighted item as well as the font in the keyboard pop-up when you go to enter a wifi password are both *bugged*, since those appear to be set at the system-level and isn't something I can change through the config file
|
|
- **In case you have any existing theme overrides**, I recommend that you enable the `battery percentage` option with the following settings to replicate what's been set in the config file for the best UI experience:
|
|
|
|
Go to `Apps > Tweaks > Appearance > Theme overrides > Battery Percentage`
|
|
|
|
```json
|
|
"Visible": set to "-" (the theme config will turn it on by default)
|
|
"Font family": set to 'Exo-2-Bold-Italic_Universal'
|
|
"Font size": 18 px
|
|
"Text alignment": Left
|
|
"Fixed position": off
|
|
"Horizontal/Vertical offset": both set to 0 or off
|
|
```
|
|
|
|
# Download
|
|
|
|
Go to the [Releases](https://github.com/antonlabz/KantOS/releases) page and download the `Source code (zip)` file.
|
|
|
|
# Installation
|
|
|
|
**To install the default theme:**
|
|
|
|
- Place the downloaded ZIP file into the `Themes` folder of your SD card
|
|
- Apply the theme by going to `Apps > Themes`
|
|
|
|
**To install the alt version:**
|
|
|
|
- Extract the downloaded ZIP file
|
|
- Copy the images instead the `alt-skin` folder
|
|
- Past them into the `skin` folder to replace the existing ones
|
|
- Place the entire folder into the `Themes` folder of your SD card and apply the theme
|
|
|
|
# How is the alt version different?
|
|
|
|
The original design is based off the muOS theme which has the 3 primary menus as buildings, while the remaining menus are more minimal 'material' icons.
|
|
|
|
The alt version replaces the icons for `Expert`, `Apps` & `Settings` to overworld elements, in order to match the aesthetic of the buildings.
|
|
|
|
Please see the next section which showcases both.
|
|
|
|
# Screenshots
|
|
|
|
#### Default
|
|
|
|
|
|
|
|
#### Alt Version
|
|
|
|
|
|
|
|
#### Settings
|
|
|
|
|
|
#### Games
|
|
|
|
|
|
#### Boot Screen
|
|
|
|
|
|
#### Low Battery
|
|
|
|
|
|
#### Charging Animation
|
|
|
|
|
|
#### Power Off + Save
|
|
|
|
|
|
#### Power Off
|
|
|
|
|
|
#### GameSwitcher
|
|
|