Skip to main content

Convert online media into podcast feeds.

Project description

Podmaker

Convert online media into podcast feeds.

PyPI - Version PyPI - Status PyPI - Python Version PyPI - Implementation PyPI - License

Features

  • Extract audio from online videos.
  • No need to deploy web services.
  • Generate podcast feeds.
  • Run in watch mode to keep feeds up-to-date.

Dependencies

This project uses ffmpeg to extract audio from videos. Please install it before using this project.

Installation

Using pip

We recommend installing this project in a virtual environment.

pip install podmaker

Using pipx

pipx install podmaker

Configuration

You must create a configuration file before using this project. The configuration file is a TOML file. The default path is ${WORK_DIR}/config.toml. You can use the -c or --config option to specify a different path. The example configuration file is config.example.toml.

Usage

Systemd

You can use systemd to run this project in the background. The steps are as follows (need root):

# create virtual environment
apt install python3 python3-venv
mkdir -p /opt/podmaker && cd /opt/podmaker
python3 -m venv venv
# install podmaker
./venv/bin/pip install podmaker
# create config file and edit it
curl -o config.toml https://raw.githubusercontent.com/YogiLiu/podmaker/main/config.example.toml
vim config.toml
# create systemd service
curl -o /etc/systemd/system/podmaker.service https://raw.githubusercontent.com/YogiLiu/podmaker/main/systemd/podmaker.service
systemctl daemon-reload
# enable and start service
systemctl enable podmaker
systemctl start podmaker

Manual

podmaker -c path/to/config.toml

or

python -m podmaker -c path/to/config.toml

Roadmap

Platforms

  • YouTube
    • Playlist
    • Channel
  • BiliBili

Resource Hosting

  • S3

Contributing

Pull requests are welcome. Before committing, please ensure that you have pass the unit tests and activate the autohooks.

You can activate the autohooks using the following command:

poetry run autohooks activate --mode poetry

It will automatically lint, format, and sort imports for the code.

If you add new features, please add tests for them.

License

See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

podmaker-0.7.0.tar.gz (18.0 kB view hashes)

Uploaded Source

Built Distribution

podmaker-0.7.0-py3-none-any.whl (25.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page