NextUI Music Player

A comprehensive music playback application for NextUI featuring local file playback, online radio streaming, podcast and music downloading.

Note:

This is a fork of mohammadsyuhada/nextui-music-player
Support the original author on ko-fi.

Supported Platforms

• tg5040 - TrimUI Smart Pro / TrimUI Brick / Brick Hammer
• tg5050 - TrimUI Smart Pro S

Installation

Manual Installation

1. Mount your NextUI SD card to a computer.
2. Download the latest release file named Music.Player.pak.zip from Github.
3. Copy the zip file to /Tools/<PLATFORM>/Music.Player.pak.zip (replace <PLATFORM> with your device: tg5040 or tg5050).
4. Extract the zip in place, then delete the zip file.
5. Confirm that there is a /Tools/<PLATFORM>/Music.Player.pak folder on your SD card.
6. Rename the Music.Player.pak folder to Music Player.pak.
7. Unmount your SD Card and insert it into your TrimUI device.

Pak Store Installation

1. Open Pak Store application in your TrimUI device.
2. Navigate to the Browse then Media menu.
3. Select Music Player to install.

Update

1. You can update the application directly via About page in the application.
2. Or, you can update via Pak Store.

Features

General

• Support Bluetooth/USB-C devices for output and media controls.
• Automatic screen off (Follow system screen timeout).

Library

• Supports WAV, MP3, OGG, FLAC, M4A, AAC and OPUS formats
• File browser for navigating music libraries (Audio files must be placed in ./Music folder)
• Shuffle and repeat modes
• Spectrum visualizer with 4 options of color to choose from.
• Album art display (Automatically download album art if track doesn't provide)
• Automated lyric download and display during playback
• Search and download YouTube Music for music (Downloaded tracks will be placed in ./Music/Download)
• Playlist management

Online Radio

• Preset station management (add, remove, save)
• Curated station browser organized by country (Only Malaysia for now - others will be added later; please suggest)
• Support for MP3 and AAC streams, direct streaming (Shoutcast/Icecast) and HLS (m3u8).
• HTTPS support via mbedTLS
• Metadata display (song title, artist, station info)
• Album art display (Downloaded from internet based on current song)

Podcast

• Search Apple Podcast for podcast source
• Subscription management
• Download episodes for local offline playback
• Podcast files will be placed in ./Podcasts

Controls

Main Menu Navigation

• D-Pad: Navigate menus and file browser
• A Button: Select/Confirm
• B Button: Back/Cancel/Exit
• X Button: Clear Resume History/Background Playback
• Start (short press): Show Controls Help
• Start (long press): Exit Application

Music Player

• A Button: Play/Pause
• B Button: Back/Cancel/Exit
• X Button: Toggle Shuffle
• Y Button: Toggle Repeat
• D-Pad Up: Next Track
• D-Pad Down: Prev Track
• D-Pad Right: Fast Foward
• D-Pad Left: Rewind
• Select: Turn Off Screen
• Start (short press): Show Controls Help
• Start (long press): Exit Application
• L1/R1 Shoulders: Prev/Next Track
• L2/L3 Shoulders: Toggle Visualizer
• R2/R3 Shoulders: Toggle Lyrics

Radio Player

• B Button: Back/Stop
• D-Pad Up: Next Station
• D-Pad Down: Prev Station
• Select: Turn Off Screen
• Start (short press): Show Controls Help
• Start (long press): Exit Application
• L1/R1 Shoulders: Prev/Next Station

Podcast

• B Button: Back/Stop
• Select: Turn Off Screen
• Start (short press): Show Controls Help
• Start (long press): Exit Application

Usage

Playing Local Music

• Navigate to your music folder using the Library menu
• Select a file to start playback

Online Radio

• Navigate to the stations list using the Online Radio menu
• Press Y button to manage stations.
• Or add custom stations at .userdata/shared/music-player/radio/stations.txt
• Metadata displays automatically when available

Podcast

• Navigate to the podcasts list using the Podcasts menu
• Select which subscribed podcast you wish to listen.
• Download any episode you wish to listen.
• Once downloaded, it will be available to play.
• Press Y button to manage subscriptions.

Building from Source

Prerequisites

• Cross-compilation toolchain for ARM64
• NextUI workspace with platform dependencies

Build Commands

# Enter the toolchain (replace PLATFORM accordingly) 
make shell PLATFORM=tg5040

# Once in the toolchain shell
cd ~/workspace/nextui-music-player/src

# Build for TrimUI Brick (tg5040)
make clean && make PLATFORM=tg5040

Project Structure

workspace/
├── nextui-music-player/     # This project
│   ├── src/                 # Source code
│   ├── bin/                 # Platform binaries and runtime tools
│   │   ├── tg5040/          # TrimUI Brick binary (musicplayer.elf)
│   │   ├── tg5050/          # TrimUI Smart Pro S binary (musicplayer.elf)
│   │   ├── yt-dlp           # YouTube downloader
│   │   ├── wget             # HTTP downloader
│   │   └── keyboard         # On-screen keyboard
│   ├── res/                 # Resources (fonts, images)
│   ├── stations/            # Curated radio stations
│   └── state/               # Runtime state files
├── all/                     # Shared code
│   ├── common/              # Common utilities, API
│   └── minarch/             # Emulator framework
├── tg5040/                  # TrimUI Brick platform
│   ├── platform/            # Platform-specific code
│   └── libmsettings/        # Settings library
└── tg5050/                  # TrimUI Smart Pro platform
    ├── platform/            # Platform-specific code
    └── libmsettings/        # Settings library

Dependencies

The music player uses:

• Shared code: workspace/all/common/ (utils, api, config, scaler)
• Platform code: workspace/<PLATFORM>/platform/
• Libraries: SDL2, SDL2_image, SDL2_ttf, GLESv2, EGL, libsamplerate, libzip, mbedTLS, ALSA