Renardo

Live coding environment for Python - A modern fork of FoxDot for algorithmic music composition and live performance.

Renardo is currently going through a wide and deep refactoring toward version 1.0.

Features

• Live Coding: Write and execute Python code in real-time to create music
• Pattern-based Composition: Powerful pattern system for rhythmic and melodic structures
• Multiple Backends:
  • SuperCollider integration for synthesis and audio processing
  • REAPER backend for advanced DAW integration
  • MIDI output support
• Web-based Interface: Modern, responsive web client built with Svelte
• Desktop Application: Optional Electron-based desktop app
• Interactive Tutorials: Built-in tutorials in multiple languages (English, Spanish)
• Extensible: Plugin system for custom instruments and effects
• Resource Management: Library system for managing samples, FX chains, and instruments

Quick Start

Prerequisites

• Python 3.9 or higher
• SuperCollider (for audio synthesis)
• uv (Python package manager) - recommended
• REAPER (optional, for DAW integration)

Installation

Using uv (recommended)

# Clone the repository
git clone https://github.com/yourusername/renardo.git
cd renardo

# Install with uv
uv pip install -e .

# Or run directly with uv
uv run renardo

Using pip

pip install renardo

First Run

# Launch Renardo with default settings
renardo

# Or use the CLI interface
uv run cli

# Interactive pipe mode
uv run cli --pipe

The web interface will automatically open at http://localhost:5000

Usage

Basic Live Coding Example

# Create a simple drum pattern
d1 >> play("x-o-")

# Add a bassline
b1 >> bass([0, 3, 5, 7], dur=1/2)

# Modify in real-time
d1 >> play("x-o-", amp=1.2)

# Stop everything
Clock.clear()

CLI Options

# Show all available commands
renardo --help
cli --help

# Start in pipe mode (for integration with other tools)
cli --pipe

# Launch with specific backend
renardo --backend supercollider
renardo --backend reaper

# Configure REAPER integration
renardo --configure-reaper

Architecture

Renardo is organized into several key modules:

renardo/
├── lib/              # Core library (patterns, players, effects)
├── sc_backend/       # SuperCollider integration
├── reaper_backend/   # REAPER DAW integration
├── midi_backend/     # MIDI output support
├── webserver/        # Flask-based web server
├── runtime/          # Runtime environment and state management
├── settings_manager/ # Configuration management
├── gatherer/         # Resource library system
├── tutorial/         # Interactive tutorials (en, es)
└── cli_entrypoint/   # Command-line interface

webclient/
├── src/              # Svelte web interface
├── electron/         # Electron desktop app wrapper
└── dist/             # Built web assets

Documentation

Tutorials

Renardo includes interactive tutorials accessible from the web interface:

• English: /tutorial/en/
• Spanish: /tutorial/es/

Topics covered:

1. Introduction to live coding
2. Playing notes and samples
3. Algorithmic manipulation
4. Using patterns
5. Player attributes
6. Clock management
7. Advanced features (scales, groups, vars)
8. SuperCollider instruments
9. REAPER backend integration

Contributing

Contributions are welcome! Please follow these guidelines:

1. Fork the repository
2. Create a feature branch (git checkout -b feat/amazing-feature)
3. Commit your changes using Conventional Commits

   feat: add new pattern generator
   fix: resolve timing issue in Clock
   docs: update tutorial content
   

4. Push to your branch (git push origin feat/amazing-feature)
5. Open a Pull Request

We use Conventional Commits format

Reference

Key components:

• Players: Objects that play patterns (p1, d1, b1, etc.)
• Patterns: Sequence generators (P, PSum, PRand, etc.)
• Clock: Global timing system
• SynthDefs: SuperCollider instrument definitions
• TimeVars: Variables that change over time

Configuration

Renardo uses TOML files for configuration:

# Default config location
~/.renardo/settings.toml

# REAPER backend settings
~/.renardo/reaper_backend.toml

Example Configuration

[general]
backend = "supercollider"
auto_start = true

[supercollider]
port = 57120
audio_device = "default"

[reaper]
enabled = true
project_path = "~/Music/renardo_sessions"

Backends

SuperCollider Backend

The default audio backend using SuperCollider for synthesis:

# Start SuperCollider
from renardo.sc_backend import SuperColliderInstance

sc = SuperColliderInstance()
sc.start()

# Use SuperCollider instruments
p1 >> pluck([0, 2, 4, 7])

REAPER Backend

Advanced DAW integration for professional production:

# Initialize REAPER backend
from renardo.reaper_backend import ReaperBackend

reaper = ReaperBackend()
reaper.configure()

# Create REAPER instruments
r1 >> ReaperInstrument("my_synth.RfxChain", notes=[0, 4, 7])

MIDI Backend

Output to external MIDI devices:

# Configure MIDI output
from renardo.midi_backend import MIDIOut

midi = MIDIOut("My MIDI Device")
m1 >> midi([60, 64, 67])  # C major chord

Web Client

The web interface provides:

• Code Editor: Syntax highlighting, auto-completion
• Console Output: Real-time feedback
• Session Management: Save and load sessions
• Settings Panel: Configure backends and preferences
• Tutorial Browser: Access interactive tutorials
• Resource Explorer: Browse samples and instruments

Development

cd webclient

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

# Build Electron app
npm run build:electron

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

See the LICENSE file for details.

🙏 Acknowledgments

• FoxDot: Original live coding environment by Ryan Kirkbride
• SuperCollider: Synthesis engine
• REAPER: Digital Audio Workstation
• All contributors to the Renardo project

Contact & Community

• Website: renardo.org
• Issues: GitHub Issues
• Discussions: FoxDot / Renardo telegram channel

Happy live coding! 🎵