v0.1.0 Alpha (SpruceOS)

Download it Here

My first public release of StoryBoy! I've tested on my Miyoo A30, Miyoo Flip, Miyoo Flip Mini, and TrimUI Brick. It might also work for the Miyoo Mini Plus (?), and the TrimUI Smart Pro/Pro S.

Please consider this a work-in-progress. If you encounter any bugs, please let me know :)

Installation

1. Download the latest release zip from the release page linked above.
2. Extract the zip to your SD card — make sure you have a /mnt/SDCARD/App/StoryBoy/ folder.
3. Launch from the SpruceOS app menu.

On first launch, StoryBoy scans your media folders and builds its library. Make sure your audiobook files are in /mnt/SDCARD/Media/Audiobooks/. StoryBoy uses folders to define audiobooks, so each book will need its own folder, but they can be nested by series. This was a compromise in order to support audiobooks that are split up between multiple .mp3 files.

EXAMPLE:

Audiobooks/  
│
└───Dungeon Crawler Carl/
│   │   cover.png
│   │
│   └───[Book 1] Dungeon Crawler Carl/
│       │   Dungeon Crawler Carl [Book 1].m4b
│       │   cover.png
|
│   └───[Book 2] Carl's Doomsday Scenario/
│       │   Carl's Doomsday Scenario [Book 2].m4b
│       │   cover.png
|
│   └───[Book 3] The Dungeon Anarchist's Cookbook/
│       │   The Dungeon Anarchist's Cookbook [Book 3].m4b
│       │   cover.png
│   
└───Animal Farm/
|   │   Animal Farm - George Orwell.mp3
|   │   cover.jpg
|
└───Legion - The Many Lives of Stephen Leeds/
|   │   Brandon.Sanderson-Legion_Track1.mp3
|   │   Brandon.Sanderson-Legion_Track2.mp3
|   │   Brandon.Sanderson-Legion_Track3.mp3
|   │   Brandon.Sanderson-Legion_Track4.mp3
|   │   cover.png

Features

• File browser — three-level hierarchy (series → audiobooks → files) with folder grid and cover art
• Cover art — automatic use of embedded art, or by downloading from Open Library
• Automatic mosaic — For series, a mosaic is made by tiling book covers
• Playback — Chapter indicators, playback speed (1x, 1.25x, 1.5x, 2x)
• Sleep timer — Sleep timer (10m, 30m, 1h, 2h)
• Screensaver — Black screen and button lock
• Seek — ±10s / ±60s / or by chapter
• Listen history — remembers where you left off across all audiobooks
• Themes — ten color themes, cycle with R1 in the browser
• OSD — progress bar, current time, title, volume
• Status bar — clock, title, WiFi signal, battery level

Basic Usage

Navigation

• D-pad — navigate the file browser
• A — open folder / play audiobook
• B — back
• Hold D-pad up/down — fast scroll through long lists
• Hold MENU — show Controls Reference

Playback controls

Button	Action
D-pad left/right	Seek ±10 seconds
D-pad up/down	Brightness ±
A	Play / Pause
B	Back to browser
X	Cycle sleep timer
Y	Double-press for screensaver & button lock
L1	Seek -60 seconds
R1	Seek +60 seconds
L2	Previous chapter in current book
R2	Next chapter in current book
START	Toggle playback speed
SELECT	Reset playback speed to 1x
Volume up/down	Adjust volume

Browser controls

Button	Action
D-pad	Navigate
A	Open folder / play audiobook
B	Back (press twice at top level to exit)
X	Open listening history
Y	Manage cover art for selected audiobook
SELECT	Cycle view layout
R1	Cycle color theme

Cover art

Press Y on any audiobook in the browser folder grid to manage cover art & scrape cover art from Open Library.

(You can also add covers manually by placing a cover.jpg or cover.png in the folder with your audiobook .m4b or .mp3 files.)

Supported Formats

Audio: M4B, MP3

All decoding is software.

Repo Notes

I built the first test release on my laptop, I'll get everything uploaded to GitHub soon.

Enjoy! :)

I'm not sure how many people would use an audiobook app on their handheld, but I want one!

Building on GVU, I've just started development. Want to help me pick the name? Most votes below wins.

A quick update for GVU that fixes some scaling issues on the TRIMUI Smart Pro and some issues I introduced that made it so Movies weren't detected properly. Should be working again. Still a pre-release, but it's getting pretty close - at least for me :)

---

Download it here:

https://github.com/amruthwo/GVU/releases/tag/latest

v0.2.3

Install

1. Download and extract the zip below
2. Copy App/GVU/ to /mnt/SDCARD/ on your device (merging with your existing App folder)
3. Place video files in /mnt/SDCARD/Roms/MEDIA/ or /mnt/SDCARD/Media/ (or any subfolder). GVU scans all sub-folders automatically.

>

New Features

