poc of soundfiler for dpf by dromer · Pull Request #288 · Wasted-Audio/hvcc

dromer · 2025-07-23T21:44:49Z

Todo:

Add TinyWav to library dependencies - create a mechanism for marking and including additional libraries?
Define plugin internal user file locations - additional meta config and/or prepended demarcation?

dromer · 2025-07-24T20:16:35Z

To get the outlets to work I'm thinking of passing $0 as an extra value. This way we could have receivers like $0-snd-file-left and $0-snd-file-right for each object instance and be able to send messages specifically to them.

However this probably requires symbol support in pack so we can construct the appropriate message containing $0 -> #287

… DPF getSpecialDir(); split to separate template include

pedrojg321 · 2025-11-27T16:18:35Z

Hey @dromer, if you could, and it is not urgent at all, could you rebase this work on develop after getting #328? 🙏

dromer · 2025-11-27T16:29:51Z

@pedrojg321 done :)

Are you interested in testing this feature?

pedrojg321 · 2025-11-27T16:59:42Z

Thanks! I was able to compile a patch that had soundfile blocks. I'm trying to persist some values but still need to work more on it

lokkiikkol · 2026-02-11T18:47:38Z

thanks for pointing me here @dromer ! so am i right in assuming this is currently not working even in develop? or is there a way in which i could test this from plugdata by installing a dev-version of the hvcc toolchain?

dromer · 2026-02-11T19:51:43Z

Using poetry build on this branch you can get a Heavy binary that you could place in the tool chain.

lokkiikkol · 2026-02-13T21:54:09Z

Using poetry build on this branch you can get a Heavy binary that you could place in the tool chain.

thanks, did that and got this in terminal:

Building hvcc (0.14.0)
Building sdist
  - Building sdist
  - Built hvcc-0.14.0.tar.gz
Building wheel
  - Building wheel
  - Built hvcc-0.14.0-py3-none-any.whl

looking at the toolchain folder in Documents/plugdata/Toolchain it is not entirely clear to me which files/parts I would have to replace.

dromer · 2026-02-13T22:16:30Z

You would only need to replace plugdata/Toolchain/bin/Heavy/Heavy.

Let me do a rebuild of this branch to create a build in CI for you.

dromer · 2026-02-13T22:20:42Z

This Action should result in some builds of the Heavy binary: https://github.com/Wasted-Audio/hvcc/actions/runs/22004826723

lokkiikkol · 2026-02-13T22:35:05Z

thanks! replaced the binary, went through the usual security warnings and tried to compile a simple test-patch:

which gave me this error:

In file included from HeavyDPF_soundfilertry.cpp:34:
./HeavyDPF_soundfilertry.hpp:39:10: fatal error: 'tinywav.h' file not found
   39 | #include "tinywav.h"
      |          ^~~~~~~~~~~
Compiling HvMessage.c
Compiling HvMessagePool.c
Compiling HvMessageQueue.c
1 error generated.
make[1]: *** [../../build/HeavyDPF_soundfilertry.cpp.o] Error 1
make[1]: *** Waiting for unfinished jobs....
make: *** [plugin] Error 2

so i guess i need to somehow add tinywav headers to the toolchain as well

dromer · 2026-02-13T22:45:13Z

Oh yeah this is not part of Heavy internals yet so it's a manual thing.

This branch is in Draft status for a reason ;)

lokkiikkol · 2026-02-15T00:18:06Z

sorry to waste so much time on this... after exporting source + GUI from plugdata, i manually added tinywav.c and tinywav.h to the plugin/source/ directory and tried "make" now i get an error, because:

lokki@Mac soundfiler % make
/Applications/Xcode.app/Contents/Developer/usr/bin/make all -C plugin/source
Compiling Heavy_soundfilertry.cpp
Compiling HeavyContext.cpp
Compiling HeavyDPF_soundfilertry.cpp
Compiling HvHeavy.cpp
Compiling HvControlCast.c
Compiling HvControlPack.c
Compiling HvControlSlice.c
Compiling HvControlVar.c
Compiling HvLightPipe.c
Compiling HvMessage.c
Compiling HvMessagePool.c
Compiling HvMessageQueue.c
Compiling HvTable.c
Compiling HvUtils.c
Compiling tinywav.c
make[1]: *** No rule to make target `../../build/../../tinywav/tinywav.c.o', needed by `../../bin/soundfilertry.vst3/Contents/MacOS/soundfilertry'.  Stop.
make: *** [plugin] Error 2

