Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/druffko/youtube-restream-bot

A Python script that automatically starts a restream of a YouTube Livestream using OBS
https://github.com/druffko/youtube-restream-bot

python python3 restream restream-bot restreamer youtube youtube-bot youtube-restream-bot

Last synced: 3 months ago
JSON representation

A Python script that automatically starts a restream of a YouTube Livestream using OBS

Awesome Lists containing this project

README

        

![Repo-Image](https://druffko.gg/github-images/youtubebot.png)

![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/druffko/youtube-restream-bot?include_prereleases)

![.NET Version](https://img.shields.io/badge/stability-testing-yellow)
![GitHub last commit](https://img.shields.io/github/last-commit/druffko/youtube-restream-bot)


![GitHub All Releases](https://img.shields.io/github/downloads/druffko/youtube-restream-bot/total)
![GitHub closed issues](https://img.shields.io/github/issues-closed/druffko/youtube-restream-bot)
![GitHub issues](https://img.shields.io/github/issues/druffko/youtube-restream-bot)

Youtube Restream Bot



A Python script that automatically starts a restream of a YouTube Livestream using OBS


## Table of Contents
- [About](#about)
- [Features](#features)
- [Installation](#installation)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)

---

## About

YouTube Restream Bot is a Python script that automatically starts a restream of a YouTube Livestream using OBS. It uses Google's YouTube API V3 to detect if a channel is live and OBS's Websocket Plugin to send the Start/Stop Streaming Command.

---

## Features

- ✅ Detect if a Channel starts a Livestream
- ✅ Automatically Starts/Stops the Stream in OBS

---

## Installation

### Download the latest version

To start off, please head to the [releases page](https://github.com/druffko/youtube-restream-bot/releases) and download the latest release version.

### Setting Up OBS
Please make sure to have the OBS Websocket Plugin installed.

Set up your OBS Streaming credentials as you always would and Enable the Websocket Plugin.

### Entering credentials
Create a project in the Google Cloud console and enable the YouTube Data API V3.

Open the youtube-restream-bot.py in a text editor of your choice and enter API_KEY for YouTube's API, CHANNEL_ID for your Source-Channel ID and OBS_WEBSOCKET_PASSWORD.

You might also want to change the check-interval, which is set to 60 seconds per default.

### Launch the application

Launch the application in terminal using python3 youtube-restream-bot.py

---

## Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a new branch (`git checkout -b feature-name`)
3. Commit your changes (`git commit -m 'Add some feature'`)
4. Push to the branch (`git push origin feature-name`)
5. Open a pull request

---

## License

This project is licensed under the [MIT License](LICENSE).

---

## Contact

- **druffko** - [@druffko](https://twitter.com/druffko) - [email protected]
- **Project Link** - https://github.com/druffko/youtube-restream-bot

Feel free to reach out if you have any questions or suggestions!

---