ObsidianのWeb Clipper（ウェブクリッパー）は便利な機能ですが、Linux環境、特にUbuntu上のFirefoxで使う際、「Obsidianが起動しない」 や 「Obsidianは起動するが、記事が保存されない」という問題に直面することがあります。この記事では、ObsidianのWeb ClipperをUbuntuのFirefoxで使用できるように、UbuntuにAppImage版のObsidianをインストールする手順と、FirefoxでWeb Clipperを使えるようにする設定を中心に解説します。
- 環境
- ObsidianをUbuntuにインストール（AppImage版）
- URIプロトコルの設定と引数の追加
- FirefoxへWeb Clipperのインストール
- Web Clipperの動作確認
- まとめ
- 参考サイト
環境
OS：Ubuntu24.04 LTS
Obsidian：Version 1.10.3
Web Clipper：Version 0.12.0
ObsidianをUbuntuにインストール（AppImage版）
UbuntuへのObsidianのインストール方法は、この公式サイトに記載がありますが、とても簡潔なので、もう少し補足が欲しいところです。Ubuntu環境でWeb Clipperとの連携問題を避けるため、AppImage版でのインストールを推奨します。
Obsidianのダウンロード
Obsidian公式サイトのダウンロードページへアクセスし、Linux (AppImage) バージョンをダウンロードします。
AppImageの配置と実行権限の付与
ダウンロードしたファイル（例: Obsidian-xxx.AppImage。xxxはバージョン）を、分かりやすい場所に移動させます。私は/opt/obsidianというディレクトリを作り、そこに移動させました。そして、実行権限を付与します。
sudo mkdir /opt/obsidian mv <path of downloaded Obsidian-xxx.AppImage> /opt/obsidian/Obsidian.AppImage # <>は実際のパスで置き換えてください。リネームしてバージョンは消しています。 chmod +x /opt/obsidian/Obsidian.AppImage
これで、以下のようにターミナルでコマンドを実行するとobisidianを起動することができます。
/opt/obsidian/Obsidian.AppImage --no-sandbox
ランチャーの作成
毎回ターミナルから起動するのでも問題は無いのですが、少し手間なので、アプリのランチャーを作成します。まずは、アイコン用の画像をダウンロードします。このobsidian公式のアイコンのサイトからアイコン画像をダウンロードできるので、アイコン画像をダウンロードします。ダウンロードした画像（obsidian-icon.png）は/opt/obsidian/に移動しておきます。次に、/usr/share/applicationsの下にobsidian.desktopを作成してそこに設定を記述します。
sudo vi /usr/share/applications/obsidian.desktop
obsidian.desktopは以下のようにします。後述しますが %uをつけないとWeb Clipperとうまく連携できませんので忘れずに。
Name=Obsidian Exec=/opt/obsidian/Obsidian.AppImage --no-sandbox %u Icon=/opt/obsidian/obsidian-icon.png Type=Application Categories=Utility MimeType=x-scheme-handler/obsidian StartupWMClass=Obsidian
これでUbuntuの左下のアプリを表示からObsidianが表示されるので、そこから起動できるようになります。ダッシュボードにピン留めして置くと便利です。
URIプロトコルの設定と引数の追加
これはObsidianを外部から起動し、記事の内容をクリップボード経由で読み取らせるための重要な設定です。この設定を行うことで、「Obsidianが起動しない」、または「Obsidianは起動するが、記事が保存されない」という両方の問題を解決できます。実は、この設定内容は、すでに 上記のobsidian.desktopに記載済みです。
特に Exec=/opt/obsidian/Obsidian.AppImage --no-sandbox %uでの%uは重要です。このコマンドラインにおける%u は、URIハンドラーとしてアプリケーションを起動する際に使用される特別なプレースホルダーです。これは、Unix/Linuxの.desktopファイル仕様で定義されているフィールドコードの1つで、ObsidianをWeb Clipperなどの外部ソースから起動するために必須の要素となります。引数のプレースホルダーであり、Web ClipperがブラウザからObsidianを起動する際、Obsidianに「開くべき URI」を引数として渡す役割を果たしています。もし %u が含まれていない場合、Obsidianは起動するかもしれませんが、外部から渡された「次に何をすべきか（どのURIを処理すべきか）」という具体的な指示を受け取ることができません。そのため、Web ClipperがObsidianを起動するだけでなく、その起動後にコンテンツを処理できるようにするためには、Exec 行に %u が含まれていることが不可欠です。
Web Clipperは obsidian:// プロトコルを使ってObsidianを起動しています。このプロトコルURIは、どのvaultを開くか、そしてコンテンツをクリップボードから読み取るように指示する情報を含んでいます。obsidian.desktop ファイルで MimeType=x-scheme-handler/obsidian と設定することで、システムは obsidian:// で始まるリンクを見つけると、その引数（URI全体）を %u の位置に挿入し、Obsidianを起動します。
システムへの反映
obsidian.desktopを保存したら、データベースを更新し、変更をシステムに適用します。
sudo update-desktop-database /usr/share/applications
上を実行して、エラーが出ないことを確認してください。私は、実行後はエラーも含めて、何も表示されませんでした。
システムへ正しく反映されているかの確認
以下のように実行すると、指定したvaultが開き、新規で タイトルが"test_note"でノート内に"test_content"と記載されているノートができていれば問題ありません。
xdg-open "obsidian://new?vault=<your vault name>&name=test_note&content=test_content"
FirefoxへWeb Clipperのインストール
Firefoxブラウザに拡張機能をインストールします。FirefoxでObsidian Web Clipperの拡張機能ページを開きます。「Firefoxへ追加」ボタンをクリックし、インストールを完了させます。
Web Clipperの動作確認
これで全ての連携設定が完了しました。Firefoxで任意のウェブページを開いたあとWeb Clipperアイコンをクリックしてクリップを実行します。Obsidianが起動し、vaultが開かれ、クリップされた記事の内容が新しいノートとして自動で保存されていれば成功です！
まとめ
ObsidianのUbuntuへのインストール方法は、たくさん見つけたのですがそれにならってObsidianをインストールしただけでは、私はWeb Clipperが使えませんでした。Web Clipperが使えない場合の対処方法はweb上を探してもすぐに見つからず、四苦八苦しました。この記事が、同じように困っている方の参考になると嬉しいです。
