Skip to content

Modification function

cbepx edited this page Jun 2, 2024 · 26 revisions

APPS Functions

Description

  • APPS is located within the APP Center group
  • APPS folder is located in the Roms folder of the TF1 and TF ROMS partitions
  • APPS folder supports running shell scripts, which can add additional features to the system

Usage


1. Arcade_Core_AUTO

Description

Arcade game core automatic testing function, at present, only arcade games are supported. If the current set core fails to run the game, it will automatically test whether other cores can run. Successful runs will be recorded, and the next time the game fails, the record will be automatically read and the successful core will be used to run the game

Automatic adaptation of core record file location:

  • The anbernic/autocores/ARCADE.csv file located in ROMS partition of TF1

Usage

  • Arcade_Core_AUTO-OFF (Default) - Currently in an disabled state, it will switch to a enabled state after running
  • Arcade_Core_AUTO-ON - Currently in an enabled state, it will switch to a disabled state after running

2. Backup_System_Data & Restore_System_Data

Description

Important data files for backup and recovery of the system, content included:

  • Retroarch related settings file (retroarch.cfg)
  • Drastic related settings file
  • ppsspp related settings file
  • Retroarch Original settings file
  • Retroarch button mapping custom file
  • Front end settings file
  • Favorites and History Files
  • Wifi settings file

Backup files:

  • The anbernic/backup/system.dat file located in ROMS partition of TF1

3. Bezels

Description

This function can automatically adapt bezel (overlay) to the game based on settings

Usage

  • Bezels-OFF (Default) - Automatically disable the bezel function of retroarch before running the game every time. Currently in an OFF state, it will switch to a AUTO state after running
  • Bezels-AUTO - Fully automatic bezel adaptation based on simulator type and game name (game name only suitable for arcade). Currently in an AUTO state, it will switch to a MANUAL state after running
  • Bezels-MANUAL - Fully manual bezel setting function, it is necessary to set up and save separate configuration files for each simulator separately, otherwise confusion may occur. Currently in an MANUAL state, it will switch to a OFF state after running

Bezel Customization File Description

In the root directory of the ROMS partition of TF 1, under the directory anbernic/bezels, corresponding to the sub folder of the emulator name (under Roms directory):

  1. default.cfg - Bezel configuration parameter file, with internal parameters as follows

The following default parameters do not need to be modified

  • overlays=1
  • overlay0_overlay=default.png (note: changing the file name requires corresponding to the actual border file)
  • overay0_full_screen=true
  • overay0_descs=0

Explanation: The following are magic modification parameters that can be modified as needed

  • #grhparameter (0-disable 1-enable)
  • #grh'ratio (4/3, 16/9, 16/10, 16/15, 21/9, 1/1,2/1,3/2, 3/4, 4/1,9/16, 5/4, 6/5, 7/9, 8/3, 8/7, 19/12, 19/14, 30/17, 32/9, config, squarepixel, core, custom, full)
  • #grd_integratscale (0-disable, 1-enable)
  • grh_parameter=1 (whether to enable the magic modification parameter function, 0- off 1- on)
  • grh'ratio=custom (Screen scale setting, optional parameters can be found in the comments above, usually set to core, can be customized and set to custom)
  • grh_integerscale=0 (whether to enable integer scaling, 0- off 1- on)

The following parameters take effect when grh'ratio=custom

  • grh_custom_viewport_width=512 (Custom screen width in pixels)
  • grh_custom_viewport_height=448 (Custom screen height in pixels)
  • grh_custom_viewport_x=64 (The offset distance of the screen relative to the left boundary, in pixels)
  • grh_custom_viewport_y=16 (The offset distance of the screen from the upper boundary, in pixels)
  1. default.png - Border image file, file name should be consistent with default.cfg

Description of border function settings:

  • Border automatic configuration - turned off - requires manual opening, closing, and setting of borders when running the game
  • Border automatic configuration - fully automatic - fully automatic adaptation to preset borders when running the game

4. Change_RA_Hotkey

Description

The shortcut key used to modify retroarch activates the hotkey. You can choose whether to use the F button or the SELECT button. Note that this function is only valid on the RG35xx H model

Usage

  • Change_RA_Hotkey-F (Default) - Currently using the SELECT button as a shortcut to activate hotkeys, after running, it will switch to using the F button as a shortcut to activate hotkeys
  • Change_RA_Hotkey-SELECT - Currently using the F button as a shortcut to activate hotkeys, after running, it will switch to using the SELECT button as a shortcut to activate hotkeys

5. Network_Time_Protocol

Description

