Skip to content

Songmu/podbard

Repository files navigation

Podbard

Test Status Coverage Status MIT License PkgGoDev

The Podbard is a primitive podcast site generator.

Document site (Japanese)

Synopsis

# Initialize the site
$ podbard init .
✨ Initialized your brand new podcast project under "." directory

# Locate the audio file and create a new episode page
$ podbard episode audio/1.mp3
🔍 The episode file "episode/1.md" corresponding to the "1.mp3" was created.

# Build the site
$ podbard build
🔨 Generating a site under the "public" directrory
🎤 Your podcast site has been generated and is ready to cast.

Description

The podbard is software that generates a minimum podcast sites from a list of audio files.

Template Repository

You can start a new podcast site by using the template repository without installing the podbard.

Installation

How to install on terminal
# Homebrew
% brew install Songmu/tap/podbard

# Install the latest version. (Install it into ./bin/ by default).
% curl -sfL https://github.com/raw/Songmu/podbard/main/install.sh | sh -s

# Specify installation directory ($(go env GOPATH)/bin/) and version.
% curl -sfL https://github.com/raw/Songmu/podbard/main/install.sh | sh -s -- -b $(go env GOPATH)/bin [vX.Y.Z]

# In alpine linux (as it does not come with curl by default)
% wget -O - -q https://github.com/raw/Songmu/podbard/main/install.sh | sh -s [vX.Y.Z]

# go install
% go install github.com/Songmu/podbard/cmd/podbard@latest

Directory Structure

  • index.md
    • index page
  • podbard.yaml
    • configuration file
  • episode/
    • episode pages in markdown
  • audio/
    • audio files (mp3 or m4a)
  • template/
    • template files (tmpl files in Go's text/template syntax)
  • static/
    • static files

Sub Commmands

init

$ podbard init .

episode

$ podbard episode [-slug=hoge -date=2024-09-01 -title=title] audio/1.mp3

create a new epoisode page with the specified audio file.

build

$ podbard build

build the site and output to the public directory.

Author

Songmu