dromer · 2026-02-15T07:26:19Z

Ah, from the Makefile for the plugin you can see that I was putting Tinywav in a folder on the root level.

Again this was super Proof of Concept stuff so not in any way polished for users.

I think I just cloned https://github.com/mhroth/tinywav into the project root.

lokkiikkol · 2026-02-15T09:17:37Z

thanks! it compiles now. i don't get any sound out of it when compiled as a vst3. should this work? (see screenshot)

dromer · 2026-02-15T09:27:21Z

I think so, maybe check what info is passed to the outlets and print it to the console.

Not all hosts will print debug info though, personally I always test using jack standalone from cli. Should also work on macOS.

lokkiikkol · 2026-02-17T00:25:17Z

hmm. i am getting: [tinywav] Failed to open file for reading: No such file or directory if i try to load a file via "soundfiler" (compiled to tinywav) . the path works in PD, it is valid.

Copilot

Pull request overview

Adds an initial (WIP) [soundfiler] implementation intended for the DPF generator by introducing a Pd abstraction and wiring generated DPF plugins to perform WAV file read/write via TinyWav.

Changes:

Add a Pd soundfiler.pd abstraction that routes read/write (and -resize) to internal __hv_snd_* sends.
Extend the DPF generator templates with a sndFileOperator() handler and TinyWav build integration.
Filter __hv_snd_* sends from exported output parameters, and document/announce DPF-only soundfiler support.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 14 comments.

Show a summary per file

File	Description
hvcc/interpreters/pd2hv/PdSendObject.py	Minor comment movement for `@raw/@owl` handling.
hvcc/interpreters/pd2hv/libs/pd/soundfiler.pd	New Pd abstraction forwarding soundfiler messages to internal `__hv_snd_*` plumbing.
hvcc/generators/c2owl/c2owl.py	Treat `raw` attribute as present when not `None` (instead of truthy).
hvcc/generators/c2dpf/templates/sndFileOperator.cpp	New DPF-side operator implementing read/write/resize via TinyWav and patch messaging.
hvcc/generators/c2dpf/templates/Makefile_plugin	Adds TinyWav source and include paths to DPF builds.
hvcc/generators/c2dpf/templates/HeavyDPF.hpp	Includes TinyWav header and declares `sndFileOperator()`.
hvcc/generators/c2dpf/templates/HeavyDPF.cpp	Dispatches `__hv_snd_*` sends to `sndFileOperator()` and includes its template.
hvcc/compiler.py	Renames/filter helper and filters soundfiler sends out of exported output parameters.
docs/reference/objects/supported.md	Marks `[soundfiler]` as supported only for some generators (DPF).
docs/generators/dpf.md	Adds WIP section documenting DPF soundfiler + TinyWav dependency.
CHANGELOG.md	Adds “Support soundfiler object (DPF only)” entry.

Comments suppressed due to low confidence (1)

hvcc/compiler.py:125

The parameter name midi_out_objects is now misleading because the function is also used to filter non-MIDI objects (soundfiler sends). Renaming it would make the intent clearer.

def filter_objects_from_out_parameters(output_parameter_list: List, midi_out_objects: List) -> List:
    new_out_list = []

    for item in output_parameter_list:
        if not item[0] in midi_out_objects:
            new_out_list.append(item)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

 FILES_DSP += $(wildcard *.c)
+FILES_DSP += ../../tinywav/tinywav.c


+BUILD_CXX_FLAGS += -I ../../tinywav
+BUILD_C_FLAGS += -I ../../tinywav


 #include "Heavy_{{name}}.hpp"
+#include "tinywav.h"



  void hostTransportEvents(uint32_t frames);
  void setOutputParameter(uint32_t sendHash, const HvMessage *m);
+  void sndFileOperator(uint32_t sendHash, const HvMessage *m);



    plugin->setOutputParameter(sendHash, m);
