Dokumentacja

Wszystko, co musisz wiedzieć o instalacji, konfiguracji i personalizacji uBar.

Uprawnienia

W ostatnich wersjach macOS Apple zwiększa przejrzystość zabezpieczeń, wymagając zgody użytkownika na wiele interfejsów API, które wcześniej były dostępne dla wszystkich aplikacji. W związku z tym uBar wymaga teraz włączenia kilku z nich do działania, a pozostałe pozostają opcjonalne.

Dostępność

Interfejs API Dostępności służy do sterowania oknami i aplikacjami:

  • Kończenie aplikacji
  • Zamykanie okien
  • Maksymalizowanie okien
  • Minimalizowanie okien

Nagrywanie ekranu

Od macOS 10.15 Catalina różne interfejsy API wymagają uprawnienia do nagrywania ekranu. Te interfejsy API służą do:

  • Odczytywania tytułów okien
  • Wykrywania nowo otwieranych okien
  • Przechwytywania zawartości okien na potrzeby podglądów

Pamiętaj, że ekran w żadnym momencie nie jest faktycznie nagrywany.

Pełny dostęp do dysku

Od macOS 10.14 Mojave różne interfejsy API związane z Koszem wymagają uprawnienia pełnego dostępu do dysku. Te interfejsy API służą do:

  • Otwierania Kosza
  • Opróżniania Kosza

Choć zalecane, to uprawnienie jest opcjonalne, ponieważ dotyczy wyłącznie funkcji związanych z Koszem.

Różne

Stany aplikacji

Następujące stany aplikacji są oznaczane kolorowymi wzorami ukośnych linii:

  • Uruchamianie (biały): Aplikacja jest właśnie uruchamiana przez system.
  • Możliwa do przywrócenia (niebieski): Aplikacja mogła wcześniej ulec awarii i może zostać przywrócona przez system.
  • Nie odpowiada (czerwony): Aplikacja obecnie nie odpowiada.

Rzędy

Aby zwiększyć lub zmniejszyć liczbę rzędów, przeciągnij samą krawędź uBar w górę lub w dół. Maksymalna liczba rzędów to pięć.

Ulubione

Aby dodać otwartą aplikację do obszaru Ulubionych, kliknij ją z klawiszem Control lub prawym przyciskiem myszy i wybierz „Dodaj do Ulubionych”. Aby dodać dowolny plik, katalog lub aplikację, kliknij je w Finderze z klawiszem Control lub prawym przyciskiem i wybierz „Usługi”, a następnie „Dodaj do Ulubionych uBar”. Aby włączyć tę usługę, zaznacz ją w Preferencjach systemowych > Klawiatura > Skróty > Usługi.

Tryb aktywności

Przytrzymaj konfigurowalny klawisz modyfikujący (domyślnie prawy Control), aby włączyć tryb aktywności. Aplikacje pokażą wtedy wykorzystanie procesora w % oraz zużycie pamięci.

Skróty specjalne

Oprócz skrótów dostępnych w panelu Skróty w Preferencjach dostępne są następujące skróty:

SkrótOpis
Control-Option-1, 2, 3 … 0Pokaż/ukryj aplikację lub okno na wskazanej pozycji.
Command-kliknięcie aplikacji lub oknaPokaż aplikację w Finderze.
Option-kliknięcie aplikacji lub oknaPokaż lub ukryj aplikację albo okno.
Option-Command-kliknięcie aplikacji lub oknaPokaż tylko tę aplikację. Wszystkie pozostałe aplikacje zostają ukryte.
Shift-kliknięcie aplikacji lub oknaZakończ aplikację.
Shift-Command-kliknięcie aplikacji lub oknaWymuś ponowne uruchomienie aplikacji.
Kliknięcie środkowym przyciskiem aplikacji lub oknaZakończ aplikację lub zamknij okno.
Kliknięcie środkowym przyciskiem paskaWłącz/wyłącz automatyczne ukrywanie.
Shift-kliknięcie podglądu oknaZamknij okno.

Zachowanie kafelków

