Szybki start

1. Instalacja

brew install --cask bettercmdtab

brew install --cask bettercmdtab@beta

BetterCmdTab działa na pasku menu — nie ma ikony w Docku ani głównego okna. Po uruchomieniu znajdź jego ikonę na pasku menu.

2. Przyznanie uprawnienia Dostępność

To uprawnienie jest obowiązkowe. BetterCmdTab potrzebuje Dostępności, aby zainstalować globalne przechwytywanie zdarzeń ⌘Tab i odczytywać listy okien.

1. Otwórz Ustawienia systemowe → Prywatność i ochrona → Dostępność.
2. Włącz BetterCmdTab.

Karty przeglądarki wymagają drugiego uprawnienia

Dostępność wystarcza do wszystkiego poza kartami przeglądarki. Pobieranie listy kart z Safari, Chrome, Arc, Brave, Edge i podobnych aplikacji korzysta z Apple Events, które macOS kontroluje osobno w sekcji Prywatność i ochrona → Automatyzacja.

Otwórz Ustawienia → Prywatność → Uprawnienia → Dostęp do kart przeglądarki i naciśnij Sprawdź dostęp…, pozostawiając otwarte okno ustawień — macOS wyświetla prośbę o zgodę tylko wtedy, gdy okno jest aktywne, i pyta raz dla każdej przeglądarki. Jeśli pominiesz ten krok, \ w wierszu przeglądarki, expandBrowserTabsAsWindows oraz searchExpandsBrowserTabs będą po cichu zwracać puste wyniki.

Karty natywne (Finder, Terminal, TextEdit) korzystają z Dostępności i nie wymagają niczego więcej.

3. Przełączanie

Poniższe czynności działają, gdy przełącznik jest otwarty. Wszystkie można przypisać osobno dla każdego profilu w Ustawienia → Profile; ustawienia domyślne to:

⌘ jest przytrzymywany przez cały czas, gdy panel jest widoczny, więc liczy się tylko zarejestrowany klawisz — modyfikator jest w panelu ignorowany. Wyczyszczenie pola wyłącza dany klawisz.

↓ przechodzi do okien aplikacji tylko tam, gdzie w innym przypadku nie wykonywałby użytecznej czynności — w układzie siatki i podglądu okien, gdy panel ma jeden wiersz. W układzie listy i wielowierszowej siatce ↓ nadal przesuwa zaznaczenie. Funkcja wymaga też włączenia windowDrillEnabled, jednego wiersza na aplikację (applicationsOnly) oraz aplikacji z co najmniej dwoma oknami.

Szybkie naciśnięcie przełącza natychmiast, bez wyświetlania czegokolwiek. Panel pojawia się dopiero po przytrzymaniu skrótu przez czas określony w revealDelayMs (domyślnie 100 ms) — zwiększ tę wartość, jeśli panel miga podczas szybkiego przełączania.

Znaczenie ikon

Mały symbol na końcu wiersza listy (lub pod kafelkiem siatki) informuje o stanie pozycji:

Cztery symbole stanu okna (ukryta, zminimalizowane, brak okna, pełny ekran) można wyłączyć w Wygląd → Etykiety → Pokazuj ikony stanu (showWindowStatusIcons). Wskaźniki dźwięku, uruchomienia i przywrócenia są zawsze widoczne.

Aplikacje bez otwartego okna nie mają historii użycia okna, więc przy obu porządkach według użycia (sortOrder mru i mruWindows) gromadzą się na końcu listy. Ukryte aplikacje zachowują się tak samo, gdy włączone jest sinkHiddenApps. Ustaw sortOrder na alphabetical, aby uporządkować wszystkie pozycje alfabetycznie, albo przypnij wybrane aplikacje na górze w sekcji Aplikacje.

4. Dostosowanie

Otwórz Ustawienia z ikony na pasku menu. Dostępne panele to Ogólne, Profile, Skróty, Przełącznik, Sterowanie, Karty, Aplikacje, Wygląd, Prywatność i Informacje.

Trzy zmiany, które warto wprowadzić od razu:

• Układ — Wygląd → Układ. Wypróbuj Podglądy okien, jeśli pracujesz z wieloma oknami tej samej aplikacji.
• Pokaż okna z — Przełącznik → Zawartość. Przy wielu monitorach opcja Widoczne biurka pokazuje to, co faktycznie znajduje się na ekranie, i ukrywa okna pozostawione na biurkach w tle.
• Pozostaw otwarte — Sterowanie → Klawiatura. Panel pozostaje widoczny po puszczeniu ⌘, dzięki czemu możesz spokojnie przeglądać pozycje i zatwierdzić wybór klawiszem Return.

5. Opcjonalnie: przenieś ustawienia do pliku

Jeśli przechowujesz pliki konfiguracyjne w repozytorium albo chcesz porównywać i wersjonować swoją konfigurację, włącz plik konfiguracyjny:

Ustawienia → Ogólne → Kopia zapasowa → Plik konfiguracyjny → Utwórz…

Spowoduje to zapisanie bieżących ustawień w ~/.config/bettercmdtab/config.json i uruchomienie dwukierunkowej synchronizacji na żywo — zmiany w pliku są stosowane natychmiast, a zmiany w oknie ustawień zapisywane z powrotem.

{
  "$schema": "schema.json",
  "layoutMode": "windowPreview",
  "spaceScope": "visibleSpaces",
  "stayOpenOnRelease": true,
  "revealDelayMs": 150
}

Zobacz Plik konfiguracyjny, aby poznać działanie synchronizacji, oraz dokumentację konfiguracji, aby przejrzeć wszystkie klucze.

Następne kroki