ArchersPlayer
User Guide

AUv3 Audio Player Plugin for iOS

Overview

ArchersPlayer is an AUv3 audio player plugin for iOS. It plays audio files from a configurable playlist with support for track regions, real-time pitch/speed warping, MIDI control, and flexible looping. Use it inside any AUv3-compatible host app (such as AUM, ApeMatrix, or Audiobus).

ArchersPlayer main screen overview
Main screen overview

Getting Started

Adding Audio Files

Tap Add Files at the bottom of the screen to open the file picker. You can select one or more audio files at a time. Supported formats include MP3, WAV, AIFF, M4A, CAF, FLAC, and AAC.

Tap Add Folder to import all audio files from a folder recursively. Files are sorted alphabetically and added to the end of the playlist. If a file with the same name already exists in the playlist, it will still be added — this allows you to create multiple tracks from the same audio file with different regions.

Add Files and Add Folder buttons
Bottom action buttons

The Playlist

Your playlist is displayed as a scrollable list in the center of the screen. Each row shows:

Tap a track to load and play it immediately.

Playlist rows showing track names, region labels, and MIDI badges
Playlist with regions and MIDI badges

Playback Controls

The transport controls are located in the header area, below the seek bar.

Transport controls: shuffle, previous, play/stop, next, loop, warp
Transport controls

Play / Stop

Tap the Play button to begin playback. The icon changes to a Stop button while playing. If you are at the end of a track, pressing Play will restart from the beginning of the region.

Next / Previous Track

Tap Next (forward arrow) or Previous (backward arrow) to switch tracks. These buttons wrap around based on the current loop mode.

Seek Bar

The slider below the track name allows you to scrub to any position within the current track's region. The current time and total duration are displayed on either side.

Seek bar with time display and scissors button
Seek bar with time indicators

Loop Modes

Tap the Loop button to cycle through three modes:

  1. Off — Playback stops at the end of the playlist
  2. Loop All (repeat icon) — The playlist wraps from the last track back to the first
  3. Loop One (repeat.1 icon) — The current track repeats continuously

Managing Your Playlist

Reordering Tracks

Long-press and drag a track to move it to a different position in the playlist.

Locking Tracks

Swipe right on a track and tap Lock to lock it in place. Locked tracks are not affected by shuffle. Swipe right again and tap Unlock to unlock.

Swipe right showing Lock and MIDI buttons
Swipe right actions: Lock and MIDI Learn

Removing Tracks

Swipe left on a track and tap Delete to remove it from the playlist. This action can be undone.

Swipe left showing Delete button
Swipe left to delete

Clearing the Playlist

Tap the Clear button (trash icon, bottom-right) to remove all tracks. This can be undone.

Undo / Redo

The Undo and Redo buttons in the header let you revert or reapply changes to the playlist. Up to 20 levels of undo are supported. Supported actions include adding, removing, reordering, shuffling, locking, and region changes.

Header with playlist menu, undo, redo, and settings buttons
Header controls

Shuffle

Tap the Shuffle button to randomize the order of unlocked tracks. Locked tracks remain in their positions.

Shuffle control
Shuffle button

Saving and Loading Playlists

Tap the Playlist Menu (disk icon, top-left) to access playlist management:

A red dot appears on the playlist menu icon when you have unsaved changes.

Playlist menu showing Load, Save, and Save As options
Playlist menu
Load Playlist screen with MIDI badges and checkmark
Load Playlist screen

Deleting Saved Playlists

In the Load Playlist screen, swipe left on a playlist name and tap Delete to remove it. Any MIDI mapping assigned to that playlist is also removed.

Track Regions (Trimming)

By default, each track plays the entire audio file from start to finish. You can define a custom region to play only a specific section.

Opening the Waveform Editor

Tap the scissors icon next to the seek bar to open the Waveform Trim Editor. The scissors icon appears filled when the current track has a custom region.

Waveform Trim Editor showing selection, playhead, and controls
Waveform Trim Editor

Selecting a Region

Drag across the waveform to select a region. The selected area is highlighted, and the waveform automatically zooms in to show your selection plus one second of padding on each side.

While zoomed in, you can drag again to refine your selection.

Waveform zoomed in on a selection
Zoomed view with selection

Nudge Controls

Below the waveform, two rows of buttons let you fine-tune the start and end positions:

The current time for each boundary is displayed between the buttons in M:SS.CC format.

