sd-parseq  by rewbs

Parameter sequencer for Stable Diffusion, extending Deforum/A1111

created 2 years ago
379 stars

Top 76.2% on sourcepulse

GitHubView on GitHub
Project Summary

Parseq is a parameter sequencer designed for the Deforum extension of the Stable Diffusion Web UI, enabling users to create complex animations with fine-grained control over various generation parameters. It targets users who need to synchronize visual elements with audio or create intricate temporal parameter changes, offering a powerful, scriptable interface for animation sequencing.

How It Works

Parseq operates as a front-end application, storing state in the browser's local storage by default. It utilizes a keyframe grid where users define parameter values at specific points in time. Crucially, it allows for scriptable interpolation between these keyframes using a rich expression language. This language supports mathematical operations, context variables (like frame number, beats, seconds), built-in functions (oscillators, noise, math), and even JavaScript math functions, providing immense flexibility in defining parameter evolution.

Quick Start & Requirements

  • Installation: Install the Deforum extension for AUTOMATIC1111's Stable Diffusion Web UI. Parseq will appear as a section within the Deforum extension's Init tab.
  • Prerequisites: A working installation of AUTOMATIC1111's Stable Diffusion Web UI.
  • Usage: Create parameter sequences at https://sd-parseq.web.app/, copy the output JSON or URL, and paste it into the Parseq section of the Deforum extension.
  • Documentation: Tutorials and examples are available in the README and linked on the project wiki.

Highlighted Details

  • Scriptable Interpolation: Advanced control over parameter changes using a powerful expression language with custom functions, oscillators, and noise generators.
  • Audio Synchronization: Features for syncing animations to audio, including event detection, pitch/amplitude extraction into time series, and beat/second-based keyframing.
  • Prompt Manipulation: Dynamic prompt generation and modification using expressions, including conditional logic and weighted prompt blending.
  • Camera Movement Preview: An experimental feature to visualize 3D camera movements in real-time.

Maintenance & Community

The project is actively maintained by rewbs, with significant community support acknowledged via Patreon and contributions. A Discord server is available for community interaction and feedback.

Licensing & Compatibility

The project is licensed under the MIT License, permitting commercial use and integration with closed-source projects.

Limitations & Caveats

The camera movement preview is experimental and may not perfectly match Deforum's rendering. Seed travelling is limited to interpolating between adjacent seeds due to the use of fractional seeds. The graph view becomes uneditable when displaying over 1000 frames, requiring zooming to edit.

Health Check
Last commit

1 year ago

Responsiveness

1 week

Pull Requests (30d)
0
Issues (30d)
0
Star History
5 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.