The function of automatically setting time zones and synchronizing dates and times through networking

  • Time Zone - Automatically set the time zone of the external IP address obtained through networking

  • Date and Time - Automatically access the timing server after networking and set the date and time based on the time zone

  • Automatically set and save local time during startup and shutdown Tip

  • Need to connect to the internet through WiFi and obtain the correct external network address

  • Due to the randomness of IP addresses provided by network service providers, there may be deviations between the obtained time zone and the actual situation

  • Automatic time setting may trigger the system's timed screen lock function, causing the machine to black out and enter sleep mode. Press the power button to wake up

  • Due to the mechanism of displaying the refresh time on the front-end, the displayed time on the front-end may not change immediately after the time is automatically set. Simply run a game or APPS script and exit to refresh the time Usage

  • Network_Time_Protocol-OFF (Default) - At present, the time zone is disabled, and the automatic date and time networking timing function can save power to a certain extent. After running, it can be switched to enabled

  • Network_Time_Protocol-ON - At present, the time zone is enabled, and the automatic date and time networking timing function can save power to a certain extent. After running, it can be switched to disabled


6. Night_Mode

Description

After opening, the brightness of the retroarch simulation game screen can be reduced, making it suitable for playing games at night or in dark environments. The principle is to automatically activate the Darken.fit video filter built-in in retroarch. Tip

This feature will not reduce the brightness of the front-end and third-party independent simulators Usage

  • Night_Mode-OFF (Default) - Currently, night mode is disabled and enabled after running
  • Night_Mode-ON - Currently, night mode is enabled and disabled after running

7. Power_LED

Description

Turning on and off the host power light is perfect for nighttime use Tip

This function is one-time and returns to normal after shutdown and restart Usage

  • Power_LED-Turn_OFF - Turn off the power light
  • Power_LED-Turn_ON- Turn on the power light

8. Quick_Shutdown_Set

Description

This function can change the effect of short pressing the power button, and the host will no longer sleep, but will quickly shut down. If you are playing a game before shutting down, the game status will be automatically saved and will be automatically restored to the game status before shutting down on the next boot, which is very suitable to replace the originally unsatisfactory sleep function Tip

  • This function is only valid in the retroarch simulator and front-end interface

  • Third party emulators do not support game save state and still use sleep mode

  • A very small number of emulators and games may experience incompatibility issues with this feature, resulting in failure to restore game state or even freezing Usage

  • Quick_Shutdown-OFF (Default) - The current quick shutdown setting is disabled, but it will switch to enabled after running

  • Quick_Shutdown-ON - The current quick shutdown setting is enabled, but it will switch to disabled after running


9. Reset_APPS

Description

Reinstall the default scripts in the APPS feature and restore the default settings for each feature to solve various error problems that may occur in the system Tip

After running, the data files corresponding to the APPS function will be reinstalled, which takes a long time. After completion, the system will automatically restart. Please be patient and wait


10. Shaders

Description

This function can automatically adapt shader to the game based on settings Usage

  • Shaders-OFF (Default) - Currently, the shader is turned off, and the shader function will be automatically turned off every time the retroarch game is launched. After running, it will switch to AUTO mode
  • Shaders-AUTO - Currently, the shader is AUTO mode, fully automatic Shaders adaptation based on simulator type. After running, it will switch to MANUAL mode
  • Shaders-MANUAL - Currently, the shader is MANUAL mode, fully manual Shaders setting function, it is necessary to set up and save separate configuration files for each simulator separately, otherwise confusion may occur. After running, it will switch to OFF mode

11. SSH_Server

Description

Turn on or off the SSH server function of the host Tip

  • Need to connect to the internet through WiFi

  • The default access port is: 22

  • User name: root

  • Password: root Usage

  • SSH_Server-OFF (Default) - After running, the SSH service will switch to enabled

  • SSH_Server-ON - After running, the SSH service will switch to disabled


12. Varcade_Rotation

Description

Set whether the vertical arcade group game has automatic rotation enabled. After setting, the vertical arcade will be automatically set to rotate when starting the game. If the border function is also enabled, it will automatically adapt to the horizontal or vertical borders Tip

  • RG35xx Plus recommends disabling this feature and playing games in a normal way

  • RG35xx H recommends enabling this feature and playing games in a rotated manner Usage

  • Varcade_Rotation-OFF (Default) - After running, the Varcade Rotation will switch to enabled

  • Varcade_Rotation-ON - After running, the Varcade Rotation will switch to disabled


13. Random-All_Game & Random-Emulation

Description

Don't know what game to play? Let me help you choose! Tip

  • Random-All_Game: This function automatically picks a random game from TF1 or TF2 or Favorite or History and runs it.
  • Random-Emulation: This feature can create a flag called -Random- under the supported emulator. By running this flag, a game can be randomly run in the current emulator.
  • Some games may not be able to run.

Usage

  • After running, just follow the on-screen instructions.

14. Random-bootlogo

Description

This feature supports randomly displaying the logo image of the first screen of startup Tip

  • The bootlogo image is saved in the anbernic/bootlogo folder of the TF1 Roms partition
  • There is no special restriction on image file names, and the total number should not exceed 10
  • The logo that automatically changes during this startup will be displayed on the next startup
  • Logo image requirements:
  1. Resolution: 640x480
  2. File format: bmp
  3. Color bit depth: 24 bits

Special function

If only one logo image is placed in the anbernic/bootlogo folder, it will be set as a fixed boot logo by default and automatically deleted

