Metadata-Version: 2.1
Name: pd4web
Version: 1.1.3
Summary: pd4web compiles PureData patches with external objects for Wasm, allowing to run entire patches in web browsers.
Home-page: https://www.charlesneimog.github.io/pd4web
Author: Charles K. Neimog
Author-email: charlesneimog@outlook.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: pyyaml (>=6.0.0,<7.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Project-URL: Documentation, https://www.charlesneimog.github.io/pd4web
Project-URL: Repository, https://github.com/charlesneimog/pd4web
Description-Content-Type: text/markdown

<p align="center">
  <h1 align="center">pd4web</h1>
  <p align="center">
    <a href="https://charlesneimog.github.io/pd4web">
      <img src="https://raw.githubusercontent.com/charlesneimog/pd4web/main/docs/assets/icon.svg" width="10%" alt="Logo">
    </a>
  </p>
  <h4 align="center">pd4web: Running PureData Patches in Browsers with Web Audio</h4>
</p>

<p align="center">
  <a href="https://github.com/charlesneimog/pd4web/releases/latest"><img src="https://img.shields.io/github/release/charlesneimog/pd4web?include_prereleases" alt="Release"></a>
  <a href="https://pypistats.org/packages/pd4web"><img src="https://img.shields.io/pypi/pyversions/pd4web" alt="Version"></a>
  <a href="https://zenodo.org/badge/latestdoi/685549750"><img src="https://zenodo.org/badge/685549750.svg" alt="DOI"></a>
</p>

<p align="center">
    <a href="https://pypistats.org/packages/pd4web"><img src="https://img.shields.io/pypi/dm/pd4web" alt="Downloads"></a>
    <a href="https://img.shields.io/pypi/pyversions/pd4web"><img src="https://img.shields.io/badge/platforms-macOS%20%7C%20Windows%20%7C%20Linux-green" alt="License"></a>
</p>

<p align="center">
  <a href="https://github.com/charlesneimog/pd4web/actions/workflows/pd4web-tests.yml"><img src="https://github.com/charlesneimog/pd4web/actions/workflows/pd4web-tests.yml/badge.svg" alt="Tests"></a>
</p>

`pd4web` empowers you to execute PureData patches directly in web browsers using advanced Web Audio technologies. This tool distinguishes itself from alternative approaches like [hvcc](https://github.com/Wasted-Audio/hvcc) and [WebPd](https://github.com/sebpiq/WebPd) by compiling the source code of [libpd](https://github.com/libpd/libpd), a feat made possible largely due to the contributions of  [claudeha](https://github.com/claudeha). With `pd4web`, you can compile virtually any PureData vanilla patch, along with a wide list of externals.

<h3 align="center"> Details and Documentation</h3>

For more details and documentation, please visit the [Docs](https://charlesneimog.github.io/pd4web/) section of this project.

<h3 align="center"> Contribute</h3>

Contribute to enabling running PureData in WebBrowsers! These are the main areas for your  contributions:

* The `pd4web/lib/` folder, which contains files with special steps for compiling certain `externals/libraries`.
* The `pd4web/src/template.c`, used to pd4web to build the `main.c` file.
* The `pd4web/pd4web.py`, which configures the `main.c` file.

<h3 align="center"> Examples</h3>

<table align="center" width="100%">
  <tr>
    <th>Name</th>
    <th>Description</th>
    <th>Link</th>
  </tr>
  <tr>
    <td align="center">Algorithm I</td>
    <td align="center">It is a piece where I use <code>pmpd</code> and <code>plaits~</code> to make Algorithm Music.</td>
    <td><a href="https://charlesneimog.github.io/Algorithm-Music/Piece-I/">WebSite</a></td>
  </tr>
  <tr>
    <td align="center">Compiled I</td>
    <td align="center">Live-Electronics music for Trumpet in developing yet!</td>
    <td><a href="https://charlesneimog.github.io/Compiled-I">WebSite</a></td>
  </tr>
</table>





