Troubleshooting

Phone pairing will not complete

1. Keep the app’s pairing screen open and confirm that both devices can reach the internet.
2. Start a new pairing session if the code expired or the page no longer responds. Use the new QR or code, not a saved screenshot.
3. Use an up-to-date browser with JavaScript enabled. Test a site-specific content-blocker exception if needed.
4. Compare the match number on both devices before accepting. If it differs, cancel the session and begin again.

A title has no playable sources

1. Confirm the exact title, season, episode, and language. Your provider may not support that combination.
2. Open Settings → Services → Manage sources. Check that the intended provider is installed and enabled, and that the repository or manifest address was entered correctly.
3. Review the connected state of any service the source requires. Tracker accounts do not authorize a playback provider.
4. Refresh or update the relevant entry when available, then test another title it is expected to support.
5. If only one provider fails, investigate that provider before resetting the entire app.

Playback is choppy, laggy, or buffering

1. Separate buffering from rendering. Pauses to load data can indicate a source or network bottleneck. Uneven motion without loading can have a different cause.
2. Compare a source you are authorized to use. Try a lower-bitrate option or a completed local download. This helps distinguish delivery problems from device playback behavior.
3. Test the alternative player. In Settings → Playback, select Media3 (Built in). Optionally enable Media3 SurfaceView, then reopen the same video.
4. Compare the result. SurfaceView affects Media3, not MPV. Revert when it does not help; do not change multiple settings at once.
5. Collect details if it persists. Record the player, device, app build, and whether the issue occurs with one source or all sources. Do not publish private stream URLs.

Tracking or the calendar is out of date

1. Confirm the intended tracker and account are connected in Settings → Accounts.
2. Check the episode-progress threshold. An episode may not be marked watched until that threshold is reached.
3. Refresh the list after making changes. For the calendar, check that followed shows actually have an airing episode in the selected week.
4. Check whether the tracker service is temporarily unavailable. Reconnect only when authorization appears invalid, not as the first response to every empty list.

A download is stuck or failed

1. Check free device storage and the status shown by the Download Manager.
2. Verify that the chosen source still works and that any required authorization has not expired.
3. Use the job’s retry or resume control as appropriate. A short-lived source may need to be selected again.
4. Reopen TetoTV after process termination. Force-stopping Android apps ends their active work; a transfer cannot continue through force-stop.
5. Test the completed file before relying on it offline.

A Watch Party room will not join or stay in sync

1. Check the code with the host and confirm that the room has not ended or expired.
2. Confirm that each person can play their own source outside the room.
3. Use the same episode version. Different cuts or intro lengths can cause a persistent offset.
4. Wait for buffering to finish and review the room’s participant state. Restart the room if the current session is no longer usable.

Report a useful issue

Share reproducible steps, not credentials. The template below includes the details that are usually useful for an initial report.

TetoTV version and build:
Device model and Android / Fire OS version:
Player: MPV or Media3 (SurfaceView on/off):
What I expected:
What actually happened:
Steps to reproduce:
Does it affect one title/source or all of them?
Changes already tested:
Redacted diagnostics or screenshots, if relevant: