norri

Work in Progress: These docs are incomplete and may contain inaccuracies. Norri is not yet available for download.

Common Issues

Media Not Appearing

Symptoms

  • Library scan completes but shows 0 items
  • Some files are missing from the library

Solutions

  1. Check that Norri has read access to your media folders
  2. Verify your files follow the naming conventions
  3. Make sure your files are in supported formats
  4. Go to library settings and click “Scan Library Files” to force a rescan

Playback Issues

Video won’t play

  1. Check if transcoding is needed (look at playback info)
  2. Verify your client supports the video format
  3. Check available disk space for transcoding cache

Buffering / Stuttering

  1. Check your network connection speed
  2. Lower the streaming quality in settings
  3. Enable hardware transcoding if not already

Cannot Connect Remotely

  1. Verify your remote access setup
  2. Check firewall rules
  3. Ensure your reverse proxy is running
  4. Test with the local IP first

Files Disappeared After Scan

Symptoms

  • Items that were in your library are now missing
  • Movies or shows you’ve watched are gone

Causes

  1. The files were actually deleted or moved from their expected location
  2. Network storage was offline when the scan ran (common with NAS devices)

Solutions

If files are in trash (not permanently deleted):

  1. Go to Settings → Libraries
  2. Click Edit on the affected library
  3. Check the Unavailable Files section
  4. If your files are listed there, they can return automatically when you restore the files on disk and rescan

If auto-empty trash is enabled:

Files may have been permanently removed from the database. You’ll need to:

  1. Restore the actual files on disk
  2. Rescan the library to re-add them

To prevent this in future:

  • Disable “Empty trash automatically” if you have unreliable storage
  • Set a grace period (e.g., 7 days) to give yourself time to fix issues
  • Ensure network storage is online before scheduled scans run

See Unavailable Files (Trash) for more details.

Library Shows Wrong File Count

Symptoms

  • File count doesn’t match what’s on disk
  • Some files show as “unavailable”

Solutions

  1. Open the library edit page and check the trash section for unavailable files
  2. Verify all drives and network shares are accessible
  3. Click “Scan Now” in library settings to rescan

Note

Norri protects your library by skipping inaccessible paths. If a network share is offline, those files won’t be marked as unavailable. They’re simply not scanned.

Need More Help?