Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/banisterious/obsidian-sonigraph

An Obsidian plugin that transforms the visual structure of your knowledge graph into music. It maps the visible notes (nodes) and their connections to musical parameters, allowing you to "hear" the relationships and complexity of your ideas, using an open-source JavaScript synth framework.
https://github.com/banisterious/obsidian-sonigraph

algorithmic-music audio generative-music music obsidian-graph obsidian-plugin sonification sound synth tonejs

Last synced: about 1 month ago
JSON representation

An Obsidian plugin that transforms the visual structure of your knowledge graph into music. It maps the visible notes (nodes) and their connections to musical parameters, allowing you to "hear" the relationships and complexity of your ideas, using an open-source JavaScript synth framework.

Awesome Lists containing this project

README 

          
# Sonigraph



**Transform your knowledge graph into immersive orchestral soundscapes.**



Sonigraph is an Obsidian plugin that maps the visual structure of your knowledge graph to rich musical parameters, creating dynamic orchestral compositions with 34 instruments, advanced effects processing, and real-time audio synthesis.



Sonic Graph visualization showing Smart Clustering and enhanced graph features




Sonic Graph: Smart Clustering & Visual Enhancement



Animated demonstration of the Sonigraph Control Center




Control Center: 34-Instrument Orchestra Management



## 🎼 Features



### Core Sonification

- **Graph-to-Music Mapping**: Convert note connections into orchestral compositions

- **34-Instrument Orchestra**: Full orchestral palette including strings, woodwinds, brass, percussion, vocals, and electronic synthesis

- **Real-time Audio Synthesis**: Generate music directly within Obsidian using Tone.js Web Audio API

- **Intelligent Musical Mapping**: Sophisticated algorithms that translate graph structure to musical elements



### Advanced Audio Engine

- **Sample-Based Synthesis**: High-quality orchestral samples with realistic articulation

- **Advanced Percussion Engine**: Physics-modeled timpani, mallet instruments, and resonant gongs

- **Electronic Synthesis Suite**: Professional filter modulation, LFO control, and envelope shaping

- **Master Effects Processing**: Orchestral reverb hall, 3-band EQ, and dynamic compression



### Professional Effects & Routing

- **Per-Instrument Effect Chains**: Individual reverb, chorus, and filter processing for each instrument

- **11 Professional Presets**: Optimized effect configurations (Concert Hall, Jazz Club, Cathedral, etc.)

- **Smart Parameter Ranges**: Context-aware effect parameters that adapt to musical content

- **Enhanced Effect Routing**: Advanced signal flow with send/return busses and parallel processing



### Intelligent User Experience

- **Family-Organized Interface**: Instruments grouped by orchestral families for intuitive control

- **Performance Optimization**: Adaptive quality system with voice pooling and CPU monitoring

- **Real-time Audio Feedback**: Visual and auditory feedback during graph playback

- **Comprehensive Settings**: Detailed control over all 34 instruments and their parameters



### 🚀 Production Features



- **Sonic Graph Visualization**: High-performance interactive graph visualization with temporal animation

  - **Instant Loading Performance**: Optimized data processing using Obsidian's MetadataCache infrastructure

  - **Static Graph View**: D3.js force simulation displaying all vault files and connections

  - **Timeline Animation Mode**: Audio-synchronized chronological node appearance with intelligent spacing

  - **Timeline Granularity Controls**: Multi-level time granularity (Year, Month, Week, Day, Hour) with custom ranges

  - **Time Window Filtering**: Focus on specific time periods (All time, Past year, Past month, etc.)

  - **Smart Event Spreading**: Intelligent audio event distribution to prevent crackling from simultaneous triggers

  - **Professional Settings Panel**: Comprehensive configuration with 21+ settings, each with detailed tooltips

  - **Advanced Filtering**: Content exclusion system with native Obsidian autocomplete for folders and files

  - **Performance Optimizations**: Adaptive rendering modes and efficient data structures for large vaults

- **Enhanced Modal Interface**: Full-screen overlay settings panel with smooth transitions and responsive layout

- **Cross-Modal Navigation**: Seamless integration between Sonic Graph and Control Center interfaces



*Sonic Graph now delivers production-ready performance matching Obsidian's core Graph plugin.*



## 📦 Installation



