Przejdź do głównej zawartości

Instalacja

Aplikacja couchterm na Maca prowadzi przez instalację w kreatorze. Każdy krok pyta, zanim cokolwiek zmieni poza katalogiem aplikacji.

Instalator po kolei:

  1. Sprawdza narzędzia: Node 20 lub nowszy i tmux. Brakujące proponuje doinstalować przez Homebrew.
  2. Instaluje zależności aplikacji.
  3. Tworzy ustawienia. Serwer słucha tylko na tym komputerze (127.0.0.1). Istniejących ustawień nie nadpisuje.
  4. Prosi o hasło, co najmniej 12 znaków. Na dysku zostaje tylko jego skrót.
  5. Dokłada dyktowanie (Whisper, około 1,6 GB) i czytanie na głos. Ten krok możesz pominąć.
  6. Włącza autostart, żeby couchterm działał po restarcie komputera.
  7. Udostępnia couchterm Twoim urządzeniom w Tailscale.
  8. Na końcu uruchamia sprawdzenie.

Po instalacji aplikacja pokazuje listę dodatków z przyciskiem przy każdym brakującym.

Pobrany plik AppImage przy pierwszym uruchomieniu zapisuje aplikację w katalogu domowym i dodaje ją do menu aplikacji. Później uruchamiaj couchterm z tego menu. Starszy plik AppImage nie zastąpi nowszej zainstalowanej wersji: pokaże komunikat i zamknie okno. Jeśli trwa już instalacja, komunikat podaje ścieżkę jej zamka. Zamek starszy niż 30 minut zostaje odzyskany przy kolejnej próbie, także po ponownym uruchomieniu komputera.

Jeśli druga instalacja właśnie trwa, zobaczysz komunikat. Poczekaj na jej zakończenie i spróbuj ponownie.

Instalator można też uruchomić w terminalu:

Okno terminala
scripts/install.sh

Różnice względem Maca:

  • programy instaluje z apt przez sudo. Gdy Node z apt jest za stary, bierze Node 22 z oficjalnego repozytorium NodeSource;
  • dyktowanie liczy się na procesorze. Whisper jest budowany ze źródeł do ~/.local/bin;
  • czytanie na głos działa głosami Piper albo głosem telefonu;
  • autostart to usługa użytkownika systemd (systemctl --user status couchterm). Działa też bez zalogowania, więc nadaje się na serwer w szafie.

Restart usługi zachowuje workspace’y, terminale i pracujących w nich agentów. Ponowne uruchomienie kroku autostart i zatwierdzenie usługi zapisuje jej aktualne ustawienia również w istniejącej instalacji.

Każdy krok uruchomisz osobno, bez przechodzenia całej instalacji:

Okno terminala
scripts/install.sh --step=whisper

Dostępne kroki: core, whisper, piper, hooks, cmux, autostart, tailscale-share, tailscale-public. Kilka naraz rozdzielasz przecinkiem.