FragmentLooper Manual

Main :

Apple Software

:

FragmentLooper

:

Manual


Introduction

This is an application that plays a fragment or a piece of a sound file. This provides a simple tool that allows people to repeatedly play a section of a sound file without manually trying to jump about as you'd need to do in a standard music player. It was originally conceived as a tool to help musicians practice by letting them focus on a smaller part of a song. It can be used for other purposes like allowing language students to repeat small passages in their hearing exercises.


Basic Workflow

There are a number of elements to the GUI but the most basic workflow is to add a sound file with the + iTunes button, adjust the begin and end times, then finally to press the Play.


Left - File Management

The main window is divided into two halves with a splitter control. The left side is focused on managing the list of sound files.

List Management

One adds sound files by using the buttons with a + sign.

Currently one can only search their iTunes using the + iTunes button. This brings up a search panel.

Files can be dragged around the list. Also, files can be removed from the list by clicking on the - Selected button.

Search Panel

There are three fields that are used during searching: Artist, Album and Title. The search is a contains search and is not case sensitive.

Each of these fields are absolute. That is all characters, including spaces, are used in the search. Thus searching for "Cthulhu Software" will return anything that contains that full string as it is, and not anything containing "Cthulhu" and "Software" separately.

Also the three fields must all be satisfied. Setting the Artist to "Cthulhu" and the Album to "Should Not" will only return matches that satisfy both of these conditions.

Any field that isn't needed in a search should just be left empty.

The Search button will start the search and return the results to the table just below.

The final steps are to select the sound file of interest from the list, and click on the Add button.

This will add the sound file to the list of visible sound files.

Visibility

To help manage the file collection, each sound file has a visibility option adjusted by using the check box in the lower right of it's table item. Ticked on is visible. Ticked off is hidden.

This visibility parameter can be seen in action when selecting the visibility menu. The choice All will show all the song files. The choice Visible will only show those files that have their visibility option on. The choice Hidden will only show those files that have their visibility option off.


Right - Replay

The right side of the main window is concerned with replaying the sound file that is currently selected on the left side of the window. Only when a single file is selected on the left will anything appear on the right.

Description Fields

At the top are four fields used to describe the sound file: Description, Artist, Album and Song. These labels do show the original intent of this app but are common fields used in organising sound libraries - even if used by a big stretch.

These fields are editable and will not affect the original data. Any changes made here will only apply to what is seen within the app FragmentLooper.

These fields can be changed to whatever the app user wants and should be helpful. For example, in the Description field one could write "No guitars" if that sound file lacks a guitar track for play along purposes. As changes are made they appear in the list to the left.

Timing

There are four adjustable parameters that control play back. These controls are grouped with a text box, a slider and a stepper control. Changing one will change the others. Using a slider or stepper will result in the value in the text box to change. Typing a number into the text field and pressing return will cause changes to the slider and stepper.

Begin is the time when the sound file replay begins. End is the corresponding time latter where the replay will stop. These two parameters are used to control what part/piece of the sound file is played.

Initial delay is used to set a one time delay before any sound is played. This can be used as silent preparation time. For example, a musician might use this time to turn away from the device that is running this app and picking up their instrument.

Repeat delay is used to create a delay between repeats of any sound played. This can be used as a chance to re-organise oneself. For example, a musician can give their hands a short rest break before the next practice session begins.

Looping

Loop Count is used to control the number of times a sound fragment is played. The drop down menu provides suggestions. Anything above 0 is acceptable. "Infinite" is a special case where the replay continues endlessly until the Stop button is pressed.

Play Rate

Play rate is used to control how fast the play rate occurs. A value of 1.0 is at normal speed. A value of 0.5 will play at half speed.

Using the slider will limit values from 0.1 to 1.0. It is possible to type other values that might result in weird sounding replays.

Playing

On the lower left is the Play/Stop button. This button will start or stop playing a sound file. When nothing is being played this will say Play and Stop while playing.

There is a progress bar that shows the progress. While playing a sound file it will move to the right. While in a delay stage it will move to the left.

To the right of Play button is an information field. Inside the round brackets you'll see a count down of the number of repeats left. After the rounded brackets is the current time. While playing the sound file this number will increase. While in a delay stage this number will decrease to zero.

On the lower right is a slider controlling the volume. The values range from 0.0 to 1.0. This a global control in that it affects all sound files in the list on the left.


Copyright © by Cthulhu Software. All rights reserved.