Skip to content
Chemicalabuse edited this page Jan 5, 2025 · 3 revisions

Here you will find applications and tools included in CrossMix-OS.

System Tools

banner system tools

System Tools is the core app of CrossMix-OS, enabling you to customize your OS to match your personal preferences.

Emulators

  • Auto load state: Resume your game systematically where you left off.
  • Resume at boot: Quit and power off completely with the POWER button. Resume where you left off on the next boot.
  • Overlays selector: Configure your default display for all platforms.
  • PSX Analog detector: Detects PSX games compatible with analog sticks and sets the right controller configuration.

LEDs Section

  • Configure default LED behavior (persistent after reboot).

Network

  • SFTPGo: FTP and HTTP file server.
  • SMB: network shares file server
  • SSH server.
  • Syncthing server
  • Telnet server
  • Display current IP.

Themes

  • Advanced settings:
    • Background collection selector (how to create your own Background Pack).
    • Icon Pack selector (how to create your own Icon Pack).
    • Emulator labels.
    • Themes (a theme switcher similar to the stock one but with preview).
    • Sound settings (enable/disable music and clicks).
    • Hide/show the top-left logo.
  • Theme Packs: Theme Packs a combinations of a theme, a bootlogo, an icon pack, a background pack, emulators naming scheme and a style for CrossMix messages. (How to create your own Theme Pack).
  • Sort Themes alphabetically (for native MainUI selector).

Tools

User Interface

  • Best Collection: Improve look & feel of Best collections by adding platform folder icons and platform renaming.
  • Start Tab: Select the default tab at boot (Best, Game, Favorite, etc.).
  • Refresh System Tools Menu: To refresh System Tools Menu (will detect new scripts, new wallpaper/icon packs).

SSH

SSHBanner

Overview

SSH provides a secure command line method to communicate with your TrimUI Smart Pro.

SFTP is included and provides a secure file transfer method

Features

Virtual password auth.

Command-Line Interface

Scripting and automation

Debugging and troubleshooting

Encrypted

Activating

By default SSH is enabled on CrossMix-OS.

You can however disable / enable it:

Go in System Tools -> NETWORK -> SSH -> SSH - enable

Logging in

Once you've activated your SSH server in "System Tools" you'll now be able to connect using software such as PuTTY, SolarPuTTY, Hyperterm or Kitty client. You'll also be able to use an SFTP client to transfer files securely (like WinSCP)

You can simply use "TSP" as target network address otheriwse you'll need the IP of the device, found below (System Tools -> NETWORK -> Display IP)

Authentication

Default username: root

Default password: tina

Security

Although we've taken every precaution to offer as much security as possible, remember to keep your CrossMix safe. SSH/SFTP is the most secure of the services CrossMix offers to communicate with your device but it is not advisable to leave SSH enabled while using public/open WIFI unless you're activley using it.

bar

FTP

banner FTP

Overview

Much like the HTTP server, FTP provides a method of transferring files between your TrimUI Smart Pro and other devices such as a PC/Phone/Tablet. You'll need an FTP client installed on the second device.

Features

File transfer

Debugging and troubleshooting

Activating

Go in System Tools -> NETWORK -> SFTPGo -> SFTPGo Server - enable

Logging in

Once you've activated your FTP server in "System Tools" you'll now be able to connect using software such as Filezilla, CuteFTP, WinSCP, FireFTP. You'll also be able to use an SFTP client to transfer files securely if SSH is also enabled.

You can simply use "TSP" as target network address otherwise you'll need the IP of the device, found below System Tools -> NETWORK -> Display IP

Authentication help

Default username: trimui

Default password: trimui

Notes

On some FTP clients you may need to alter settings or bin files will become damaged when they're transferred, filezilla for example may need to the below setting changing (Transfer -> Transfer type -> Binary)

FZTT

Security

Although we've taken every precaution to offer as much security as possible, remember to keep your CrossMix safe. It is not recommended you use FTP on an insecure WIFI network that is open or public as traffic is unencrypted, for this reason we strongly recommend you toggle FTP off when you're on the move!

bar

HTTP file server

banner SFTP

Overview

The built-in HTTP fileserver will allow you to manage your files through a web browser on your phone, a PC or a tablet. Think of it as a website, hosted by your TrimUI Smart Pro.

Features

Download anything, anywhere.

Upload anything, anywhere.

Built in text editor.

Activating

