# TransTUI wiki

TransTUI is a terminal client (ncurses) for the [Transmission](https://transmissionbt.com/)
BitTorrent daemon, written in C. It talks directly to `transmission-daemon`'s
JSON-RPC API - no `libcurl`, `jansson`, or other heavy dependency required.

```
              ╭─ TransTUI ──────────────────────────────────────────╮
              │                                                     │
              │   █████ ████   ███  █   █  ████ █████ █   █ █████   │
              │     █   █   █ █   █ ██  █ █       █   █   █   █     │
              │     █   ████  █████ █ █ █  ███    █   █   █   █     │
              │     █   █  █  █   █ █  ██     █   █   █   █   █     │
              │     █   █   █ █   █ █   █ ████    █    ███  █████   │
              │                                                     │
              │               Transmission TUI Client               │
              ╰─────────────────────────────────────────────────────╯
```

## Contents

- **[Installation](Installation.md)** - dependencies, building, installing
- **[Configuration](Configuration.md)** - `config.ini`, command-line flags
- **[Interface](Interface.md)** - tour: sidebar, list view, detail view,
  settings screen, splash screen
- **[Keybindings](Keybindings.md)** - full reference
- **[Daemon: setup & troubleshooting](Daemon-Setup-and-Troubleshooting.md)**
  - no daemon found, HTTP 401 authentication, common errors
- **[Browser Integration](Browser-Integration.md)** - `--add` mode,
  `.desktop` file for magnet links/`.torrent` files
- **[Architecture](Architecture.md)** - how the code is structured and why

## Quick start

```sh
make && make install
transtui
```

See [Installation](Installation.md) for dependencies and
[Daemon: setup & troubleshooting](Daemon-Setup-and-Troubleshooting.md) if
`transtui` can't connect to a daemon.