view release on metacpan or  search on metacpan

bin/nama  view on Meta::CPAN

The I<REC> setting prepares to connect the live track source and
record it to an audio file.

The I<PLAY> setting enqueues an audio file for playback from
disk as the track source.
 
The I<OFF> setting tells Nama to remove the track from the
audio network. I<OFF> status may result for a track when no
audio source is available. For example, a track with no
recorded audio files will show OFF status when set to PLAY.

=head2 Track output

By default a track belongs to the Main bus and is routed to
the Main track. This track provides a final fader before the
signal goes via ALSA or JACK to the audio device.

=head2 Bus setting

Buses can force the status of their member tracks to OFF.
Nama provides MON and OFF settings for buses.
OFF (set by C<bus-off>) removes all member tracks from the chain
setup, MON (set by C<bus-mon> restores them.

The B<mixplay> command sets the Mixdown track to PLAY and the
Main bus to OFF.

=head2 Version Numbers

Multiple audio files ("takes") can be recorded for each track. These are
distinguished by a version number that increments with each
recording run, i.e. F<sax_1.wav>, F<sax_2.wav>, etc.  All
audio files recorded in the same run have the same version
number.

The version numbers for track playback can be selected at
the bus or track level. By setting the bus version
to 5, you can play back version 5 of several tracks
at once. Version 5 could signify the fifth take of a song, or
the fifth song of a live recording session. 

The track version setting, if present, overrides the bus
version setting. Setting the track version to zero restores
control of the version number to the bus.

The Main bus version setting does I<not> propagate to
other buses. 

=head2 Marks

Marks in Nama are similar to those in other audio editing
software. One limitation is that mark positions are relative
to the beginning of an Ecasound chain setup. If your project
involves a single track, and you will be shortening the
stream by setting a region to play, set any marks you need
I<after> defining the region.

=head2 Regions

The C<region> command allows you to define endpoints for a
portion of an audio file.  You can then use the C<shift>
command to move the region to the desired time position.

If you use named marks as endpoints, the region will change
if the mark's position is adjusted.

Each track can have one region definition. To create
multiple regions, the C<new-region> command takes a pair of
marks to create a read-only copy of the current track with
the specified region definition. 

You can control this region as you would any other other
track, shifting the start time, applying effects, adjusting volume, etc.

=head3 Using Tracks from Other Projects

The C<link-track> clones a read-only track from
another track, which may belong to a different project. 

=head2 Effects

Each track gets volume and pan effects by default.  New
effects added using C<add-effect> are applied before pan
volume controls.  You can position effects anywhere you
choose using C<insert_effect> or C<position-effect>.

=head3 Fades

Fades can be placed on any track. They
defined by mark position and duration. An additional volume
operator, -eadb, is applied to each track to host the
envelope controller that implements fades.

=head3 Sends and Inserts

The C<send> command can route a track's post-fader output
to a soundcard channel or JACK client in addition to the
normal mixer input. Nama currently allows one aux send per
track.

The C<add-insert> command configures a pre- or post-fader
send-and-return to soundcard channels or JACK clients.
Wet and dry signal paths are provided, with a default
setting of 100% wet.

Each track can have one pre-fader and one post-fader insert.

=head2 Bunches

A bunch is just a list of track names. Using the C<for>
keyword with the name of a bunch will apply the commands
that follow to all of the tracks in the bunch. A bunch can be
created with the C<new-bunch> command. A bus name can also
be treated as a bunch.
 
=head2 Buses

B<Buses> enable multiple tracks to be routed through a
single mix track before feeding the Main mixer bus (or
possibly, another bus.) 

The following commands create a bus and assign
three tracks to it. The mix track takes the name of
the bus and is stereo by default.