Qutebrowserのソースを表示

{{Lowercase title}}
[[Category:ウェブブラウザ]]
[[en:Qutebrowser]]
[[pl:Qutebrowser]]
[https://github.com/The-Compiler/qutebrowser qutebrowser] は、Python と PyQt5 に基づくキーボードに焦点を当てた Web ブラウザーです。

== インストール ==

{{Pkg|qutebrowser}} または {{AUR|qutebrowser-git}} パッケージをインストールしてください。

== 基本的な使い方 ==

コマンドプロンプトを出すには {{ic|:}} を使います。{{ic|Tab}} で自動補完が効きます。

qutebrowser を初めて起動した場合、クイックスタートページが表示されます。クイックスタートは {{ic|:help}} でいつでも開けます。キーボードショートカットは [http://qutebrowser.org/img/cheatsheet-big.png チートシート] を見てください。

=== ユーザー設定 ===

qutebrowser の設定は UI、コマンドライン、もしくは Python スクリプトからの三種類の方法で設定することができます。qutebrowser 自身のドキュメントで、これらの異なる方法での設定方法を詳しく説明しています。qutebrowser のヘルプシステムを開くには、{{ic|:help}} とタイプしてください。ヘルプページで、{{ic|:Configuring qutebrowser}} を選びます。

設定ファイルの場所を知るには、{{ic|qute://version}} という特別なページを開いて下さい。Arch Linux では、通常、{{ic|$XDG_CONFIG_HOME/qutebrowser/}} となります。qutebrowser で行った設定は、{{ic|autoconfig.yml}} に保存されます。(これはユーザが触ってはいけません) ユーザの Python スクリプトは {{ic|config.py}} です。

==== qutebrowser の設定 ====

設定項目を1つ設定するには、{{ic|:set}} と入力し、その後に設定項目名と設定したい新しい値を入力するだけでよいです。例えば、次のように入力します。

 :set auto_save.session true

qutebrowser を再度開いたときに前のタブを開きます。

qutebrowser の UI 設定画面を開くには、次のように入力します。

 :set

を追加引数なしで実行します。そこで、UI で異なる設定を編集することができます。編集が終わったら、もう一度 {{ic|:set}} と入力すると設定が保存されます。

例えば、{{ic|url.searchengines}} では、キーと値のペアのリストとして保存される検索エンジンを設定することができます。この設定をまだ変更していない場合、次のようになります。

 {"DEFAULT": "<nowiki>https://duckduckgo.com/?q={}</nowiki>"}

これは、DuckDuckGo をデフォルトの検索エンジンとして設定し、プレースホルダーの
{{ic|<nowiki>{}</nowiki>}} は、検索キーワードに置き換えられます。Arch Linux wiki を素早く検索するためのショートカットを追加するには、次のようにします。

 {"DEFAULT": "<nowiki>https://duckduckgo.com/?q={}</nowiki>", "wa": "<nowiki>https://wiki.archlinux.org/?search={}</nowiki>"}

そして qutebrowser UI のコメントにあるように、{{ic|o wa <searchterm>}} と入力することで Arch Linux wiki を検索することができるようになります。検索を実行するために必要な引数は検索エンジンによって異なることに注意してください。例えば、Google を設定するには {{ic|<nowiki>https://www.google.com/search?hl=en&q={}</nowiki>}} を使います。

Tor がインストールされているシステムで、DuckDuckGo の onion ページを使用する場合、次のような設定にする必要があります。

 {"DEFAULT": "<nowiki>https://3g2upl4pq6kufc4m.onion/?q={}</nowiki>", "wa": "<nowiki>https://wiki.archlinux.org/?search={}</nowiki>"}

==== キーバインド ====

キーバインドを編集するには、ブラウザから {{ic|:bind ''key'' ''command''}} というコマンドで直接編集するか、ファイルから直接編集することができます。すでに多くのキーバインドがあることに注意してください。もし、あるキーバインドでラグに気づいたら、それは他のキーバインドも同じキーで始まっているためです。

例については、[https://qutebrowser.org/doc/help/configuring.html#_binding_keys ドキュメント] を参照してください。

=== 動画の再生 ===

[[ブラウザプラグイン#マルチメディアの再生]] を見てください。

== ヒントとテクニック ==

=== quickmarks/ブックマークのインポート ===

Qutebrowser は、python スクリプト {{ic|/usr/share/qutebrowser/scripts/importer.py}} により、複数のフォーマットからブックマークをインポートすることができます。デフォルトの出力形式は、qutebrowser の quickmarks 形式です。ブックマークとクイックマークの違いについての簡単な説明は、[https://qutebrowser.org/doc/faq.html qutebrowser FAQ]を参照してください。

==== Chromium/Chrome から ====

第一引数に {{ic|chromium}} を、第二引数にブックマークファイルのあるディレクトリを指定して、上記のスクリプトを実行してください。Chromium の場合は {{ic|~/.config/chromium/Default}}、Chrome の場合は {{ic|~/.config/google-chrome/Default}} となります。スクリプトの出力は、{{ic|~/.config/qutebrowser/quickmarks}} に追記することができます。入力フォーマットの一部を以下に説明します。追加情報は、{{ic|importer.py}}に{{ic|-h}} フラグを与えることで確認できます。

==== Firefox から ====

Firefox のブックマークを HTML ファイルに書き出す([https://support.mozilla.org/en-US/kb/export-firefox-bookmarks-to-backup-or-transfer] を参照)そして、インポートスクリプトを使用します。

 $ python /usr/share/qutebrowser/scripts/importer.py bookmarks.html >> ~/.config/qutebrowser/quickmarks

==== bookmarks.html ファイルから ====

{{ic|bookmarks.html}} ファイルからのインポートは {{pkg|python-beautifulsoup4}} パッケージが必要です。インポートするには、 {{ic|bookmarks.html}} ファイルを {{ic|importer.py}} に渡し、出力を {{ic|~/.config/qutebrowser/quickmarks}} に追加します。

 $ python /usr/share/qutebrowser/scripts/importer.py ~/.config/chromium/Default >> ~/.config/qutebrowser/quickmarks

==== quickmarks ではなく、ブックマークとしてインポートする ====

上記の方法のいずれかを使用し、さらに {{ic|-b}} フラグを指定することで、スクリプトの出力形式をブックマークに変更することが可能です。出力は、{{ic|~/.config/qutebrowser/bookmarks/urls}} に追加します。

 $ python /usr/share/qutebrowser/scripts/importer.py -b chromium ~/.config/chromium/Default >> ~/.config/qutebrowser/bookmarks/urls

なお、このフラグはブラウザ指定の前に追加する必要があります。

=== ログイン情報を自動的に入力する ===

[https://github.com/qutebrowser/qutebrowser/blob/master/misc/userscripts/qute-pass qute-pass] ユーザースクリプトを使用すると、[[Pass]] パスワードストアに保存されているログイン情報を [https://i.imgur.com/KN3XuZP.gif 自動的に入力] することが可能です。[[dmenu]] や互換性の有る [[アプリケーション一覧/その他#アプリケーションランチャー|アプリケーションランチャー]] と {{Pkg|python-tldextract}} が必要です。{{ic|:spawn --userscript qute-pass}} を実行するキーバインドを設定します。

{{Style|The quote should be part of the userscript's {{ic|--help}} page if it is so prominent.}}

スクリプトの説明から引用します:
 サイトのドメインは、パスパスのセグメントとして表示される必要があります。例えば、"github.com/cryzed" や "websites/github.com" のように。ユーザー名とパスワードの決定方法は、CLI の引数で自由に設定することができます。ログイン情報は、qutebrowser の fake-key コマンドを使ってキーイベントをエミュレートすることで、以下のように挿入されます。[USERNAME]<Tab>[PASSWORD] のように、qutebrowser の fake-key コマンドでキーイベントをエミュレートしてログイン情報を挿入します。これは、ほぼすべてのログインフォームと互換性があります。

さらに明確にするために、デフォルトで使用されるパス構造は次のようになります。

{{ hc| user@computer$ pass |
 Password Store 
 ├── example.site1.com 
 │   └── username 
 ├── example.site2.com 
 │   └── username1 
 │   └── username2 
}}

これは、各ウェブサイトが ~/.password-store フォルダの中のディレクトリであることを意味します。各ウェブサイトの名前の付いたディレクトリの中には、username.gpg、username2.pgp などのタイトルのファイルがあり、各ファイルにはウェブサイトの各ユーザー名に関連するパスワードが含まれています。 Firefox から移行する場合、[https://github.com/johnabs/firefox_decrypt firefox_decrypt の修正版]は、このフォーマットで移行する必要があります。

ユーザースクリプトは、ほとんどのワークフローや特殊な状況(パスワードだけを挿入したい、ユーザー名とパスワードを挿入する通常の方法がうまくいかないなど)に対応できるように、多くのオプションを提供しています。

=== スペルチェックをオンにする ===

まず、qutebrowser に同梱されている {{ic|dictcli.py}} スクリプトで、適切な辞書をダウンロードします。

例えば、英語 (US) の場合。

 $ /usr/share/qutebrowser/scripts/dictcli.py install en-US

このスクリプトには他の機能もあり、{{ic|--help}} で表示することができます。

次に、qutebrowser で以下を設定します。

 :set spellcheck.languages ["en-US"]

=== フィンガープリンティングを避ける ===

ウェブサイトは、画面サイズ、ユーザーエージェント、HTTP_ACCEPT ヘッダーなどの情報を組み合わせることで、ユーザーを特定できる場合があります。詳しくは[https://panopticlick.eff.org/] をご覧ください。また、ブラウザの独自性をテストすることもできます。以下は、あなたの qutebrowser のインストールをより「一般的」にするためにできるいくつかのステップです。

さらに、より多くのアイデアについては、[[Firefox プライバシー#Stop Fingerprinting]] を参照してください。

==== 共通のユーザーエージェントを設定する ====

{{ic|set content.headers.user_agent}} を使用すると、いくつかのユーザーエージェントをオプションとして使用できます。もうひとつ、おそらくより一般的なユーザーエージェントがあります。

 Mozilla/5.0 (Windows NT 10.0; rv:68.0) Gecko/20100101 Firefox/68.0

{{Note|
* ウェブサイトは Javascript でプラットフォームの種類を収集することもでき、この設定は qutebrowser では変更できないため、{{ic|Windows NT 10.0}} を {{ic|X11; Linux x86_64}} に変更するとよいかもしれません。
* ユーザーエージェントをデフォルトから変更すると、一部の Web サイトが正常に動作しなくなります。例えば、ユーザーエージェントが古いブラウザとしてリストされている場合、CAPTCHA はあなたのブラウザがサポートされていないことを言及します。}}

==== HTTP_ACCEPT ヘッダーの設定 ====

以下は、一般的な HTTP_ACCEPT ヘッダー(Firefox のデフォルト)です、プロンプトで次のコマンドを入力するだけです。

 set content.headers.accept_language en-US,en;q=0.5
 set content.headers.custom '{"accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"}'

==== canvas からの読み込みを無効にする ====

 content.canvas_reading を false に設定します。

{{Note|一部のウェブサイトは、コンテンツのレンダリングやその他の機能において、canvas の読み込みに依存しています。このオプションを追加すると、それらが正しく動作しなくなる可能性があります[https://github.com/qutebrowser/qutebrowser/issues/2908]}}

==== WebGL を無効にする ====

WebGL を無効にするには {{ic|content.webgl}} を {{ic|false}} に設定します。

=== dwb ライクなセッション処理 ===

qutebrowserに、[[dwb]] の {{ic|--restore}} オプションに近いセッション処理(複数同時アクティブセッション)をさせるには、[https://github.com/ayekat/dotfiles/blob/master/lib/dotfiles/wrappers/qutebrowser このラッパースクリプト] を使用します。これは、{{ic|--basedir}} を使って、各セッションのデータ、キャッシュ、ランタイムを分離し、設定は共有されたままです。

=== Web サイトを無効にする ===

{{ic|~/.config/qutebrowser/blocked-hosts}} を作成し、各行にブロックしたいウェブサイトを入力します。例えば {{ic|www.youtube.com}} のように。これで、内蔵のアドブロックリストを維持したまま、ウェブサイトを追加していくことができます。qutebrowser を再起動し、{{ic|:adblock-update}} を実行します。

=== Brave ブラウザの adblocker を使用する ===

{{Pkg|python-adblock}} パッケージをインストールし、qutebrowser 内で adblocker を有効にしてください。

 :set content.blocking.method both

=== mpv でリンクを開く ===

Web ページを読み込む代わりに、mpv で特定のリンク (YouTube、reddit など) を開いて、広告や追跡などをバイパスするために使用できます。もちろん、mpv を選択したビデオプレーヤーに置き換えることもできます。

 :bind M hint links spawn mpv {hint-url}

=== ダークテーマを有効にする ===

 :set colors.webpage.darkmode.enabled true

=== JavaScript を無効にする ===

 :set content.javascript.enabled false

=== トラフィックを Tor 経由でルーティングする ===

まず [[tor]] を有効にして実行する必要があります。これは、Tor プロキシのみを使用していますが、Tor ブラウザ上のフィンガープリントから保護するものではないことに注意してください。

 :set content.proxy socks://localhost:9050/

== トラブルシューティング ==

=== ツールチップが読めない ===

Qt のテーマによっては、ツールチップが読みにくい場合があります。これを解決するために、Qt スタイルシートファイルを作成してください。例えば
{{hc|head=~/.local/share/qutebrowser/fix-tooltips.qss|output=<nowiki>
QToolTip {
	background-color: palette(highlight);
	border: 2px solid palette(highlight);
	color: palette(text);
}</nowiki>}}

そして、qutebrowser の起動時にスタイルシートを読み込ませます。

 qutebrowser --qt-arg stylesheet ~/.local/share/qutebrowser/fix-tooltips.qss

{{Note|すでに qutebrowser のインスタンスが起動している場合は、スタイルシートは適用されません。}}

{{Tip|この例のように、余分な引数を指定する場合、[[デスクトップエントリ#アプリケーションエントリ|デスクトップエントリ]] を使って、便利なランチャーを作成する方法もあります。}}

詳しくは、[https://github.com/qutebrowser/qutebrowser/issues/4520 バグレポート] をご覧ください。

バグレポートでは、起動時に引数を必要としない {{ic|qt5ctl}} を使った [https://github.com/qutebrowser/qutebrowser/issues/4520#issuecomment-584115754 別の方法] が提案されています。

# qutebrowser では {{ic|:set qt.force_platformtheme qt5ctl}} です。
# {{ic|qt5ct}} で、style:gtk2, standard dialogs: gtk2, palette: default を設定する。
# スタイルシートタブに変更し、新しいファイルを作成する、例えば ({{ic|tooltip-gtk2.qss}})
# 中に以下の内容を入れてください。 {{bc|<nowiki>QToolTip{
	background: QLinearGradient(x1: 0, y1: 0, x2: 0, y2: 0, stop: 0 palette(window), stop: 1 palette(alternate-window));
	border-radius: 3px;
	border: 1px solid #000000;
	padding: 1px;
	color: palette(text);
}</nowiki>}}
# 保存して OK をクリック
# この新しいファイルの隣にあるボックスにチェックを入れて、テーマに適用されるようにします。
# 適用をクリック

=== PDFが表示されない ===

PDF.jsのバージョンアップに伴い、PDFファイルが一切表示出来なくなる不具合が存在しています([https://github.com/qutebrowser/qutebrowser/issues/7335 qutebrowser/qutebrowser #7335])。

一時的な処置として、 {{Pkg|pdfjs}} をアンインストールし {{Pkg|pdfjs-legacy}} をインストールすることで解決出来ます。

== 参照 ==

* [https://github.com/qutebrowser/qutebrowser GitHub リポジトリ]
* [https://qutebrowser.org/ ホームページ]
* [https://bbs.archlinux.org/viewtopic.php?id=191076 BBS スレッド]
* [https://hg.sr.ht/~jasonwryan/shiv/browse/.config/qutebrowser/config.py 新規設定例]