Monorepo for Aesthetic.Computer
aesthetic.computer
1# Ableton Live Session Viewer - Blessed Edition
2
3## 🎯 Overview
4
5This is an upgraded version of the Ableton Live Session Viewer that uses the **blessed** TUI library for smooth, professional terminal rendering without flickering.
6
7## ✨ Key Improvements
8
9### ✅ Fixed Issues from Original Version
10- **No more flickering** - Uses blessed's efficient screen update system
11- **Complete track labeling** - All tracks have proper labels and headers
12- **Better layout management** - Professional boxed interface with organized sections
13- **Smooth real-time updates** - Stable rendering without screen artifacts
14
15### 🎛️ Interface Layout
16```
17┌─── Header: Title, Play Status, Beat Counter, Active Clips ───┐
18│ │
19├─── Session Grid (75%) ───┬─── Track Activity (25%) ─────────┤
20│ Track headers │ Individual track level meters │
21│ 8x16 clip grid │ Real-time activity monitoring │
22│ Color-coded clip states │ Track name + percentage │
23│ │ │
24├─── Aggregate Output ─────┴─────────────────────────────────┤
25│ Master level visualization │
26│ Overall system activity │
27├─── Controls ────────────────────────────────────────────────┤
28│ Interactive key bindings and help text │
29└─────────────────────────────────────────────────────────────┘
30```
31
32## 🚀 Usage
33
34### Quick Start
35```bash
36# One-command launcher
37./session
38
39# Or run directly
40node ableton-session-viewer-blessed.mjs [path-to-xml]
41```
42
43### Interactive Controls
44- **SPACE** - Play/pause transport
45- **1-8** - Trigger scene rows (launches clips in that row)
46- **T** - Random clip triggering
47- **R** - Reset all activity
48- **Q/ESC** - Quit application
49
50## 🎨 Visual Features
51
52### Clip State Visualization
53- `[░░░]` - Empty clip slot (gray)
54- `[▁▁▁]` - Low activity (gray, 0-25%)
55- `[▃▃▃]` - Medium activity (yellow, 25-50%)
56- `[▅▅▅]` - High activity (green, 50-75%)
57- `[███]` - Maximum activity (red, 75-100%)
58
59### Track Activity Meters
60- 20-character progress bars
61- Color-coded intensity levels
62- Real-time percentage display
63- Individual track monitoring
64
65### Aggregate Output
66- Master level visualization
67- System-wide activity aggregation
68- Color-coded intensity levels
69
70## 🔧 Technical Architecture
71
72### Blessed TUI Components
73- **Screen** - Main terminal interface manager
74- **Boxes** - Bordered containers for each interface section
75- **Efficient Rendering** - Only updates changed content
76- **Proper Layout** - Responsive boxed design
77
78### XML Parser Enhancements
79- Supports `GroupTrack`, `AudioTrack`, `MidiTrack`
80- Handles `ClipSlot` and `GroupTrackSlot`
81- Parses `EffectiveName` for track labels
82- Robust clip detection and metadata extraction
83
84### Real-time Updates
85- 100ms update intervals
86- Activity decay simulation
87- Random activity spikes
88- Smooth transport simulation
89
90## 📁 Files
91
92- `ableton-session-viewer-blessed.mjs` - Main blessed-based application
93- `session` - Simple launcher script
94- `BLESSED-SESSION-README.md` - This documentation
95
96## 🎵 Data Flow
97
98```
99Ableton XML → SaxesParser → Track/Clip Data → Blessed UI → Interactive Session View
100```
101
1021. **Parse** - Extract tracks, clips, and metadata from XML
1032. **Visualize** - Render session grid with blessed components
1043. **Interact** - Respond to user input for clip triggering
1054. **Update** - Real-time activity simulation and display
106
107## 🌟 Benefits
108
109- **Professional appearance** - Clean, stable interface
110- **Better usability** - Clear track labels and organized layout
111- **Smooth performance** - No flickering or visual artifacts
112- **Enhanced interactivity** - Responsive controls and feedback
113- **Scalable design** - Handles multiple tracks and complex sessions
114
115This blessed edition provides the stable, professional session view visualization you requested!