Metadata-Version: 2.1
Name: podmaker
Version: 0.2.0
Summary: Convert online media into podcast feeds.
Home-page: https://github.com/YogiLiu/podmaker
License: Unlicense
Keywords: rss,youtube,podcast
Author: YogiLiu
Author-email: YogiLiu@outlook.com
Maintainer: YogiLiu
Maintainer-email: YogiLiu@outlook.com
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: apscheduler (>=3.10.4,<4.0.0)
Requires-Dist: boto3 (>=1.28.27,<2.0.0)
Requires-Dist: pydantic[email] (>=2.2.0,<3.0.0)
Requires-Dist: tomlkit (>=0.12.1,<0.13.0)
Requires-Dist: typing-extensions (>=4.7.1,<5.0.0)
Requires-Dist: yt-dlp (>=2023.7.6,<2024.0.0)
Project-URL: Bug Tracker, https://github.com/YogiLiu/podmaker/issues
Project-URL: Documentation, https://github.com/YogiLiu/podmaker/blob/main/README.md
Project-URL: Repository, https://github.com/YogiLiu/podmaker
Description-Content-Type: text/markdown

# Podmaker

Convert online media into podcast feeds.

## 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.

```bash
pip install podmaker
```

### Using `pipx`

```bash
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](config.example.toml).

## Usage

```bash
podmaker -c path/to/config.toml
```

or 
    
```bash
python -m podmaker -c path/to/config.toml
```

## Roadmap

### Platforms

- [x] YouTube
    - [x] Playlist
    - [ ] Channel
- [ ] BiliBili

### Resource Hosting

- [x] 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:

```bash
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](LICENSE).
