Move tool

A simple CLI for slicing long samples into Ableton Note / Ableton Move presets

Quick Start for Non-Developers

Using Move Tool

1. Prepare an audio sample containing up to 16 parts (e.g., a sample with 16 equal-length slices).
2. Open Terminal (macOS) or Command Prompt (Windows).
3. Run the Move Tool command:
   • For macOS:

     ./move-tool slice -i /path/to/your/sample.wav -n 16 -o /Users/your-username/Desktop
     

   • For Windows:

     move-tool.exe slice -i C:\path\to\your\sample.wav -n 16 -o C:\Users\YourUsername\Desktop
     

4. Move Tool will slice the original sample into 16 pieces and create a Move/Note preset with a random name in the specified output directory.
5. If you find this tool helpful, please star the repository!

Quick start for macOS Users

1. Download the latest macOS version of Move Tool for Apple Silicon (M chips) or Intel
2. Open Finder and navigate to your Downloads folder.
3. Double-click the downloaded file (it should be named something like move-tool-macos.zip) to unzip it.
4. Open Terminal (you can find it by pressing Cmd + Space and typing "Terminal").
5. In Terminal, type cd (with a space after it), then drag the folder containing the unzipped move-tool into the Terminal window. Press Enter.

• Note: The Move Tool CLI is not signed, which means macOS may prevent it from running due to security measures. To run the tool, you'll need to follow these additional steps:

  • Right-click on the move-tool executable and select "Open" from the context menu. You'll see a security warning. Click "Open" to run the tool for the first time.

  • If the above method doesn't work, you can try the following:

    1. Open "System Preferences" > "Security & Privacy" > "General" tab.
    2. Look for a message about move-tool being blocked and click "Open Anyway".

  • If you're comfortable using the Terminal, you can remove the quarantine attribute:

    xattr -r -d com.apple.quarantine ./move-tool
    

    This command removes the quarantine flag, allowing the tool to run.

• Before using the tool, ensure it has the correct permissions. Run the following command in the Terminal:

  chmod +x ./move-tool
  

  This sets the executable permission on the file, allowing you to run it from the command line. The chmod +x command is crucial as it grants execute permissions to the file, which is necessary for running command-line tools.

6. Now you can use Move Tool. For example, to slice a sample, type:

   ./move-tool slice -i /path/to/your/sample.wav -n 16 -o /Users/your-username/Desktop
   

   Replace /path/to/your/sample.wav with the actual path to your audio file, and /Users/your-username/Desktop with where you want to save the output.

Quick start for Windows Users

1. Download the latest Windows version of Move Tool for Intel/AMD processors or ARM
2. Open File Explorer and navigate to your Downloads folder.
3. Right-click the downloaded file (it should be named something like move-tool-windows.zip) and select "Extract All". Choose a location to extract the files.
4. Open Command Prompt (you can find it by pressing Win + R, typing "cmd", and pressing Enter).
5. In Command Prompt, type cd (with a space after it), then type the path to the folder where you extracted Move Tool. For example:

   cd C:\Users\YourUsername\Downloads\move-tool
   

6. Now you can use Move Tool. For example, to slice a sample, type:

   move-tool.exe slice -i C:\path\to\your\sample.wav -n 16 -o C:\Users\YourUsername\Desktop
   

   Replace C:\path\to\your\sample.wav with the actual path to your audio file, and C:\Users\YourUsername\Desktop with where you want to save the output.

Quick start for Linux Users

1. You know what to do folks. Welcome home.

For Developers

• Overview
• Installation
• Usage
• Contributing
• License

Installation

1. Ensure that you have Go 1.22 installed.

2. Clone the repo:

   git clone https://github.com/alexfedosov/move-tool.git

3. Navigate to the project directory:

   cd move-tool

4. Install dependencies:

   go mod tidy

Usage

go run . slice -i <file path> -n <number of samples> -o <output directory>

Contributing

1. Fork the repository.
2. Create a new branch (git checkout -b feature/YourFeature).
3. Commit your changes (git commit -m 'Add some feature').
4. Push to the branch (git push origin feature/YourFeature).
5. Open a Pull Request.

License

This project is licensed under the MIT License. See the LICENSE file for details.