How it works, step by step.
This manual describes version 0.8.0, the version built today. Where something on the Features page arrives in a later version, the manual says which.
Getting started
Freally Unloop runs inside your DAW as a CLAP or VST3 plugin, or as an AU on macOS, and on its own as a standalone app. Put it on the track that plays your loop: until you press Generate it passes the track's audio through exactly as it arrives, so it is safe to leave in place.
Version 0.8.0 works in a DAW, with audio or MIDI, and with no DAW at all: drop stems, one loop or a MIDI loop on the standalone app’s Stems panel. The web app — the same app in a browser tab — is built and tested with every release, and opens to the public with version 1.0.0.
There are no downloads before version 1.0.0, and the source code is private.
The licence agreement
The first time Unloop opens it shows its End User License Agreement, which is written in English. Read it to the end and Agree becomes available.
If you decline, Unloop is paused: nothing is arranged, and your audio still passes through unchanged. Choose Read it again whenever you are ready. Your answer is kept on your computer, for every copy of Unloop on it.
The window
Along the top are the loop project menu (the folder button), the Arrangement menu, the search, the mode, and Undo and Redo; on the right, the tempo, the clock and Settings (the gear). In the middle is the arrangement map: the record's sections, a lane for each part, and its moves. Along the bottom is the console: Generate, a strip for each part, the master section and the seed.
Settings holds the language, the theme — System, Dark or Light — the interface sounds and the list of keyboard shortcuts.
Picking a name
Type in the search to find any of 2,413 artists, producers and genres. Aliases and near misses find them too, and letters such as Ø, ß and Ł fold, so "mo" finds MØ. With the search empty it offers your recent names and the flagship models. Use the arrow keys and Enter, or click.
Each name has a model card: the modes it arranges in and how often each is drawn, its typical song forms, its signature moves, the parts it drives, where its data comes from and how confident it is. A name with little data of its own inherits from its genre, and the card shows the chain.
Generate, modes and seeds
Press Generate and Unloop plans the whole record for the name you picked: every section, which parts play in it, and every move. Choose a mode first — Radio cut, Mixtape cut, Club / DJ cut, Switch-up, Minimal and more, depending on the name — or leave it on Any mode and Unloop draws one.
Every plan has a seed, 16 hexadecimal digits in the console, and each press of Generate draws a new one. The same loop, name, mode and seed always give the same arrangement: copy a seed to keep an arrangement or to send it to a collaborator, and paste one to get it back.
Tempo and the clock
In a DAW, Unloop always plays at your project's tempo and never changes it. The tempo chip says whether your tempo is in the range the name usually works at — counting half and double time as a match — and, if it is not, which tempo to set your DAW to, with a button to copy it. In the standalone app, where there is no DAW, it suggests a tempo for the loop to adhere to instead (Stems mode and tempo adhere, below).
Unloop needs to know how long your loop is: it asks, and assumes 8 bars until you say. The clock follows your DAW's song position, or counts the loops itself when the position does not move — FL Studio's pattern mode, or Ableton Live's session view — so the whole record still plays over a loop going round. Auto decides for you; choose Song or Loop to decide yourself.
One loop, or every part
On one track with a finished stereo loop, Unloop arranges it in three bands — low, mid and high — and the map says so.
For the full set of moves, put an instance on each part's track and give each one a role: drums, bass, melody, chords and so on. Unloop suggests one from the track's name. Instances on the same channel perform one record together: the first conducts, and every other follows its plan to the sample and plays only its own part's moves. The console shows a strip for each, with its fader and lamps.
When your DAW runs plugins in separate processes, instances meet through a shared file on your computer, never the network. If another project's plan is already on a channel, Unloop says so and offers another channel.
Capture and preview
After Generate, each instance captures one cycle of its loop — the music arriving on its track, never its own output — and from then on plays the record from memory. The LIVE / CAPTURED chip says where it stands, with Recapture and Forget capture. A loop longer than 64 seconds cannot be captured, and a stop, a jump or a tempo change during a capture starts it again at the next play.
If the loop coming in is no longer the one captured, the chip asks: Loop changed — recapture? Nothing is replaced while it plays; recapturing is your press.
With your DAW stopped, the play, pause, stop and loop keys in the master section — or the space bar — preview the whole record inside Unloop, every instance on the channel together. Click the map's ruler to jump, or loop a section. Press play in your DAW and it takes over at once.
Stems mode and tempo adhere
The standalone app needs no DAW: its Stems panel, at the left of the window, takes one to eight audio files — stems, or one whole loop — or one MIDI file. Drop them on the panel or choose them. Each file shows the part it plays, how sure Unloop is and why: its name (an "808" is the bass, "hats" are the hats) or, when the name says nothing, its sound — how much of it sits low or high, and whether it is short hits or held notes. Choose another part for any file and your choice wins.
Unloop reads the loop's tempo and length from where the hits fall. A loop that could be 70 or 140 is read at the one inside the range of the name you picked; pin the tempo or the bars when you know better. A shorter file repeats in whole cycles under a longer one. The tempo is exact: a whole number of bars fills the file to the sample.
Here Unloop owns the tempo, so the tempo chip suggests the name's usual tempo — or the nearest in its range when your loop is close — with Adhere, Tape and Keep. Adhere stretches the loop to it and keeps its pitch; Tape speeds it up or slows it down as tape would, pitch and all; Keep goes back to the loop's own tempo. The loop is always exactly its bars at the new tempo, seamless where it goes round, and the same every time. Past 35 % either way the chip warns that the sound will change. Each is one undo step, and the MIDI file carries the tempo the loop now plays at.
One whole loop can be split into its low end, its drums and its music — Split drums from music — so a drop-out on the drums takes out mostly the drums. It is an approximation, and the panel says so. A .unloop or .unarr dropped on the panel opens as its menu item would.
The Loop Doctor
Doctor, in the header, listens to the loop itself and lists what is wrong with it, worst first: a click where the loop goes round, a loop that clips or is very quiet, a tempo read an octave away or not measured at all, or, in a DAW, a capture made at another tempo than the project's. Nothing found reads Clean.
Each finding comes with its fix — crossfade the seam, trim the level, pin the bars or the tempo, capture again — and each fix is one undo step. Your loop file is never changed: the fix is kept with the project and applied as the loop plays.
Print, drag and receipts
PRINT in the master section opens Print & export. Choose what to print — the mix, the stems, any of the parts, a section or the whole record — and the format: WAV (16-bit, 24-bit or 32-bit float), AIFF, FLAC or MP3, at the captured sample rate or one you pick. It renders through the very code that plays live, so the file is what you heard. Cancel leaves nothing behind.
You can dither when the bit depth drops, put a safety limiter at −1 dBTP on the mix, and write receipts. File names come from a template you can edit, and by default no file name carries an artist's or producer's name. When the export is done, the print meter shows the mix's peak, true peak and loudness.
To skip the dialog, use the drag rack: drag the mix, the stems, one part or one section straight onto your tracks. The files are rendered before the drag begins, as 24-bit WAV by default.
A receipt, a small .unloop-receipt.json file, goes beside every export and every drag. It holds the versions, the name, mode and seed, and the fingerprints needed to make the same record again. Receipts are on by default; you can turn them off in the dialog.
Package writes everything one export makes — the mix, the stems, the MIDI song template, the receipt and the arrangement sheet, as text and as a picture — into a folder of its own or one zip; two exports of the same record make the same zip, byte for byte. Print a range of bars, or the bars of the clips you selected. The loop extender writes your loop repeated to the record's length, tagged with its tempo, and the dialog tells you how many times your loop fills the record. Save any setup as a named preset.
Loop projects and the Loop Library
Save loop project… in the loop project menu (the folder button) saves the loop — its parts as 24-bit FLAC — with every arrangement over it, as one .unloop file. Open loop project… brings it back exactly. Saving never overwrites a file: a name that is taken gets (2).
The Loop Library, in the same menu, lists every .unloop project and every WAV, AIFF, FLAC, MP3 and MIDI file in the folders you add, with its bars, tempo, tags and how often it has been arranged. Search and filter it; click a loop to hear it inside Unloop (the arrow keys walk the list, Esc stops), and Arrange it when it is exactly one loop. It only ever reads your folders. MIDI loops are listed now and become arrangeable in version 0.7.0.
Make a loop from a longer file… cuts a loop out of a longer recording: pick a start bar, a length of 1, 2, 4, 8 or 16 bars and the tempo, hear the cut on repeat, then Arrange it as a new loop project. The file itself is never changed.
Recent Projects lists what you opened or saved, newest first. One that has moved shows as missing, and Remove from list takes the row away — never the file.
Editing the timeline
Every clip on the map is yours to edit. Click to select it, Shift-click or drag a marquee for more, or press Ctrl/Cmd+A for all. Drag a clip to move it on the snap (hold Alt to move it freely), drag an edge to resize it — the loop repeats past its length — and Alt-drag inside it to slip it. S splits at the edit cursor.
The clip's menu — right-click, Shift+F10 or the menu key — holds Cut, Copy, Paste, Clone after, Duplicate in place, Delete, Split at the cursor, Reverse, Lock, Reset to plan, Colour and Rename. A clip pasted onto a lane its part cannot go on is offered the lanes it can.
Snap to the bar, the beat, an eighth or a sixteenth note, their triplets, or nothing; zoom in and out, or fit the whole record. Where clips meet, Unloop crossfades them over 3 ms, and with snapping off an edge lands on the loop's nearest zero crossing, so no edit makes a click.
Fades and faders
Each end of a clip has three fade handles, as in Freally MIDI Master's Song Arrangement: the length on the clip's top edge and the curve on the fade itself. They never cross, at any clip length.
Drag a clip's gain handle from −∞ to +6 dB — hold Shift for fine steps, double-click for 0 dB. The console has a fader for each part and a master fader. Every move is heard while you drag, and is one undo step when you let go.
The console's faders work like every Freally app's: from −96 dB to +6 dB, even in decibels, 0.1 dB a step, the whole range over 200 pixels — hold Shift for a quarter of that. Double-click or Alt-click a fader for 0 dB; on the keyboard, Page Up and Page Down move it a tenth of the way, Home sends it to the floor and End to the top. The number under a fader is what you set; the meter beside it shows what plays — green below −12 dBFS, yellow to −3, red above — and its clip light stays on until you click it.
Automation
Open Automation, pick a part and what to move, add a lane and draw on it. Each part has lanes for volume, pan, width, low-pass and high-pass cutoff, resonance, reverb and delay sends, drive, crush, gate depth and pitch; the master has volume and a low-pass.
Draw points, or select and move them; bend the line between two; stamp a shape over a range — a ramp, an S-curve, a sine, triangle, square or saw, or random steps — and copy and paste a range. A move's own sweep or dive can be edited on the lane it plays. Automation is read sample by sample, live and in a print alike.
Sections
Open a section's menu from its header, or press M, to rename it, change its kind or its length, move it earlier or later, insert a new section before or after it, remove it or lock it. You can also drag a section to reorder it: everything in it goes with it.
Lock, reroll and moves by hand
Lock a section or a clip you like, and Reroll draws the rest again. It never touches a locked section or a clip you edited, and never moves a neighbour. What changed then lists every part and move it changed, section by section.
Add move opens a palette of every move, this arrangement's own first: place one on the moves strip, then drag, stretch or delete it. Select a move to open its inspector — its start, its length, its parts and its own settings, such as a filter's range or a stutter's steps — and Audition it while the preview plays.
Undo, redo and autosave
Every change in the Song Arrangement view is one step of unlimited undo and redo. The Undo and Redo buttons at the top name the step, or press Ctrl/Cmd+Z and Ctrl/Cmd+Shift+Z (or Ctrl+Y). The history is saved with your DAW project.
Every change is also written to your computer at once, so if your DAW closes before you save, the project reopens on your last change and says so. If that change was really another copy's — an older project reopened after Save As — choose Keep the saved version.
Many arrangements on one loop
The Arrangement menu holds every arrangement of the loop you have open: New, Duplicate, Rename, Delete, Switch — on the next bar while playing, at once when stopped — and Compare, an A/B between any two. Each arrangement keeps four snapshots, A to D: click one to recall it, or Shift-click to keep the arrangement there.
Export arrangement… writes one arrangement as an .unarr file, without its loop. Import arrangement… lays one over the loop you have open, finding each section, clip, move and lane by what it is, and lists anything that had no place.
The MIDI view and the Velocity Doctor
Press MIDI in the header to see the arrangement as notes: each clip on the timeline shows the notes its part plays, and every handle in the drag rack — the mix, a part, a section — now carries a MIDI file instead of audio. Press it again for the audio. The toggle changes only what you see and drag: no clip, section, fade or marker moves, and nothing joins your undo history.
The notes come from your loop. Unloop reads each captured part as notes with Freally MIDI Master's audio-to-MIDI road — classic signal analysis, no AI — while your DAW keeps working. The MIDI panel lists every part and why it was read as it was (on the drum channel, plays like a kit, the lowest voice, split by pitch…), and says plainly what the road cannot do: it writes no counter-melody from audio, a sung line is not written as notes, chords are spelled plainly, and a hit hidden under a louder one is lost.
If you have the loop as MIDI, drop the .mid file on the MIDI panel, or choose it there: its notes are used for this part instead, split exactly as Freally MIDI Master splits a file. It is kept with your project and never changed on disk. A MIDI loop can be at most 40 KB; Forget the MIDI loop goes back to the notes read from the capture.
Dragging the mix gives one MIDI file for the whole song: a track for each part, named after it, with drums on channel 10, the tempo, and a marker at every section. Each clip's notes follow its slip, repeat and reverse. A mute, drop-out or cut takes notes out, a stutter or roll repeats them, half-time stretches them, and filters, volume, pan and sends become controllers. A move MIDI cannot say — a rewind, a reverse, lo-fi — becomes a marker in the file and has a badge on the map; a tape stop or a pitch dive becomes a pitch bend and a marker. The same seed always gives the same file.
The Velocity Doctor sets each part's velocities to the right kind: drums Tiered — every hit classed as an accent, a main or a ghost, then placed in its band (100–127, 76–89 and 38–51 unless the model says otherwise) — bass and 808 Fixed at 127, chords Flat at 96 with the top voice 6 louder, a melody Contoured into its band with a phrase arch, and a counter-melody 12 lower. Measured keeps the notes' own velocities, and Artist feel uses the model's. Each change is one undo step, and no ghost in a lane is ever louder than a main. Fades in MIDI scales the velocities along each fade, or, if you choose, writes it as expression (CC11).
Keyboard shortcuts
Every edit in the Song Arrangement view works without a mouse. In Unloop, press ? for this sheet; on a Mac, Ctrl/⌘ is ⌘.
Everywhere
| Undo | Ctrl/⌘+Z |
| Redo | Ctrl/⌘+Shift+Z or Ctrl+Y |
| Show this sheet | ? |
| Play or pause the preview while your DAW is stopped | Space |
| Close a dialog, a card or a panel | Escape |
Song Arrangement view
| Select the next clip | ] |
| Select the previous clip | [ |
| Select the clip on the lane above | Alt+↑ |
| Select the clip on the lane below | Alt+↓ |
| Select every clip | Ctrl/⌘+A |
| Select nothing, or let go of a drag | Escape |
| Move the selected clips earlier by the snap | ← |
| Move the selected clips later by the snap | → |
| Move the selected clips to the lane above | ↑ |
| Move the selected clips to the lane below | ↓ |
| Shorten the clip from its end | Shift+← |
| Lengthen the clip at its end | Shift+→ |
| Lengthen the clip at its start | Alt+Shift+← |
| Shorten the clip from its start | Alt+Shift+→ |
| Raise the clips’ gain | = or + |
| Lower the clips’ gain | - |
| Move the edit cursor earlier | , |
| Move the edit cursor later | . |
| Split at the edit cursor | S |
| Hold the clip’s fade handles | F |
| Reverse the selected clips | R |
| Lock or unlock the selected clips | L |
| Copy the selected clips | Ctrl/⌘+C |
| Cut the selected clips | Ctrl/⌘+X |
| Paste at the edit cursor | Ctrl/⌘+V |
| Clone after the selection | Ctrl/⌘+D |
| Duplicate in place | Shift+D |
| Delete the selected clips, or the picked move | Delete or Backspace |
| Open the clip’s menu | Shift+F10 or ContextMenu |
| Open the section’s menu | M |
While holding fade handles
| Lengthen the fade by the snap | → |
| Shorten the fade by the snap | ← |
| Bend the fade’s curve up | ↑ |
| Bend the fade’s curve down | ↓ |
| Switch to the other fade | Tab |
| Let go of the fade handles | Escape or F |
On a fader
| Raise the fader a step | ↑ or → |
| Lower the fader a step | ↓ or ← |
| Raise the fader a tenth of its travel | PageUp |
| Lower the fader a tenth of its travel | PageDown |
| Fader to the top | End |
| Fader off | Home |
On an automation lane
| Delete the picked points | Delete or Backspace |
| Let go of a drag | Escape |
In the search
| Next result | ↓ |
| Previous result | ↑ |
| Choose the result | Enter |
| Close the results | Escape |
In a menu
| Next item | ↓ |
| Previous item | ↑ |
| Close the menu | Escape |
Interface sounds and the title bar
Opening or closing Settings, a menu or a dialog, and showing or hiding the Loop Library, each makes a short sound — the same sounds in every Freally app — that lasts exactly as long as the move on screen. They play through Unloop's own output in your DAW, never into your record: not into a Print, a capture, a stem, a drag or an offline bounce. In Settings you can switch them off, set their level, or keep Quiet while playing on (it is on to start with), so they stay silent while your DAW or the preview plays. With reduced motion turned on in your system, nothing moves and a short tick plays instead.
In the standalone app the title bar follows the theme — dark in the dark theme, light in the light one — and carries no title, because the turning name at the top of the window is the title. Inside a DAW the plugin's window belongs to the DAW and keeps its title.
Themes, controls and motion
Unloop has two themes, dark and light, on Freally green; in Settings choose Dark, Light or System, which follows your computer. Its faders, knob and meters, the GENERATE, REROLL and PRINT keys, and the sliders and switches are the Freally family's — the same controls as Freally Flipcopy, rendered for each theme — so every Freally app looks and presses the same.
In Settings, Motion has two choices. Speed: Quick turns the name at the top twice as fast. Reduced motion: Reduce lays the name flat and stills every animation; Follow the system does the same whenever your computer asks for less motion.
Languages
Unloop speaks eighteen languages. It starts in your system's language; to choose another, open Settings with the gear and pick one.
The web app
The web app is Freally Unloop in a browser tab: the same code, compiled to WebAssembly, with Stems mode, tempo adhere, the Loop Doctor, preview and every export. Nothing you drop is uploaded — it never leaves your computer — and once the page has loaded it asks nothing of the network; after one visit it works offline.
Exports and saved projects arrive as downloads. To open a .unloop project or an .unarr arrangement, drop it on the Stems panel or choose it from the menu. Your browser keeps your answer to the licence agreement, and nothing else. A current Chrome, Edge, Firefox or Safari runs it, opened over https.
The web app is built and tested with every release, and opens to the public with version 1.0.0.
Privacy and the network
Unloop has no account and no telemetry, and the plugin and the standalone app contain no networking code at all. Your loops, your projects and your records never leave your computer, and a loop, a project or an export folder on a network drive is refused before anything on it is touched. The web app uploads nothing and makes no request once it has loaded.
It keeps its own files in your app-data folder (%APPDATA%\Freally Unloop on Windows): the licence answer, your preferences, Recent Projects, the Loop Library's index, the capture cache (at most 2 GB) and the files instances meet through. It never writes into your loop folders; exports and projects go where you choose.
It contains no AI of any kind: every arrangement is planned by deterministic rules over researched arrangement data and performed by classic signal processing, and a build gate fails if a machine-learning library is ever added.
Reporting a problem
When Unloop itself fails — it could not write one of its own files, an export or a drag went wrong, a loop it should read could not be read, or the window crashed — the error has a Report button. It opens the report page in your browser with the facts already filled in: where it failed, the version and your system, signed so they cannot be changed. You add what happened, and nothing is sent until you press Send there. Unloop itself sends nothing.
If Unloop crashed, the next time it opens it offers to report it once; Dismiss forgets it. An error that only says no to something you asked — a name that cannot be a file, a folder that is not there — has no Report button. Only release builds can make a report.
Known limitations
- A loop's key is not read yet, so default file names leave the key out.
- A drag shows no picture of what you are dragging yet.
- A reverb or delay throw on the last bar is cut at the record's last bar line; the print does not ring on past it.
- On a second monitor at another display scale, the editor sizes itself from the primary display.
- In the web app, the preview pauses while an export is printed.
- Split drums from music is an approximation: some of the drums stay in the music, and some of the music in the drums.
- Unloop has not yet been worked through by hand in every DAW, on every system. That is the release candidate's job, before 1.0.0.