Juggling Engine

Siteswap types

• Vanilla / asynchronous: one throw per beat.
  3 441 b97531
• Synchronous: paired throws written with parentheses.
  (4,4) (8,6x)*
• Multiplex: more than one object released together, written with brackets.
  [43]23
• Hybrid / mixed forms: combine sync, crossings, multiplexes and transitions.
  ([8x4],2)*

Click any example to load it and start the animation.

Multi-rhythm notation (MRN)

MRN lets you describe patterns where the two hands do not always throw on the same rhythm. The ! separator marks beat groups with their own timing.

Click any example to load it, start the animation, and close this window.

Main controls

• Siteswap: type the pattern you want to animate.
• Outside Throws: choose which beats should throw on the outside path.
• Allow Impulse: adds body momentum to the toss.
• Allow Spins: lets compatible 2 and 0 throws trigger spins.
• Speed: increases or decreases the animation speed.
• TPS: increases or decreases how many throws are executed each second.

Generator panels

• Siteswap Generator: searches patterns from the selected state and filters.
• Transition Generator: finds ways to move from one siteswap to another.
• Graph Generator: explores state graphs and reachable transitions.

How to read notation

• Higher numbers usually mean higher or longer throws.
• x marks a crossing throw to the other hand.
• Letters continue values above 9, so a = 10, b = 11, and so on.
• * repeats the mirrored half of a synchronous pattern.

What this panel does

The Siteswap Generator searches for valid patterns that match the template and filters you set, then lets you preview, animate, add, or export the results.

It works with vanilla / asynchronous, synchronous, multiplex, and mixed siteswaps.

It does not work with MRN and it also does not generate prime siteswaps.

To explore prime asynchronous and prime synchronous siteswaps, use the Graph Generator modes SGen by Statepattern or SGen by Siteswap.

Recommended workflow

• Start with a broad template such as ???? or 5??.
• Set the number of Objects.
• Optionally set a Base siteswap as the reference used to determine whether generated results are ground or excited relative to it.
• Use height limits and exclusions to narrow the results.
• Click Generate, then click a result to send it to the simulator.
• For an excited result, click its state pill to preview or select transition throws between the base siteswap and that result.

Field: Siteswap

Use this field as a search template: keep the throws you know, and use ? where the generator should fill in a throw.

For asynchronous patterns, ? means any valid throw and ?s means the marked positions must match.

For synchronous patterns, use ? for any throw, ?x for crossing, ?i for same-hand, and ?s, ?xs, or ?is when the marked throws must be equal.

Field: Objects

Sets the average number of objects in each generated result. For example, 3 searches for 3-object patterns, 5 searches for 5-object patterns, and so on.

Field: Base siteswap

Sets the reference siteswap used to determine whether each generated result is ground or excited relative to it. This is what tells the generator whether transition throws are needed between the generated siteswap and the base siteswap to form a complete sequence.

Field: Expressions to exclude

Remove unwanted results by listing fragments or expressions separated by ;. This is useful for filtering out throws, structures, or whole families of patterns you do not want in the output.

• Exclude 0 to avoid holds.
• Exclude 2 to avoid non-crossing carry-style beats; 2x still remains allowed.
• Exclude x to keep only non-crossing patterns when that fits your search.

Fields: Minimum and maximum height

Restrict the throw values allowed in the generated results. Lower ranges keep patterns more compact and quicker; higher ranges allow taller, more spread-out patterns.

Results list

• Click a result: sends it to the Controls panel and starts the animation.
• Download (⬐): exports the generated list as a text file.
• Filter pill (all → ground → excited): cycles through the result filter. all shows every result, ground shows only results in the same state as the base siteswap, and excited shows only results that need transition throws.
• State toggle pill: shows or hides the state pattern shown under each result.
• State badge: shows whether the result is grounded (same state as the base siteswap) or excited (different state, so transition throws are needed).

Useful search ideas

• Start with short templates, then tighten the filters.
• Keep the height range narrow to reduce very large result sets.
• Use a familiar base siteswap as the reference when checking whether generated results need transitions to connect back to it.
• Combine fixed throws and ? to guide the generator without overconstraining it.