MusicBrainz Picard/Troubleshooting: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
mNo edit summary
(Add info on getting logs, some tips on logging better tickets)
Line 6: Line 6:
* For general usage information see the [[Picard Documentation|documentation]] and the [[How To Tag Files With Picard|illustrated quick start guide]]
* For general usage information see the [[Picard Documentation|documentation]] and the [[How To Tag Files With Picard|illustrated quick start guide]]
* Read the [[Picard FAQ|FAQ]] for common questions and problems
* Read the [[Picard FAQ|FAQ]] for common questions and problems
* Consult the [http://forums.musicbrainz.org/viewforum.php?id=2 forums]
* Consult the [http://forums.musicbrainz.org/viewforum.php?id=2 forums].
* Check the [[MusicBrainz Picard|download page]] for a newer version of Picard which might solve your problem
* Check the [[MusicBrainz Picard|download page]] for a newer version of Picard which might solve your problem
* If the problem is to do with a plugin, check the [[Picard Plugins]] for updated plugin versions


== Reporting a bug ==
== Reporting a bug ==
If you have found a bug please check whether you are using the [[MusicBrainz Picard|latest version]] of Picard and whether the bug has already been reported in our [http://bugs.musicbrainz.org/report/5 bug tracker]. If not, open a [http://bugs.musicbrainz.org/newticket?component=Picard+Tagger new ticket] providing the following information:
If you think you have found a bug please check whether you are using the [[MusicBrainz Picard|latest version]] of Picard and whether the bug has already been reported in our [http://bugs.musicbrainz.org/report/5 bug tracker]. If you're not sure or don't want to look through the existing tickets, ask on the [http://forums.musicbrainz.org/viewforum.php?id=2 forums] first.


If you're still convinced you have found a new bug, open a [http://bugs.musicbrainz.org/newticket?component=Picard+Tagger new ticket] providing the following information:
* Which version of Picard do you use?

* Which operating system do you use?
* Which version of Picard do you use? ('''Version''' in the form)
* Which operating system do you use? ('''OS''' in the form)
* What did you do when the bug occurred?
* What did you do when the bug occurred?
* What did you expect to happen, what did happen?
* What actually happened and what did you expect to happen?
* If you're using plugins, which plugins do you have enabled?

Please leave the '''Milestone''' empty, and do not increase the '''Priority''' - usually that is for developers and [http://en.wikipedia.org/wiki/Bug_triage bug triagers] to decide.

=== Getting logs ===
For many bugs, it helps developers to have a log from Picard. You can see the log by going to '''Help''' >> '''View Log'''. You can also get a full debug log (even better) by starting Picard with '''-d''' as a command-line argument. If you're using Windows, you can change your shortcut's ''Target'' (right click shortcut >> '''Properties''') to <pre>"C:\Program Files\MusicBrainz Picard\picard.exe" -d</pre> Pasting this log into your forum post or bug ticket can help developers and other users to resolve your issue more quickly.


[[Category:MusicBrainz Picard]]
[[Category:MusicBrainz Picard]]

Revision as of 05:03, 19 May 2011

Products > Picard > Picard FAQ

Getting help

If you have problems using Picard, please first check the following resources:

Reporting a bug

If you think you have found a bug please check whether you are using the latest version of Picard and whether the bug has already been reported in our bug tracker. If you're not sure or don't want to look through the existing tickets, ask on the forums first.

If you're still convinced you have found a new bug, open a new ticket providing the following information:

  • Which version of Picard do you use? (Version in the form)
  • Which operating system do you use? (OS in the form)
  • What did you do when the bug occurred?
  • What actually happened and what did you expect to happen?
  • If you're using plugins, which plugins do you have enabled?

Please leave the Milestone empty, and do not increase the Priority - usually that is for developers and bug triagers to decide.

Getting logs

For many bugs, it helps developers to have a log from Picard. You can see the log by going to Help >> View Log. You can also get a full debug log (even better) by starting Picard with -d as a command-line argument. If you're using Windows, you can change your shortcut's Target (right click shortcut >> Properties) to

"C:\Program Files\MusicBrainz Picard\picard.exe" -d

Pasting this log into your forum post or bug ticket can help developers and other users to resolve your issue more quickly.