Po kliknięciu kafelka w uBar zachowanie zależy od liczby okien powiązanych z kafelkiem:

  • 0 okien: To kafelek aplikacji. Kliknięcie pokazuje lub ukrywa aplikację.
  • 1+ okien: To kafelek stosu okien. Kliknięcie wyświetla menu z listą okien i aplikacją.

Ręczne porządkowanie aplikacji

Aby ręcznie uporządkować aplikacje, ustaw kolejność aplikacji na Ręczną w oknie Preferencji, w sekcji Ogólne. Następnie przejdź do panelu Aplikacje w oknie Preferencji, gdzie możesz zmienić kolejność listy uwzględnionych aplikacji.

Domyślny kalendarz

Po kliknięciu obszaru zegara uruchomi się Twoja domyślna aplikacja Kalendarz. Można ją ustawić w Kalendarz > Preferencje > Ogólne > Domyślna aplikacja kalendarza.

Format zegara

Format obszaru zegara zależy od ustawień formatu w Preferencjach systemowych > Język i region. Pamiętaj, że ustawienia w Data i czas > Zegar dotyczą tylko paska menu macOS, a nie uBar.

Preferencje

Wielkość

Ustawienie wielkości w oknie Preferencji oferuje pięć opcji: Automatyczna, Mała, Średnia, Duża i Ogromna. Zaletą opcji Automatyczna jest to, że uBar automatycznie dostosowuje się do wielkości ekranu. Główny ekran o szerokości 1600 pikseli lub większej da duży uBar, a mniejszy — mały uBar. Jest to szczególnie przydatne na laptopach.

Ekran

Ustawienie ekranu w oknie Preferencji pozwala wyświetlać uBar na ekranie aktywnym (tym z aktywnym paskiem menu), na ekranie głównym lub na ekranie dodatkowym.

Grupowanie okien

Funkcja grupowania okien w oknie Preferencji określa, czy uBar grupuje okna należące do tej samej aplikacji. Dostępne są trzy ustawienia: Zawsze, Nigdy i Automatycznie. Automatycznie oznacza, że okna pozostają niepogrupowane, chyba że zabraknie miejsca — wtedy okna grupują się automatycznie.

Miganie aplikacji

Opcja „Migaj aplikacjami, które chcą zwrócić uwagę” pozwala określić, czy aplikacje domagające się uwagi użytkownika mają migać w uBar. To odpowiednik podskakiwania ikon w Docku. Istnieją dwa rodzaje próśb o uwagę — informacyjne i krytyczne. Przy prośbie informacyjnej aplikacja miga przez sekundę. Przy prośbie krytycznej aplikacja miga, dopóki nie przełączysz się na nią i nie uczynisz jej aktywną. W Docku odpowiednikiem jest pojedynczy podskok wobec wielokrotnych podskoków. Pamiętaj, że Skype to popularna aplikacja, która domyślnie bardzo często korzysta z próśb o uwagę. Jeśli Skype ciągle miga, wyłącz opcję podskakiwania w Docku dla wielu zdarzeń w Preferencjach Skype > Powiadomienia > Szczegóły.

Ustawienia domyślne docka

Zostaną zastosowane następujące ustawienia:

  • Rzędy: 1
  • Przypinanie: brak
  • Pokazuj tytuły aplikacji: nie
  • Grupowanie okien: zawsze
  • Kliknięcie lewym przyciskiem pokazuje listę zgrupowanych okien: nie
  • Ulubione — Pokazuj separatory: tak
  • Zegar — Pokazuj zegar: nie
  • Kliknięcie aktywnej aplikacji ukrywa ją: nie

Ustawienia domyślne paska zadań

Zostaną zastosowane następujące ustawienia:

  • Przypinanie: lewo i prawo
  • Pokazuj tytuły aplikacji: tak
  • Grupowanie okien: automatyczne
  • Kliknięcie lewym przyciskiem pokazuje listę zgrupowanych okien: tak
  • Ulubione — Pokazuj separatory: nie
  • Zegar — Pokazuj zegar: tak
  • Kliknięcie aktywnej aplikacji ukrywa ją: tak

