Troubleshooting

TanukiVision · Last updated August 2, 2026

How do I enable metadata or lyrics fetching?

Open Settings → Metadata. Metadata and lyrics fetching are optional and off by default; TanukiVision Membership is not required.

Imported songs don't appear

After copying files via USB or Files, return to TanukiVision so it can scan. For cloud and network folders, open Library → Sources and confirm the account or folder is connected. Scanning may take a moment for large libraries.

Wi‑Fi Transfer won't connect

Connect both devices to the same Wi‑Fi network. Start the server in Library → Sources → Wi‑Fi Transfer and keep TanukiVision running on your iPhone. On your computer, open the address shown in the app. Disable VPN or firewall rules that block local network access.

Cloud service missing from the folder picker

Install and sign in to the cloud app, then enable the service under Browse → … → Edit in the Files app. TanukiVision reads cloud folders through Files—if a service isn't listed there, it won't appear when you add a source either.

Cloud sign-in failed

Open Library → Sources, sign out of the affected cloud account, then connect it again with +. For Dropbox, a development warning during beta is normal—tap Continue to proceed.

Network folder won't connect

Double-check the server address, username, and password. For SMB shares, use the share path shown by your NAS or router and stay on the same local network. WebDAV may require HTTPS and an app-specific password from your provider.

A song won't play or skips

TanukiVision supports common audio formats including MP3, FLAC, AAC, and ALAC. DRM-protected or corrupted files may not play—try converting or re-importing the file.