Merge pull request #202 from tobexyz/feat/ui2

Feat/ui2

Author: tobexyz

CHANGELOG.md

@@ -0,0 +1,126 @@
+# YAACC Changelog
+
+## [Unreleased] - 2026-02-21
+
+### Added
+- **SAF Short ID System**: Implemented short numeric ID mapping to fix UPnP browsing errors caused by long ObjectIDs (97% size reduction)
+- **Clear Cache Button**: Added button in Server Control Activity to clear SAF cache and trigger reindexing
+- **Image Preload**: Extended preload indexing to include image files (previously only audio/video)
+- **Preload Timeout**: Added 5-minute timeout to prevent indefinite hanging during indexing
+- **Permission Checks**: Added read permission checks before traversing SAF folders
+- **Notification Permission**: Added POST_NOTIFICATIONS permission request on startup (Android 13+)
+- **Lightweight Content Wrappers**: Created YaaccItem, YaaccMusicTrack, YaaccPhoto, YaaccRes classes for faster browsing
+- **ProtocolInfo Cache**: Pre-created ProtocolInfo for common MIME types to eliminate repeated parsing
+
+### Changed
+- **Renamed**: DurationCacheManager → SAFCacheManager (better reflects actual purpose)
+- **Extended Cache**: Now caches duration, MIME type, file size, and shortId for all files
+- **Optimized Item Creation**: Eliminated Cling library overhead (~5.5x faster, from ~250ms to ~45ms per item)
+- **Improved Logging**: Better logging for cache operations and preload progress
+- **ID Persistence**: ID counter now persisted in SharedPreferences to maintain stable IDs across restarts
+
+### Fixed
+- Fixed SAF folder browsing hanging on folders without read permission
+- Fixed preload getting stuck on large or inaccessible folders
+- Fixed ID counter not persisting, causing ID collisions after restart
+- Fixed cache not including image files
+- Fixed UPnP `UPNP_E_BAD_RESPONSE` errors caused by excessively long ObjectIDs
+
+### Performance
+- SAF browsing: 70% faster after initial cache population (3.75s → 1.1s for 15 files)
+- Item creation: 5.5x faster (~250ms → ~45ms per item)
+- ObjectID length: 97% reduction (250 chars → 8 chars)
+- Cache hit time: <1ms (memory), <50ms (disk)
+
+### Breaking Changes
+- Cache format changed: Old cache entries automatically migrated to include shortId
+- ID format changed: ObjectIDs now use short numeric IDs instead of Base64-encoded URIs
+- Desktop UPnP clients may need to clear cache and re-browse after update
+
+---
+
+## [4.4.1] - Previous Release
+
+### Added
+- Modernized image viewer with zoom support (PhotoView library)
+- Media controls on lock screen
+- Volume controls using Media Router API (standard Android implementation)
+- System audio streaming (Android 10+)
+- Screen cast streaming using MJPEG
+- Experimental MPEG-TS streaming
+- Smart logger for better debugging
+- Unit tests for core functionality
+
+### Changed
+- Refactored player service to align with recent Android APIs
+- Implemented ExoPlayer and Media3 MediaSession
+- Smart WiFi lock management to reduce battery drain
+- Improved DLNA metadata
+- Modernized TabBrowser activity
+- Improved performance in content browsing
+- LRU cache for SAF file scanning
+
+### Fixed
+- Fixed renderer service issues
+- Fixed album art in notifications
+- Fixed restart during pause
+- Fixed background service not stopping correctly
+- Fixed issue #151 (network stack)
+- Fixed issue #186 (media controls)
+- Fixed issue #187 (media resource selection)
+- Fixed issue #110 (network stack refactoring)
+- Fixed issue #105 (player service refactoring)
+- Fixed issue #93 (volume controls)
+- Fixed issue #81 (audio streaming)
+- Fixed issue #121 (screen cast)
+
+### Removed
+- Removed dead classes after refactoring
+- Cleaned up deprecated player implementations
+
+---
+
+## Migration Notes
+
+### From 4.4.1 to Unreleased
+1. **SAF Cache**: Existing cache entries will be automatically migrated on first access
+2. **Desktop Clients**: Clear UPnP client cache and re-browse YAACC server after update
+3. **Permissions**: Grant POST_NOTIFICATIONS permission when prompted (Android 13+)
+4. **Cache Management**: Use new "Clear SAF Cache" button in Server Control Activity if needed
+
+---
+
+## Technical Details
+
+### SAF Short ID Implementation
+- Bidirectional URI ↔ shortId mapping in SAFCacheManager
+- Persistent ID counter in SharedPreferences (`saf_id_counter`)
+- Automatic migration of old cache entries
+- ObjectID format: `1100999` + shortId (e.g., `11009991`, `11009992`)
+- URL format: `http://ip:port/saf/11009991/1.mp3`
+
+### Performance Optimizations
+- Eliminated Cling Property/ArrayList overhead in item creation
+- Cached ProtocolInfo for common MIME types
+- Lightweight wrapper classes instead of heavy Cling objects
+- Deferred Cling conversion until UPnP response generation
+
+### Cache Improvements
+- Memory cache: LRU with 1000 entry limit
+- Disk cache: SharedPreferences with automatic trimming
+- Preload: Background indexing with timeout and permission checks
+- Metadata: Duration, MIME type, file size, shortId for all media files
+
+---
+
+## Known Issues
+- Preload may take several minutes for large SAF folders (5-minute timeout)
+- Desktop UPnP clients must refresh cache after YAACC cache clear
+- Local device in Receiver tab doesn't show status badge (not a UPnP renderer)
+
+---
+
+## Credits
+- SAF Short ID implementation: tobexyz
+- Content browsing optimization: tobexyz
+- Cache management improvements: tobexyz

