Todo

Release notes

Alpha 3 release notes:
Mix View device:
- GL button removed (screenshots in the doc will be updated for Beta release)
- preview inside device is limited to 25 FPS (12.5 FPS on Windows), (FPS in pop window and stream output is unaffected)

Alpha 7 release notes:
- cross device communication optimization
- reduced preview inside Mix View device on Windows to 8 FPS

Alpha 10 release notes:
Mix View
- `[...]` button replaced with `[<]` and `[>]` buttons

Alpha 11 release notes:
All
- Push support

Mix View
- fixed mixing sliders 

Mix View + IN Mix
- Mix OUT, IN Mix: renamed buttons from numbers 1-9 to letters A-Z

DEV Info, DEV Console
- smaller device width

Alpha 13 release notes:
Mix Grid
- new device

Mix View
- more blend modes + color modes
- alpha, view fit, swap and OKLAB support
- consistent initial popup size
- improved UI look for smaller popup size
- known issue: demo set "Using Feedback" not showing preview inside device on Windows (pop works) 

Mix Dry
- more blend modes + color modes
- alpha, view fit, swap and OKLAB support

IN Video
- fixed play buton (cosmetic) state

Alpha 17 release notes:
Mix View
- added UI, Full, Bare options as a workaround for multi-monitor setup especially with different DPI which does not work well with the UI option
- fixed dimension change for hidden preview
- fixed UI for Max 9.1.0 although there might other issues so it's better to stay on bundled 9.0.7
- added fullscreen <key>ESC<key> support

