https://github.com/trugamr/botto

🦦 Botto, a playful Discord bot for remote media playback
https://github.com/trugamr/botto

discord-bot docker-image media-playback self-hosted typescript

Last synced: about 2 months ago
JSON representation

🦦 Botto, a playful Discord bot for remote media playback

• Host: GitHub
• URL: https://github.com/trugamr/botto
• Owner: Trugamr
• License: mit
• Created: 2023-03-08T11:42:57.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-03-27T13:34:31.000Z (3 months ago)
• Last Synced: 2025-05-01T10:51:49.205Z (about 2 months ago)
• Topics: discord-bot, docker-image, media-playback, self-hosted, typescript
• Language: TypeScript
• Homepage:
• Size: 352 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        


# Botto 🦦

[![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/trugamr/botto?sort=date)](https://hub.docker.com/r/trugamr/botto)

[![Docker Pulls](https://img.shields.io/docker/pulls/trugamr/botto.svg)](https://hub.docker.com/r/trugamr/botto)

[![GitHub issues](https://img.shields.io/github/issues/trugamr/botto)](https://github.com/trugamr/botto/issues)

Botto, the otter named Otto, is a playful Discord bot that can play media from various remote sources in your Discord server.

## Features

- ✍ Written in TypeScript

- 🎶 Queue multiple tracks from a playlist

- 🎥 Livestream playback support

- 🤝 Play in multiple guilds

Botto is designed to be extensible and new features will be added over time.

## Running

Before running Botto, you will need to have the following prerequisites installed:

- [Node.js](https://nodejs.org/)

- [pnpm](https://pnpm.io/)

- [ffmpeg](https://ffmpeg.org/)

- [yt-dlp](https://github.com/yt-dlp/yt-dlp)

1. Clone the repository using `git clone https://github.com/trugamr/botto.git`

2. Install dependencies using `pnpm install`

3. Create a `.env` file using the provided `.env.example` file as a template, and fill in your own values.

4. Build the project using `pnpm run build`

5. Start the bot using `pnpm run start`

## Docker

You can also play with Botto in a Docker container. To start the container, run:

```bash

docker run -d --name botto -e DISCORD_CLIENT_ID= -e DISCORD_BOT_TOKEN= trugamr/botto

```

Make sure to replace `` and `` with your own values.

For a full list of available environment variables, please refer to the `.env.example` file included in the repository.

## Contributing

If you would like to contribute, you can fork the repository, create a new feature or bugfix branch, and create a pull request.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE.md) file for more information.