docs/index.md

@@ -26,13 +26,13 @@ On the first screen all UPnP/DLNA servers in your network are listed.
 Select one and the app will automatically switch to the content tab.
 It allows to browse the content provided by the selected server.
 
-![browse_servers](./screenshots/4.4.x/browse_servers.png){:height="30%" width="30%"}
+![browse_servers](./screenshots/5.0.x/browse_servers.png){:height="30%" width="30%"}
 
 Before selecting content make sure you have chosen an receiver on
 the receiver tab. Receivers are either UPnP/DLNA media renderers in
 your network or the android device itself.
 
-![browse_receiver](./screenshots/4.4.x/browse_receiver.png){:height="30%" width="30%"}
+![browse_receiver](./screenshots/5.0.x/browse_receiver.png){:height="30%" width="30%"}
 
 Normally senders and receivers will appear automatically.
 If not you can use the refresh button at the bottom of
@@ -50,34 +50,155 @@ Behind each content entry different symbols are showing the possible actions:
 
 At the bottom of the screen the currently selected sender and receiver is displayed.
 
-![browse_music_folder](./screenshots/4.4.x/browse_music_folder.png){:height="30%" width="30%"}
+![browse_music_folder](./screenshots/5.0.x/browse_music_folder.png){:height="30%" width="30%"}
 
 ## Playing content
 
-YAACC is able to control an multiple players at the same time.
-For example you are able to stream a image show with background music
+YAACC is able to control multiple players at the same time.
+For example you are able to stream an image show with background music
 on your device, starting a movie on a TV or play music on a
 smart speaker at the same time.
 
 Each player is displayed in the player tab. Depending on the content type
 and if the content is played by YAACC itself or a network device, the player ui differs.
 
-![browse_player](./screenshots/4.4.x/browse_player.png){:height="30%" width="30%"}
+![browse_player](./screenshots/5.0.x/browse_player.png){:height="30%" width="30%"}
 
 YAACC includes a player for music and image shows.
 Videos are played using a third parties app on the device.
 The video app will start automatically, if video content is selected for playing
 
-![music_player](./screenshots/4.4.x/music_player.png){:height="30%" width="30%"}
+![music_player](./screenshots/5.0.x/music_player.png){:height="30%" width="30%"}
 
