PluelyPluelyDokumentacja

Pierwsze kroki

Uprawnienia Pluely w systemie Linux: mikrofon i przechwytywanie ekranu

Linux nie ma jednego, spójnego systemu uprawnień, jak macOS czy Windows. To, co trzeba sprawdzić, zależy od serwera dźwięku (PipeWire lub PulseAudio) i serwera wyświetlania (X11 lub Wayland), a te z kolei zależą od dystrybucji i środowiska graficznego. Na tej stronie omawiamy dwie rzeczy, których potrzebuje Pluely v1 (wejście mikrofonu i przechwytywanie ekranu), oraz sposób ich sprawdzenia w typowej, nowoczesnej konfiguracji Linuksa.

W Pluely strona Panel → Uprawnienia i audio pokazuje je jako Zarządzane przez system z przyciskiem Otwórz ustawienia Linux i na bieżąco sprawdza dźwięk systemowy.

Mikrofon przez PipeWire lub PulseAudio

Większość obecnych dystrybucji Linuksa przesyła dźwięk przez PipeWire (często z warstwą zgodności z PulseAudio) lub przez samo PulseAudio. Pluely v1 potrzebuje działającego urządzenia wejściowego wybranego w tej warstwie, aby słyszeć Cię w trybie Słuchaj i w funkcji Naciśnij i mów.

Sprawdź, czy urządzenie wejściowe jest dostępne i wybrane:

  • Otwórz ustawienia Dźwięk w swoim środowisku (dokładna ścieżka się różni, na przykład w GNOME Ustawienia → Dźwięk, a w KDE Ustawienia systemowe → Dźwięk) i sprawdź, czy jako urządzenie wejściowe wybrano właściwy mikrofon oraz czy poziom sygnału zmienia się, gdy mówisz.

  • Źródła dźwięku możesz też wyświetlić bezpośrednio w terminalu. W systemie z PipeWire lub PulseAudio:

    pactl list short sources

    Znajdź na liście swój mikrofon i upewnij się, że nie jest wyciszony.

Model uprawnień zależy od dystrybucji i środowiska: niektóre dystrybucje używają uprawnień sesji i portali PipeWire, aby kontrolować dostęp do mikrofonu dla każdej aplikacji osobno (podobnie jak macOS), i pytają o zgodę, gdy aplikacja po raz pierwszy prosi o dźwięk. Inne opierają się wyłącznie na uprawnieniach urządzeń ALSA/PulseAudio, bez żadnych próśb dla poszczególnych aplikacji: jeśli urządzenie nie jest wyciszone i jest wybrane, może z niego korzystać każda aplikacja, w tym Pluely. Jeśli nie wiesz, jakiego modelu używa Twój system, najbezpieczniejszym pierwszym krokiem jest zawsze opisany wyżej panel ustawień dźwięku.

Objaw braku lub błędnej konfiguracji: wykres fali w trybie Słuchaj nie reaguje na Twój głos, a Twoja strona rozmowy nigdy nie jest transkrybowana; przytrzymanie klawisza Naciśnij i mów nic nie daje.

Przechwytywanie ekranu i uprawnienia portali (zwłaszcza w sesjach Wayland)

Zrzuty ekranu w trybie Zapytaj zależą od serwera wyświetlania:

  • Sesje X11 pozwalają Pluely odczytywać ekran bezpośrednio. Zaznaczanie obszaru wyświetla własną nakładkę zaznaczania Pluely na każdym monitorze.
  • Sesje Wayland nigdy nie pozwalają aplikacji odczytywać ekranu, dlatego Pluely prosi o to xdg-desktop-portal (z zapleczem Twojego środowiska, na przykład portalem GNOME lub KDE). Przy pierwszym zrzucie całego ekranu pojawia się okno z prośbą o zgodę, a środowisko zapamiętuje odpowiedź. Zaznaczanie obszaru otwiera własne narzędzie do zrzutów ekranu Twojego środowiska (obszar, okno lub ekran) zamiast nakładki Pluely, a wynik trafia do czatu w ten sam sposób. Zamknięcie tego narzędzia po prostu anuluje przechwytywanie.

Dźwięk systemowy drugiej strony rozmowy nie przechodzi przez portal. Pluely nagrywa źródło monitora urządzenia wyjściowego przez PulseAudio lub PipeWire, a mikrofon przez ten sam serwer dźwięku, więc dzieli mikrofon z aplikacją do spotkań zamiast walczyć z nią o urządzenie.

Ukrycie Pluely podczas udostępniania ekranu nie jest możliwe w systemie Linux. Ani X11, ani Wayland nie pozwalają oknu wykluczyć się z przechwytywania, więc w systemie Linux nakładka jest widoczna na udostępnianych ekranach i nagraniach. Przenieś ją poza udostępniany ekran albo udostępniaj pojedyncze okno zamiast całego ekranu.

Jak sprawdzić lub zresetować uprawnienia portali: szczegóły zależą od środowiska graficznego, ale ogólny sposób wygląda tak:

  1. Sprawdź, czy zainstalowano xdg-desktop-portal (oraz zaplecze dla Twojego środowiska, np. xdg-desktop-portal-gnome lub xdg-desktop-portal-kde). W większości nowoczesnych dystrybucji jest instalowany domyślnie, ale w instalacjach minimalnych może go brakować.
  2. Poszukaj w ustawieniach prywatności swojego środowiska opcji uprawnień do udostępniania ekranu lub pulpitu zdalnego; czasem można tam zresetować uprawnienia, których wcześniej odmówiono aplikacji.
  3. Jeśli okno portalu zostało zamknięte bez odpowiedzi, spróbuj ponownie przechwycić ekran w Pluely, aby wyświetlić je jeszcze raz.

Objaw braku uprawnienia: przechwytywanie ekranu kończy się błędem, zwraca pusty obraz albo nic się nie dzieje przy próbie dołączenia zrzutu ekranu; w trybie Słuchaj transkrybowany jest tylko Twój mikrofon, a druga strona rozmowy nigdy się nie pojawia.

Skróty klawiszowe w sesjach Wayland

Globalne skróty w sesjach Wayland działają przez portal GlobalShortcuts środowiska, który wymaga KDE Plasma 5.27 lub nowszego, GNOME 48 lub nowszego albo środowiska opartego na wlroots (Hyprland, Sway) z zainstalowanym portalem. Środowisko może raz poprosić o potwierdzenie skrótów Pluely i tam też możesz zmienić klawisze. Strona Kursor i skróty w Panelu pokazuje, czy przypisanie się powiodło. W sesjach X11 skróty działają bez żadnego portalu.

Dwa kolejne ograniczenia Wayland wynikają z kompozytora, a nie z Pluely: skróty przesuwania nakładki i zapisana pozycja nakładki nic nie robią, ponieważ aplikacje w sesjach Wayland nie mogą same ustawiać położenia swoich okien, a GNOME ignoruje opcję zawsze na wierzchu. Zamiast tego przeciągnij nakładkę w wybrane miejsce.

W razie wątpliwości najpierw sprawdź urządzenie wejściowe

Konfiguracje Linuksa są bardzo różnorodne, dlatego najszybszą diagnozą jest niemal zawsze sprawdzenie na poziomie serwera dźwięku, czy mikrofon jest wybrany, niewyciszony i odbiera sygnał. Pozwala to ustalić, czy problem dotyczy konfiguracji dźwięku, czy uprawnień do przechwytywania ekranu lub portali, a każdy z nich wymaga innego rozwiązania.

Powiązane

Ostatnia aktualizacja: 10 lipca 2026 · pluely.com