StreaMu changelog

StreaMu v1.5.1 Release Notes

Highlights

• Improved steady-state Opus playback behavior to reduce low-FPS feeling and refill instability during playback.
• Reduced noisy hot-path observation overhead while keeping the playback pipeline changes that were validated on hardware.
• Tightened several playback and UI edge cases, including buffering state transitions, startup connection checks, and QA Remove handling.

Upgrade Notes

• Update both the 3DS app and the proxy server together.
• Replace your existing StreaMu-Server.zip with the version from this release.
• Existing Opus Direct usage stays the same; this is a maintenance and smoothness update rather than a feature reset.

Release Assets

• streamu.cia
• streamu.3dsx
• StreaMu-Server.zip
• Includes StreaMu-Server.exe, LICENSE, and THIRD_PARTY_LICENSES.md.

Validation

• The Opus playback tuning changes were reviewed in TAKT review runs before release preparation.
• Device testing reported no regression and no meaningful playback artifacts after the steady-state refill tuning adjustments.
• GitHub release automation rebuilds the 3DS and server artifacts from the merged main commit before publishing this release.

StreaMu v1.5.0 Release Notes

Highlights

• Opus Direct is now the only release playback path.
• MP3 Proxy and server-side FFmpeg transcoding have been removed.
• The proxy server no longer requires FFmpeg.
• Existing audio_path settings, including old mp3 and aac_direct values, are treated as Opus Direct.

Upgrade Notes

• Update both the 3DS app and the proxy server together.
• Use the latest StreaMu-Server.zip; older proxy servers may not provide the required /stream_opus_ogg endpoint.
• If playback fails for a specific video, please include the video ID and the server dashboard log when reporting it.

Release Assets

• streamu.cia
• streamu.3dsx
• StreaMu-Server.zip
• Includes StreaMu-Server.exe, LICENSE, and THIRD_PARTY_LICENSES.md.

Validation

• Clean 3DS build passed and produced streamu.3dsx / streamu.cia.
• Python syntax check passed for proxy server modules.
• Manual 3DS smoke test passed.

Summary

• Added cancelable startup server connection flow.
• Added Mac/Linux Python server startup script.
• Added GitHub Actions 3DS artifact build workflow.
• Added GitHub Actions packaging tool installation for CIA builds.

Verification

• Local clean 3DS build passed.
• GitHub Actions required check passed on PR #1.

Android APK prototype changes are not included in this release.

What's New

Standalone Server EXE

• StreaMu-Server.zip — extract and run. No Python required.
• Automatically downloads FFmpeg and yt-dlp on first launch.

Improved Documentation

• Added Quick Start guide for easy setup
• Added Troubleshooting section (connection timeout, firewall, FFmpeg)
• Documented playlist workflow, custom wallpaper, and all settings
• Bilingual (English / Japanese)

Download

| File | Description |
|------|-------------|
| streamu.cia | Install via FBI (HOME Menu) |
| streamu.3dsx | Homebrew Launcher |
| StreaMu-Server.zip | Proxy server (Windows, no dependencies) |

Setup

1. Install streamu.cia on your 3DS
2. Extract StreaMu-Server.zip and run the EXE inside
3. Enter the IP shown on the server dashboard
4. Press Y to search and play music

For Mac/Linux or manual setup, see the [README](../../blob/main/README.md).

v1.3.0

Features

• Split L/R button action into Skip Back and Skip Fwd — each independently assignable in Settings
• Search keyboard hint text updated to "Search music..."

Bug Fixes

• Fix seek bar not pausing when using L/R Play/Pause action
• Fix mp3d uninitialized in MP3Player constructor

Performance

• Faster startup: removed 1.1s of artificial sleep delays
• Startup loading screen now appears before wallpaper decode (no more black screen on launch)

Improvements

• Track rename feature in Track Options popup (playlist context only)
• Separated search results from playlist tracks — no more overwriting each other
• SearchScreen redesigned to match PlayingScreen layout (PlayBar + seek + hamburger)
• Network: reduced streaming latency, pipe-based stream generator, Keep-Alive support
• Fixed DASH fMP4 seek via manual segment fetch + init segment pre-send

v1.2.0

Features

• Thumbnail display on PlayingScreen top screen (async download, center crop)
• Thumbnail routed through proxy server (no direct ytimg.com access)
• Delayed thumbnail fetch by 3s to prioritize audio buffering
• Hide view count when playing from playlist

Bug Fixes

• Fix crash on START exit when thumbnail is loaded

Changes

UI Improvements

• Home screen rich styling (gradient, bevel, touch feedback, cursor)
• List UI restyle v2 (minimal flat, dashed separator, left accent bar)
• Custom color palette with S/V sliders for freeform color selection

Features & Fixes

• Streaming 15s timeout with simplified retry logic
• Settings screen Save button fixed outside scroll list
• Playlist track view counts removed (stale data)

First public release of StreaMu - a homebrew music player for Nintendo 3DS.

Features

• Search and stream YouTube audio on your 3DS
• Playlist management (create, edit, shuffle, loop)
• Customizable themes and wallpaper
• Quick Access slots for favorite playlists
• CIA and 3DSX support

Files

• streamu.cia — Install with FBI (recommended)
• streamu.3dsx — For Homebrew Launcher

Setup

A companion proxy server (Python) is required on your PC. See
README for setup instructions.