Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
midori_faq [2010/04/15 19:22] 89.0.160.10midori_faq [2010/10/02 17:26] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== Midori - Frequently asked questions ====== ====== Midori - Frequently asked questions ======
-This is a list of frequently asked questions about the Midori Web Browser. Anyone feel free to improve and/ or extend this page, but keep it clean and easy to read for other Xfce users. 
-====== Getting started ====== 
-===== About Midori ===== 
  
-=== What is "Midori" and why should I use it? === +Moved to [[midori/faq|midori/faq]].
-Midori is a Web Browser, that aims to be lightweight and fast. It aligns well with the Xfce philosophy of making the most out of available resources. +
- +
-=== How to pronounce Midori and what does the name mean? === +
-Pronounce it "midoɺi", with a Bavarian/ Japanese "r" or "Mee-Doh-Ree" in English or read it Italian. The name comes from the Japanese word 緑 (みどり) for the colour "green"+
- +
-=== What does the logo mean? === +
-The paw of a green cat. Obviously. Also it resembles the letter "M" in "Midori". The curving is supposed to emphasize speed. +
- +
-=== On which platforms does Midori run currently? === +
-Midori is basically very portable and should run on all platforms that its dependencies support. +
- +
-=== Under which license is Midori distributed? === +
-Midori and all delivered artwork are licensed under the LGPL2. +
-===== Common problems ===== +
- +
-=== There are missing icons/ warnings === +
-The set of themed icons Midori can use is very limited. For instance icons for a new tab or the throbber are not guaranteed to be available. To fix this, install a Freedesktop.org spec compliant icon theme, such as Tango or Gnome, or one that is compatible with these. +
- +
-=== Tweaking Midori on the Gtk level === +
-If you don't have a desktop application that takes care of Gtk settings or if your interface doesn't support a particular feature, you can modify any settings easily manually by specifying them in a text file called ~/.gtkrc-2.0 or /etc/gtk-2.0/gtkrc: +
- +
-Use Tango as a fallback for your icon theme: +
-<code>gtk-icon-theme = "MySuperFancyTheme" +
-gtk-fallback-icon-theme = "Tango"</code> +
- +
-Use a smaller toolbar: +
-<code>gtk-toolbar-icon-size = GTK_ICON_SIZE_SMALL_TOOLBAR</code> +
- +
-Enable changing hotkeys while hovering menu items: +
-<code>gtk-can-change-accels = 1</code> +
- +
-=== Midori crashes shortly before pages are loaded === +
-There appears to be an issue with Glib 2.16. The recommended solution is to upgrade your Glib package to 2.18. +
- +
-=== Flash/ Netscape plugins don't work === +
-You need to set MOZ_PLUGIN_PATH, for example like this: +
- +
-<code bash>export MOZ_PLUGIN_PATH="/usr/lib/mozilla/plugins"</code> +
- +
-The official Flash plugin is called libflashplayer.so . +
- +
-You can either run that above line and run Midori in the same terminal afterwards or, for the long term, put it in ~/.bash_profile or /etc/profile.d or your respective distribution's place for this. +
- +
-=== Flash is crashing all the time === +
- +
-Have a look at [[http://gwenole.beauchesne.info/en/blog/2008/12/26/nspluginwrapper_1.2.0|NSPluginWrapper]] which implements plugins in their own process so they can't drag down the whole browser. +
- +
-=== HTTPS URLS won't load === +
- +
-That's a problem with WebKit. You can work around it to some extent if you start Midori like so: +
- +
-<code bash>export WEBKIT_IGNORE_SSL_ERRORS="1" midori</code> +
- +
-=== GIO-2.0 version === +
- +
-If you're trying to build midori on an older system, when you run +
-<code>./waf configure</code> +
-you may get the following message: +
- +
-<code> +
-Checking for gio-2.0 >= 2.16.0    : Package gio-2.0 was not found in the pkg-config search path. +
-Perhaps you should add the directory containing `gio-2.0.pc' +
-to the PKG_CONFIG_PATH environment variable +
-No package 'gio-2.0' found +
-</code> +
- +
-This may mean that you don't have libglib2.0-dev installed, or that the version you have is too old. +
- +
-On a Debian machine you can check the libglib2.0 version with: +
- +
-<code> +
-user@debian:~/midori-0.1.9$ dpkg -l grep glib +
-ii  libglib2.0-0             2.12.4-2+etch1           The GLib library of C routines +
-ii  libglib2.0-data          2.12.4-2+etch1           Common files for GLib library +
-ii  libglib2.0-dev           2.12.4-2+etch1           Development files for the GLib library +
-</code> +
- +
-In this case, the libglib2.0 with etch is at 2.12.4-2+etch1, glib needs to be >= 2.16 (currently as of Sep 2009 it is at 2.20.1-2 on sqeeze.) +
- +
-=== Javascript Popup windows === +
- +
-By default, Midori blocks all popup windows that openen on their own. With WebKitGTK+ 1.1.11 or higher, you can use a hidden setting to enable these windows. +
- +
-  - Quit Midori +
-  - Open the file ~/.config/midori/config +
-  - Add a line "javascript-can-open-windows-automatically=true" +
- +
-There is also a preference in the git version as of 2010-03-23. +
- +
-=== Scroll with middle mouse button === +
- +
-http://ubuntuforums.org/showthread.php?t=478418 +
- +
-=== No video in HTML5 Video objects === +
- +
-Webkit using gstreamer 0.10 as a video framework. So in order to make it work make sure that you have following gstreamer packages installed:  +
- +
-  - gstreamer0.10-alsa for alsa sound output or gstreamer0.10-pulseaudio for pulseaudio output +
-  - gstreamer0.10-plugins-good and gstreamer0.10-ffmpeg plugins +
- +
-=== Cant import bookmarks from firefox === +
- +
-Currently midori doesnt import bookmarks from firefox. But there is a way to do this manually. +
- +
-  - Export your bookmarks from firefox into html file. (Bookmarks -> Manage bookmarks -> Import/Export -> Export into html) +
-  - Go to http://www.linkagogo.com/go/Convert +
-  - Select Netscape as "input format" and XBEL as "output format", select a file with your exported bookmarks and press "Convert" +
-  - Import file into midori. (Bookmarks -> Import bookmarks) +
- +
-=== Java doesn't work, applets don't show up === +
- +
-Java is supported in WebKitGTK+ since 1.1.22. If you need Java, you need to upgrade to at least that version. Sun/ Oracle Java as well as IcedTea are known to work. Distribution specific setup might be required, such as setting LD_LIBRARY_PATH to include the location of libxul.so. +
- +
-=== Are SOCKS proxy servers supported? === +
- +
-Currently only HTTP proxy servers are supported directly. A way to use SOCKS on Unix is to use tsocks with SSH as follows: +
- +
-  - Install 'tsocks' +
-  - Open /etc/tsocks.conf in an editor +
-  - Type something like this, you can choose the port freely: +
-    server = 127.0.0.1 +
-    server_type = 5 +
-    server_port = 5555 +
-  - Open an SSH connection with the same port: +
-    ssh -D localhost:5555 myhost.com +
-  - Run Midori with "tsocks" in front of it: +
-    tsocks midori +
-  - Now you can use for example http://www.whatsmyip.org/ to verify that you are using a SOCKS connection. The IP address should match the one of your SSH host. Remember to keep the SSH login running, and don't suspend it, otherwise it won't work. +
-  - If the connection fails for some reason, you should see a connection error. +
- +
-====== Features ====== +
-===== Download Managers ===== +
- +
-Midori can start downloads with an external download manager. To use that feature, open up the Preferences and insert the name of a program executable in the Download Manager executable. There is a list of download managers on [[http://en.wikipedia.org/wiki/Comparison_of_download_managers|Wikipedia]]. +
- +
-=== Uget (former Urlgfe) === +
- +
-[[http://urlget.sourceforge.net/|UGet]] is a cross platform download manager. It can watch the clipboard to offer download dialogues automatically and it can be configured to pass through files, such as torrents, to the appropriate handler. +
- +
-=== GGet === +
- +
-[[http://live.gnome.org/GGet|GGet]] is a download manager primarily for the GNOME desktop, but it also works in other unix/ GTk+ environments. +
- +
-=== wget.sh === +
- +
-A simple shell script that uses wget to download the files and informs the user with a notification when the downloads are complete. +
- +
-You need a notification daemon, usually you already have the one from GNOME, but there is also [[http://goodies.xfce.org/projects/applications/notification-daemon-xfce|notification-daemon-xfce]] and [[http://git.xfce.org/kelnos/xfce4-notifyd/|xfce4-notifyd]] (only in git). +
- +
-<code bash>#!/bin/sh +
- +
-test -z "0.70€" && exit 1 +
- +
-if [ -f ${XDG_CONFIG_HOME:-~/.config}/user-dirs.dirs ]; then +
-    . ${XDG_CONFIG_HOME:-~/.config}/user-dirs.dirs +
-fi +
-XDG_DOWNLOAD_DIR=${XDG_DOWNLOAD_DIR:-~/downloads} +
- +
-notify-send -t 1500 -u low -i gtk-save Midori\ Download "Download started... +
-$*" +
-wget "$*" -P $XDG_DOWNLOAD_DIR || exit 2 +
-notify-send -u low -i gtk-save Midori\ Download "The download is complete. +
-<a href=\"file://$XDG_DOWNLOAD_DIR\">$XDG_DOWNLOAD_DIR</a>"</code> +
-===== Proxy servers ===== +
- +
-By running a local proxy you can modify web content even before it has reached Midori. That allows you to do things similar to what user scripts and user styles provide and even others that neither is suitable for. +
- +
-To use Midori with a proxy server, there are two options: +
- +
-1. WebKit is built with libcurl. Define an environment variable http_proxy and set it to your proxy server like so: +
- +
-export http_proxy = 234.22.154.11:8000 +
- +
-2. WebKit is built with libsoup. Midori >= 0.1.2, is built with libsoup. Try to open some web page. Now open the preferences, and you should see a Network tab with a 'Proxy server' field. +
- +
-=== Privoxy === +
- +
-Privoxy is a non-caching web proxy with filter capabilites and particular support for blocking advertisements before even loading them. +
- +
-http://www.privoxy.org/faq+
- +
-=== Mousehole === +
- +
-Mousehole is a scriptable proxy server written in Ruby. +
- +
-http://code.whytheluckystiff.net/mouseHole/ +
- +
-=== Polipo === +
- +
- Polipo is a caching web proxy (a web cache) designed to be used by one +
- person or a small group of people. It is similar in spirit to WWWOFFLE, but +
- the implementation techniques are more like the ones used by Squid. +
- +
-http://www.pps.jussieu.fr/~jch/software/polipo/ +
- +
-===== Mouse Gestures ===== +
- +
-Midori has an extension that implements Mouse Gestures now. It is only available in the repository and won't work with a copy older than 2009-01-21. +
- +
-For a quick and dirty overview of the gestures in the current release take a look at the [[http://www.matthiaskruk.de/midori/mouse-gestures.pdf|preliminary manual]]. +
-Further information is available at the [[http://www.matthiaskruk.de/midori|MGX website]]. +
- +
-Additionally, there are programs allowing mouse gestures system-wide, for example [[http://easystroke.wiki.sourceforge.net/|EasyStroke]]. +
- +
-===== Search Engines ===== +
- +
-Search engines are tools to ease searches on different web sites. In order to search something with a website, that site must provide a search feature available with a web form. In this example, we will setup a search engine for the English Wikipedia. +
- +
-=== Step 1: Search the web form, and find the right parameters === +
- +
-The search form of the Wikipedia web site is available in the left column. Just enter your search terms (for example "Midori browser") and validate. You're then directed to a result page. You can see its address in the location bar. It is http://en.wikipedia.org/wiki/Special:Search?search=Midori+browser&go=Go. Notice that your search terms are present in the result page address. +
- +
-=== Step 2: Setting up a search engine in Midori === +
- +
-Now, open the Search Engine Manager +
- +
- +
-{{http://www.fdn.fr/~arenevier/midori/search_engines_tuto/tools_manage_search_engines.png}} +
- +
-Here it is +
- +
-{{http://www.fdn.fr/~arenevier/midori/search_engines_tuto/search_engines_manager_empty.png}} +
- +
-If you validate the Add button, you are presented an interface to enter different parameters. Choose a name and a description. Then enter a search URL. That is your previous search URL with your search term replaced with %s. When searching something with that search engine, Midori will use the search URL, replace %s with your search terms, and bring you to computed URL. We don't care about the icon yet. A token can be used as a shorthand for a keyboard search. It's therefore important to use an easy to remember token. For example, we use "wp" for the Wikipepdia. More to come about tokens latter. +
- +
- +
-{{http://www.fdn.fr/~arenevier/midori/search_engines_tuto/add_search_engine.png}} +
- +
-Now, your search engine is created. +
- +
-{{http://www.fdn.fr/~arenevier/midori/search_engines_tuto/search_engines_manager_full.png}} +
- +
-You can check its presence in the Midori search bar +
- +
-{{http://www.fdn.fr/~arenevier/midori/search_engines_tuto/searchbar.png}} +
- +
-=== Step 3: Use your search engine === +
- +
-Now, you can use it by typing your search term in the location bar. If you search for "Midori browser", you should be redirected to http://en.wikipedia.org/wiki/Special:Search?search=Midori+browser&go=Go. Since we assigned the token "wp" to our search engine, you can also access the result page by typing "wp Midori browser" in the location bar. +
- +
- +
-{{http://www.fdn.fr/~arenevier/midori/search_engines_tuto/token_search.png}} +
- +
-Tip: You can go through the this tutorial and replace all instances of "en." in "en.wikipedia.org" with "fr." or any other Wikipedia country code and you will have your Wikipedia search in your favourite language. +
- +
-===== User scripts ===== +
- +
- +
-=== Overview === +
- +
-UserScripts are scripts applied on some, or on all web pages. They can modify  pages locally to add or alter functionality. That includes fixing bugs in web pages. User scripts are also available in other browsers, in the form of [[http://www.greasespot.net|Mozilla's Greasemonkey]] or [[http://www.opera.com/support/tutorials/userjs/|Opera's User JavaScript]]. +
- +
-=== GreaseMonkey compatibility === +
- +
-Midori's support for user scripts aims to be compatible with Greasemonkey to a good extent. Midori supports Greasemonkey's //@include// and //@exclude// metadata. So user scripts have a way to define on which pages they will be executed. Midori does not support advanced metadata, such as @require and @resource, so user scripts cannot define dependencies on other scripts. Midori also does not support [[http://wiki.greasespot.net/API_reference|greasemonkey's api]]. Be aware that scripts must be compatible with Webkit. A Greasemonkey script that makes use of functionality specific to Gecko will not work in Midori. +
- +
-=== How to install a UserScript === +
- +
-First, you need to find some scripts (or write your own). You can find some at [[http://userscripts.org/|userscripts.org]]. As explained previously, a lot of scripts work, while others do not work. +
- +
-To install a userscript, you have to download the script as a file, and put it in the folder **~/.local/share/midori/scripts** (you may need to create that folder if it does not exist). Midori will automatically see and use it, which you can also see in the user scripts panel. +
- +
-Note, if the script is only shown as source code on the page, you first have to create a new text file in a text editor, copy the source code into the new file, and save it as my-user-script.user.js where ".user.js" is the extension. +
- +
-=== Feed (RSS/Atom) reading via a UserScript === +
- +
-Midori is indeed sure can handle RSS and ATOM feeds (via it's **Feed Panel** extension) and yet, it's lack of spotting feed addresses makes it pretty difficult to find these addresses on websites that do not have an organized list of feeds addresses. To track those hidden (not well organized) feeds you can use [[http://userscripts.org/scripts/show/688|RSS+Atom Feed Subscribe Button Generator]] as a user script which finds RSS/Atom links on a page and inserts feed subscription links on the Top Left of the page, and just //Right-Click// on the newly created RSS/Atom oblong box //Copy Link Loc__a__tion// and add the address to your favorite news aggregator.  +
- +
-=== Flash blocking via a UserScript === +
- +
-You can use [[http://userscripts.org/scripts/show/45343|BlockFlash2]] as a user script which "Replaces" Flash individual flash elements with a button that says [Play Flash]. +
- +
-=== Flash blocking via a User style === +
- +
-You can also use [[http://rightfootin.blogspot.com/2009/04/flashblock-wannabe.html|FlashBlock WannaBe]] as a user script in order to replace Flash elements with placeholders and load them on click. The script is pretty advanced compared to most Flash blockers found on the web. +
-===== User styles ===== +
- +
-=== Overview === +
- +
-User styles are CSS Cascading Style sheets that are loaded locally and applied on top of web pages, similar to User scripts, in order to add or alter functionality and also fix bugs. +
- +
-=== How to install a user style === +
- +
-First, you need to find some styles (or write your own). You can find some at [[http://userstyles.org/|userstyles.org]]. Many styles may or may not work, depending on whether the author decided to use browser specific features. +
- +
-To install a user style, you have to download the style as a file, and put it in the folder **~/.local/share/midori/styles** (you may need to create that folder if it does not exist). Midori will automatically see and use it, which you can also see in the user styles panel. +
- +
-Note, if the style is only shown as source code on the page, you first have to create a new text file in a text editor, copy the source code into the new file, and save it as my-user-style.user.css where ".user.css" is the extension. +
- +
-=== How to install a user style before Midori 0.0.20 === +
- +
-Open up the Preferences and use the file chooser button beside User Stylesheet to choose a style sheet file. The style sheet will from now on be applied to all sites automatically. +
- +
-===== Reporting a bug ===== +
- +
-If you find a bug in Midori, the first step to have it fixed is to report it with Midori's bug tracker. You will improve chances to have the bug fixed if you [[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html|report it effectively]]. So here are some tips to make your report useful. +
- +
-=== Is the bug related to WebKit or Midori ? === +
- +
-Midori is based on the WebKitGtk rendering engine.  This means the process of displaying web content on a page is done mainly by the WebKit library. If your bug involves the user interface of Midori (buttons, menu, addressbar, behavior and so on) it's definitely a bug in Midori. If your bug involves a crash when visiting a specific website, or a page displaying improperly, this could be a WebKit problem. +
- +
-Before opening a bug report in Midori's bugtracker, please check if the problem comes from the WebKit side or is on the Midori side. Webkit provides a minimal browser named GtkLauncher. If you installed WebKit via your Linux distribution's package, GtkLauncher should be installed as part of that WebKit package. If you're on a Debian system (tested on squeeze) you can find it in /usr/lib/webkit-(version)/libexec/GtkLauncher (e.g. /usr/lib/webkit-1.0-2/libexec/GtkLauncher ). +
-If you compiled WebKit yourself, GtkLauncher should be in the **Programs/** directory. +
- +
-First, launch GtkLauncher and open the problematic website. If the same problem occurs in +
-GtkLauncher too, you've probably encountered a bug in WebKit itself. The problem is therefore more likely to be fixed if you report it via the [[http://bugs.webkit.org/|WebKit bug tracker]]. +
-If the problem appears in Midori but not in GtkLauncher, you've probably encountered a Midori problem, so should report it via the [[http://www.twotoasts.de/bugs/|Midori bug tracker]].+