rnhmjoj/qutebrowser
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

troubleshooting added to faq

Browse Source
This commit is contained in:
John ShaggyTwoDope Jenkins 2014-12-23 16:05:23 -08:00
parent bececc69c3
commit b02c406cb9
1 changed files with 41 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
doc/FAQ.asciidoc
View File

@ -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.