https://github.com/mohammadsyuhada/nextui-music-player
NextUI app for playing local music, streaming internet radio, and listening to podcast on TrimUI devices
https://github.com/mohammadsyuhada/nextui-music-player
nextui trimui trimui-brick trimui-smart-pro trimui-smart-pro-s
Last synced: 4 months ago
JSON representation
NextUI app for playing local music, streaming internet radio, and listening to podcast on TrimUI devices
- Host: GitHub
- URL: https://github.com/mohammadsyuhada/nextui-music-player
- Owner: mohammadsyuhada
- License: mit
- Created: 2025-12-31T17:20:30.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-02-24T14:46:54.000Z (4 months ago)
- Last Synced: 2026-02-24T19:03:25.463Z (4 months ago)
- Topics: nextui, trimui, trimui-brick, trimui-smart-pro, trimui-smart-pro-s
- Language: C
- Homepage:
- Size: 122 MB
- Stars: 9
- Watchers: 0
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# NextUI Music Player
A comprehensive music playback application for NextUI featuring local file playback, online radio streaming, podcast and music downloading.
## Supported Platforms
- **tg5040** - TrimUI Smart Pro / TrimUI Brick / Brick Hammer
- **tg5050** - TrimUI Smart Pro S
[](https://ko-fi.com/Y8Y61SI04B)
## 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//Music.Player.pak.zip` (replace `` with your device: `tg5040` or `tg5050`).
4. Extract the zip in place, then delete the zip file.
5. Confirm that there is a `/Tools//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
```bash
# 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/`
- **Libraries**: SDL2, SDL2_image, SDL2_ttf, GLESv2, EGL, libsamplerate, libzip, mbedTLS, ALSA