# Command-Line Tool

The Command-Line Tool of Youlean Loudness Meter 2 offers advanced users an efficient way to analyze and normalize audio files, and export reports. To begin using the tool, ensure it's properly installed. You can either manually install it or use an installer to integrate it into your system path for system-wide availability.

**Basic Usage:**

The tool functions via specific command line arguments. Here's the basic usage structure:

```bash
Usage: --input-file-path <path> [options]
```

{% hint style="info" %}
Always use absolute paths as relative paths are not supported.
{% endhint %}

**Key Commands and Options:**

* `--input-file-path <path>`: Sets the input file path. You can input multiple paths for multi-mono files.
* `--preset-name <name>`: Selects the preset name for analysis settings.
* `--channel-config <config>`: Chooses the channel configuration, with 'auto' as the default.
* `--export`: Triggers the export of reports.
* `--normalize`: Exports a normalized file.

**Examples of Usage:**

1. **Basic Analysis**:

{% code overflow="wrap" %}

```bash
--input-file-path "/your/file/path/file.wav"
```

{% endcode %}

{% hint style="info" %}
You can also analyze multi-mono files too:

```
ylm2 --input-file-path "C:\example\file.L.wav" "C:\example\file.R.wav" "C:\example\file.C.wav" "C:\example\file.LFE.wav" "C:\example\file.Ls.wav" "C:\example\file.Rs.wav"
```

{% endhint %}

This command analyzes the specified file and prints the results.

2. **Analysis with Export**:

{% code overflow="wrap" %}

```bash
--input-file-path "/your/file/path/file.wav" --export --export-type "PNG"
```

{% endcode %}

Analyzes the file and exports the results as a PNG.

3. **Normalization and Export**:

{% code overflow="wrap" %}

```bash
--input-file-path "/your/file/path/file.wav" --normalize --export --export-type "PDF"
```

{% endcode %}

Normalizes the audio file and exports a PDF report.

{% hint style="info" %}
**Tips for Effective Use:**

* **Preset Selection**: Use the Youlean Loudness Meter 2 application to create and select presets with desired settings for your analysis.
* **Export Customization**: Customize your export options (type, folder path, file name) based on your requirements.
* **Console Results**: Use `--print-result` to see immediate analysis results in the console.
* For a full list of `--preset-name`, `--channel-config`, and `--export-type` options, use `--help` to print options to the console.
  {% endhint %}

#### Analyze folder script

You can download the scripts here and double-click on the script to load it. On macOS, you may need to make the script executable by using `chmod +x`. Once launched, it will prompt you to specify the folder for analysis. You can drag the folder from File Explorer or Finder, and every audio file will be analyzed, generating a report.

{% hint style="success" %}
Download Analyze Folder Script here: [link](https://youlean.co/wp-content/uploads/2025/10/ylm2-Analyze-Folder.zip)
{% endhint %}

***

#### Watch folder script

Set up a watch folder system to organize your audio files into folders for processing, completed tasks, and errors. This helps you efficiently manage your audio analysis workflow.

Double-click the script to start the watch folder process.

Simply insert any audio files you wish to analyze into the `ylm2-to-process` folder, and the script will automatically process them, moving them to the appropriate outcome folder.

{% hint style="info" %}

* `ylm2-to-process`: This directory is monitored for new files to be analyzed.
* `ylm2-completed`: Successfully processed files are moved here.
* `ylm2-failed`: Files that fail to process are moved to this folder.
  {% endhint %}

{% hint style="success" %}
Download Watch Folder Script here: [link](https://youlean.co/wp-content/uploads/2025/10/ylm2-Watch-Folder.zip)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.youlean.co/youlean-loudness-meter/getting-started/command-line-tool.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.