Wszystko o Speakeys

#Szybki start

1. Pobierz i zainstaluj Speakeys — zobacz Instalacja.
2. Załóż klucz API Groq (za darmo) — zobacz Konto Groq i klucz API.
3. Wklej klucz, gdy Speakeys poprosi o niego przy pierwszym uruchomieniu.
4. Zezwól na dostęp do mikrofonu i Dostępności — zobacz Uprawnienia.
5. Ustaw kursor w dowolnym polu tekstowym, przytrzymaj prawy ⌘, mów i puść.

Okres próbny (7 dni) zaczyna się przy pierwszym uruchomieniu. W tym czasie dostępne są wszystkie funkcje.

#Wymagania

• macOS 14 Sonoma lub nowszy, na procesorze Apple Silicon (M1 i nowsze) lub Intel.
• Połączenie z internetem — rozpoznawanie mowy i edycja z AI działają w Groq.
• Klucz API Groq. Groq ma darmowy plan, który wystarczy na start.

#Instalacja

1. Pobierz Speakeys.dmg i otwórz plik.
2. Przeciągnij Speakeys do folderu Aplikacje.
3. Uruchom Speakeys z folderu Aplikacje. W pasku menu na górze ekranu pojawi się ikona fali dźwiękowej — to Speakeys. Aplikacja nie ma okna ani ikony w Docku.

#Uprawnienia

Speakeys potrzebuje dwóch uprawnień. O oba prosi przy pierwszym uruchomieniu.

• Mikrofon — żeby Cię słyszeć. Kliknij Pozwól, gdy macOS zapyta.
• Dostępność — żeby zauważyć przytrzymanie prawego ⌘ lub lewego ⌥ i wkleić tekst do aplikacji, w której pracujesz. Wybierz Nadaj uprawnienia… w menu Speakeys; otworzy się Ustawienia systemowe → Prywatność i ochrona → Dostępność, gdzie włączasz Speakeys.

Speakeys nigdy nie czyta tego, co piszesz. Odczytuje tylko zaznaczony tekst w chwili, gdy przytrzymujesz lewy ⌥.

#Konto Groq i klucz API

Speakeys wysyła dźwięk do Groq, który bardzo szybko uruchamia model rozpoznawania mowy (Whisper) i model AI. Korzystasz z własnego klucza Groq, więc rozliczasz się bezpośrednio z Groq, a my nie widzimy Twojego użycia.

1. Wejdź na console.groq.com i załóż konto (Google, GitHub lub e-mail).
2. Otwórz API Keys i kliknij Create API Key. Nadaj mu nazwę, np. „Speakeys”.
3. Skopiuj klucz — zaczyna się od gsk_. Groq pokazuje go tylko raz.
4. W Speakeys wklej go w okno, które pojawia się przy pierwszym uruchomieniu, albo później przez Klucz API Groq… w menu.

Klucz jest zapisywany w pęku kluczy macOS (Keychain). Żeby go zmienić, wybierz ponownie Klucz API Groq….

Zalecane: w konsoli Groq otwórz Settings → Data Controls i włącz Zero Data Retention, żeby Groq nie przechowywał logów Twoich zapytań. Zobacz Prywatność i UE.

#Dyktowanie

1. Kliknij w dowolne pole tekstowe — e-mail, czat, dokument, edytor kodu.
2. Przytrzymaj prawy ⌘. Na dole ekranu pojawi się mały panel „Dyktuję”.
3. Mów, potem puść klawisz. Tekst zostanie wklejony w miejscu kursora.

• Anulowanie: naciśnij Esc — albo dowolny inny klawisz — w trakcie trzymania. Zwykłe skróty, np. ⌘ C, działają bez zmian.
• Tapnięcia krótsze niż 0,3 s są ignorowane. Ciche nagrania nigdy nie są wklejane.
• Zawartość schowka wraca na miejsce zaraz po wklejeniu.
• Speakeys dodaje spację po dyktowanym tekście, więc możesz mówić fragmentami. Jak to wyłączyć — zobacz Ustawienia zaawansowane.

#Edycja z AI

1. Zaznacz tekst w dowolnej aplikacji.
2. Przytrzymaj lewy ⌥ i powiedz, co z nim zrobić.
3. Puść klawisz. Zaznaczenie zostanie zastąpione wynikiem.

Bez zaznaczenia Speakeys napisze nowy tekst na podstawie polecenia i wstawi go w miejscu kursora. Wynik zostaje w języku tekstu, chyba że poprosisz o inny.

Polecenia, które dobrze działają:

