🔧 Troubleshooting Guide

Common problems and solutions for FastMediaSorter v2.

Connection Issues

❌ “Cannot connect to SMB server”

Possible causes:

  1. Wrong network - Phone must be on same Wi-Fi as NAS
  2. Wrong address format - Try both formats:
    • \\192.168.1.100\share
    • smb://192.168.1.100/share
  3. Firewall blocking - Check NAS firewall settings
  4. SMB version mismatch - Some NAS require SMB v1 (deprecated)

Solution:

❌ “SFTP connection timeout”

Possible causes:

  1. Wrong port (default: 22)
  2. SSH server not running
  3. Firewall blocking

Solution:

1. Test with SSH client on PC first:
   ssh username@192.168.1.100
2. Check if SSH service is running
3. Verify port in Settings

❌ “Google Drive sign-in failed”

Solution:

  1. Clear app data: Settings → Apps → FastMediaSorter → Clear Data
  2. Reinstall the app
  3. Check Google account settings → Security → Third-party apps

❌ “OneDrive sign-in failed”

Solution:

  1. Check Microsoft account status
  2. Clear app data: Settings → Apps → FastMediaSorter → Clear Data
  3. Check Microsoft account settings → Privacy → Apps and services

❌ “Dropbox sign-in failed”

Solution:

  1. Check Dropbox account status
  2. Clear app data: Settings → Apps → FastMediaSorter → Clear Data
  3. Check Dropbox account settings → Security → Connected apps

Performance Issues

❌ “App is slow / laggy”

For large folders (5000+ files):

  1. Settings → Edit folder → Enable “Disable thumbnails”
  2. Use filters to reduce visible files
  3. Close other apps to free RAM

For network folders:

  1. Check Wi-Fi signal strength
  2. Reduce thumbnail cache size
  3. Enable “Scan subdirectories” = OFF if not needed

❌ “Thumbnails not loading”

Local files:

Network files:

File Operation Errors

❌ “Copy failed: Permission denied”

Local files:

Network files:

❌ “Cannot delete file”

Possible causes:

  1. File is open in another app
  2. No write permission
  3. File is system-protected

Solution:

❌ “Move operation failed”

Cross-protocol moves (e.g., Local → SMB):

Solution:

App Crashes

❌ “App crashes when opening player”

Common causes:

  1. Corrupted video file
  2. Unsupported codec
  3. File too large (>4GB)

Solution:

❌ “Media file not playing or no sound”

Problem: Video loads but shows black screen, or plays without sound.

Solution:

  1. Tap the ⓘ (Info) button in top toolbar
  2. Tap “Open in External Player”
  3. Select a specialized player (e.g., VLC, MX Player)

This uses the Secondary Player feature to hand off unsupported codecs to other apps.

❌ “App crashes on startup”

Solution:

  1. Clear app cache: Settings → Apps → FastMediaSorter → Clear Cache
  2. If persists: Clear app data (⚠️ loses settings)
  3. Reinstall app as last resort

UI / Display Issues

❌ “Touch Zones not working”

Check if enabled: Settings → Playback → “Show touch zones hint on first run” = ON

Make visible: Settings → Playback → “Always show touch zones overlay” = ON

❌ “Command panel buttons too small”

Solution: Settings → Playback → “Compact mode” = OFF

This doubles the size of all buttons and spacing.

❌ “Dark theme not working”

The app follows system theme:

Data Issues

❌ “Favorites disappeared”

Favorites are stored locally:

Prevention:

❌ “Trash folder keeps growing”

Deleted files go to .trash/ folder and stay there until manually emptied.

Solution:

  1. Settings → Quick Sort → “Clear Trash”
  2. Or manually delete .trash/ folders

Still Having Issues?

Check Logs

  1. Settings → General → “Enable detailed errors” = ON
  2. Reproduce the issue
  3. Check logcat output

Report a Bug

Include this information:

Submit: GitHub Issues

Translation & EPUB Issues

❌ “Translation not working or stuck”

Possible causes:

  1. Missing models: The app failed to download OCR models.
  2. No Internet: First run requires internet to download models.
  3. Storage full: No space for models (~50 MB).

Solution:

  1. Check internet connection.
  2. Go to Settings → Documents
  3. Toggle “Enable Translation” OFF and ON again.
  4. Try switching Source Language to “Auto”.

❌ “EPUB book not opening”

Possible causes:

  1. DRM Protection: The app only supports DRM-free EPUBs.
  2. Corrupted file: The file might be incomplete.
  3. Very large file: >100MB files on slow network might timeout.

Solution:

  1. Verify the file opens in other readers.
  2. If on network/cloud, try downloading it manually first.
  3. Ensure file extension is exactly .epub.

Content Issues

❌ “Cannot see Text or PDF files”

Solution:

  1. Check Settings → General
  2. Ensure “Support Text Files” and “Support PDF Files” are enabled.
  3. Check Filters on main screen (funnel icon) to ensure they are selected.
  4. Rescan the folder (pull-to-refresh).

Known Limitations

Last updated: December 2025
Version: v2.25.1206