Nudge controls for start and end times
Nudge controls

Zoom Controls

Playback in the Editor

The editor has its own playback controls:

A white playhead line moves across the waveform in real time showing the current playback position.

Live Editing

Changes to the region are applied to playback immediately as you adjust them. You do not need to close the editor first.

Resetting a Region

Tap Reset (top-left of the editor) to clear the custom region and restore the full file.

Closing the Editor

Tap Done to close the editor and save the region change to the undo history. The previous loop mode is restored when the editor closes.

Warp (Pitch and Speed Control)

The Warp button (waveform icon) to the right of the loop button provides real-time pitch and speed manipulation.

Basic Usage

Tap and hold the Warp button, then drag:

Warp control button
Warp control

A circular indicator overlay shows your current offset from center, with crosshair labels for PITCH and SPEED axes.

Warp overlay showing pitch/speed crosshair indicator
Warp indicator overlay

Axis Locking (Two-Finger Control)

While dragging with one finger, place a second finger on the screen to lock one axis:

The locked axis is highlighted on the indicator overlay. Lift the second finger to unlock.

Warp with axis lock indicator showing locked dimension
Axis locking with two fingers

MIDI Control

ArchersPlayer supports comprehensive MIDI control. All MIDI mappings are saved and restored between sessions.

MIDI Channel

By default, ArchersPlayer responds to MIDI messages on all channels. To restrict to a specific channel (1–16), open Settings and change the Channel picker under MIDI Triggers.

Transport Function Mappings

You can assign MIDI triggers to the following transport functions:

FunctionBehavior
Play / PauseToggles playback on/off
Next TrackAdvances to the next track
Previous TrackGoes to the previous track
Loop ToggleCycles through Off, All, One
ShuffleRandomizes the playlist
Warp PitchContinuous CC for pitch control
Warp SpeedContinuous CC for speed control

Warp Pitch and Warp Speed only accept CC mappings and use the full 0–127 range: 64 is center (no change), lower values decrease pitch/speed, higher values increase it.

Track Slot Mappings

Assign a MIDI trigger to a specific track slot (1–20). When triggered, that track is loaded and played. If no file exists in that slot, the trigger is ignored.

Playlist Mappings

Assign a MIDI trigger to a saved playlist. When triggered, that playlist is loaded.

MIDI Learn

There are several ways to enter MIDI Learn mode:

  1. Long-press a transport button (Play, Next, Previous, Loop, Shuffle) to learn that function
  2. Swipe right on a playlist row and tap MIDI to learn that track slot
  3. Swipe right on a playlist name in the Load Playlist screen and tap MIDI to learn that playlist
  4. Open Settings and tap the Learn button next to any function
MIDI Learn overlay showing function name and channel info
MIDI Learn overlay

When in Learn mode, a modal overlay appears. Send a MIDI note or CC message to assign it. The overlay shows:

Conflict Resolution

If the MIDI message you send is already assigned to another function, track, or playlist, ArchersPlayer will notify you.

MIDI conflict dialog showing Replace and Cancel options
MIDI conflict resolution

The conflict overlay shows which control currently uses that trigger and offers two options:

MIDI Trigger Display

MIDI note triggers are displayed using standard musical notation (e.g., C4, D#3). CC triggers are displayed as CC followed by the number (e.g., CC64).

Mappings appear as badges on playlist rows, in the Settings screen, and on playlist names in the Load Playlist screen.

Settings screen showing MIDI Triggers, Track Triggers, and Playlist Triggers sections
MIDI settings

Track Delay

When enabled, a random pause is inserted between tracks before the next one begins automatically.

Configuration

Open Settings and toggle Delay between tracks. Adjust the Min and Max delay sliders (2–10 seconds each). If both are set to the same value, the delay will always be that exact duration. Otherwise, a random value between the two is chosen for each transition.

Track Delay settings with toggle and min/max sliders
Track Delay settings

During a Delay

A countdown is displayed on screen showing "Next in Xs". To skip the delay and advance immediately, tap the Play button. Tapping Next, Previous, or manually selecting a track also cancels the delay.

The delay does not apply when Loop One mode is active.

Settings

Tap the gear icon in the top-right corner to open Settings. Available sections:

Supported Audio Formats

Files are automatically converted to the host's sample rate and stereo format during loading.

Support

For questions, feedback, or support, please email support@mixmaster-ab.com.