Added
- Flat View (Indexed Root Browser Mode): Instant virtualized directory flattening for indexed storage volumes directly from root:
- Instant Room Querying: High-performance flattened directory view leveraging Room database (
FileIndexDao.getFlatViewFiles) capable of loading 100,000+ files instantly without blocking the UI thread. - Parent Section Headers & Deep Tree Collapsing: Displays relative directory parent paths (e.g.,
Documents/Work/2026/ (12 files)) with all folders expanded by default, supporting individual folder expand/collapse and global "Expand All" / "Collapse All" actions. - Direct Folder Navigation: Each folder section header includes an "Open Folder" action button jumping directly to standard hierarchical browser mode at that specific location.
- System Folder Exclusion & Settings Integration: Automatically excludes system folders (
Android/data,Android/obb) by default, configurable via a dedicated "Flat View" settings card under "Browsing & File List" with settings backup/restore support (FlatViewPreferenceManager). - Full Multi-Selection & Edit Mode Parity: Selection Tools FAB (
fabTools) and Floating Quick Action Bar (floatingQuickBar) synchronized with standard file operations (Copy, Move, Delete, Share, Properties). Folder header checkboxes cascade selection to all contained files, and Select All operates seamlessly across expanded and collapsed sections. - Android TV & D-pad Remote Support: Adheres to
UFMStandardwith a 72dp glass header, D-pad navigation, and clear yellow focus highlights for Android TV and Fire TV devices. - Overflow Menu Access: Accessible via the 3-dots overflow menu directly below "Twin Window" in Local Standalone and Tabbed browser modes when browsing at the root of an indexed volume.
- Instant Room Querying: High-performance flattened directory view leveraging Room database (
- Smart Bookmark Hub (Mobile Only): Unified repository for saved links, media, files, and notes captured across external applications:
- Share Target ("Bookmark with UFM"): Dedicated system share sheet target alongside "Open In..." and "Save to...", featuring a glass bottom sheet that auto-detects sender apps (WhatsApp, Reddit, YouTube, Chrome, Telegram, etc.) with smart auto-grouping and duplicate detection with note appending.
- Isolated Application Sandbox Storage: Cloned media and documents are preserved strictly inside the app's internal sandbox (
context.filesDir/bookmarks/media/), isolated from external file managers, MTP, and Android MediaStore, and excluded from UFM's regular file browsing lists. - Rich OpenGraph Previews & Scraper: Asynchronous background scraper extracts webpage titles, descriptions, favicons, and primary cover images with local thumbnail caching.
- Distraction-Free Reader Mode & Text-to-Speech (TTS): Clean typography reading view stripping ads and clutter, featuring Light, Sepia, and Dark themes, font scaling, and an integrated Android
TextToSpeechengine with speed controls (0.75x–2.0x). - Bookmark Hub Dashboard (
BookmarkHubActivity): Mobile-only dashboard with live search, collection chips, content type filter chips (All, Links, Media, Docs, Notes, Starred), chronological sorting (newest to oldest, oldest to newest), 5-second undo delete snackbar, biometric vault lock integration, and HTML/Markdown export. - Main Menu Organize Tile: Added mobile-only tile under the "Organize" category in
StorageBrowserActivitywith live bookmark and group count metrics.
- Selective Torrent & Magnet File/Folder Download Inspector: Pre-download content selection dialog allowing users to inspect the full file and folder tree of a
.torrentfile or Magnet link before downloading begins. Features one-tap "Select All" (default) and "Deselect All" controls, recursive collapsible folder toggling, category filter chips (Videos, Audio, Images, Archives, Docs), real-time search, live selected payload size calculation, andlibtorrent4jpriority masking (Priority.DEFAULTvsPriority.IGNORE). - Android TV Widescreen Split Selection Dialog: Dedicated 800dp two-column layout on Android TV with a persistent left control sidebar (summary, location picker, Select/Deselect All, Start Download) and a full-height right tree pane navigable with the D-pad remote.
- Transfer Action Dialog (Mobile & Android TV): Interactive dialog opened by pressing D-pad OK on TV or tapping a transfer card on mobile to pause, resume, open download directory in File Browser, or delete transfers with clear options to keep or delete downloaded files from disk.
- Enhanced Long Filename Display & Interactive Scrolling Options: Added comprehensive single-line filename display enhancements and customizable marquee animation options to make long filenames with identical prefixes and discriminating suffixes or version tags easily distinguishable:
- Truncate Middle Mode (
FileNameDisplayHelper): Added a dedicated "Single line (Truncate middle)" option in Settings -> Appearance & Customization -> File Name Display (MODE_TRUNCATE_MIDDLE). It shortens long filenames in the center (prefix…xyz2.ext), guaranteeing preservation of the beginning prefix, an ellipsis, at least 4 trailing base characters, and the complete file extension (including compound extensions like.tar.gz). - Configurable Marquee Animation Options (
ScrollingTextHelper,ScrollingTextPreferenceManager): When Marquee scrolling is enabled, users can customize:- Scroll Speed: Selectable between Slow (~30 dp/s), Normal (~50 dp/s), and Fast (~80 dp/s).
- Loop Mode: Toggle between One-Shot (plays once, scrolls back to start, and stops to conserve battery) and Continuous Loop (smoothly cycles back and forth indefinitely).
- Scroll Scope: Choose between All Visible Files (scrolls all overflow names) and Focused / Selected Only (mobile: scrolls only checked/selected items in multi-select mode; Android TV: scrolls the currently D-pad focused file row).
- Interactive Touch Scrubbing (
ScrollingTextHelper): Added manual horizontal touch scrubbing on single-line filenames for touchscreens. Dragging horizontally across the filename smoothly scrubs across the full name without triggering vertical list scrolls, taps to open, or row long-presses. Once scrubbed, the filename remains locked at the scrubbed position and marquee animation halts until the row scrolls off-screen and is re-bound. - UFMStandard Settings UI & Android TV Dialog (
dialog_file_name_display.xml,dialog_file_name_display_tv.xml,SettingsActivity): Upgraded the File Name Display dialog adhering toUFMStandardon Mobile and Android TV with inline Marquee sub-options, interactive live preview demonstrating active settings in real time, and full persistence across backup and restore (SettingsBackupManager).
- Truncate Middle Mode (
- Actual vs. Nominal File Size Detection & Sparse/Incomplete File Handling: Added comprehensive detection and handling for sparse and pre-allocated incomplete files (such as files created by torrent clients, download utilities, and sparse virtual disk images):
- File Properties & Details (
FilePropertiesBottomSheet): Displays both nominal (logical) size and actual physical disk allocation ("Size on disk") along with allocation percentage and an amber "Partial Download (Sparse)" badge whenever physical allocation is substantially less than the reported file length. - Intelligent Duplicate Detection & Retention (
DuplicateRetentionManager,AnalyzerDuplicateAdapter,FolderDuplicateFinderActivity): The duplicate detection engine now differentiates between complete files and sparse/partial downloads sharing the same nominal size. Incomplete candidates are prominently tagged with an amberPartial (X%)badge, and complete files are strictly protected from accidental deletion across all automated retention policies (Keep Oldest,Keep Newest). Added a new explicit "Keep Most Complete" duplicate retention preset. - File Comparison Header & Offset Matching (
FileCompareDialogFragment): When comparing files with identical nominal size, UFM checks file allocation and executes fast 64 KB header and sampled block offset verification, accurately reporting whether an incomplete copy matches the reference complete file (Matching Header / Partial Copy) instead of failing with generic checksum mismatches. - Storage Analyzer Cleanup Category (
StorageAnalyzerEngine): Added an "Incomplete / Sparse Downloads" cleanup recommendation card to Storage Analyzer, enabling 1-tap review and reclamation of abandoned torrent allocations and sparse files. - Graceful Storage Degradation: Local ext4 and f2fs filesystems leverage POSIX block allocation inspection, while cloud, SMB, SFTP, WebDAV, and non-sparse volumes gracefully fall back to nominal size without false positives.
- File Properties & Details (
Fixed
- Flat View Tools & Selection Main Thread Blocked ANR (
FlatViewActivity,FlatViewViewModel,ArchiveManager): Fixed an ANR (App Freeze) report ("Main thread blocked >5000ms" inFlatViewActivity.showStandardToolsBottomSheet->File.isFile->UnixFileSystem.getBooleanAttributes0, reported on Samsung SM-A346E, Android 16 / SDK 36, app 2.2.6-GOOGLE) when opening selection tools or interacting with the Floating Quick Action Bar in Flat View mode. When files or folders were selected,showStandardToolsBottomSheetandFloatingQuickActionBar.bindSelectionsynchronously scanned selected items on the main looper usingFile.isFileandArchiveManager.isSupportedArchive, issuing thousands of blocking POSIXstat()/getBooleanAttributes0system calls across indexed files. Resolved by eliminating main-thread filesystem stat calls, evaluating archive, image, audio, and video types purely from in-memory file names and extensions viaArchiveManager.isSupportedArchiveName, caching indexed files inFlatViewViewModelwith an O(1) path lookup map (fileMap), and pre-computingFlatRootCategory.allFilesto eliminate list re-flattening overhead. - Android TV Transfer Focus Loss: Fixed an issue where 1-second progress updates in Download Manager reset D-pad focus to the top toolbar by replacing full adapter dataset invalidation with granular payload updates and stable item IDs.
- ANR Watchdog Activity Destroy View Detachment Filter (
CrashReportManager): Fixed a false-positive ANR (App Freeze) report on Android devices (reported on Samsung SM-A346E, Android 16 / SDK 36, app 2.2.6-GOOGLE) during activity destruction and window teardown (ActivityThread.handleDestroyActivity->WindowManagerGlobal.removeViewImmediate->ViewRootImpl.die->ViewRootImpl.dispatchDetachedFromWindow->ViewGroup.dispatchDetachedFromWindow->View.cleanupDraw->ViewRootImpl.cancelInvalidate->Handler.removeMessages->MessageQueue.removeMessagesLegacy), thread stateRUNNABLE. During Activity teardown or window dismissal, the Android framework dispatches window removal and view detachment recursively through the view hierarchy, cleaning up draw state and canceling pending invalidations in-memory. Added filter 89 (isActivityDestroyViewDetachStall) and updatedisPureFrameworkStackto recognizeCrashReportManager'sActivityThread.mHtransaction hook frames (installActivityThreadCrashHook), resetting the watchdog heartbeat rather than reporting a spurious freeze when concurrent background worker threads delay the watchdog timer during pure framework view hierarchy detachment with zero application business logic and no framework blocking primitives held. - DLNA SSDP Listener OutOfMemoryError Crash (
DlnaSsdpEngine,DlnaDiscovery): Fixed an unhandledjava.lang.OutOfMemoryErrorcrash ("Could not allocate JNI Env: Failed anonymous mmap... Operation not permitted", reported on Amlogic VONTAR X3, Android 9 / SDK 28, app 2.2.1-GOOGLE) on threadDlnaSsdpListenerwhen processing incoming SSDP multicast/unicast discovery packets. Previously,msearchResponseExecutorandssdpSendExecutorinDlnaSsdpEngineas well asfetchExecutorinDlnaDiscoveryused unboundedExecutors.newSingleThreadExecutorinstances that spawned worker threads on-demand when packets were received. On memory-constrained TV boxes under network traffic or SSDP discovery bursts, native thread creation (Thread.start()->nativeCreate()) failed with anonymous mmap allocation errors, which propagated out of unguardedsubmit()calls directly intoDlnaSsdpListener, terminating the listener thread and crashing the application process. Resolved by:- Replacing unbounded executors with bounded
ThreadPoolExecutorinstances (queue capacities 64 and 128) usingThreadPoolExecutor.DiscardOldestPolicy()to shed stale discovery responses and device fetches gracefully during network packet storms without memory exhaustion. - Pre-starting core executor threads during engine and discovery initialization (
prestartCoreThread()) so thread resources are allocated upfront rather than under transient memory pressure. - Wrapping all executor task submissions and task execution bodies in
try/catch (t: Throwable)guards so worker threads remain alive and submission failures never escape to calling threads. - Adding
OutOfMemoryErrorandThrowablerecovery handling inDlnaSsdpListener's packet reception loop with a 1-second backoff and GC recovery, preventing transient system-level allocation failures from crashing the app. - Wrapping all SSDP listener callback invocations (
onNotifyAlive,onNotifyByeBye,onMSearchResponse) in non-throwing blocks, clearing queues on shutdown, and catchingThrowableacross network subnet resolution helpers.
- Replacing unbounded executors with bounded
- Picture-in-Picture Custom Launcher Compatibility (
UFMPlayerActivity): Fixed an issue where Picture-in-Picture (PiP) mode failed to activate when navigating back to the home screen (via swipe gesture or Home button) while using custom third-party launchers (such as One4Home, Nova Launcher, Lawnchair) on Android 12+ (SDK 31–37+). Modernized PiP lifecycle management:- Configures
setAutoEnterEnabled(true)onPictureInPictureParamswhen video playback is active and Background Video Mode is set to PiP, allowing the system WindowManager to seamlessly transition into PiP at the OS gesture navigation level without relying on launcher-triggeredonUserLeaveHint()callbacks. - Disables
autoEnterEnabledwhen video is paused or when Background Video Mode is set to "Audio Only" so navigating home minimizes normally without popping up an unwanted floating window. - Dynamically calculates and synchronizes the PiP aspect ratio from active video dimensions (accounting for
unappliedRotationDegreesand safely clamping between 1:2.39 and 2.39:1). - Provides
sourceRectHintfrom the active video player surface bounds for a fluid zoom-to-home transition. - Automatically dismisses the PiP window (
finish()) when advancing to an audio-only track in a mixed playlist while retaining audio playback seamlessly in the background notification service. - Preserves backward compatibility on Android 8.0–11 (API 26–30) using
onUserLeaveHint().
- Configures
- ANR Watchdog HONOR / Huawei Looper HiTrace Filter (
CrashReportManager): Fixed a false-positive ANR (App Freeze) report on HONOR and Huawei devices (reported on HONOR CRT-LX3, Android 12 / SDK 31, app 2.2.1-GOOGLE) during main looper message loop processing (Looper.loopOnce->HwFrameworkFactory.getHiTraceHandler->HwFrameworkFactoryImpl.getHiTraceHandler), thread stateRUNNABLE. In Magic UI and EMUI ROMs,android.os.Looper.loopOnceinvokesHwFrameworkFactory.getHiTraceHandler()on each iteration for performance tracing, which executes purely in-memory in nanoseconds. Added filter 88 (isHonorHuaweiHiTraceLooperStall) and registeredhihonor.,com.hihonor.,huawei., andcom.huawei.underPLATFORM_PREFIXESto recognize vendor factory and trace handler lookups during looper execution with zero application business logic and no framework blocking primitives held, resetting the watchdog heartbeat rather than reporting a spurious freeze when concurrent background worker threads (Room indexing, MediaStore observer, arch disk I/O) delay the watchdog timer. - ANR Watchdog TextInputLayout Layout Inflation Filter (
CrashReportManager): Fixed a false-positive ANR (App Freeze) report on Android TV devices (reported on SDMC G1, Android 14 / SDK 34, app 2.2.1-GOOGLE) during activity launch and view inflation (SafPickerActivity.onCreate->setContentView->LayoutInflater.inflate->TextInputLayout.<init>), thread stateRUNNABLE. Added filter 87 (isTextInputLayoutInflateStall) to detect when the main thread is executing in-memoryTextInputLayoutconstruction and delegate initialization during layout inflation under an Activity lifecycle or window creation callback with zero application business logic and no framework blocking primitives held, resetting the watchdog heartbeat rather than reporting a spurious freeze when concurrent background worker threads (Firebase, DLNA/SSDP discovery, HTTP server listeners) cause CPU contention on low-end hardware. - Text Editor afterTextChanged Main Thread Blocked ANR (
TextViewerActivity): Fixed an ANR (App Freeze) report ("Main thread blocked >5000ms" inTextViewerActivity->afterTextChanged->lineSequence().maxOfOrNull->SpannableStringBuilder.charAt, reported on TECNO BG7, Android SDK 33, app 2.2.4-FOSS) during text editing. InTextViewerActivity, typing or modifying text in edit mode synchronously scanned the entire document character-by-character on every keystroke (editable.lineSequence().maxOfOrNull) withinTextWatcher.afterTextChangedto calculate maximum line width for horizontal layout constraints, executing thousands ofSpannableStringBuilder.charAt()iterations and blocking the main looper during rapid IME text input. Resolved by removing the synchronous document scan fromafterTextChanged, moving line length measurement and layout width expansion into the existing 300 ms debounced handler onDispatchers.Defaultusing a zero-allocation single-pass string scan, and reusing cachedlastMaxCharsduring pinch-to-zoom gestures in edit mode. - RecyclerView Inconsistency Detected IndexOutOfBoundsException Crash (
SafeLayoutManager,FileAdapter,NetworkFileAdapter,FileBrowserActivity,FileBrowserFragment,NetworkBrowserActivity,NetworkBrowserFragment,CategoryFilesActivity): Fixed an unhandledjava.lang.IndexOutOfBoundsException("Inconsistency detected. Invalid view holder adapter position", reported on Samsung SM-S938B, Android SDK 37, app 2.2.5-FOSS) during RecyclerView layout passes (LinearLayoutManager.onLayoutChildren->layoutChunk->getViewForPosition->validateViewHolderForOffsetPosition). InFileAdapter.submitList, selection pruning previously executed directly afterDiffUtildispatch; when selected files were deleted or moved,removeBufferRows()mutated the adapter's backing list (items) directly without notifying RecyclerView, reducing item count while scrap view holders retained pre-diff positions and causing RecyclerView's scrap validation check (position >= mAdapter.getItemCount()) to fail. Resolved by:- Reconciling selection state and resetting selection mode in
FileAdapterandNetworkFileAdapterbefore constructingnewItemsand computingDiffUtil, ensuring empty buffer rows are cleanly diffed and animated out via standard adapter notifications without direct list mutations after dispatch. - Replacing index-equality checks for
ListItem.EmptyBufferinFileDiffCallbackandNetworkDiffCallbackwithtrue, allowing DiffUtil to match buffer rows regardless of item shifts. - Introducing
SafeLinearLayoutManagerandSafeGridLayoutManageracross all browser activities and fragments (FileBrowserActivity,FileBrowserFragment,NetworkBrowserActivity,NetworkBrowserFragment,CategoryFilesActivity), which catches framework-levelIndexOutOfBoundsExceptioninonLayoutChildrenand scroll passes and disables predictive item animations to eliminate stale scrap view holder crashes.
- Reconciling selection state and resetting selection mode in
- SAF DocumentsProvider Network Query Main Thread Blocked ANR (
UfmDocumentsProvider,SafTreeManager,FileBrowserActivity,FileBrowserFragment): Fixed an ANR (App Freeze) report ("Main thread blocked >5000ms" inUfmDocumentsProvider.queryDocument->listNetworkFiles->runBlocking, reported on Samsung SM-G990B2, Android SDK 36, app 2.2.5-FOSS) where opening a folder or checking SAF path existence inFileBrowserActivity.onCreateorFileBrowserFragmenttriggered a synchronousContentResolver.queryon in-processUfmDocumentsProvider. When querying network or cloud storage documents (WebDAV, SMB, SFTP, FTP, Cloud),listNetworkFilesexecuted synchronous blocking coroutines viarunBlocking(Dispatchers.IO)on the UI thread, freezing the main looper inLockSupport.parkNanosduring slow or high-latency network requests. Enforced main-thread non-blocking guards inUfmDocumentsProvider.listNetworkFiles,openNetworkDocumentThumbnail, andopenLocalDocumentThumbnailthat immediately return cached results or safe fallbacks when invoked on the main looper without blocking, addedwithTimeoutOrNull(10_000L)safety timeouts for background network listings, guardedSafTreeManager.existsto resolvesaf://location roots directly viaSafLocationRepositorywithout issuing synchronous content resolver queries, and short-circuitedinitExistswhen the initial path matches the storage root. - External Video & Audio Player Playback History Tracking (Issue #67): Fixed an issue where videos and audio files opened from UFM in VLC for Android (and other external media players) failed to record in the external player's playback history and resume database. On Android 13–16+, external players holding standard
READ_MEDIA_VIDEO/READ_MEDIA_AUDIOpermissions could not resolve physical file paths from privateFileProviderURIs, causing VLC'slibmedialibraryto drop them from history. UFM now:- Prioritizes Android's system
MediaStorecontent URIs (content://media/external/...) for local media files, allowing external players to verify and track playback history and resume points. - Implements a fast on-demand media scanner (
MediaScannerConnection.scanFile) with a 250ms timeout to resolve MediaStore URIs for freshly downloaded or moved media before launch, falling back cleanly toUfmFileProviderwith enhanced_dataand metadata projections if unindexed. - Attaches
Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSIONalongside read permissions so external players' history databases retain read authorization across device reboots without requiring any Play Console policy declarations. - Configures
NetworkHttpProxyServerwith preferred port28842and persistent session metadata with dynamic session revival, allowing network and cloud streams (SMB, SFTP, WebDAV, Cloud) to be reopened and resumed directly from VLC's history tab.
- Prioritizes Android's system