Loopers

Loopers是一个图形化的现场循环器，用Rust编写，设计用于易用性和稳定的稳定性。它可以作为练习工具、创作辅助工具或用于现场环境中循环作品的表演。

目前它作为独立的Jack应用程序在Linux上运行，这使得它可以与像效果架、软件乐器和DAWs等Jack客户端进行交互，或在MacOS上使用Jack或（实验性）直接使用CoreAudio。

系统被建模为一系列硬件循环单元（如Boss Loop Station），这些单元通过单个时间控制进行同步。循环单元的数量仅受显示屏大小的限制，循环长度仅受可用内存的限制。

特性

• 通过公共时间控制同步的多个循环
• 循环可以录制（设置循环长度）、叠加、清除、静音和独奏
• 最多可以使用四个部分来分割表演的部分
• 支持循环命令的节拍、小节和自由量化，使其保持同步变得容易
• 无限撤销/重做
• 双速和半速播放（以及叠加！）
• 每个操作都可以通过GUI或MIDI进行控制
• 可以保存和恢复会话
• 内置节拍器（在单独的Jack输出上）帮助您保持循环的节奏
• 除了计算机的内存之外，循环长度没有限制
• 交叉淡入确保每次循环都是完美的
• 很有趣！

入门

Linux

要构建loopers，您将需要jack和sdl2。

对于Ubuntu/Debian，可以使用以下命令安装：

$ sudo apt install jackd2 libjack-jackd2-dev libgl1-mesa-dev libsdl2-dev

现在您已经准备好安装loopers本身。首先安装rust工具链（https://rustup.rs），然后

$ cargo install loopers

然后使用以下命令启动它：

$ loopers

（如果您收到有关Jack未运行错误的错误，您需要首先启动Jack服务器。有关详细信息，请参阅Jack文档。）

这将创建一个Jack客户端，可以用任何数量的工具将其连接到您的输入/输出/效果（我推荐来自KXStudio的Claudia）。

Loopers 应与 PipeWire 完全兼容，这消除了对单独 Jack 服务器的需求。

MacOS

Loopers 对在 CoreAudio 上运行提供实验性支持，这是 MacOS 的原生音频系统（您也可以在 MacOS 上在 jack 上运行它，目前对它的支持更好）。要在 Mac 上使用 coreaudio 构建

$ brew install jack sdl2
$ cargo install loopers
$ loopers

默认情况下，它将使用 CoreAudio 运行。要使用 jack 运行，

$ loopers --driver jack

注意：目前通过 coreaudio 不支持 midi，也没有选择音频源和目标的能力（使用默认设备）。

文档

界面导览

界面分为两部分：顶部包含一组 Looper，底部包含引擎的控制和设置。将鼠标悬停在每个 Looper 上将显示该 Looper 的控制，包括设置 Looper 所属的部分和控制模式。

每个 Looper 显示一些关键信息，以便表演者快速了解其状态

将鼠标悬停在 Looper 上会产生 Looper 的控制（尽管大多数表演者更喜欢使用硬件按钮）

底部是我们找到的引擎控制

Looper 模式

在任何时候，每个 Looper 都可以处于几个模式之一，每个模式在 UI 中都通过颜色标识

播放

在播放模式下，Loopers 的输出将与所有其他 Loopers 的输出混合，并发送到全局输出。这是默认模式。

录音

当开始录音时，Loopers 的所有现有样本都会被清除。然后记录新的音频到一个样本，直到录音完成，从而确定循环长度。

叠加

在叠加模式下，我们在 Loopers 中现有的样本上方添加新的输入，而不改变循环长度。

除了这些专有模式外，Loopers 还可以有一个或多个以下 修饰符

独奏

如果启用独奏，所有其他 Loopers 都将被静音（除了那些也处于独奏模式的 Loopers）。

静音

当启用静音时，Loopers 将被静音。

模式和修饰符可以通过 UI 或通过发送 midi 命令来控制。

量化

当使用多个 Loopers 时，通常希望它们同步。在 Loopers 中，这是通过使用跨所有 Loopers 的单个时间控制来实现的。此外，循环长度必须是彼此的确切倍数（例如，您可能有一个 4 倍于您的节奏循环的贝斯循环）。如果长度偏差超过几毫秒，几轮重复后就会很快被注意到。

为了帮助表演者将循环长度精确对齐，Loopers 提供了 量化 功能。这允许您将命令（例如，停止录音从而设置循环长度）同步到某些计量事件。

它支持三种量化模式，通过 UI 底部的按钮设置

• 免费 这将禁用量化，并使所有命令立即生效
• 节拍 命令在发出后的下一个节拍上生效，由节奏决定
• 小节 命令在小节的开始处生效，由节奏和拍号决定

一些命令受量化影响，而另一些则立即生效。有关更多信息，请参阅命令参考。

命令

系统的每个方面都可以通过命令进行控制，无论是通过用户界面还是通过MIDI。有关配置MIDI控制的详细信息，请参阅设置。

有两种类型的命令：循环命令，应用于一个或多个循环器，以及整体应用于系统的引擎命令。命令可以接受参数，以控制命令的行为。

循环命令都接受一个第一个参数，用于确定哪个循环器将被目标化

• 选择：仅针对通过用户界面或通过Select*Looper命令之一控制的已选择循环器
• Id：接受一个id参数，并针对具有该id的循环器进行目标化
• 索引：接受一个索引参数，并针对当前可见部分中的该索引处的循环器进行目标化，从0开始。
• 所有：针对所有循环器

其他命令也可能接受控制其行为的参数。

命令在量化方面也存在差异

• 立即 命令在收到时立即执行，无论量化设置或系统状态如何
• 队列 命令将在执行之前在队列中等待其他（可能已量化的）命令生效。这允许您，例如，发送切换到下一个部分的命令（一个量化的命令），然后发送SelectNextLooper命令（一个队列命令），它将在执行之前等待部分切换。
• 量化 命令将等待到下一个量化边界（例如，下一个小节的开始，有关详细信息，请参阅量化）才执行。

循环器命令

① RecordOverdubPlay从记录 -> 覆盖和覆盖 -> 播放进行量化，但从播放 -> 覆盖进行队列处理。

引擎命令

设置

配置存储在标准系统用户配置位置（通常这将是在~/.config/loopers/）。目前配置由从MIDI消息到循环器命令的一组映射组成。这些映射应放在该配置目录中名为midi_mappings.tsv的文件中，循环器首次运行后，将自动创建此文件。

此文件的每一行（非空行）应包含以下制表符分隔的列

1. MIDI通道（可以是*表示任何通道或通道号）
2. MIDI控制器编号
3. MIDI数据（可以是*表示任何数据，单个值如50，或范围如0-100）
4. 命令名称（参见上面的表格）
5. 命令参数（多个参数应以制表符分隔；特殊值$data可以用于某些数值参数的位置，以使用MIDI事件的数值，例如用于表情踏板）

MIDI值（通道、控制器、数据）可以被视为对传入MIDI事件的过滤器；对于每个事件，所有匹配的命令都会触发。

配置用于与Behringer FCB1010（一个出色的踏板板）的示例

Channel	Controller	Data	Command	Arg1	Arg2	Arg3
*	22	127	RecordOverdubPlay	Selected
*	22	0	RecordOverdubPlay	Selected

*	23	127	SelectNextLooper
*	23	0	SelectNextLooper

*	24	127	NextPart
*	24	0	NextPart

*	25	127	Clear	Selected
*	25	0	Clear	Selected

*	26	127	PlayPause
*	26	0	PlayPause

*	27	0-127	SetPan	Selected	$data