
[GoTikTokLive](https://github.com/steampoweredtaco/gotiktoklive) is a Go library for connecting to TikTok LIVE streams.
It uses a channel-based API for receiving events.

<Callout type="info">
  View the full source on [GitHub](https://github.com/steampoweredtaco/gotiktoklive).
</Callout>

## Quickstart

<Steps>
<Step>

### Install the package

```bash
go get github.com/steampoweredtaco/gotiktoklive
```

</Step>
<Step>

### Configure your API key

```go
import "github.com/steampoweredtaco/gotiktoklive"

tiktok := gotiktoklive.NewTikTok()
tiktok.SetSigningApiKey("YOUR_API_KEY")
```

</Step>
<Step>

### Connect and listen to events

```go
live, err := tiktok.TrackUser("username")
if err != nil {
    panic(err)
}

for event := range live.Events {
    switch e := event.(type) {
    case gotiktoklive.ChatEvent:
        fmt.Printf("%s: %s\n", e.User.Username, e.Comment)
    case gotiktoklive.GiftEvent:
        fmt.Printf("%s sent a gift!\n", e.User.Username)
    case gotiktoklive.ViewersEvent:
        fmt.Printf("Viewers: %d\n", e.Viewers)
    default:
        fmt.Printf("%T: %+v\n", e, e)
    }
}
```

</Step>
</Steps>

## Stream Download

GoTikTokLive can also download the live stream video (requires `ffmpeg`):

```go
if err := live.DownloadStream(); err != nil {
    panic(err)
}
```

See the [API Key Usage](/docs/api-key-usage/go) guide for more configuration options.
