explaingit

bennjordan/kirlianorbits_win64

Analysis updated 2026-05-18

39PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A circular MIDI sequencer where notes orbit a spinning ring instead of a straight timeline, with bendable curves, custom scales, and range based randomization.

Mindmap

mindmap
  root((Kirlian Orbits))
    What it does
      Circular MIDI sequencing
      Bezier arm warping
      Generative note ranges
    Tech stack
      Python
      Pygame
      Mido and python-rtmidi
      Tkinter
    Use cases
      Live MIDI performance
      Experimental sequencing
      Scale locked composition
    Audience
      Musicians
      DJs
      Hobbyist coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Sequence MIDI notes on a spinning ring instead of a linear timeline for live performance.

USE CASE 2

Generate semi-random melodic variation using min and max ranges on pitch, velocity, or gate length.

USE CASE 3

Lock composition to one of 22 built in scales and a chosen key.

What is it built with?

PythonPygameMidopython-rtmidiTkinterPyInstaller

How does it compare?

bennjordan/kirlianorbits_win64aa2448208027-code/localaihotswapamapvoice/pilottts
Stars393939
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Python 3.12+, a MIDI setup, and possibly Windows C++ Build Tools for the python-rtmidi dependency.

Use, share, copy and modify freely for non-commercial purposes only, as long as you give credit.

In plain English

Kirlian Orbits is a circular MIDI sequencer, a music tool where notes travel around a spinning ring instead of sitting on a straight timeline. The idea came from watching the spinning discs of a DJ turntable and wanting a more flexible, computer based way to turn circular motion into musical triggers. The author notes that circular sequencers are not a new concept, tracing back to a 1959 device called the Circle Machine, but built this version because existing tools did not quite fit their needs. The program lets you grab and bend a spinning arm into custom curves while it keeps rotating, with the math adjusting so your mouse movements still feel natural. Notes orbit the center at their own speeds, either as a percentage of the master tempo or synced to simple clock divisions, and they trigger sounds with timing that stays accurate no matter how fast the ring spins or which direction it turns. A generative mode can turn a single note setting, such as pitch or volume, into a range so the program picks a random value within your chosen boundaries each time. It also includes 22 musical scales, from common Western scales to less common ones, plus a way to lock in a specific key so notes stay in tune. Sessions can be saved and reloaded with standard keyboard shortcuts, and a built in diagnostics panel shows live MIDI activity and flags if another program is interfering with your MIDI ports. The project is licensed under Creative Commons Attribution NonCommercial 4.0, meaning it can be used, shared, copied, and modified for free as long as credit is given and it is not sold or used commercially. Running it from source needs Python 3.12 or newer plus a few packages, after which a single command starts the program. A separate script can bundle everything into one standalone Windows executable. The author also offers a prebuilt executable through a paid Patreon tier, explaining that this is meant to limit unofficial redistribution rather than to charge users. The README states there is no ongoing support, and that a local AI model was used to help build the Windows interface.

Copy-paste prompts

Prompt 1
Help me set up Python 3.12 and install pygame, mido, and python-rtmidi to run main.py.
Prompt 2
Walk me through building a standalone Windows exe using build_exe.py and PyInstaller.
Prompt 3
Explain how the relative polar coordinate collision math keeps note triggers accurate at any spin speed.
Prompt 4
Show me how to use Range Mode to randomize pitch between two values.

Frequently asked questions

What is kirlianorbits_win64?

A circular MIDI sequencer where notes orbit a spinning ring instead of a straight timeline, with bendable curves, custom scales, and range based randomization.

What language is kirlianorbits_win64 written in?

Mainly Python. The stack also includes Python, Pygame, Mido.

What license does kirlianorbits_win64 use?

Use, share, copy and modify freely for non-commercial purposes only, as long as you give credit.

How hard is kirlianorbits_win64 to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is kirlianorbits_win64 for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.