view release on metacpan or  search on metacpan

bin/nama  view on Meta::CPAN

#!/usr/bin/env perl
use Audio::Nama;
Audio::Nama::main();
__END__
=head1 NAME

=encoding UTF-8

B<Nama> - multitrack recorder and digital audio workstation

=head1 SYNOPSIS

B<nama> [I<options>] [I<project-name>]

=head1 DESCRIPTION

A multitrack audio application for recording, effects
processing, editing, mixing, mastering and live
performance. It can also perform general-purpose audio
processing, such as 5.1 to stereo conversion. Nama uses 
Ecasound as the audio processing engine.

=head2 Audio projects

Projects in Nama are audio networks of tracks and buses.
Tracks may contain one or more RIFF (.wav) files, as well as
effects, sends, inserts, marks, regions, fades,
edits and sequences.  Tracks can host LADSPA, LV2 and
Ecasound plugins.  Audio regions may be altered, duplicated,
time-shifted or replaced.  

Audio processing is performed in realtime when a track is
played and may be cached (frozen) to a new audio file.

Project data is serialized as JSON. The complete history
is tracked by the git version control system.  As a result,
projects can be managed using branches and tags, and provide
undo/redo.

Nama supports some MIDI functionality via midish. 

=head2 Presets and templates

To facilitate reuse, a track's plugins and inserts can be
stored as an I<effect chain>. I<Effect profiles> apply effect
chains to groups of tracks.  I<Project templates> are for
duplicating an entire project sans audio files.

=head2 Audio device

Nama performs Audio IO via JACK or ALSA. Soundcard IO goes
via JACK, if running, with transparent fallback to ALSA.

Nama supports Ladish Level 1 session handling.

=head2 User interfaces

Nama has fully featured terminal command prompt, a Tk
GUI, and experimental OSC and remote-command modes.
 
The command prompt can run Nama commands, Ecasound
interactive-mode commands, commands for the midish MIDI
recorder/player, shell commands and perl code.  Commands and
filenames can be autocompleted using the TAB key. Command
history is available to browse with up and down arrows. 

The help system provides documentation and keyword search
covering Nama commands and effects-processing
plugins.

=head1 OPTIONS

=over 12

=item B<--gui, -g>

Start Nama in GUI mode (default when Tk is available)

=item B<--text, -t>

Start Nama in text mode

=item B<--config, -f>

Specify configuration file (default: ~/.namarc)

=item B<--project-root, -d>

Specify project root directory

=item B<--use-pwd, -p>

Use current dir for all WAV and project files

=item B<--create-project, -c>

Create project if it doesn't exist

=item B<--net-eci, -n>

Use Ecasound's Net-ECI interface

=item B<--libecasoundc, -l>

Use Ecasound's libecasoundc interface

=item B<--save-alsa, -a>

Save/restore alsa state with project data

=item B<--help, -h>