+    switch (sendHash)
+    {
+      case HV_HASH_SND_WRITE:
+      case HV_HASH_SND_READ:
+      case HV_HASH_SND_READ_RES:
+        plugin->sndFileOperator(sendHash, m);
+        break;
+    }


+      const char *tableName = hv_msg_getSymbol(m, 2);
+
+      auto filePath = getSpecialDir(kSpecialDirDocumentsForPlugin) + std::string("/Samples/") + std::string(fileName);
+


+      TinyWav tw;
+      tinywav_open_read(&tw, filePath.c_str(), TW_INLINE);
+
+      tinywav_read_f(&tw, table, tableSize);
+
+      _context->sendMessageToReceiverV(


+## Soundfiler
+> WORK IN PROGRESS
+
+It is possible to read and write `.wav` audio files to/from tables using `[soundfiler]` object. This currently depends on [TinyWav](https://github.com/mhroth/tinywav) being placed on the same level as `DPF` in your build environment. Paths are relative to the execution directory of the plugin.
+


dromer added 2 commits July 23, 2025 23:42

poc of soundfiler for dpf

b935c30

cleanup

4c0d0a4

dromer marked this pull request as draft July 23, 2025 22:09

dromer added 9 commits August 3, 2025 13:15

poc of symbol in pack

75d7bda

Merge branch 'feature/symbol-in-pack' into feature/soundfiler_sends

62f2f3c

soundfiler outputs

bad823a

Merge branch 'develop' into feature/soundfiler

b71c6d1

merge conflict

af29e63

start writing some docs

07182f0

merge conflict

c30451e

fix HvControlPack; use correct number of arguments in soundfiler; use…

7009867

… DPF getSpecialDir(); split to separate template include

fix symbol position

07b044f

dromer mentioned this pull request Nov 27, 2025

Add option to use persistence on the display_params #329

Closed

merge develop

3a6ad5a

dromer mentioned this pull request Feb 6, 2026

load [table] content at runtime in dpf-plugin? plugdata-team/plugdata-heavy-toolchain#50

Closed

merge conflict

f72b4e1

dromer added 5 commits March 27, 2026 08:40

merge conflict

8c4dece

Merge branch 'develop' into feature/soundfiler

27ea278

merge conflict

b64da3c

merge conflict

8a85d56

merge develop

a9553ec

dromer requested a review from Copilot July 9, 2026 16:35

Copilot started reviewing on behalf of dromer July 9, 2026 16:36 View session

Copilot AI reviewed Jul 9, 2026

View reviewed changes

		FILES_DSP += $(wildcard *.c)
		FILES_DSP += ../../tinywav/tinywav.c

		BUILD_CXX_FLAGS += -I ../../tinywav
		BUILD_C_FLAGS += -I ../../tinywav

		const char *tableName = hv_msg_getSymbol(m, 2);

		auto filePath = getSpecialDir(kSpecialDirDocumentsForPlugin) + std::string("/Samples/") + std::string(fileName);

Uh oh!

Uh oh!

Conversation

dromer commented Jul 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dromer commented Jul 24, 2025

Uh oh!

pedrojg321 commented Nov 27, 2025

Uh oh!

dromer commented Nov 27, 2025

Uh oh!

pedrojg321 commented Nov 27, 2025

Uh oh!

lokkiikkol commented Feb 11, 2026

Uh oh!

dromer commented Feb 11, 2026

Uh oh!

lokkiikkol commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dromer commented Feb 13, 2026

Uh oh!

dromer commented Feb 13, 2026

Uh oh!

lokkiikkol commented Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dromer commented Feb 13, 2026

Uh oh!

lokkiikkol commented Feb 15, 2026

Uh oh!

dromer commented Feb 15, 2026

Uh oh!

lokkiikkol commented Feb 15, 2026

Uh oh!

dromer commented Feb 15, 2026

Uh oh!

lokkiikkol commented Feb 17, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

dromer commented Jul 23, 2025 •

edited

Loading

lokkiikkol commented Feb 13, 2026 •

edited

Loading

lokkiikkol commented Feb 13, 2026 •

edited

Loading