• Added support for more devices!!!
  • Now available on Miyoo Mini Flip, Miyoo Flip, Miyoo A30, and TRIMUI Brick/Hammer, TRIMUI Smart Pro/Pro S
• Selective Cover Clear - You can now delete covers for an individual show/movie. Press Y to bring up the cover fetch tool, then press X. Previously, you had to manually delete the cover.png or cover.jpg with a file browser, or run /mnt/SDCARD/App/GVU/resources/clear_covers.sh on the device.

Bug Fixes

• Scaling on TRIMUI Smart Pro/S - the previous release didn't scale properly on the TRIMUI Smart Pro/S. Adjusted the scaling. Fixed (I hope, I don't have one to test with).
• Movie Covers and Subtitles - previously, scraping and subtitle searching for movies was not working as intended. Updated heuristics for better handling of both TV Shows and Movies.
• Aspect Ratio Fixes - some widescreen videos were rendering improperly, and appeared stretched vertically. Fixed.
• Goofed up API on Build v0.2.2 - typo caused TMDB in v0.2.2 not to work. D'oh! Fixed.

Known Limitations

• Different devices have different limitations due to the CPU/RAM available. 60fps files struggle more on the Miyoo Mini Flip than other devices.
• Miyoo Mini V2/V3 - not technically supported. Need to figure out the ALSA audio. Currently, all video plays silently. SpruceOS is pretty rough on my Miyoo Mini V2 anyway, so I'm not sure this is a huge loss, for now.
• Probably doesn't work on GKD Pixel 2 - I don't have this device to test with.
  • If any GKD Pixel 2 owners want to test and tell me what doesn't work, I'll try to fix it :)

Repo Notes

• u/Sundownersport made a yaml so builds can be made on github. What a legend!
• Fixed API keys not getting picked up in the build.

I've been developing GVU, a video player for SpruceOS, for a couple weeks now. Previously, it was only for the Miyoo A30, but I just made a version that works on the Miyoo A30, Miyoo Flip V1/V2, Miyoo Mini Flip, and TRIMUI Brick/Hammer!

It's SpruceOS only for now, but I plan on making paks for MinUI and NextUI...eventually.

Project GitHub Page: https://github.com/amruthwo/GVU

Grab the release here: https://github.com/amruthwo/GVU/releases/tag/v0.2.1

v0.2.1

Install

1. Extract the zip to get a spruce_gvu_pkg/ folder
2. Copy App/GVU/ to /mnt/SDCARD/ on your device (merging with your existing App folder)
3. Place video files in /mnt/SDCARD/Roms/MEDIA/ or /mnt/SDCARD/Media/ (or any subfolder). GVU scans all sub-folders automatically.

>

New Features

Added support for more devices!!!

• Now available on Miyoo Mini Flip, Miyoo Flip, Miyoo A30, and TRIMUI Brick/Hammer. (These are the only devices I own that run SpruceOS)
• New folder icon, the previous default icon for folders looked more like a file, not a folder. Made a new icon to make it clear entries are folders. The new icon still updates dynamically based on the theme set.
• Monochrome Theme - previously, the vampire and night_contrast themes were very similar. Replaced night_contrast with monochrome, which looks great, and will be the default on Minui/NextUI when I get around to making a pak.

Bug Fixes

• Multi-Audio-Track on Miyoo Mini Flip — Hit some random OOM issues with videos with multiple audio tracks, causing GVU to crash. Fixed.
• Sleep/wake Audio — resuming from sleep could cause audio to pitch in a weird way on the Miyoo Flip and Trimui Brick/Hammer. Fixed.
• TVMaze Covers — If no API for TMDB was available, the covers downloaded from TVMaze were downloaded at an inconsistent size. Fixed.
• Contrast Issues — A few themes had poor contrast on some views of the file browser. Added a pill around file names and changed some colors. Fixed.
• Rotation/Resolution Issues — A few devices had the wrong rotation/resolution applied. Fixed.

Known Limitations

• Different devices have different limitations due to the CPU/RAM available. 60fps files struggle more on the Miyoo Mini Flip than other devices.
• Miyoo Mini V2/V3 - not fully supported. Need to figure out the ALSA audio. Currently, all video plays silently. SpruceOS is pretty rough on my Miyoo Mini V2 anyway, so I'm not sure this is a huge loss, for now.
• Not sure about TRIMUI Smart Pro/Pro S - I don't have this device to test with.
• Probably doesn't work on GKD Pixel 2 - I don't have this device to test with.
  • If any TRIMUI Smart Pro/Pro S or GKD Pixel 2 owners want to test and tell me what doesn't work, I'll try to fix it :)

Repo Notes

• The new default branch is at https://github.com/amruthwo/GVU/tree/universal
• Added a readme to the project, finally.
• Updated the gvu-handoff document. I probably won't maintain this project forever, so this will give others a good TL:DR for the project if they want to pick up the mantle, or make a fork.