https://github.com/adanalife/tripbot

An ongoing 24/7 slow-TV art project
https://github.com/adanalife/tripbot

geolocation libvlc slowtv twitch-api twitch-bot

Last synced: 9 months ago
JSON representation

An ongoing 24/7 slow-TV art project

• Host: GitHub
• URL: https://github.com/adanalife/tripbot
• Owner: adanalife
• License: mit
• Created: 2018-08-07T00:38:05.000Z (almost 8 years ago)
• Default Branch: develop
• Last Pushed: 2025-02-20T05:40:50.000Z (over 1 year ago)
• Last Synced: 2025-09-07T14:58:04.336Z (9 months ago)
• Topics: geolocation, libvlc, slowtv, twitch-api, twitch-bot
• Language: Go
• Homepage: http://whereisdana.today
• Size: 13.2 MB
• Stars: 13
• Watchers: 1
• Forks: 0
• Open Issues: 26
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
## Tripbot loves you :robot: :heart:

[![GoDoc](https://godoc.org/github.com/adanalife/tripbot?status.svg)](https://pkg.go.dev/github.com/adanalife/tripbot)

[![Go Report Card](https://goreportcard.com/badge/github.com/adanalife/tripbot)](https://goreportcard.com/report/github.com/adanalife/tripbot)

[![GitHub Super-Linter](https://github.com/adanalife/tripbot/workflows/Super%20Linter/badge.svg)](https://github.com/marketplace/actions/super-linter)

[![Version](https://img.shields.io/github/v/release/adanalife/tripbot?sort=semver&include_prereleases)](https://github.com/adanalife/tripbot/releases)

![Build Status](https://img.shields.io/github/checks-status/adanalife/tripbot/master)

[![License](https://img.shields.io/github/license/adanalife/tripbot)](https://tldrlegal.com/license/mit-license)

This is the source code to [whereisdana.today](http://whereisdana.today), a 24/7 interactive [slow-tv](https://en.wikipedia.org/wiki/Slow_television) art project.

If you like it, please consider [subscribing](https://dana.lol/prime) to my channel on [Twitch.tv](https://www.twitch.tv/ADanaLife_).

Thanks for watching!

-Dana ([dana.lol](https://dana.lol))

### How it all works

There are two main components: the chatbot itself, which listens for user commands, and a VLC-based video server, which manages the currently-playing video.

They can be run on separate computers.

The general flow of information looks like this:

![A diagram showing the different components](assets/infra-diagram.png)

For more detail, check out [Tripbot, the Adventure Robot](https://dana.lol/2020/04/15/tripbot-the-adventure-robot/).

### Running tripbot locally

You can use `docker-compose` to run tripbot on your own machine.

It is configured to spin up all of the dependencies for the project.

A helper script ([`bin/devenv`](https://github.com/adanalife/tripbot/blob/main/bin/devenv)) has been created to make the process a little easier.

For example:

```bash

# (optional) create alias for devenv script

alias devenv="$(pwd)/bin/devenv"

# spin up tripbot stack on current machine

devenv up --daemon

# see running containers

devenv ps

# see logs for a specific container

devenv logs tripbot

# shut down everything

devenv down

```

### Other Useful Docs

#### Infra

See [infra/README.md](infra/README.md) for infra setup instructions.

#### Database

See [db/README.md](db/README.md) for database instructions.