Motyw

  • Systemowy: W OS X 10.10 Yosemite i nowszych uBar używa trybu jasnego lub ciemnego w zależności od tego, czy tryb ciemny jest włączony w Preferencjach systemowych w sekcji Ogólne. W OS X 10.9 Mavericks uBar używa trybu jasnego, gdy wygląd jest ustawiony na Aqua, a ciemnego przy ustawieniu Grafit (Preferencje systemowe > Ogólne).
  • Jasny: uBar przypomina domyślny styl paska menu.
  • Ciemny: uBar przypomina ciemny styl paska menu wprowadzony w OS X 10.10 Yosemite.
  • Platinum Neue: uBar przypomina „ujednolicony” styl okien OS X.
  • Teraz odtwarzane: uBar przyjmuje styl oparty na okładce albumu aktualnie odtwarzanego dźwięku lub wideo w iTunes. Jeśli okładka nie jest dostępna, to ustawienie działa tak samo jak „Systemowy”.
  • Własny: uBar przyjmuje styl oparty na wybranym przez Ciebie kolorze tła, kolorze pierwszego planu, kolorze wyróżnienia i kryciu.

Zmiana nazw aplikacji

Aby edytować wyświetlaną nazwę aplikacji, kliknij dwukrotnie jej pozycję na listach w Preferencjach > Aplikacje, zmień nazwę i naciśnij Return. Aby przywrócić nazwę domyślną, powtórz proces, usuwając całą nazwę.

Tryb dewelopera

Tryb dewelopera można włączyć w oknie Preferencji. Tryb dewelopera pokazuje identyfikator procesu (PID) aplikacji oraz identyfikator okna (WID) okien.

Personalizacja przez Application Support

Zastępowanie ikon

Ikony w uBar można zastąpić plikami PNG w katalogu ~/Library/Application Support/uBar/Icons.

Aby zastąpić ikonę aplikacji, nazwa pliku musi być identyfikatorem pakietu (bundle identifier) aplikacji z rozszerzeniem .png. Na przykład: com.apple.AddressBook.png

Dla ikon specjalnych można używać następujących nazw:

  • Katalog: Folder.png
  • Katalog Aplikacje: FolderApplications.png
  • Katalog Biurko: FolderDesktop.png
  • Katalog Dokumenty: FolderDocuments.png
  • Katalog Filmy: FolderMovies.png
  • Katalog Muzyka: FolderMusic.png
  • Katalog Obrazki: FolderPictures.png
  • Katalog Publiczny: FolderPublic.png
  • Kosz pusty: TrashEmpty.png
  • Kosz pełny: TrashFull.png

Własne zegary

Oprócz wbudowanych zegarów do uBar można dodawać własne zegary w ~/Library/Application Support/uBar/Timepieces.

Każdy zegar musi znajdować się we własnym katalogu i zawierać plik Timepiece.plist oraz odpowiednie pliki PNG. Możesz pobrać następujący przykład: Brawer_A300-1.zip.

Terminal

Polecenia Terminala

Poniższe polecenia Terminala pozwalają zmienić pewne zachowania, których nie można ustawić w interfejsie graficznym. Aby zaczęły działać, wymagane jest ponowne uruchomienie uBar.

defaults write ca.brawer.uBar menuAbout -bool NO

Ukrywa uBar w menu uBar. Użyj YES zamiast NO, aby go przywrócić.

defaults write ca.brawer.uBar singleWindowUsesTitle -bool YES

Sprawia, że aplikacje z jednym otwartym oknem używają tytułu tego okna. Użyj NO zamiast YES, aby używać nazwy aplikacji.

defaults write ca.brawer.uBar showWindowCount -bool YES

Pokazuje liczbę okien na zgrupowanych kafelkach aplikacji. Użyj NO zamiast YES, aby ukryć licznik.

defaults write ca.brawer.uBar useAppIconForWindows -bool YES

Używa ikony aplikacji dla okien. Użyj NO zamiast YES, aby w miarę możliwości używać ikony dokumentu.

defaults write com.apple.dock autohide-delay -float 1000 && killall Dock

Praktycznie ukrywa Dock Apple, ustawiając opóźnienie automatycznego ukrywania na 1000 sekund.

defaults delete com.apple.dock autohide-delay && killall Dock

Przywraca domyślne opóźnienie automatycznego ukrywania Docka Apple.