Data

Tools

Indexes

Applications

Experiments

Awesome

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

https://github.com/detteee/bilistream

BiliStream is a Rust application designed to automatically redirect live streams from YouTube or Twitch to Bilibili. This tool leverages the power of FFmpeg for stream processing, yt-dlp for YouTube integration, and Streamlink for Twitch support. BiliStream 是一个用 Rust 编写的应用程序，旨在自动将 YouTube 或 Twitch 的直播流转播到 Bilibili。使用FFmpeg， yt-dlp和Streamlink实现转播。
https://github.com/detteee/bilistream

bilibili bilibili-live m3u8 rust shell-script twitch youtube

Last synced: 4 months ago
JSON representation

BiliStream is a Rust application designed to automatically redirect live streams from YouTube or Twitch to Bilibili. This tool leverages the power of FFmpeg for stream processing, yt-dlp for YouTube integration, and Streamlink for Twitch support. BiliStream 是一个用 Rust 编写的应用程序，旨在自动将 YouTube 或 Twitch 的直播流转播到 Bilibili。使用FFmpeg， yt-dlp和Streamlink实现转播。

Awesome Lists containing this project

README 

        
# Bilistream



[English](README.md) | [中文](README.zh_CN.md)



This project is inspired by [limitcool/bilistream](https://github.com/limitcool/bilistream) but has been significantly redesigned and enhanced. While it shares the same core concept, this implementation offers distinct features and improvements, including a comprehensive `stream_manager.sh` script for easier management.



## Features



- Automated rebroadcasting of Twitch and YouTube streams to Bilibili Live

- Support for scheduled streams on YouTube

- Configurable and auto update Bilibili live settings (title, area and thumbnail)

- Comprehensive management script (`stream_manager.sh`) for easy configuration and control

- Danmaku command feature for changing the listening target channel when Bilibili live is off

- Monitor League of Legends Live game and stops Bilibili live if blacklisted words are found in player names

- Detects and avoids rebroadcasting content already being streamed by monitored Bilibili live rooms



## Dependencies



- ffmpeg

- yt-dlp

- streamlink (with [2bc4/streamlink-ttvlol](https://github.com/2bc4/streamlink-ttvlol) plugin)

- [Isoheptane/bilibili-danmaku-client](https://github.com/Isoheptane/bilibili-live-danmaku-cli) (for danmaku command feature)



## Setup



1. Clone the repository:



   ```bash

   git clone https://github.com/your-username/bilistream.git

   cd bilistream

   ```

2. Install the required dependencies (example for Debian-based systems):



   ```bash

   sudo apt update

   sudo apt install ffmpeg python3-pip

   pip install yt-dlp streamlink

   ```

3. Install the streamlink-ttvlol plugin:

   Follow the instructions at [2bc4/streamlink-ttvlol](https://github.com/2bc4/streamlink-ttvlol)

4. [Isoheptane/bilibili-danmaku-client](https://github.com/Isoheptane/bilibili-live-danmaku-cli) (if you need danmaku command feature)

5. Build the project:



   For Debian 12 and other Linux distributions using glibc 2.36 or newer:



   ```bash

   cargo zigbuild --target x86_64-unknown-linux-gnu.2.36 --release

   ```



   For Windows:



   ```bash

   cargo build --target x86_64-pc-windows-gnu --release

   ```

6. Configure `config.yaml`:



   ```yaml

   # Copy and edit the example config

   cp config.yaml.example config.yaml

   ```



   See `config.yaml.example` for detailed configuration options:



   - Bilibili live room settings

   - YouTube/Twitch channel settings

   - Area IDs for different game categories

   - Proxy settings

   - API keys for various services

   - Anti collision settings

7. For the danmaku feature, configure `config.json` according to the [bilibili-danmaku-client documentation](https://github.com/Isoheptane/bilibili-live-danmaku-cli)

8. Create channels configuration file:

   Create `channels.json` in the root directory with the following structure:



```json

{

  "channels": [

    {

      "name": "Channel Name",

      "platforms": {

        "youtube": "YouTube Channel ID",

        "twitch": "Twitch Channel ID"

      },

      "riot_puuid": "League of Legends PUUID"  // Optional

    }

  ]

}

```



9. (Optional) Create `invalid_words.txt` to monitor League of Legends in-game IDs:



- Create a file named `invalid_words.txt` with one word per line

- Configure `RiotApiKey` and `LolMonitorInterval` in config.yaml:



  ```yaml

  RiotApiKey: "YOUR-RIOT-API-KEY"    # Get from https://developer.riotgames.com/

  LolMonitorInterval: 1               # Check interval in seconds

  ```

- The program will monitor in-game players and stop streaming if any blacklisted words are found



## File Structure



```txt

.

├── bilistream           # Main executable

├── channels.json        # Channel configuration for YouTube, Twitch, and PUUID

├── config.json          # Danmaku client configuration

├── config.yaml          # Main configuration file

├── cookies.json         # Bilibili login cookies (./bilistream login)

├── invalid_words.txt    # Filtered words for LOL players ID

├── live-danmaku-cli     # Danmaku client

└── stream_manager.sh    # Management script

```



## Usage



Run the Bilistream application:



```bash

./bilistream 

```



### Subcommands



Bilistream supports the following commands:



1. Start streaming:



   ```bash

   ./bilistream

   ```

2. Login to Bilibili:



   ```bash

   ./bilistream login

   ```

3. Send danmaku (chat message):



   ```bash

   ./bilistream send-danmaku 

   ```

4. Replace stream cover:



   ```bash

   ./bilistream replace-cover 

   ```

5. Update stream area:



   ```bash

   ./bilistream update-area 

   ```

6. Renew Bilibili tokens:



   ```bash

   ./bilistream renew

   ```

7. Get live status:



   ```bash

   ./bilistream get-live-status  [channel_id]

   # platform: YT, TW, bilibili, all

   ```

8. Generate shell completions:



   ```bash

   ./bilistream completion 

   # shell: bash, zsh, fish

   ```



### Danmaku Command Feature



When the Bilibili live stream is off, you can use danmaku commands in the Bilibili live chat to change the listening target channel. This allows for dynamic control of the rebroadcasting target without restarting the application.



To use this feature:



1. Ensure the Bilibili live stream is off.

2. Send a specific danmaku command in the Bilibili live chat.

3. The system will process the command and change the listening target channel accordingly.



Danmaku command format:



```txt

%转播%YT/TW%channel_name%area_name

channel_name must in YT/TW_channels.txt

```



Example:



```txt

%转播%YT%kamito%英雄联盟

%转播%TW%kamito%无畏契约

```



The system will check the live title and adjust the area ID if necessary. For example, if the live title contains "Valorant", it will set the area ID to 329 (无畏契约) regardless of the specified area name. Check [https://api.live.bilibili.com/room/v1/Area/getList](https://api.live.bilibili.com/room/v1/Area/getList) for more Area name and ID.



### Shell Completions



Bilistream supports command completion for bash, zsh, and fish shells. To enable completions:



#### Bash



```bash

# Generate completions

./bilistream completion bash > ~/.local/share/bash-completion/completions/bilistream

# Reload completions

source ~/.bashrc

```



#### Zsh



```bash

# Generate completions

./bilistream completion zsh > ~/.zsh/completion/_bilistream

# Reload completions

source ~/.zshrc

```



#### Fish



```bash

# Generate completions

mkdir -p ~/.config/fish/completions

./bilistream completion fish > ~/.config/fish/completions/bilistream.fish

# Reload completions

source ~/.config/fish/completions/bilistream.fish

```



## Contributing



Contributions are welcome! Please feel free to submit a Pull Request.



## License



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



## Acknowledgements



- [limitcool/bilistream](https://github.com/limitcool/bilistream)

- All users of this project