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-12-28 04:54:48 -08:00
parent ccf6598555
commit 0d84597311
1 changed files with 2 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Troubleshooting.md
+2 -5
@@ -7,15 +7,12 @@ See the [README.md](https://github.com/rembo10/headphones/blob/master/README.md)
## 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.
* Modify the command line arguments to include the `--verbose` (or `-v`) option. Do note that the `--verbose` option may conflicts with `--quiet` (web log only) and `--daemon` (no terminal output), but it will always print to the web log.
* Toggle verbose mode via `http://ip:port/toggleVerbose`. You should see in the web log if verbose is turned on or off. This option is **not permanent**, and will be restored on the next start. With this option, you cannot log startup errors, since Headphones should be started to toggle this.
The second option will be the easiest option in most cases, especially for Synology users.
* Start Headphones with the `--verbose` option. Do note that the `--verbose` option may conflicts with `--quiet` (web log only) and `--daemon` (no terminal output).
* Toggle verbose mode temporary via `http://ip:port/toggleVerbose`. You should see in the web log if verbose is turned on or off.
## 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:
* Do you have Python 2.6 or 2.7 installed? Run `python --version` to see which version you have installed. Python 3.x is NOT supported. Some distributions favor Python 3.x above Python 2.x as default interpreter.
* Review your settings. If possible, try to start from scratch (just run a separate install from another directory), to isolate the problem. For instance, see this issue [#1985](https://github.com/rembo10/headphones/issues/1985).
* 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!