view release on metacpan or  search on metacpan

bin/nama  view on Meta::CPAN

=head4 B<set-tempo> (tempo tp) - Set MIDI tempo (bpm)

=over 8

set-tempo <integer:tempo-setting>

=back

=head2 General commands

=head4 B<set-sample-rate> (ssr) - Configure the sample rate for the current project or report sample rate if no parameter

=over 8

set-sample-rate <integer:sample-rate>

=back

=head1 REALTIME OPERATION

Nama selects realtime or nonrealtime parameters based on the
B<realtime_profile>, B<ecasound_buffersize> and
B<ecasound_globals> fields in F<.namarc>. You can
optionally specify the buffersizes as a multiple of the JACK
period size. Note that for best realtime operation under
JACK you will have to configure jackd appropriately as well.

The B<realtime> and B<auto> profiles are useful when using
Nama/Ecasound for live fx processing or live monitoring.

The B<realtime> profile sets a small buffersize and other low
latency settings whenever a soundcard or JACK client is
connected. 

The B<nonrealtime> profile uses a bigger buffer, providing
extended margins for stable operation. It is suitable for
post-processing, or for recording without live monitoring
responsibilities.

The B<auto> profile defaults to nonrealtime settings. It
switches to realtime, low-latency settings when a track has
a live input.

=head1 DIAGNOSTICS

On any change in setup, the GUI display updates and
C<show-tracks> command is executed automatically showing
what to expect the next time the engine is started.

You can use the C<chains> command to verify the Ecasound
chain setup. (The Ecasound command C<cs-save-as mysetup.ecs>
will additionally store all engine data, effects as
well as routing.)

The C<dump> command displays data for the current track.
The C<dumpall> command shows all state that would be saved.

This is the same output that is written to the F<State.yml>
file when you issue the C<save> command.

=head1 BUGS AND LIMITATIONS

No latency compensation across signal paths is provided at
present. This feature is under development.

=head1 SECURITY CONCERNS

If you are using Nama with the NetECI interface (i.e. if
Audio::Ecasound is I<not> installed) you should block TCP
port 2868 if your computer is exposed to the Internet. 

=head1 INSTALLATION

The following commands, available on Unixlike systems with
Perl installed, will pull in Nama and other Perl libraries
required for text mode operation:

C<cpanm Audio::Nama>
-or-
C<PERL_MM_USE_DEFAULT=1 cpan Audio::Nama>

To use the GUI, you will need to install Tk:

C<cpanm Tk>

You may want to install Audio::Ecasound if you prefer not to
run Ecasound in server mode:

C<cpanm Audio::Ecasound>

You can pull the source code as follows: 

C<git clone git://github.com/bolangi/nama.git>

Consult the F<BUILD> file for build instructions.

=head1 SUPPORT

The Nama mailing list is a suitable forum for questions
regarding Nama installation, usage, bugs, feature requests, etc.

http://www.freelists.org/list/nama

For questions and discussion related to Ecasound 

https://lists.sourceforge.net/lists/listinfo/ecasound-list

=head1 PATCHES

The modules that make up this application are the
preprocessed output from several source files.  Patches
against these source files are preferred.

=head1 AUTHOR

Joel Roth, E<lt>joelz@pobox.comE<gt>

=head1 CONTRIBUTORS

Alex Stone 
Brett McCoy