TeensyROM Web — Release Notes

v1.0.0-alpha.8

Firmware Requirement: TeensyROM firmware v0.7.1 or later is required for this release.

What's New

🌐 TCP / Ethernet Device Support

TeensyROM Web can now connect to your TeensyROM device over the network via TCP/Ethernet in addition to the existing USB Serial connection. This enables wireless or wired Ethernet access to your device without being physically tethered by USB.

• Connects using port 2112 on the TeensyROM device
• Select connection type (Serial or TCP) from device settings
• See the updated README for multi-device Ethernet setup instructions

Requires TeensyROM firmware v0.7.1

📱 Mobile & Responsive UI Overhaul

A major rework of the player, browser, and navigation experience for phones and smaller screens.
Phone Demo: https://www.youtube.com/shorts/hcfaokI_lHw

• Swipe navigation — swipe left/right between player views on mobile
• Mini player toolbar — compact, touch-friendly toolbar for phone sizes
• Bottom nav rail — dedicated navigation bar at the bottom of the screen on phone layouts
• Swipeable action bar — file actions accessible via swipe for efficiency on small screens
• Phone player view — shows artist name, title, and time display optimized for small screens
• Header hidden in phone view to maximize content area
• Navigation rail auto-hides and supports hover-delay and pin/unpin functionality
• Directory tree hidden at smaller screen sizes to prioritize content
• Collapsible directory breadcrumb for space-efficient navigation
• Scrollbar fixes, touch tap support for launching files, and numerous polish fixes across all breakpoints

🔍 Global Cross-Device Search

Search now queries across both SD and USB storage devices simultaneously, returning unified results from your entire library. Favorites and playlist directories are excluded from results to avoid duplicates.

💾 Storage Device Indicators

Files in the browser now display which storage device (SD or USB) they are stored on, with an icon and tooltip for quick identification. All storage-related actions (launch, favorites, etc.) now correctly resolve the storage device context, including from search results.

⚠️ Incompatible File Auto-Advance

When a file is incompatible with the current launch mode (e.g., launching a game as minimal), the player now automatically advances to the next file instead of stopping. An indicator is shown in the file listing for incompatible items so you can identify them at a glance.

💡 Tooltip System

A new custom tooltip directive replaces the CDK-based tooltips throughout the app. Key improvements:

• Tooltips work correctly alongside the CRT effect CDK overlay
• Touch device support via long-press activation
• Tooltips can now be toggled globally from the header
• Added throughout: device toolbar buttons, player toolbar, power button, action buttons, icon components

🗂️ Indexing Guidance Indicators

New indexing indicators and alerts have been added to guide users through the file indexing process more clearly, particularly after first-launch or device re-connection.

⏱️ Custom Play Timer Improvements

• Fixed timer start edge case on the first game launch in a session
• Removed 5-second and 10-second options (too short for practical use)
• Added descriptive tooltips on all timer controls

🐢 Slow Operation Feedback

• A new slow launching file dialog gives feedback when a file is taking longer than expected to launch
• A slow favorite operation dialog improves UX when swapping minimal FW favorites which can be a slow transition.

Notable Fixes

• Fixed favorite button functionality after icon family change
• Fixed an issue where the progress bar would not return after switching from a game back to a SID
• Fixed device discovery when a storage device is missing on the TeensyROM device
• Fixed directory tree expansion for deep directory structures
• Fixed visual hover/selection jank on file listings caused by glassmorphism layering
• Fixed scroll issues on real phone hardware
• Fixed custom play timer edge cases on first session launch
• Sanitized log output — removed extra carriage returns that caused large visual gaps in user-facing logs
• Fixed launch guard to prevent timer-based launches while a launch is already in progress

Upgrade Notes

• See README for installation / setup instructions
• Firmware v0.7.1 is required. TCP connectivity and some Serial communication changes depend on updated firmware routines.
• Application port changed: TeensyROM Web now runs on port 213 (e.g., http://localhost:213) instead of the previous port 5000. Update any bookmarks, firewall rules, or router port-forwarding configurations accordingly.