Skip to content

A personal playground for exploring code-driven sound: algorithmic music experiments and custom tools built with Sardine, a Python library for live coding.

Notifications You must be signed in to change notification settings

malbiruk/can-of-sprats

Repository files navigation

can of sprats

Yo! Welcome to my can of sprats! This is where I mess around with Sardine, a cool Python library for making algorithmic music and live coding.

Why "can of sprats"? Think of it as a collection of things packed tightly together – Sardine code, custom tools, experiments, and musical sketches, all swimming in their own little brine.

What's Inside?

  • Projects: These are actual musical pieces or recreations. Right now, there's a recreation of Platina's "NEO" beat. Check it out: NEO Beat Recreation
  • My Sardine Tools: A custom Python package with utilities to make Sardine even more fun. Think of it as my personal toolbox. More details here: My Sardine Tools
  • Scripts: Little helpers for setting things up and connecting stuff.
  • Common: Shared resources and configurations.

Getting Started

Wanna dive in? Here's the basic flow:

  1. Dependencies: Make sure you have everything installed. Install Sardine, then do this:

    pip install -r requirements.txt
    pip install -e ./my_sardine_tools
  2. Start Sardine:

    • Option 1: Direct Terminal: If your editor can send text to the terminal, just run ./scripts/start_sardine.sh in terminal. (This script makes sure SuperCollider and SuperDirt are up and running before Sardine starts. In some cases Sardine doesn't start SuperCollider automatically, otherwise just running sardine might work.)
    • Option 2: Client/Server: If your editor can't send text to the terminal, use the client/server approach:
      • Start the Sardine server: ./run_sardine.sh
      • Configure your editor to send selected text via the client script: ./scripts/sardine_client.sh "YOUR_SELECTED_CODE"
    • Option 3: Editor extension: For some editors extensions are available, check here.
  3. Load a Project: Sardine works as a REPL. You edit code in your editor and send it to the REPL.

License

This is all for fun and learning. Do what you want with it.

About

A personal playground for exploring code-driven sound: algorithmic music experiments and custom tools built with Sardine, a Python library for live coding.

Topics

Resources

Stars

Watchers

Forks