gronod/headphones
1
0
Fork 0
mirror of https://github.com/rembo10/headphones.git synced 2026-07-21 16:34:01 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated Troubleshooting (markdown)

basilfx
2014-09-25 17:48:43 -07:00
parent f1c3a618f4
commit 609bafd373
1 changed files with 7 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Troubleshooting.md
+7 -6
@@ -1,6 +1,8 @@
This page presents some guides to help fix common problems. If your problem is not listed, or the steps below don't work, please file an issue INCLUDING verbose logging.
Please note that the issue tracker **is not** a support forum. It is primarily used to submit bugs, improvements or feature requests. We are glad to help you, but please understand that we don't have a crystal ball that can look into your problem. Furthermore, don't expect from us that we provide the full answer step-by-step. See [README.md](https://github.com/rembo10/headphones/blob/master/README.md) for more information.
Please note that the issue tracker **is not** a support forum. It is primarily used to submit bugs, improvements or feature requests. We are glad to help you, to make sure the problem is not the cause of Headphones. But **please** understand that we don't have a crystal ball that can look into your problem. Every system is different. Furthermore, don't expect from us that we provide a complete answer step-by-step. We voluntarily try to help you, but please understand we just don't have the time to work out every problem. Therefore, we **assume** you understand what we reply. If not, we advice you to look for support in general forums on the internet.
See [README.md](https://github.com/rembo10/headphones/blob/master/README.md) for more information.
## First of all: toggle verbose ##
Headphones does not turn on verbose logging (also known as debug information) for efficiency reasons. While this information is extremely useful in solving problems, it is the first thing that you should enable in case of problems. There are two ways of toggling verbose mode.
@@ -13,11 +15,10 @@ The second option will be the easiest option in most cases, especially for Synol
## Second of all: rule-out human error ##
There are a lot of issues that can be solved by just reviewing your settings. Before continuing (or posting an issue), consider the following general advice:
* Am I connected to the internet?
* What settings did I change from the default installation?
* Did I spell the URL correctly (note that some URLs require `http://` in front, while others may not)?
* Do I have write permissions to the directory Headphones tries to move files to?
* Does Google know it?
* Review your settings. If possible, start from scratch (backup your files!)
* Check the permissions. Under Linux, `ls -al` should list the files in the current folder. The user owning the files is shown too, which should match the running user.
* Try to start Headphones directly, not via an init script or service. Type `python Headphones.py -h` to see how to start it directly, and as a tip: make sure the paths to your configuration files are correct!
* Use Google! It's for a reason we put so much logging in Headphones. Sometimes, Google yields the answer by just copy-pasting the error message.
## Cannot reach MusicBrainz server ##
_Symptons_: