Bilipod: Turn Bilibili Channels or Playlists into Podcast Feeds

English / 简体中文

Easily convert Bilibili user uploads into podcast feeds

Features

• Generates podcast feeds from Bilibili user uploads or playlists.
• Flexible configuration:
  • Choose video or audio-only feeds.
  • Select high or low quality output.
  • Filter episodes by keywords.
  • Customize feed metadata (artwork, category, language, etc.).
• OPML export for easy importing into podcast apps.
• Episode cleanup to keep your feed tidy (keep last X episodes).
• Docker support for simplified deployment.
• Endorse the uploader (like, coins, favorite)

Getting Started

Prerequisites

• Python 3.8+
• Bilibili account (and cookies - see below)

Installation & Usage

1. Clone the repository:

   git clone https://github.com/sunrisewestern/bilipod.git
   cd bilipod

2. Create a virtual environment (recommended):

   python -m venv .venv
   source .venv/bin/activate

3. Install dependencies:

   pip install .

4. Obtain your Bilibili cookies or configure login:

   • Follow the instructions in the bilibili-api documentation, or set login.method to password, sms, or qrcode in config.yaml.
   • For Docker login, publish or reverse proxy ports 41942 (Geetest login), 41943 (Geetest verification), and 41944 (QR code login).

5. Configure config.yaml:

   • Provide your Bilibili cookies.

   • Customize feed settings (output format, quality, filters, etc.).

   • String values can reference environment variables with $env{VAR_NAME}:

     login:
       method: password
       username: $env{BILIPOD_USERNAME}
       password: $env{BILIPOD_PASSWORD}

6. Create your podcast feed:

   bilipod --config config.yaml --db data.db

7. Subscribe to the generated feed URL in any podcast app

Docker

The Docker image is available on Docker Hub under sunrisewestern/bilipod.

Running the Docker Container

1. Prepare Configuration and Data Directories: Ensure you have your config.yaml file ready and create a directory for the database if it doesn't exist:

   mkdir -p data

2. Run the Docker Container: Use the following command to run the Docker container, mounting the configuration file and data directory:

   docker run -d \
       --name bilipod \
       -v $(pwd)/config.yaml:/app/config.yaml \
       -v $(pwd)/data:/app/data \
       -p 5728:5728 \
       -p 41942:41942 \
       -p 41943:41943 \
       -p 41944:41944 \
       sunrisewestern/bilipod:latest

Using Docker Compose

Create a docker-compose.yml file with the following content:

version: '3.8'

services:
  bilipod:
    image: sunrisewestern/bilipod:latest
    container_name: bilipod
    volumes:
      - ./config.yaml:/app/config.yaml
      - ./data:/app/data
    ports:
      - "5728:5728"
      - "41942:41942"
      - "41943:41943"
      - "41944:41944"

1. Run with Docker Compose: Run the following commands to start the application using Docker Compose:

   docker-compose up -d

   This command starts the container in detached mode.

2. Stopping the Docker Compose Services: To stop the services, run:

   docker-compose down

Reverse Proxy Login Helpers

If you expose Bilipod through path-based Nginx routes, set the public login helper URLs explicitly:

login:
  geetest_login_url: https://example.com/login
  geetest_verify_url: https://example.com/verify
  qrcode_url: https://example.com/qrcode

After Geetest completes and Bilibili sends an SMS code, open the same /login/ or /verify/ URL again to submit the SMS code from the browser. The hosted Bilipod page also polls /auth/status and shows a clickable login notification while authentication is waiting for action. If the hosted page is public, protect /auth/status, /login/, /verify/, and /qrcode/ with Basic Auth or an IP allowlist at Nginx.

An Nginx example is available at docs/nginx_bilipod_example.conf.

Documentation

• Configuration: Detailed instructions in config_example.yaml
• Bilibili Cookies: https://nemo2011.github.io/bilibili-api/#/get-credential

Acknowledgements

• Inspired by podsync
• Utilizes the bilibili-api library.
• Feed generation powered by python-feedgen.

License

This project is licensed under the GNU General Public License v3.0.