PluelyPluelyドキュメント

はじめに

Pluely の Linux アクセス権：マイクと画面キャプチャの設定

Linux には macOS や Windows のような統一されたアクセス権の仕組みがありません。確認すべき点は、オーディオサーバー（PipeWire または PulseAudio）とディスプレイサーバー（X11 または Wayland）によって変わり、それらはディストリビューションやデスクトップ環境によって決まります。このページでは、Pluely v1 に必要な 2 つのもの（マイク入力と画面キャプチャ）と、一般的な最近の Linux 環境でそれぞれを確認する方法を説明します。

Pluely 内では、ダッシュボード → アクセス権とオーディオにこれらが OS が管理と表示され、Linux の設定を開くボタンがあり、システムオーディオはその場で確認されます。

PipeWire または PulseAudio 経由のマイク

最近の Linux ディストリビューションの多くは、PipeWire（多くは PulseAudio 互換レイヤー付き）か、従来の PulseAudio 単体でオーディオを扱います。Pluely v1 が聞き取りモードや「押して話す」であなたの声を聞くには、このレイヤーで正常に動作する入力デバイスが選択されている必要があります。

入力デバイスがあり、選択されているか確認します。

  • デスクトップのサウンド設定を開き（場所は環境によって異なります。たとえば GNOME なら 設定 → サウンド、KDE なら システム設定 → オーディオ）、正しいマイクが入力デバイスとして選ばれていて、話すと入力レベルが動くことを確認します。

  • ターミナルからオーディオソースを直接一覧表示することもできます。PipeWire または PulseAudio のシステムでは、次を実行します。

    pactl list short sources

    一覧に自分のマイクがあり、ミュートされていないことを確認してください。

アクセス権の仕組みはディストリビューションやデスクトップによって異なります。一部のディストリビューションでは、PipeWire のセッションやポータルのアクセス権によってアプリごとにマイクへのアクセスが制限され（考え方は macOS に近いものです）、アプリが初めてオーディオを要求したときに確認が表示されます。一方、ALSA や PulseAudio のデバイスのアクセス権だけに頼り、アプリごとの確認がまったくないディストリビューションもあります。その場合、デバイスがミュートされておらず選択されていれば、Pluely を含むどのアプリでも使えます。自分のシステムがどちらの仕組みかわからない場合も、まずは上記のサウンド設定パネルを確認するのが確実です。

オフまたは設定に問題があるときの症状：聞き取りモードで自分の声の波形が動かず、会話のうち自分の発言がまったく文字起こしされません。「押して話す」もキーを押しても何も起きません。

画面キャプチャとポータルのアクセス権（特に Wayland）

質問モードのスクリーンショットは、ディスプレイサーバーによって動作が変わります。

  • X11 のセッションでは、Pluely が画面を直接読み取れます。範囲選択では、すべてのモニタに Pluely 独自の選択オーバーレイが表示されます。
  • Wayland のセッションでは、アプリが画面を読み取ることは一切できないため、Pluely は xdg-desktop-portal（GNOME や KDE のポータルなど、デスクトップのバックエンドと組み合わせて）に要求します。画面全体のスクリーンショットでは初回にアクセス許可のダイアログが表示され、デスクトップがその回答を記憶します。範囲選択では、Pluely のオーバーレイの代わりにデスクトップ独自のスクリーンショットの選択画面（範囲、ウィンドウ、画面）が開き、結果は同じようにチャットに入ります。選択画面を閉じれば、単にキャンセルされます。

通話相手のシステムオーディオはポータルを経由しません。Pluely は PulseAudio または PipeWire を通じて出力デバイスのモニターソースを録音し、マイクも同じサウンドサーバーを通じて録音します。そのため、会議アプリとデバイスを奪い合うことなく、マイクを共有して使います。

Linux では、画面共有から Pluely を隠すことはできません。X11 も Wayland も、ウィンドウが自分自身をキャプチャから除外する方法を用意していないため、Linux ではオーバーレイが共有画面や録画に映ります。オーバーレイを共有する画面の外に移動するか、画面全体ではなく 1 つのウィンドウだけを共有してください。

ポータルのアクセス権の確認とリセットの方法：詳細はデスクトップ環境によって異なりますが、おおまかな手順は次のとおりです。

  1. xdg-desktop-portal（と、xdg-desktop-portal-gnome や xdg-desktop-portal-kde などのデスクトップ固有のバックエンド）がインストールされているか確認します。最近のディストリビューションの多くには標準で含まれていますが、最小構成のインストールでは入っていないことがあります。
  2. デスクトップのプライバシー設定で、画面共有やリモートデスクトップのアクセス権の設定を探します。以前にアプリに対して拒否したアクセス権を、そこでリセットできることがあります。
  3. ポータルの確認に答えずに閉じてしまった場合は、Pluely でもう一度キャプチャを試して、確認を再表示させます。

オフのときの症状：スクリーンショットのキャプチャが失敗する、空白の画像になる、または画面のキャプチャを添付しようとしても何も起きません。聞き取りモードでは自分のマイクの音声だけが文字起こしされ、通話相手の発言は表示されません。

Wayland でのキーボードショートカット

Wayland でのグローバルショートカットは、デスクトップの GlobalShortcuts portal を経由します。これには KDE Plasma 5.27 以降、GNOME 48 以降、またはポータルがインストールされた wlroots 系のデスクトップ（Hyprland、Sway）が必要です。デスクトップから Pluely のショートカットの確認を一度求められることがあり、キーの変更もそこでできます。割り当てがうまくいったかどうかは、ダッシュボードのカーソルとショートカットページで確認できます。X11 のセッションでは、ポータルなしでショートカットが動作します。

Pluely ではなくコンポジタによる Wayland の制限がほかに 2 つあります。Wayland のアプリは自分のウィンドウの位置を決められないため、オーバーレイを移動するショートカットと保存されたオーバーレイの位置は機能しません。また、GNOME は「常に手前に表示」を無視します。代わりに、オーバーレイを好きな位置にドラッグしてください。

迷ったら、まず入力デバイスを確認する

Linux の構成は千差万別なので、最も手早い診断方法は、ほぼ必ず、オーディオサーバーのレベルでマイクが選択され、ミュートされておらず、入力があることを確かめることです。そうすれば、問題がオーディオの設定によるものか、画面キャプチャやポータルのアクセス権によるものかを切り分けられます。この 2 つは対処法が異なります。

関連情報

最終更新：2026年7月10日 · pluely.com