diff --git a/doc/FAQ.asciidoc b/doc/FAQ.asciidoc index f52b3a5d9..221bdf443 100644 --- a/doc/FAQ.asciidoc +++ b/doc/FAQ.asciidoc @@ -75,5 +75,46 @@ Is there an adblocker?:: usage], so implementing it properly might take some time and won't be done for v0.1 if at all. +== Troubleshooting + +Configuration not saved after modifiying config.:: + When editing your config file mannually, Qutebrowser must be exited completely. + Either by issuing the command `:quit` or by pressing `ctrl+q` (`alt+F4` on windows). + +Unable to view flash content.:: + If you have flash installed for on your system, it's nesscary to enable plugins + to use the flash plugin. Using the command `:set content allow-plugins true` + in qutebrowser will enable plugins. It may be helpful to close and re-open + the browser to allow plugins to load properly. Packages for flash should + be provided for your platform. Read any help documentation with regards to + installing flash from your operating systems. Flash can also be + obtained from http://get.adobe.com/flashplayer/[Adobe]. + This can also be set manaully in your config file located in + `~/.config/qutebrowser/qutebrowser.conf` on *nix systems. Before editing be + sure to exit completely. Locate the line `allow-plugins = false` and change + to `allow-plugins = true` save the file and load your browser and enjoy flash! + +Experiencing freezing on sites like duckduckgo and youtube.:: + When visiting some pages and you experience freezing, unable to close or unable exit + the browser. This can be solved by disabling plugins, or checking if you have + a package installed called mozplugger installed on your system. On Archlinux + and Debian/Ubuntu systems the package is called mozplugger. After removing the + package, you may need to also delete a file in your home plugin dir. It's named + `~/.mozilla/plugins/mozplugger*.so`. Be sure to exit the browser completely before + removing any plugins manually. See https://github.com/The-Compiler/qutebrowser/issues/357[Issue #357] + for more details. + +Experiencing segfaults (crashes) on Debian systems.:: + For Debian it's nessacary to install the `gstreamer0.10-plugins-base` package. + Either with apt-get or a tool like synaptic. With apt-get simply run + `sudo apt-get install gstreamer0.10-plugins-base` in a terminal or search + for the package name in synaptic and install like any other package. + +My issue is not listed here.:: + If you experience any segfaults or crashes, you can report the issue on + https://github.com/The-Compiler/qutebrowser/issues[qutebrowser issues]. + Be sure to read over how to create a stacktrace to report crashes of unknown cause + by visiting here https://github.com/The-Compiler/qutebrowser/blob/master/doc/stacktrace.asciidoc[reporting segfaults]. + // We link to github rather than to the file here so it also works with the // qutebrowser :help because that doesn't render HACKING.