• „Zrób to krócej i bardziej oficjalnie.”
• „Popraw gramatykę i interpunkcję, nie zmieniaj słów.”
• „Przetłumacz na niemiecki.”
• „Zrób z tego trzy punkty.”
• „Napisz uprzejmą odpowiedź, że nie mogę przyjść na spotkanie.”

Prawy ⌥ pozostaje wolny, więc polskie znaki (ą, ę, ś…) działają jak zawsze.

#Język

Wybierz Język w menu: Polski, English lub Automatycznie. Stały język daje najdokładniejsze wyniki; Automatycznie rozpoznaje język każdego nagrania i obsługuje też inne języki dostępne w Whisperze.

#Mikrofon

Domyślnie Speakeys nagrywa z wbudowanego mikrofonu Maca, nawet gdy podłączone są słuchawki. Słuchawki Bluetooth (także AirPods) po rozpoczęciu nagrania przełączają się w tryb rozmowy o niskiej jakości, co ucina pierwsze słowa i pogarsza rozpoznawanie.

Żeby to zmienić, otwórz Mikrofon w menu i wybierz Wbudowany (zalecany), Domyślny systemowy albo dowolne podłączone urządzenie. Gdy wybrane urządzenie zostanie odłączone, Speakeys wróci do wbudowanego mikrofonu.

#Historia

Historia w menu pokazuje ostatnie wyniki. Kliknij wpis, żeby skopiować go ponownie do schowka. Historia jest przechowywana tylko na Twoim Macu.

#Własny słownik

Naucz Speakeys nazwisk, marek i żargonu, które ma zapisywać poprawnie. Wybierz Edytuj słownik… w menu — otworzy się zwykły plik tekstowy:

~/Library/Application Support/Speakeys/dictionary.txt

Jedna pozycja na linię. Linie zaczynające się od # to komentarze.

# Hasła — nazwy, produkty, żargon
Kubernetes
Finarena
PostgreSQL

# Reguły poprawek — źle => dobrze
Tankowicz => Tonkowicz
Fin Arena => Finarena

Hasła

Hasła trafiają do modelu mowy jako podpowiedzi, więc rozpoznaje je pewniej. Podpowiedzi mają łącznie maksymalnie 800 znaków — najważniejsze hasła wpisz na początku.

Reguły poprawek

Reguła źle => dobrze poprawia słowo, które model ciągle zapisuje błędnie. Reguły:

• ignorują wielkość liter w rozpoznanym tekście i wstawiają prawą stronę dokładnie tak, jak ją zapisano;
• działają od początku słowa i poprawiają też odmiany (Tankowicz => Tonkowicz zamieni „Tankowicza” na „Tonkowicza”, a „Tankowiczowi” na „Tonkowiczowi”);
• nigdy nie zmieniają środka słowa;
• działają przy dyktowaniu i w wynikach AI; prawa strona trafia też do podpowiedzi.

Speakeys czyta plik przy każdym nagraniu, więc zmiany działają od razu — bez restartu.

#Modele mowy i AI

Speakeys korzysta z dwóch modeli Groq:

Możesz przełączyć się na dowolny zgodny model dostępny na Twoim koncie Groq. Otwórz Terminal i wpisz na przykład:

# szybsze, nieco mniej dokładne rozpoznawanie mowy
defaults write app.speakeys.mac sttModel whisper-large-v3-turbo

# mniejszy, szybszy model AI
defaults write app.speakeys.mac llmModel openai/gpt-oss-20b

Zmiana działa od następnego nagrania. Powrót do ustawień domyślnych:

defaults delete app.speakeys.mac sttModel
defaults delete app.speakeys.mac llmModel

Nazwy modeli zmieniają się z czasem — aktualną listę znajdziesz na console.groq.com/docs/models. Model mowy musi obsługiwać transkrypcję audio, a model AI — chat completions.

#Ustawienia zaawansowane

Uruchamianie przy logowaniu: wybierz Uruchamiaj przy logowaniu w menu.

Bez spacji po dyktowanym tekście:

defaults write app.speakeys.mac trailingSpace -bool false

Klucz Groq ze zmiennej środowiskowej zamiast z pęku kluczy (np. przy zarządzanych instalacjach): ustaw GROQ_API_KEY. Klucz zapisany w pęku kluczy ma pierwszeństwo.

#Okres próbny i licencja

Speakeys jest darmowe przez 7 dni od pierwszego uruchomienia, ze wszystkimi funkcjami. Menu pokazuje, ile dni zostało.