Usage

  • Random4-bootlogo-OFF (Default) - Currently disabled Random_logo features, enable function after running
  • Random4-bootlogo-ON - Currently enabled Random_logo features, disabled function after running, restore bootlogo to default anbernic picture

15. Show_MOD_info

Description

Display system date, model, OS version, modified version, storage space and other related information

Usage

  • After running, relevant system information will be displayed on the screen
  • Press A to switch display pages, press M/F to exit

16. RA_Turbo_Key

Description

Set retroarch Turbo activation hotkey Tip

How to use the shortcut key to activate Turbo

  • For example, if R2 is set as a shortcut key, when you need to use the B key to fire continuously in the game, first hold down the B key and press the R2 key to enable the automatic firing of the B key.
  • When the B key is set as the activation key, pressing the B key in the game will automatically turn on the B key burst.
  • This feature is only supported by the retroarch emulator

Usage

  • After running abc, follow the on-screen instructions to long-press the burst shortcut key you want to set, wait for the indicator to point to the corresponding key, and then press START to save the setting and exit.
  • If you want to cancel the current settings, press and hold the SELECT key. After the indicator disappears, press the START key to save and exit.
  • Pressing the M/F key will not make any changes and exit.

17. Mirr._with_CLD_Lid

Description

Used to set whether the system enters standby mode when the RG35xx SP is connected to the HDMI output and the front cover is closed. Usage

  • When enabled, the system will not go to sleep even if the lid is closed when connected to HDMI output.
  • When disabled, the system will go into sleep mode when the lid is closed while the HDMI output is connected.

18. Real_Time_Game_Guide

Description

You can switch to the interface for querying game Guide during the game, and it will automatically return to the interruption point of the game after the game is finished. Tip

  • This feature only supports retroarch emulators.
  • You need to prepare a Guide file in .txt or .epub format in advance and place the file in the path where the game rom file is located. The strategy file name needs to be the same as the game rom file name.
  • In the game, hold down L2 + R2 and then press down on the dpad to activate the Guide view interface. Use the arrow keys to view the corresponding Guide.
  • After the game is finished, press the M/F key to return to the point where the game was interrupted and continue.

Usage

  • Enable to activate the viewing function
  • Disable to deactivate the viewing function

19. Backup_&_Restore_TF1_Save

Description

Backing up and restoring save game files on TF1. Tip

  • The backup file is saved in TF1: /anbernic/backup/savegame.dat or TF2: /anbernic/backup/savegame.dat.
  • The location of backup and restore files is based on TF2 first. If TF2 does not exist, TF1 will be used first.
  • Please copy the backup file to another safe location as soon as possible after the backup.

Usage

  • After running, there will be a backup and restore operation prompt, just follow the prompt to select the corresponding function.

20. Switch_font_size

Description

Can automatically switch between regular and large font sizes. Tip

  • This function only affects the text display on the front-end interface and will not affect the text size on the emulator interface.
  • After switching to large font, some files will be displayed beyond the preset boundaries.

Usage

  • Automatically complete the switch after running.

21. RA_Combination_keys

Description

Which can use L1 or R1 as the combination function of A+B or A+Y. Tip

  • A+B: Pressing L1 or R1 is equivalent to pressing the A and B keys at the same time, which is suitable for arcade games that require the A+B key combination.
  • A+Y: Pressing L1 or R1 is equivalent to pressing the A and Y keys at the same time, which is suitable for arcade games that require the A+Y key combination.

Usage

  • Follow the on-screen instructions after running.

22. Theme_Manager

Description

Used to uniformly manage customized theme resources Requirements

  • This template needs to be used with the "Theme_Master" function in the StockOS MOD version produced by me.
  • To use the "Theme_Master" function, you need to upgrade to the MOD v2.3 or above.

Instructions

  1. The theme template is a .zip compressed file, which needs to be decompressed and modified accordingly.

.zip contains file and folder descriptions: (1) bootlogo Saved in this folder is the logo image displayed on the first screen after booting. The format is a .bmp image with a 24-bit depth and a resolution of 640x480 pixels. The file name requirements must be 35xx.bmp and 28xx.bmp. Due to the 28xx screen rotation requirements, the corresponding 28xx.bmp image needs to be rotated in advance. Please pay attention when making it. Note that this folder is optional!

(2) font This folder saves theme-specific font files. The extension is required to be .ttf. The file name can be arbitrary. Note: This folder is optional!

(3) theme This folder saves the contents of the resource folders of the two styles, res1 and res2, corresponding to the theme. The theme can be modified accordingly according to the corresponding resources. Note: The unmodified resource files in this folder can be deleted without being retained!

  1. Preview image preview.png This file is a theme preview picture, which is a picture of the theme displayed when running as the "Theme Manager". The file format is a .png picture with a resolution of 640x480 pixels. Note: The file must exist and the file name cannot be modified at will, otherwise the "Theme Manager" will not be able to recognize and install the corresponding theme!

  2. Theme structure after packaging The name of the packaged .zip file can be arbitrary, and the name of the main folder where it is stored can also be arbitrary.

20240531225644