summaryrefslogtreecommitdiffstats
path: root/CONTRIBUTING.md
blob: ffc4379a7501a426363988997b2f454449993e2e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
Reporting bugs
==============

- State your platform and mpv version.
- Make sure you're actually using the latest mpv release. Linux distributions
  in particular love redistributing ancient and unmaintained mpv releases.
- Attach a log file made with ``-v`` or ``--log-file=output.txt``.
- Avoid attaching text files packed in archive files (zip/rar/...), unless
  explicitly asked so. There are better means, such as using http://sprunge.us
- If you think this is file specific, upload a sample file and link it.
- Don't report multiple unrelated/barely related bugs in one issue.
- If you don't get a reply after days, be sure to post a new message to the
  issue - it could have been overlooked or forgotten.
- Read: https://mpv.io/bug-reports/

Asking questions
================

Preferably, asking questions should be done via IRC (#mpv on irc.freenode.net),
but asking questions by opening a github issue is also barely tolerated.

When asking on IRC (#mpv on irc.freenode.net), don't ask to ask, just state
your problem. Stay long enough until someone gets a chance to reply. Sometimes
it can take hours.

Sending patches
===============

See: https://github.com/mpv-player/mpv/blob/master/DOCS/contribute.md

In particular, be aware that all changes to GPL code must come with the
implicit agreement that they might be LGPLv2.1+ relicensed at a later point.