csound-plugins / risset

Csound Package Manager

External plugins for csound

This is a repository for plugins for csound. It includes multiple plugins, where each plugin contains a series of opcodes.

---

Documentation of all plugins

Go to Documentation

---

Plugins in this repository

klib

very efficient hashtables (dictionaries) and other data structures for csound

poly

Parallel and sequential multiplexing opcodes, they enable the creation and control of multiple instances of a csound opcode

beosc

additive synthesis implementing the loris model sine+noise

else

A miscellaneous collection of effects (distortion, saturation, ring-modula generators (low freq. noise, chaos attractors, etc), envelope generators, etc.

jsfx

jsfx support in csound, allows any REAPER's jsfx plugin to be loaded and controlled inside csound

pathtools

opcodes to handle paths and filenames in a cross-platform manner

---

Installation

The recommended way to install plugins is via risset (https://github.com/csound-plugins/risset). Risset itself can be installed via pip install risset.

Then, to install any plugin:

risset update
risset install <pluginname>

For example, to install klib and poly:

risset install klib poly

Using risset to install plugins also ensures integration with other tools like CsoundQt. Risset also can be used to show manual pages, list opcodes, etc.

---

Manual Installation

Plugins can be manually downloaded from the releases page:

https://github.com/csound-plugins/csound-plugins/releases

The binaries need to be copied to the plugins directory. The directory needs to be created if it does not exist.

Platform	Csound Version	Plugins Path
linux	6	$HOME/.local/lib/csound/6.0/plugins64
linux	7	$HOME/.local/lib/csound/7.0/plugins64
windows	6	C:\\Users\\$USERNAME\\AppData\\Local\\csound\\6.0\\plugins64
windows	7	C:\\Users\\$USERNAME\\AppData\\Local\\csound\\7.0\\plugins64
macos	6	$HOME/Library/csound/6.0/plugins64
macos	7	$HOME/Library/csound/7.0/plugins64

Note for Mac Users

You will probably have to overcome Apple's security mechanism to use the plugins. Right-click on each plugin and choose "Open with Terminal". Confirm "Open" in the dialog panel.

---

Build

git clone  https://github.com/csound-plugins/csound-plugins
cd csound-plugins
git submodule update --init --recursive
mkdir build
cd build
cmake ..
cmake --build . --parallel
cmake --install .

risset's Issues

risset fails to find plugin path on MacOS with brew installed csound

Hi.

First of all thanks for this project!

I am getting these kinds of errors when trying to do anything. Interestingly when trying risset list the first time it was searching in usr/local/lib, now after an unsuccessful risset install pathtools (see below) its looking in */Library/*.

** Error:  System plugins path not found! Searched paths: [PosixPath('/Users/normenhansen/~/Library/Frameworks/CsoundLib64.framework/Versions/6.0/Resources/Opcodes64'), PosixPath('/Library/Frameworks/CsoundLib64.framework/Versions/6.0/Resources/Opcodes64')]
** Error:  Could not copy the binary to the install path

Csound was installed with brew install csound and the path it seems to look for here would be /usr/local/opt/csound/Frameworks/CsoundLib64.framework/Versions/6.0/Resources/Opcodes64 in that case I guess. Is there any way to specify this?

Thanks again!

Is there a way to get binaries for arm Macs?

I noticed that a lot of plugins do not seem to have opcodes for Arm64.

I'm happy to compile these, but I figured there was a reason that only some of the plugins are available.

Is there a way that I can compile them and use Risset?

pip3 install fails for me on Ubuntu

mkg@xenakis:~$ pip3 install risset
Collecting risset
Downloading https://files.pythonhosted.org/packages/5c/57/a4ac3bc62b13da1d2f1fe90ea8abfe1649b7aadb96f0b192d3b5c4921a07/risset-0.2.1.tar.gz
Building wheels for collected packages: risset
Running setup.py bdist_wheel for risset ... done
Running setup.py clean for risset
Failed to build risset
Installing collected packages: risset
Running setup.py install for risset ... error
Complete output from command /usr/bin/python3 -u -c "import setuptools, tokenize;file='/tmp/pip-build-umu1ecmh/risset/setup.py';f=getattr(tokenize, 'open', open)(file);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, file, 'exec'))" install --record /tmp/pip-xbxztc3l-record/install-record.txt --single-version-externally-managed --compile --user --prefix=:
/home/mkg/.local/lib/python3.6/site-packages/setuptools/dist.py:485: UserWarning: The version specified ('Traceback (most recent call last):\n File "./risset.py", line 5, in \n import dataclasses\nModuleNotFoundError: No module named 'dataclasses'') is an invalid version, this may not work as expected with newer versions of setuptools, pip, and PyPI. Please see PEP 440 for more details.
"details." % self.metadata.version
running install
running build
running build_py
creating build
creating build/lib
copying risset.py -> build/lib
running install_lib
copying build/lib/risset.py -> /home/mkg/.local/lib/python3.6/site-packages
byte-compiling /home/mkg/.local/lib/python3.6/site-packages/risset.py to risset.cpython-36.pyc
running install_egg_info
running egg_info
writing risset.egg-info/PKG-INFO
writing dependency_links to risset.egg-info/dependency_links.txt
writing entry points to risset.egg-info/entry_points.txt
writing top-level names to risset.egg-info/top_level.txt
reading manifest file 'risset.egg-info/SOURCES.txt'
writing manifest file 'risset.egg-info/SOURCES.txt'
Copying risset.egg-info to /home/mkg/.local/lib/python3.6/site-packages/risset-Traceback.most.recent.call.last..File..risset.py.line.5.in.module....import.dataclasses_ModuleNotFoundError_.No.module.named.dataclasses-py3.6.egg-info
error: [Errno 36] File name too long: '/home/mkg/.local/lib/python3.6/site-packages/risset-Traceback.most.recent.call.last..File..risset.py.line.5.in.module....import.dataclasses_ModuleNotFoundError_.No.module.named.dataclasses-py3.6.egg-info'

----------------------------------------

Command "/usr/bin/python3 -u -c "import setuptools, tokenize;file='/tmp/pip-build-umu1ecmh/risset/setup.py';f=getattr(tokenize, 'open', open)(file);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, file, 'exec'))" install --record /tmp/pip-xbxztc3l-record/install-record.txt --single-version-externally-managed --compile --user --prefix=" failed with error code 1 in /tmp/pip-build-umu1ecmh/risset/

Version 2.9.1 fails with an exception on Mac M1

I installed risset 2.9.1 using pipx on an ARM Mac.

Python version is 3.12.3

When I type any command (e.g. risset list) it fails with the following traceback:

Csound Version: 6180

Traceback (most recent call last):
  File "/Users/cianoconnor/.local/bin/risset", line 8, in <module>
    sys.exit(main())
             ^^^^^^
  File "/Users/cianoconnor/.local/pipx/venvs/risset/lib/python3.12/site-packages/risset.py", line 3306, in main
    ok = args.func(mainindex, args)
         ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/cianoconnor/.local/pipx/venvs/risset/lib/python3.12/site-packages/risset.py", line 2781, in cmd_list
    return mainindex.list_plugins(installed=args.installed, nameonly=args.nameonly, oneline=args.oneline,
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/cianoconnor/.local/pipx/venvs/risset/lib/python3.12/site-packages/risset.py", line 2329, in list_plugins
    info = self.installed_plugin_info(plugin)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/cianoconnor/.local/pipx/venvs/risset/lib/python3.12/site-packages/risset.py", line 2008, in installed_plugin_info
    binary = plugin.find_binary()
             ^^^^^^^^^^^^^^^^^^^^
  File "/Users/cianoconnor/.local/pipx/venvs/risset/lib/python3.12/site-packages/risset.py", line 823, in find_binary
    if b.platform == platformid and b.matches_versionid(csound_version)]
       ^^^^^^^^^^
AttributeError: 'str' object has no attribute 'platform'

Enable risset to host user-defined opcodes and potentially other resources as well as plugin opcodes

Risset should copy UDO code to a standard location, first looking at Csound's standard INCDIR environment variable, second using a standard location in the user's home directory configuration.

Name collisions should be managed by requiring the user to rename a colliding UDO or filename, and encouraging the use of a pseudo-namespace filename and UDO prefix, e.g. "my_udo" in "my_udo.csd."

Dependency on the dataclasses module

pip3 install risset succeeds but running risset fails if the dataclasses module has not been installed.