# TransTUI

A terminal client (ncurses) for the [Transmission](https://transmissionbt.com/)
BitTorrent daemon, written in C. Talks directly to `transmission-daemon`'s
JSON-RPC API - no `libcurl`, `jansson`, or other heavy dependency, just
`libncursesw`.

```
╭─ Filter ─────╮╭─ All (2) ───────────────────────────────────────────────╮
│ ❯ All        ││  Name            Size        %  Status       Down   Up  │
│   Downloading││  Debian netinst  667 MiB  100%  Seeding      0 B/s  12K/s│
│   Uploading  ││  Ubuntu ISO      3.7 GiB    75%  Downloading 5M/s   0 B/s│
│   Paused     ││                                                         │
│   Completed  ││                                                         │
╰──────────────╯╰─────────────────────────────────────────────────────────╯
  ↑↓  Navigate  Tab  Filter  Enter  Details  Space  Select  s/S/p  Start/Stop
  a  Add  d  Remove  l  Speed  o/O  Sort  /  Search  g  Settings
```

## Quick start

```sh
sudo apt install build-essential libncurses-dev pkg-config   # build deps
make && make install
transtui
```

Connects to `127.0.0.1:9091` by default. No daemon running, or it requires
a password you don't know? `transtui` detects that and helps you fix it
interactively at startup - see the
[wiki](docs/Daemon-Setup-and-Troubleshooting.md) for details.

## Documentation

Full documentation lives in the [wiki](docs/Home.md):

- **[Installation](docs/Installation.md)** - dependencies, building, installing
- **[Configuration](docs/Configuration.md)** - `config.ini`, command-line flags
- **[Interface](docs/Interface.md)** - a tour through the views
- **[Keybindings](docs/Keybindings.md)** - full reference
- **[Daemon: setup & troubleshooting](docs/Daemon-Setup-and-Troubleshooting.md)**
- **[Browser Integration](docs/Browser-Integration.md)** - add torrents
  directly from magnet links/`.torrent` files
- **[Architecture](docs/Architecture.md)** - how the code is structured and why

## License

`third_party/cJSON.c`/`.h` is [cJSON](https://github.com/DaveGamble/cJSON),
MIT licensed.