james-trayford / strauss

Sonification Tools and Resources for Analysis Using Sound Synthesis
Apache License 2.0
33 stars 4 forks source link

Soundfonts, TTS, WIndows Support & Helper functions #26

Closed james-trayford closed 1 month ago

james-trayford commented 3 months ago

Note the examples/colab directory containing versions of the notebooks with preambles that allow them to run in Google Colab. This can be opened using the github URL to the file and changing github.com to githibtocolab.com. This provides a way to test the notebooks in a 'fresh' environment. In particular, the examples/colab/AudioCaption.ipynb example by default should install the TTS extras to strauss. Without these extras captioning still fail, but all other aspects of strauss should work. Some of the default Colab modules don't play well with these modules, but examples should still work (though may complain and ask to reset the runtime)

The Colab notebooks won't work by default at the moment, as they're designed to pip install strauss from PyPI (and they're not there yet). When open in Colab, can change:

%pip --quiet install strauss

to

%pip --quiet install "strauss @ git+https://github.com/james-trayford/strauss.git@development"

for this development branch. In the case of the examples/colab/AudioCaption.ipynb example, for the full functionality need to specify the TTS extras for strauss, so:

%pip --quiet install "strauss[TTS] @ git+https://github.com/james-trayford/strauss.git@development"

james-trayford commented 3 months ago

To do:

Note: Need to add !git checkout -b development origin/development line after the %cd strauss/examples/ line to get all the examples to work in Colab