# Začíname

## Inštalácia potrebných nástrojov

Pre predvolené nastavenie lokálneho tunela nainštalujte do počítača tieto nástroje:

### Node.js 20+

Stiahnite si z [nodejs.org](https://nodejs.org) alebo použite správcu balíkov.

```bash
# Check if installed
node --version
```

### tmux

Multiplexor terminálu, ktorý zabezpečuje fungovanie relácií Termbridge.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Vytvára zabezpečený tunel k vášmu terminálu (v priamom režime sandboxu nie je potrebný).

```bash
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads
```

[Stiahnuť cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Spustenie Termbridge

```bash
npx termbridge
```

Zobrazí sa výstup podobný tomuto:

```
┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘
```

> **Poznámka**
> `trycloudflare.com` URL je rýchly tunel, ktorý nevyžaduje účet. Ak Termbridge používate často,
> nastavte token pomenovaného tunela Cloudflare, aby ste sa vyhli limitom požiadaviek.


## Pripojenie z telefónu

1. Otvorte fotoaparát v telefóne
2. Namierte ho na kód QR
3. Ťuknite na zobrazený odkaz
4. Terminál sa načíta v prehliadači

To je všetko – ste pripojení!

## Čo sa práve stalo?

1. Termbridge spustil lokálny server vo vašom počítači
2. Vytvoril reláciu tmux pre váš terminál
3. Cloudflare vytvoril zabezpečený tunel (`trycloudflare.com` URL)
4. Kód QR obsahuje jednorazový token na zabezpečený prístup. Funguje len raz a jeho platnosť vyprší 90 sekúnd po spustení, preto ho naskenujte čo najskôr; ak jeho platnosť vypršala, reštartujte Termbridge a vytvorte nový
5. Po naskenovaní ste získali súbor cookie relácie a pripojili sa

## Vyskúšajte si to

Po pripojení vyskúšajte niekoľko príkazov:

```bash
# See system info
htop

# Check a git repo
cd ~/your-project && git status

# Run any CLI tool
```

Terminál podporuje plnofarebné zobrazenie, TUI aj všetky klávesy, ktoré by ste očakávali.

## Nechajte ho bežať

Aby pripojenie fungovalo, Termbridge musí zostať spustený. Keď skončíte:

- Stlačte `Ctrl+C` v termináli, v ktorom beží Termbridge
- Tunel sa zatvorí a spojenie sa ukončí
- Relácia tmux zostane aktívna (pokiaľ ste nepoužili `--kill-on-exit`)

## Správanie pri prvej relácii

- Termbridge vytvorí reláciu tmux (predvolený názov sa odvodí od portu)
- Automaticky sa načíta prvý terminál v zozname
- Pri spustení môžete vytvoriť viacero relácií nastavením `TERMBRIDGE_SESSIONS=2`

## Použitie existujúcej relácie tmux

Ak zadáte `--session <name>` a táto relácia už existuje, Termbridge sa k nej pripojí namiesto vytvorenia novej. To sa hodí na sledovanie dlho bežiacich procesov, ktoré ste už spustili.

## Ďalšie kroky

### [Ovládanie v mobile](https://termbridge.inline0.dev/sk/docs/usage/mobile-controls)

Tipy na používanie Termbridge v telefónoch a tabletoch

### [Viacero terminálov](https://termbridge.inline0.dev/sk/docs/usage/multiple-terminals)

Spúšťajte viacero relácií a prepínajte medzi nimi

### [Ukážka vývojového servera](https://termbridge.inline0.dev/sk/docs/usage/dev-server-preview)

Zobrazte si ukážku aplikácie Vite vedľa terminálu

### [CLI Referencia](https://termbridge.inline0.dev/sk/docs/cli)

Pozrite si všetky dostupné príznaky a možnosti