Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mslinn/live_set

Tools for Ableton Live 11 & 12 sets
https://github.com/mslinn/live_set

ableton-live

Last synced: about 2 months ago
JSON representation

Tools for Ableton Live 11 & 12 sets

Awesome Lists containing this project

README

        

# `Live_set` [![Gem Version](https://badge.fury.io/rb/live_set.svg)](https://badge.fury.io/rb/live_set)

This program can:

1. Make a copy of an Ableton Live 12 set and save to Live 11 format.

2. Report the version compatibility of an Ableton Live set.

3. Detect environmental problems, for example unwanted directories called `Ableton Project Info` in parent directories.

4. Display the location and size of the samples in each track.

5. Clearly show if a Live set is ready to be transferred to a Push 3 Standalone, and what needs to be changed if not.

a. Detect sets that are too large to be frozen, which means they are too large to transfer to Push 3 Standalone.

b. Detect tracks that are not frozen, which means they are not ready to be transferred to Push 3 Standalone.

c. Shows clips that are have not been collected within the set’s project directory.

This program has successfully converted the Ableton Live 12 demo project to Live 11.

## Installation

Simply type:

```shell
$ gem install live_set
```

If the above does not work because you need to install Ruby, please
[follow these instructions](https://www.mslinn.com/ruby/1000-ruby-setup.html).

## Upgrading

Simply type:

```shell
$ gem upgrade live_set
```

## Usage

```text
$ live_set
Displays information about a Live set or converts a copy of a Live 12 set in Live 11 format.
Also verifies that 'Ableton Project Info' is in the same directory as the .als file,
and there is no parent directory with a directory of that name.

Syntax: live_set OPTIONS PATH_TO_ALS_FILE

Environment variables used in PATH_TO_ALS_FILE are expanded.

Options are:
-11 Convert a copy of the Live 12 set to Live 11 format.
-f Overwrite any existing Live 11 set.
-h Display this help message.

Example:
live_set -11 -f $path/to/my_set.als
```

### Report

Report the version of the [Ableton Live 12 Demo Project](https://help.ableton.com/hc/en-us/articles/209774005-Location-of-the-default-Demo-Set):

```text
$ live_set "$ableton_media/Projects/Ableton Live 12 Demo Project/Ableton Live 12 Demo.als"
/mnt/e/media/Ableton/Projects/Ableton Live 12 Demo Project/Ableton Live 12 Demo.als
Created by Ableton Live 12.0.1
Major version 5
Minor version v12.0_12049
SchemaChangeCount 7
Revision dc76d800e94bdd5e2d8f0f72ef4d056a634a8cd7
Warning: This set should not be transferred to Push 3 Standalone.
- Some tracks are not frozen.
Total set size: 312.5 MB
4 tracks:
Track 'Vocal Main' **not frozen** (12 clips, totaling 154.0 MB)
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34
Samples/Imported/Vocal Patience Main.wav 12.8 MB 2024-01-31 22:00:34

Track 'Vocal Harmony' **not frozen** (12 clips, totaling 154.0 MB)
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04
Samples/Imported/Vocal Patience Harmony.wav 12.8 MB 2024-01-31 22:00:04

Track 'Vocal Hum' **not frozen** (1 clips, totaling 2.9 MB)
Samples/Imported/Vocal Patience Hum.wav 2.9 MB 2024-01-31 22:03:22

Track 'Vocal Adlib' **not frozen** (2 clips, totaling 1.7 MB)
Samples/Imported/Vocal Patience Adlib.wav 827.9 kB 2024-01-31 22:00:22
Samples/Imported/Vocal Patience Adlib.wav 827.9 kB 2024-01-31 22:00:22
```

### Convert

Make the Live 12 set compatible with Live 11 and save as `path/to/my_set_11.als`:

```shell
$ live_set -11 -f path/to/my_set.als
```

## Development

After checking out this git repository, install dependencies by running `bin/setup`:

```text
$ git clone https://github.com/mslinn/live_set
$ cd live_set
$ bin/setup
$ code . # Run Visual Studio Code
```

### Run the Tests

```text
$ bundle exec rake test
```

### Debug run

Define the `VO_DEBUGGING` environment variable so the code is loaded from the project
instead of attempting to load the `live_set` gem.

```shell
$ VO_DEBUGGING=true ruby exe/live_set /path/to/my_set.als
```

### Interactive Session

The following will allow you to experiment:

```shell
$ bin/console
```

### Local Installation

To install this gem onto your local machine, type:

```text
$ bundle exec rake install
```

### To Release A New Version

To create a git tag for the new version, push git commits and tags,
and push the new version of the gem to https://rubygems.org, type:

```shell
$ bundle exec rake release
```

## Contributing

Bug reports and pull requests are welcome at https://github.com/mslinn/live_set.

## License

The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).