Atomiix is a re-implementation of the Ixi lang live-coding environment.
The documentation already assumes some knowledge of Ixi lang, and needs to be greatly improved.
There are also bugs, though things are about at the stage where it's usable and hopefully useful.
Atomiix has two parts, the audio engine written in SuperCollider and the Atom editor plug-in.
Installing SuperCollider should just involve going to the Download page on the website, downloading the most recent version for your platform, and then running the installer. The SC3 Plugins extension is required, but the instructions for that are pretty simple and can be found on the project repository. Once that's done, open the SuperCollider IDE and run the following code to use the Quarks tool and install the atomiix quark.
Quarks.install("https://github.com/rumblesan/atomiix.quark.git")
To install the editor, first download and install Atom and then the atomiix package.
By default, Atomiix will expect the default samples and letter mappings to be in the ~/atomiix/default folder. The easiest way to set this up is to download the default-project file from the releases page and unzip it into your home directory. It's also possible to change the default project directory by changing the settings in the Atom plugin.
There is also support for custom projects. If the *.ixi file that you load in atom is in a folder containing a file called atomiix.project then Atomiix will check for a samples folder, a keyMapping.yaml file and a synthdefs.scd file and load these if they exist.
It's possibly worth disabling the bracket-matcher plug-in in Atom so that it doesn't add in extra closing parentheses when changing the volume of an agent. This can be done from the Atom -> Preferences -> Packages menu.
To use Atomiix, start up the audio engine by running the following in the SuperCollider IDE.
Atomiix.setup(57120, 57121);
Create a file in Atom with the .ixi extension.
From the Atomiix sub menu in the Packages menu in Atom, click Start Atomiix.
To evaluate code, any of the following key combinations can be used :-
- Ctrl-Enter
- Alt-Up
- Alt-Right
Alt-Left can be used to evaluate lines and free the agents on those lines.
There are a number of differences between Atomiix and the original Ixi lang. Some of these are deliberate, some just haven't been implemented yet.
This list isn't exhaustive as there will likely be some differences that have been overlooked.
- Multiple lines can be evaluated at once. Just select them and run an evaluate command.
>shift
and<shift
are nowshiftr
andshiftl
respectively.
- All the tuning functionality (I don't understand how it works. Feel free to explain it to me)
- Agent specific scales
- The
sequence
command - Meta-Agents
- The intoxicant commands
hash
,beer
,coffee
,LSD
,detox
- MIDI in/out
- snapshots
coder
,autocode
,matrix
suicide
andhotline
- Score operators working as commands
- Auto-coder
- Recording sound file functionality
Like Ixi lang, Atomiix supports translations of the language. Both in terms of the error and info messages displayed, and the language itself. Translations need to be added to the language and editor repositories currently, so please either open a pull-request with the changes, or get in contact so we can make it happen.
Plenty! Not least more documentation and bug hunting. Please feel free to raise issues or send pull requests.
Drop me an email at guy@rumblesan.com
BSD License.