Alpha 18 release notes:
Mini Shader
- added support for `#include` directive and [Lygia Shader Library](https://lygia.xyz/) (bundled in `assets/lib/lygia`), see examples `X.Lygia.01` to `18`

Rec
- fixed video recording (Thanks (@SenPi)[https://discord.com/channels/1329379539708805193/1329379539708805196/1436424813731123311])

Sync & Follow
- fixed 3rd modulation weight not applied (was always 50%)
- fixed session restoring selected modulated parameter
- increased weight resolution (from 1% to 0.01%)

Mix View
- cosmetic fix of instant recording

Demo sets
- added `Sync.als` 
- added `Simple Set.als`
`

```text
Alpha 19 release notes:
Mini Shader
- added support for input texture (repurposed backbuffer b variable)
- added FX shader examples (X.02 FX Invert, X.Lygia.21 FX ... X.Lygia.25 FX)

Shader
- added support for `#include` directive and [Lygia Shader Library](https://lygia.xyz/) (bundled in `assets/lib/lygia`), see examples `X.Lygia.01` to `02`
- changed bool param rounding (works better with modulation now) 
- added shaders
- fixed audiofft used instead of audioFFT
- fixed MIDI data update
- fixed error on empty ISF inputs

MIDI Route
- reduced MIDI data indicator overhead
``

```text
Alpha 22 release notes:
All
- updated to Max 9.0.8 (bundled in Live 12.2.7 )

Shader
- removed unused `Audio Fft` parameter (regression caused by previous update)
- added shaders - showing usage of `#include` directive with Lygia and custom shader libraries in ISF shaders

Demo
- `Retro O Vis.als` demo [youtu.be/XsXSijTUIKI](https://youtu.be/XsXSijTUIKI)
- `Retro Vis.als` demo [youtu.be/7piqR-xdgHY](https://youtu.be/7piqR-xdgHY)
- `X.Darosh.06 Retro Roll.fs` shader [youtu.be/4xlyQeEKm5U](https://youtu.be/4xlyQeEKm5U)

Alpha 23 release notes:
Mix View
- fixed MIX OUT not streaming on session open (Thanks [@_Mote_ of Discord](https://discord.com/channels/1329379539708805193/1329379539708805196/1440322236392411228))

Shader
- added support for `long` parameter
- added shaders

Licencing

check mini shaders licences
check processing licences
- CC BY https://x.com/SnowEsamosc/status/1971220103070130586
- https://x.com/yuruyurau/status/1719632742269514103

Hi,

I would love to include your shaders in my open source VJ toolkit for Ableton Live: https://github.com/darosh/px-stream

Currently, it's included in the assets/mini-shaders folder with a link to the original post and marked as "license pending clarification" in assets/LICENSE.md.

The project is dual-licensed MIT/CC-BY. I can work with any open license you prefer (CC0, CC-BY, CC-BY-NC-SA, etc.) - or if you'd prefer, I'll remove it immediately.

The shaders are dynamically loaded and user-editable, so people can learn from and tweak your code while creating visuals for their music.

Would you be okay with this? Let me know your preferred license or if you have any concerns.

Best regards,
Jan

Hi,

I would love to include your Processing sketches in my open source VJ toolkit for Ableton Live: https://github.com/darosh/px-stream

Currently, it's included in the assets/sketches folder with a link to the original post and marked as "license pending clarification" in assets/LICENSE.md.

The project is dual-licensed MIT/CC-BY. I can work with any open license you prefer (CC0, CC-BY, CC-BY-NC-SA, etc.) - or if you'd prefer, I'll remove it immediately.

The sketches are dynamically loaded and user-editable, so people can learn from and tweak your code while creating visuals for their music.

Would you be okay with this? Let me know your preferred license or if you have any concerns.

Best regards,
Jan

Hi! Can I include it in my open source VJ toolkit https://github.com/darosh/px-stream ? It's in assets/mini-shaders with link to post, marked "license pending." Any open license works (CC0/BY/BY-NC) or I'll remove it. Thank you!

Hi! Can I include it in my open source VJ toolkit https://github.com/darosh/px-stream ? It's in assets/sketches with link to post, marked "license pending." Any open license works (CC0/BY/BY-NC) or I'll remove it. Thank you!

ISF

Windows

Final checklist

From m4l-production-guidelines

Here is a checklist to recap the topics of this guide that can be tested, which you can use for Quality Assurance purposes for your device.

General

Error messages: There are no prints in the Max Console on load.
Undo History: After adding the device, there is only one new undo.
Undo History: Live's undo menu is never ‘flooded’.
Freezing: The device is frozen if it contains dependencies.
Presets: The device comes with a collection of presets.

Audio and MIDI

Clicks: There are no unintended audio clicks, when changing parameter values or otherwise.
Sample rate consistency: Everything continues to work and sound the same when changing the sample rate in Live's preferences.
Render consistency: The device sounds identical on playback, on a frozen track, and on rendering an audio file.
MPE: MIDI devices support MPE (is_mpe is set to active).
Latency: The device plays in sync with the rest of the Live Set.
MIDI Mapping: The main device parameters can be mapped to a MIDI controller.
MIDI Tools: Random number generators (e.g. random objects) in between live.miditool.in and live.miditool.out must be reset using a seed value before being triggered. The seed value used should only change as a result of user input. This ensures a deterministic output when live.miditool.in is repeatedly triggered by Live.

Live themes: All UI objects have theme-following colors, checked with all color themes.
Disabling: The UI colors are correct when the device is disabled.
Positioning: The left-most element in presentation mode is as far from the left side of the device as the right-most element is from the right side.
Default initialization: Colors and texts that are changed dynamically are saved in their default state to prevent a color or content flash after loading a new instance of the device.
Font consistency: All UI fonts are set to Live's font.
Tab stops: Comments don't include any tab stops. The result will look different per OS.
Device width: The device does not take up too much of the horizontal space in the Device view.
Device width: If the device can dynamically change its size, make sure the device's custom width setting matches its initial width.

Parameters

Note: many of these things can be checked and changed in the View > Parameters window.

Robustness

CPU Load: The device does not cause unexpectedly high CPU load in the context of a Live Set.
Version support: The device runs well with all Live and Max versions starting from the lowest versions set in the device.
Platform support: Ideally macOS, Windows and Push 3 Standalone all host the device well.
Independence: Multiple instances of the device run well simultaneously.
Testing: The device is tested by one or more people besides the device developer.

For new versions of existing devices

Name consistency: The parameter names are the same as the old version.
- Take special care of auto-indexed names when there are parameters in abstractions (also in bpatchers) that are instantiated multiple times.
Value recall: Parameter values stored in a Live Set with an old version of the device are all recalled properly.
API ID recall: Persistent ids stored in a Live Set with an old version of the device are all recalled properly.

Push mapping

Socials

Done

progress: bad number
int: bad number
tex1: bad number
jit_position: bad number
progress: bad number
direction: bad number
progress: bad number
type: bad number
ReverseEffect: bad number
tex1: bad number
textureMatrix1: bad number
FadeInSecond: bad number
textureMatrix1: bad number
FadeInSecond: bad number
u_transitionUpToDown: bad number

Performance

Mac M1 Pro

Refresh rate: Pro Motion
Sample rate: 48000
Set: PX Stream.als, 1280x720

Buffer size	FPS Limit	FPS	Note
2048	0	106
1024	0	114
512	0	117
256	0	119
128	0	119
64	0	120
32	0	120

Windows 11, Radeon RX 5700 XT

Refresh rate: 120 Hz
Sample rate: 48000
Set: PX Stream.als, 1280x720

Buffer size	FPS Limit	FPS	Note
2048	60	42
1024	60	52
512	90	85
256	90	88
128	120	120
64	120	120
32	120	120	† Unresponsive

† Max devices and Live become unresponsive

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Todo

Release notes

Licencing

ISF

Windows

Final checklist

Push mapping

Socials

Done

Performance

Mac M1 Pro

Windows 11, Radeon RX 5700 XT

FilesExpand file tree

TODO.md

Latest commit

History

TODO.md

File metadata and controls

Todo

Release notes

Licencing

ISF

Windows

Final checklist

Push mapping

Socials

Done

Performance

Mac M1 Pro

Windows 11, Radeon RX 5700 XT