View source for Report bugs

= Reporting a bug =
 	
If you find any bugs, or if you experience any crashes, then we would very much like to hear of these problems/suggestions. Here are some detailed information on how to submit useful bug reports.

Follow the bugs policy.

== Is it truly a new bug? ==

It may sound strange, but many of the bugreports we get are not really bugs at all, or have been know for months, and/or repaired. 

Please check the following:
=== Version ===
''Are you using the latest version of VLC?'' Bug reports on older versions of VLC are likely to be ignored, because changes in the program may make it impossible to reproduce the bug, or may even have fixed it. Always make sure the issue you want to report is still present in the current version of VLC.

=== Preferences ===
''Have you reset your preferences and restarted VLC yet?''
Often old preferences and incorrect settings are the cause of an issue you are seeing. 

Read the [[FAQ]] for details on	how to do this. (Uninstalling VLC does not remove it's old settings.)
Double check that your issue still exists.

=== Features ===
Some things are simply NOT supported by VLC. We have a [http://www.videolan.org/vlc/features.html features' list that are supported in VLC and a 
[https://trac.videolan.org/vlc/query?action=view&amp;type=enhancement&amp;order=priority list of things] we would like to implement in the future. 
If your suggestion is not on this list, you might want to make a ''feature request'' in the [http://forum.videolan.org/viewforum.php?f=7 Requests Forum], asking the developers to support this. Remember that we all do this in our spare time. There is no timeline whatsoever for the implementation of these enhancements and we do not make ANY promises as to when we will add them to VLC. If you really want something right now, you best implement it yourself. 
Join us on the [[Developers Corner]]

=== Closed bugs ===
Many bugs are already known. Sometimes they are already fixed for the next version of VLC. Please [https://trac.videolan.org/vlc/search?q=&amp;ticket=on search] the list of known and fixed issues. If you find your issue, see if it is already closed. The page of the issue will then show something like:

''Ticket #87 (Closed: fixed)''

== Still a bug? ==
So you still think you found a bug? Great!

=== Search ===
Search on this wiki and on the [http://forum.videolan.org forums] and see if someone else has asked a similar question or has seen a similar bug.

=== Forum ===
Ask for your problem in the [http://forum.videolan.org/ relevant forum] and make sure you include as much information as possible (see also the pointers below). Of course you can also mail us with your problems to the [http://www.videolan.org/support/lists.html mailinglist].

=== Enter the bug in trac ===
If you are sure that you found a bug and that you have all information needed, you can enter a bug in our [https://trac.videolan.org/vlc/ Trac system]. You will need to register here to enter a bug. Don't forget to enter a valid e-mail address if you want to receive notifications when your bug is handled.

= Give a report =
When you post on the forum, email us or enter a bug report, please provide as much information as possible in your report.
We try to answer all your mails, posts and reports, but there are so many that sometimes we simply don't have the time to do so. The more
sound details you provide about your issue, the better the chance that we will investigate it fully.

Please gather the following information and send it along with your report:


# Email with a valid reply address, so we can get back to you with possible additional questions.
# Your operating system and the version.
# Your {{VLC}} version.
# The hardware you use. Make sure to name all the audio and video hardware in question that might be related to VLC's usage.
For instance: iMac G4 or Pentium4 with GeForce3, with an external USB dolby surround output device.
# The exact '''situation''' in which the problem occurred. Please describe in as much detail as possible.
# Can you always '''reproduce''' the problem in a certain way?
# The type of movie you were playing. And whether or not the issue is present on other types of movies.
# If possible, the video sample in question:
If the issue is specific to a certain movie, it can help a lot if we have the movie itself. In this case please upload as much of the file as you can to our [ftp://streams.videolan.org/incoming FTP samples server]. Give the file a distinct name, and upload a text file with the same name in which you again describe the problem. Report this upload in your forum posting and tell us the name of your file. This makes sure we can more easily find back your sample.

== Additional remarks ==
If you can, or if it applies to you try to take into account the following.

===Mac OS X users===
Please send along the last part of ~/Library/Logs/CrashReporter/VLC.crash.log if you can. Many crashes of VLC are logged in this file. You can open the file from VLC by going to the menu Window and choosing Messages. Now click the "Open CrashLog" button.
Please make sure you send the last crash (at the bottom of the file) and that it actually is the crash you described. The Date/Time field reports the time of the crash so that way you can check if it is the crash you experienced, or an earlier one.

**********

Date/Time:  2007-03-04 23:42:11 -0800
OS Version: 10.2.8 (Build 6R73)
Host:       mo-aljalals-Computer.local.

Command:    VLC
PID:        434

Exception:  EXC_BAD_ACCESS (0x0001)
Codes:      KERN_INVALID_ADDRESS (0x0001) at 0x03980a00

Backtrace not available

PPC Thread State:
  srr0: 0x9068ba54 srr1: 0x0000d030                vrsave: 0x00000000
   xer: 0x20000000   lr: 0x000b69c0  ctr: 0x9068ba3c   mq: 0x00000000
    r0: 0x000b69c0   r1: 0xf0263d60   r2: 0x000b68cc   r3: 0x015372b0
    r4: 0x906ca0d0   r5: 0x00000000   r6: 0x1dcd6500   r7: 0x00756820
    r8: 0x00000000   r9: 0x00000000  r10: 0x00000000  r11: 0x005fafa8
   r12: 0x03980a00  r13: 0x00000001  r14: 0x00764d9c  r15: 0x00474d9c
   r16: 0x0075d54c  r17: 0x0075de60  r18: 0x0075d76c  r19: 0x0075d550
   r20: 0x0075d624  r21: 0x0075de7c  r22: 0x0075d7e4  r23: 0x00496398
   r24: 0x0075de9c  r25: 0x0075d7e8  r26: 0x0047558c  r27: 0x01536c30
   r28: 0x0124f47c  r29: 0x00000000  r30: 0x01536c30  r31: 0x000b6820

=== Compile problems ===
Make sure you have read the [[Developers_Corner]].
Give the full log showing the problem
<pre>
	  ./configure &lt;options&gt; &gt; logfile.txt 2&gt;&amp;1
	  make 2&gt;&amp;1 > logfile.txt 2&gt;&amp;1
</pre>

*  When dealing with a ./configure issue, please provide the generated config.log file.
* Your compiler brand and version may be relevant here as well.

== Version ==
Written by Derk-Jan Hartman, for the VideoLAN Team.

Adapted by [[User:J-b|Jean-Baptiste Kempf]] for this wiki.