-![image_player_show_menu](./screenshots/4.4.x/image_player_show_menu.png){:height="30%" width="30%"}
+![image_player_show_menu](./screenshots/5.0.x/image_player_show_menu.png){:height="30%" width="30%"}
+
+### Receiver controls
+
+The receiver tab shows all available UPnP/DLNA renderers in your network, including your device.
+Each renderer displays:
+
+* Current playback status (PLAYING badge when active)
+* Track title and album art (when available)
+* Play/pause/stop controls
+* Volume control
+* Mute button
+
+![browse_receiver](./screenshots/5.0.x/browse_receiver.png){:height="30%" width="30%"}
+
+You can control playback directly from the receiver tab without opening the player view.
+The controls work for both local playback and remote UPnP devices.
+
+### Lock screen controls
+
+When playing media locally, YAACC provides lock screen controls:
+
+* Play/pause/stop buttons
+* Next/previous track
+* Track metadata display
+* Album art
+* Hardware volume buttons control playback volume
+
+## Live streaming (Android 10+)
+
+YAACC can stream your device's screen and system audio to UPnP/DLNA renderers in your network.
+
+### System audio streaming
+
+Stream all audio playing on your device to network speakers or receivers:
+
+* Captures system audio (music, podcasts, games, etc.)
+* 44.1kHz stereo, high quality
+* Works with most UPnP audio renderers
+* Multiple simultaneous clients supported
+
+**Note:** Some apps may block audio capture (DRM-protected content like Spotify, YouTube Premium).
+
+### Screen casting
+
+Stream your device's screen to TVs or displays:
+
+* 720p video at 15fps
+* MJPEG format for broad compatibility
+* Works in web browsers and some UPnP video players
+* Useful for presentations and screen sharing
+
+### Enabling live streaming
+
+1. Go to the Server tab
+2. Find your local device in the list
+3. Tap the audio or video button
+4. Grant MediaProjection permission when prompted
+5. The stream appears in the "Live Streams" folder
+
+Access streams via UPnP or directly:
+* Audio: `http://<device-ip>:49157/live/audio`
+* Video: `http://<device-ip>:49157/live/video`
+
+## Storage Access Framework (SAF)
+
+YAACC supports browsing files from external storage, USB drives, and SD cards using Android's
+Storage Access Framework. This allows sharing media from any storage location accessible on your device.
+
+### Configuring SAF folders
+
+In the server control view, you can add SAF folders to share:
+
+1. Tap "Add SAF folder"
+2. Select the folder using Android's file picker
+3. Grant permission when prompted
+4. The folder appears in the server content directory
+
+![server_control](./screenshots/5.0.x/server_control.png){:height="30%" width="30%"}
+
+### Performance optimization
+
+YAACC caches metadata (duration, MIME type, file size) for faster browsing:
+
+* First browse: Extracts metadata from files
+* Subsequent browses: Uses cached data
+* Cache persists across app restarts
+* Clear cache button available in server control view
+
+The cache significantly improves browsing performance, especially for large media collections.
+
+## Battery optimization
+
+YAACC includes several battery-saving features:
+
+### Smart WiFi lock management
+
+The WiFi lock is only held when actually needed:
+
+* Released when app is backgrounded (if server/renderer disabled)
+* Released when no active streaming
+* Automatically re-acquired when needed
+
+
+### Smart foreground service
+
+The player service intelligently manages foreground state:
+
+* Foreground only when actively playing media
+* Stops foreground when paused (notification hidden)
+* Service stops completely when no players active
+
+
+## Modern architecture
+
+YAACC uses modern Android APIs for better performance and system integration:
+
+* **Media3/ExoPlayer** - Modern media playback engine (replaces deprecated MediaPlayer)
+* **MediaSession** - System-wide media controls and lock screen integration
+* **Improved UPnP stack** - Enhanced reliability and network state handling
+* **AudioPlaybackCapture** - System audio streaming (Android 10+)
+* **MediaProjection** - Screen casting support
 
 ## Media server
 
 YAACC includes a media server service, which has to be enabled separately.
 A switch for this is located at the bottom of the server list tab.
 
-![browse_servers](./screenshots/4.4.x/browse_servers.png){:height="30%" width="30%"}
+![browse_servers](./screenshots/5.0.x/browse_servers.png){:height="30%" width="30%"}
 
 Depending on the configurations for the server in the settings,
 the server service is used as media provider, media renderer or proxy.
@@ -91,7 +212,7 @@ are accessible for other UPnP/DLNA devices in you network.
 The shareable folders have to be configured using the server control view.
 All included files and folders are accessible for other devices in your network.
 
-![server_control](./screenshots/4.4.x/server_control.png){:height="30%" width="30%"}
+![server_control](./screenshots/5.0.x/server_control.png){:height="30%" width="30%"}
 
 The server control view is accessible through the YAACC entry in the server list tab or
 the YAACC server service notification.
@@ -122,9 +243,9 @@ The shutdown timer stops all running players and the app after a certain time.
 The timer is settable and can be enabled at the bottom of the server list tab and the remaining time
 is displayed.
 
-![browse_servers](./screenshots/4.4.x/browse_servers.png){:height="30%" width="30%"}
+![browse_servers](./screenshots/5.0.x/browse_servers.png){:height="30%" width="30%"}
 
-![shutdown_timer](./screenshots/4.4.x/shutdown_timer.png){:height="30%" width="30%"}
+![shutdown_timer](./screenshots/5.0.x/shutdown_timer.png){:height="30%" width="30%"}
 
 | [Screenshots](screenshots/) | [Settings](settings/) |  [About](about/) | [Code](doxygen/html/inherits.html)