**Recommended:** Install via [BRAT Plugin](https://github.com/TfTHacker/obsidian42-brat)

1. Install the BRAT plugin in Obsidian

2. Use BRAT to install from GitHub: `banisterious/obsidian-sonigraph`

3. Enable Sonigraph in Community Plugins settings



**Manual Installation:** Download the latest release and extract to your vault's plugins folder



---



## Support My Work



If you find this plugin useful, please consider supporting its development!



Buy Me A Coffee



---



## 🎯 Current Status



**Current Version**: 0.11.0 (Production Ready)



✅ **Complete Orchestral Implementation**

- 34 instruments across all orchestral families

- Advanced synthesis engines (percussion physics, electronic modulation)

- Master effects processing with orchestral-grade reverb, EQ, and compression

- Enhanced Effects UI with family organization for 34-instrument management

- Performance optimization with adaptive quality control

- Multiple resolved audio quality issues and stability improvements



## 🎼 Orchestral Instrument Families



### Strings (5 instruments)

- **Violin**, **Cello** - Traditional bowed strings

- **Harp** - Plucked strings with glissando effects

- **Guitar** - Steel-string acoustic with fingerpicking and strumming

- **Strings** - Full orchestral string section



### Woodwinds (4 instruments) 

- **Flute** - Pure tone with breath control

- **Clarinet** - Rich, woody timbre across registers

- **Saxophone** - Jazz-influenced with vibrato and growl

- **Oboe** - Piercing, nasal tone with expressiveness



### Brass (4 instruments)

- **Trumpet** - Brilliant, fanfare-capable lead voice

- **French Horn** - Warm, noble hunting horn character

- **Trombone** - Smooth glissando and powerful projection

- **Tuba** - Foundation bass with deep resonance



### Vocals (7 instruments)

- **Soprano** - High female voice with lyrical purity

- **Alto** - Rich contralto with warm chest tones

- **Tenor** - Male lead voice with heroic quality

- **Bass** - Deep male voice with authoritative presence

- **Choir** - Mixed vocal ensemble

- **Vocal Pads** - Sustained vocal textures

- **Pad** - Ambient vocal synthesis



### Percussion (4 instruments)

- **Timpani** - Tuned kettle drums with pitch bending

- **Xylophone** - Bright mallet percussion with wood resonance

- **Vibraphone** - Metallic bars with motor tremolo

- **Gongs** - Large suspended cymbals with extended resonance



### Electronic (3 instruments)

- **Lead Synth** - Filter-swept lead with modulation

- **Bass Synth** - Sub-oscillator bass with envelope control

- **Arp Synth** - Arpeggiated patterns with sequencing



### Experimental (1 instrument)

- **Whale Song (Humpback)** - Oceanic vocalizations with ultra-long reverb



## 🎛️ Advanced Audio Features



### Master Effects Processing

- **Orchestral Reverb Hall**: Simulated concert hall acoustics with adjustable decay

- **3-Band EQ**: Bass boost, mid-range clarity, and treble enhancement

- **Dynamic Compressor**: Automatic level control for orchestral balance



### Performance Optimization

- **Adaptive Quality System**: Automatically adjusts audio quality based on CPU load

- **Voice Pooling**: Efficient voice management for complex orchestral arrangements  

- **Emergency Performance Mode**: Fallback mode for resource-constrained systems



### Enhanced Effect Routing

- **Per-Instrument Chains**: Individual effect processing for each of 34 instruments

- **Professional Presets**: 11 optimized configurations for different musical styles

- **Smart Parameter Ranges**: Context-aware effect parameters that adapt to content



## 🎯 Musical Mapping System



### Graph-to-Music Translation

- **Nodes → Instruments**: Map vault notes to orchestral instruments based on content analysis

- **Connections → Harmony**: Link relationships create harmonic progressions and chord structures

- **Graph Traversal → Composition**: Different algorithms generate musical sequences through connected notes

- **Node Properties → Articulation**: Tags, metadata, and content influence playing style and dynamics



### Intelligent Sonification

- **Frequency-Based Assignment**: Distribute instruments across pitch ranges for optimal orchestral balance

- **Dynamic Voice Allocation**: Automatic instrument selection based on graph complexity

- **Temporal Mapping**: Connection strength influences note duration and rhythmic patterns

- **Spatial Audio**: Graph layout translates to stereo positioning and reverb characteristics



## 🚀 Getting Started



### Quick Start

1. Install and enable the plugin in Obsidian

2. Open the Audio Control Center from the ribbon or command palette

3. Configure your desired instruments in the family tabs (Strings, Brass, etc.)

4. Adjust effects and presets in the **Master** tab  

5. Play your knowledge graph with the **Play** button



### Audio Control Center Tabs

- **Status**: Real-time system diagnostics and performance monitoring

- **Musical**: Set scales, tempo, and musical parameters

- **Master**: Global controls, master effects, and bulk operations

- **Strings**: String family instruments (violin, cello, guitar, harp, strings)

- **Woodwinds**: Woodwind family (flute, clarinet, saxophone, oboe)

- **Brass**: Brass family (trumpet, french horn, trombone, tuba)

- **Vocals**: Vocal family (choir, soprano, alto, tenor, bass, vocal pads, pad)

- **Percussion**: Percussion family (timpani, xylophone, vibraphone, gongs)

- **Electronic**: Electronic family (lead synth, bass synth, arp synth)

- **Experimental**: Experimental/environmental sounds (whale song)



## 🤝 Contributing



Sonigraph has reached production status with comprehensive orchestral capabilities. Contributions are welcome for:



- New instrument synthesis methods

- Additional effect processing algorithms  

- Enhanced graph-to-music mapping strategies

- Performance optimizations for large vaults

- UI/UX improvements and accessibility features



1. Review the [Development Roadmap](docs/planning/development-roadmap.md) for development roadmap

2. Check the [implementation documentation](docs/architecture/overview.md)  

3. Open an issue or submit a pull request



## 📄 License



MIT License - see [LICENSE](LICENSE) for details.



## 🙏 Acknowledgments



- Built for [Obsidian](https://obsidian.md)

- Audio synthesis powered by [Tone.js](https://tonejs.github.io/)

- Inspired by data sonification and knowledge visualization research



---



**Note**: This plugin is not affiliated with or endorsed by Obsidian.md.