Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rumblesan/atomiix
Main documentation repo and site for atomiix, a re-implementation of the IxiLang audio live coding environment
https://github.com/rumblesan/atomiix
algorave live-coding livecoding
Last synced: 27 days ago
JSON representation
Main documentation repo and site for atomiix, a re-implementation of the IxiLang audio live coding environment
- Host: GitHub
- URL: https://github.com/rumblesan/atomiix
- Owner: rumblesan
- License: bsd-2-clause
- Created: 2019-03-23T20:21:32.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-09-08T21:06:20.000Z (over 3 years ago)
- Last Synced: 2024-10-12T22:25:00.528Z (2 months ago)
- Topics: algorave, live-coding, livecoding
- Homepage:
- Size: 13.7 KB
- Stars: 13
- Watchers: 3
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-livecoding - Atomiix - A re-implementation and re-invigoration of ixi lang. (Languages)
- awesome-livecoding - Atomiix - A re-implementation and re-invigoration of ixi lang. (inactive) (Languages)
README
# Atomiix
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.
## Installation
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](https://supercollider.github.io/download) page on the website, downloading the most recent version for your platform, and then running the installer.
The [SC3 Plugins](https://github.com/supercollider/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](http://doc.sccode.org/Guides/UsingQuarks.html) tool and install the atomiix quark.`Quarks.install("https://github.com/rumblesan/atomiix.quark.git")`
To install the editor, first download and install [Atom](https://atom.io) and then the [atomiix](https://atom.io/packages/atomiix) package.
### Setup
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](https://github.com/rumblesan/atomiix/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.### Custom Projects
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.
### Atom
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.
## Running
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*.
## Key mappings
To evaluate code, any of the following key combinations can be used :-
* Ctrl-Enter
* Alt-Up
* Alt-RightAlt-Left can be used to evaluate lines and free the agents on those lines.
## Differences from original Ixi lang
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.
### Improved Editor Functionality
* Multiple lines can be evaluated at once. Just select them and run an evaluate command.
### Changes
* `>shift` and `