Po okresie próbnym przytrzymanie klawiszy pokazuje komunikat „Okres próbny zakończony — wpisz klucz licencyjny”. Ustawienia, słownik i historia zostają zachowane.

1. Wybierz plan w cenniku. Klucz licencyjny dostaniesz e-mailem.
2. W Speakeys wybierz Wpisz klucz licencyjny…, wklej klucz i potwierdź.

• Jeden klucz działa na maksymalnie 3 Macach. Żeby przenieść go na inny komputer, najpierw wybierz Licencja… → Dezaktywuj na tym Macu.
• Speakeys sprawdza licencję mniej więcej raz w tygodniu i działa bez internetu do dwóch tygodni.
• Klucz z planu miesięcznego przestaje działać po zakończeniu subskrypcji. Licencja dożywotnia nie wygasa.

#Prywatność i UE

Dźwięk i tekst nigdy nie trafiają na nasze serwery: wysyłane są z Twojego Maca bezpośrednio do Groq, z użyciem Twojego klucza API; nigdy ich nie otrzymujemy ani nie przechowujemy. Ustawienia, słownik i historia zostają na Twoim Macu. Przy sprawdzaniu licencji na nasz serwer licencji w UE trafia tylko klucz licencyjny, identyfikator aktywacji i nazwa Twojego Maca.

Speakeys tworzy Finarena Sp. z o.o. (Polska, UE). Korzystanie z Groq regulują warunki Groq:

• Groq oferuje umowę powierzenia przetwarzania danych (DPA) ze standardowymi klauzulami umownymi UE. Klienci z EOG zawierają umowę z Groq UK Limited.
• Groq nie może używać danych z API do trenowania modeli (Services Agreement).
• Domyślnie Groq nie przechowuje danych zapytań, ale może trzymać logi do 30 dni w celu wykrywania nadużyć. Włącz Zero Data Retention w Settings → Data Controls, żeby to wyłączyć (szczegóły).
• Groq ma centra danych w Europie, m.in. w Helsinkach (Finlandia). Dla standardowych kont API Groq nie gwarantuje przetwarzania wyłącznie w UE, a dane, które przechowuje, trzyma w USA. Jeśli potrzebujesz takiej gwarancji, zapytaj Groq o umowę enterprise.

#Rozwiązywanie problemów

Nic się nie dzieje, gdy przytrzymuję prawy ⌘.

Speakeys nie ma uprawnienia Dostępności. Wybierz Nadaj uprawnienia… i włącz Speakeys. Jeśli jest już włączone, usuń Speakeys z listy przyciskiem „–”, dodaj ponownie przez „+” i uruchom Speakeys jeszcze raz.

Speakeys pisze, że tekst jest w schowku.

Speakeys nie mógł wkleić tekstu do bieżącej aplikacji — zwykle to ten sam problem z Dostępnością. Wklej ręcznie przez ⌘ V i sprawdź uprawnienie.

„Groq HTTP 401”.

Klucz API jest błędny albo został unieważniony. Utwórz nowy i wklej go przez Klucz API Groq….

„Groq HTTP 429”.

Przekroczono limit zapytań Groq. Odczekaj chwilę albo zwiększ limity, dodając płatności w konsoli Groq.

Brakuje początku zdania.

Prawdopodobnie nagrywasz przez słuchawki Bluetooth. Przełącz Mikrofon na Wbudowany (zalecany).

Jakieś nazwisko ciągle jest źle zapisywane.

Dodaj je do słownika albo dopisz regułę poprawki.

#Aktualizacja z MOVA

Speakeys wcześniej nazywało się MOVA. Przy pierwszym uruchomieniu Speakeys automatycznie przenosi klucz Groq, ustawienia, słownik i historię z MOVA. macOS może raz zapytać, czy Speakeys może użyć klucza zapisanego przez MOVA — kliknij Zawsze pozwalaj.

Aplikacja ma nową nazwę, więc nadaj ponownie uprawnienie Dostępności, a potem usuń starą aplikację MOVA.

#Odinstalowanie

1. Wybierz Zakończ Speakeys w menu. Jeśli chcesz użyć licencji na innym Macu, najpierw ją dezaktywuj (Licencja…).
2. Przenieś Speakeys z folderu Aplikacje do Kosza.
3. Opcjonalnie usuń swoje dane:

   rm -r ~/Library/Application\ Support/Speakeys
   defaults delete app.speakeys.mac

   i usuń zapisany klucz Groq w aplikacji Dostęp do pęku kluczy (wyszukaj app.speakeys.mac).