Support and contributing

Report reproducible problems, request features, contribute safely, and find project resources.

Search existing issues and review the latest release notes before opening a report.

Report a bug

Use the bug report template and include:

1. App version or commit, build variant, device model, and Android version.
2. Exact steps to reproduce the issue.
3. Expected and actual behavior.
4. Relevant mpv.conf, script, shader, gesture, decoder, or server settings.
5. Sanitized screenshots, recordings, or logs when useful.

For playback, include source type, container, codecs, resolution, and whether defaults reproduce it. For server problems, include the server product/version and whether another client works.

Request a feature

Use the feature request template. Describe the problem, affected workflow, proposed behavior, and alternatives. Discuss large changes before investing in an implementation.

Sensitive reports

Do not open a public issue containing vulnerability details, credentials, authenticated URLs, private server information, or conduct reports. Ask the maintainer for a private channel without posting the sensitive details.

Contribute

• Keep changes focused and consistent with existing architecture.
• Add or update tests according to the behavior’s risk.
• Update user documentation when behavior changes.
• Translate new Android-facing strings into every existing locale.
• Follow the Code of Conduct.

Project resources