Go in System Tools -> NETWORK -> SFTPGo -> SFTPGo Server - enable

Logging in

Once you've activated SFTPGo in System Tools you'll now be able to browse to the IP address of your device. The default port is 8080.

You can simply use "TSP" as target network address otheriwse you'll need the IP of the device, found below System Tools -> NETWORK -> Display IP

Open up your favourite web browser and browse to http://TSP:8080 !

Authentication help

Default username: admin

Default password: admin

Security

Although we've taken every precaution to offer as much security as possible, remember to keep your CrossMix safe. It may not be advisable to use the fileserver on Public/Open WIFI!

bar

SAMBA file server

banner SMB

Overview

The Samba is a file sharing protocol that provides integrated sharing of files and directories between your TrimUI Smart Pro and your PC (Windows/Unix/Linux). It enables easy access, allowing you to share, access, and modify files as if they were stored locally on your PC.

Features

File transfer

Mounted drive in Windows

Instant file visibility

Customisable share folders

Activating

For easy use we recommend to use SMB without authentification: Go in System Tools -> NETWORK -> SMB -> SMB Server - enable

It is not recommended you let SMB without password enabled on an insecure WIFI network that is open or public.

If you want a secure access to your network shares: Go in System Tools -> NETWORK -> SMB -> SMB Server (secure) - enable

Authentication help

When SMB Server (secure) is enabled:

Default username: root

Default password: trimui

Usage

Samba will provide you a streamlined method of transferring files across to your device. The folders you can access will be hosted by the device, and will be accessible through your file browser within Windows/Linux.

Once you've enabled Samba within "System Tools", it will instantly activate.

To browse to your shared folders within windows:

Hit your start button:

image

Now, type in the IP address of your MMP in this format: \\x.x.x.x, e.g:

image

Press Enter. It may take a second but an explorer window will open and you'll be met with some pre-configured locations we thought would get you started!

image

If you have Network File Sharing enabled on Windows, you'll also be able to pin the location to your quick access by finding it in the left pane of your explorer window, and clicking Pin to Quick access

image

The shares will now appear in your quick access pane:

image

The subfolders can also be mapped as network shares by right clicking on "This PC" or "My Computer" and clicking "Map network drive" - Bare in mind you will have the map to a share directory instead of the root; for example: \\192.168.1.215\screenshots - Give it a drive letter and it's ready!

Security

Although we've taken every precaution to offer as much security as possible, remember to keep your CrossMix safe. It is not recommended you use SMB on an insecure WIFI network that is open or public, for this reason we strongly recommend you toggle SMB off when you're on the move!

bar

Telnet

TelnetBanner

Overview

Telnet provides a simple and unencrypted command line method to communicate with your TrimUI Smart Pro.

Features

Command-Line Interface

Scripting and automation

Debugging and troubleshooting

Activating

Go in System Tools -> NETWORK -> SMB -> TELNET Server - enable

Logging in

Once you've activated your telnet server in "System Tools" you'll now be able to connect

On Windows without any client you can run a cmd and type telnet TSP however using software such as PuTTY, SolarPuTTY, Hyperterm or Kitty client will give better results.

If "TSP" doesn't work as target address, you'll need the IP of the device, found below System Tools -> NETWORK -> Display IP

Authentication help

Default username: root

Default password: tina

Security

Although we've taken every precaution to offer as much security as possible, remember to keep your CrossMix safe. It is not recommended you use telnet on an insecure WIFI network that is open or public as traffic is unencrypted and transported in plain text, for this reason we strongly recommend you toggle telnet off when you're on the move!

bar

Scraper

banner scraper

A missing illustration in your game list? CrossMix Scraper can solve that!

Using WiFi, this app allows you to download game covers without even touching your SD card or a computer.

Features

  • Automatically download covers from ScreenScraper or TheGameDB
  • Media type selection (Boxart, 3D, Screenshot, Title Screen, Marquee, Mix)
  • Preferred region selection (will give a priority to the covers from your own region)
  • Manage ScreenScraper accounts (less errors and faster when registered/logged in)
  • Download all missing covers for the selected platform
  • Auto conversion and resize of images for the TrimUI Smart Pro
  • Find game match even if your rom is not well named thanks to ScreenScraper CRC search
Summary screen at end of the scraping

Usage

  1. Run Scraper App from Apps section

  2. Select a platform by pressing A

Controls

Press B to stop the current scraping (it will wait for last scraping end and will display a summary)

Press menu to force the scraping exit (no summary displayed)

 

Remark

Scraper can be launched from command line too:

"/mnt/SDCARD/System/usr/trimui/scripts/scraper/scrap_screenscraper.sh" MD

Configuration

Media Preference

Choose the desired kind of media.

Name Preview example
Box Art scraper_2dbox-63a70d0266f216e7d9d4138d43e0ee5f
Screenshot - Title Screen scraper_screentitle-539dace2d56d36dff759df1043576167
Screenshot - In Game scraper_screenshot-0a591c243c06262b0eedf382c9f5f6a7
Box Art - 3D scraper_3dbox-cafef02be1a221d2a17c07186aab478c
Wheel Untitled
Marquee scraper_marquee-9e1e8685e33df1e9a21ae3b05d61633e
ScreenScraper Mix V1 scraper_mix1-1202c08c46a22e305f4b00799af75cb5
ScreenScraper Mix V2 scraper_mix2-90488752a639964e05646f3d3cb6a3c3

Region selection

Choose your preferred region. If no media is found for your country code, other countries will be searched as fallback.

Toggle background Scraping

Allows to download covers in background, which means that you can use your TrimUI Smart Pro while it is downloading your covers.

ScreenScraper: account settings

Having a screenscraper account set allows faster scraping and less errors. You can set it by editing the file sdcard/System/etc/scraper.json then fill the following fields: screenscraper_username & screenscraper_password

For example:

{
  "screenscraper_username": "JohnDoe",
  "screenscraper_password": "mypasswordd",
  "Screenscraper_MediaType": "box-2D",
  "Screenscraper_Region": "us",
  "ScrapeInBackground": "false"
}

bar

Video player

  • In addition to the Stock video player, CrossMix includes its own Video players based on mpv 0.32.0 (This version is a little old, it doesn't support lua scripts).

mpv can read 1080p video really well. mpv has been configured to resume video at the same time position. mpv is able to read streamed video on the web.

mpv launch scripts use gptokeyb to rebind controls into a classical keyboard (credits: PortMaster)

Controls :

A/B/Start = play pause
up = seek 1 minute forward
down = seek 1 minute backward
left = seek 5 seconds backward
right = seek 5 seconds forward
l1/r1 = prev / next track
Menu = exit

Note:

Libretro ffmpeg core is also available but it's slow for videos.

bar

Music player

  • CrossMix includes its own Music based on mpv 0.32.0 (This version is a little old, it doesn't support lua scripts). When in emulators list, press MENU button, "Edit" to display MUSIC (it is generally located at the end of the emulator list). Place your tracks into Roms/MUSIC folder. Music player supports playlists, wav, mp3, flac,ogg ,m3u... When selecting a track, pressing X allows to have a kind of visual equalizer, credits fraggod Libretro ffmpeg core allows funny visual effects for music (but in low resolution)

2 script has been created in CrossMix:

  • Add script to extract music covers from mp3 tags, it will allows to have an image for each mp3 for MainUI
  • Add script to generate playlist from a music subfolder: select a music file, press X, select "create m3u playlist", all the tracks from the current subfolder will be added to a playlist created at the root of the MUSIC folder.

mpv launch scripts use gptokeyb to rebind controls into a classical keyboard (credits: PortMaster)

Controls :

A/B/Start = play pause
up = seek 1 minute forward
down = seek 1 minute backward
left = seek 5 seconds backward
right = seek 5 seconds forward
l1/r1 = prev / next track
Menu = exit

bar


To complete:

EmuCleaner

  • Automatically displays emulators with present ROMs and hides others.
  • Run EmuClean after adding a pack of games to update emulator visibility.

Bootlogo

  • Choose and flash your own boot logo with basic verification (file size, format, resolution).
  • Add your own logos to SDCARD/Apps/BootLogo/Images.

Note: this is not compatible with firmwares after 1.0.4 hotfix 6 (20240413)

Screen Recorder

  • Capture your screen by launching the app. Press L1 + R1 to stop recording or launch the app again.

Moonlight

  • Stream your PC screen to your TrimUI Smart Pro.

PortMaster

  • Manage and install new ports.

USB Storage Mount

  • Access your SD card without removing it from your TrimUI Smart Pro by connecting it via USB.

Random Game Picker

  • Will choose a random game for you (Press A to launch, X to skip, B to quit)

bar

 
 
 
 

Previous: PortMaster                                               Back to top                                                  Next up: Shortcuts