# Začínáme

## Instalace předpokladů

Pro výchozí nastavení místního tunelu nainstalujte do počítače tyto nástroje:

### Node.js 20+

Stáhněte z [nodejs.org](https://nodejs.org) nebo použijte správce balíčků.

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

### tmux

Multiplexor terminálu, který zajišťuje relace Termbridge.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Vytvoří zabezpečený tunel k terminálu (není potřeba pro přímý režim sandboxu).

```bash
# macOS
brew install cloudflared

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

[Stáhnout cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Spuštění Termbridge

```bash
npx termbridge
```

Zobrazí se 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 rychlý tunel bez účtu. Pokud Termbridge používáte často,
> nastavte token pojmenovaného tunelu Cloudflare, abyste předešli omezení počtu požadavků.


## Připojení z telefonu

1. Otevřete fotoaparát telefonu
2. Namiřte ho na kód QR
3. Klepněte na zobrazený odkaz
4. V prohlížeči se načte váš terminál

A je to – jste připojeni!

## Co se právě stalo?

1. Termbridge spustil na vašem počítači místní server
2. Vytvořil relaci tmux pro váš terminál
3. Cloudflare vytvořil zabezpečený tunel (`trycloudflare.com` URL)
4. Kód QR obsahuje jednorázový token pro zabezpečený přístup. Funguje pouze jednou a jeho platnost vyprší 90 sekund po spuštění, proto ho naskenujte co nejdříve; pokud jeho platnost vypršela, restartujte Termbridge a získáte nový
5. Po naskenování jste získali soubor cookie relace a připojili se

## Vyzkoušejte to

Po připojení zkuste několik příkazů:

```bash
# See system info
htop

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

# Run any CLI tool
```

Terminál podporuje plné barvy, TUI i všechny klávesy, které byste očekávali.

## Nechte ho spuštěný

Aby připojení fungovalo, musí Termbridge zůstat spuštěný. Až skončíte:

- V terminálu, ve kterém běží Termbridge, stiskněte `Ctrl+C`
- Tunel se uzavře a připojení skončí
- Vaše relace tmux zůstane aktivní (pokud jste nepoužili `--kill-on-exit`)

## Chování při první relaci

- Termbridge vytvoří relaci tmux (výchozí název se odvozuje od portu)
- Automaticky se načte první terminál v seznamu
- Při spuštění můžete vytvořit více relací nastavením `TERMBRIDGE_SESSIONS=2`

## Použití existující relace tmux

Pokud zadáte `--session <name>` a daná relace už existuje, Termbridge se k ní připojí místo vytvoření nové. To se hodí ke sledování dlouho běžících procesů, které jste už spustili.

## Další kroky

### [Ovládání na mobilu](https://termbridge.inline0.dev/cs/docs/usage/mobile-controls)

Tipy k používání Termbridge na telefonech a tabletech

### [Více terminálů](https://termbridge.inline0.dev/cs/docs/usage/multiple-terminals)

Spouštějte více relací a přepínejte mezi nimi

### [Náhled vývojového serveru](https://termbridge.inline0.dev/cs/docs/usage/dev-server-preview)

Zobrazte náhled aplikace Vite vedle terminálu

### [CLI Reference](https://termbridge.inline0.dev/cs/docs/cli)

Zobrazit všechny dostupné příznaky a možnosti