PROTUX - The Professional Audio Tools for GNU/Linux v. 0.18 Series
Author : See AUTHORS file for full list of developers


I - INTRODUCTION
================

        Hello and welcome to Protux. 

        Protux aims to be the most pratical and one of the most powerful audio tools for Linux.
        Protux ***does not want to imitate Protools (tm)***,  as many people have been asking about, 
        Protux means "PROfessional audio Tools for gnu/linUX"

        THE things in Protux are 3 : the interface, the edition concepts , and the project assistence. 
	Protux Interface is based in the JMB engine, that lets you to edit you audio using combinations of keys and mouse 
	movements. The edition concepts are based in a real production environment, and all the internal engines are oriented to support real time operation. 
	
	This release is part of the Protux Project - Phase IV . You can see a complete text about the projects plans in the official web site (http://www.freesoftware.fsf.org/protux) .

	In the next section you'll see how to compile/install/run Protux in your Linux machine. We do not provide a RPM package yet, but it is possible that such package is released by some volunteer. Please visit http://rpmfind.net and check out for a Protux rpm package. 

	Thank you for testing Protux. Please send your suggestions and bugs reports to us.



II - HOW TO COMPILE/INSTALL/RUN PROTUX
======================================

- FIRST OF ALL, you HAVE to install libmustux, which can be obtained from the same place you got the protux tarball.
  Read the README file inside libmustux tarball for instructions on how to install it.
  
- download Protux source tarball (tar.gz file) and save it to a clean directory , for example /protux 
	(well, if you are reading this README, maybe you already have it done right ;-)

- Make sure you have Qt libs and Qt devel packages installed. If you have a KDE desktop installed with its 
	*-devel packages installed, then you probably wont have any problem on this point.

- Enter this directory and unzip the tarball file (if you havent done it yet...)

    cd /protux <enter>
    tar -zxvf  protux-vvv.tar.gz <enter> (being vvv the version/release number)

- Compile Protux. 
  
  NOTE : if you have all qt-devel packages installed, but you still get problems in compilation,
check if you have QTDIR environment variable properly set. Usually it is done by
typing :
	export QTDIR=/usr/lib/qt2 or export QTDIR=/usr/lib/qt3

 
  First, run configure to check all dependencies

 	 ./configure 

  then clean the last compilation (if applicable)

	 make clean 
   
  compile it
  
	 make
  
  and finnally , as root, install it

         make install
 

- run protux by typing

   protux 
    

Enjoy it, and dont forget to report the bugs (there are lots !)


---------------------------------------------------------------------

*** CURRENT FEATURES ***

READY TO USE:

- Quick Help
- Open/Import/Render(Export) Audio (.wav, .praf)
- Horizontal/Vertical Zoom
- Play, Stop, Record, Simultaneos Play and record
- Set Gain/Pan for each track.
- Gain/Pan Curves
- Song and Global Properties
- Auto Save/Load
- Touch Track (Set active)
- Set Work_Cursor
- Rendering Regions
- Shuttle
- Horizontal/Vertical  Scroll
- Real Time Filters (Still poor):  Noise Gate / Delay (echo)
- Bus in/out level monitoring 
- Track to Device Mapping
- Bus Routing
- Cross Fades 

Editing:
- Move Clip/Edge
- Mute, Solo
- Split
- Copy (Drag and Drop)
- Delete
- Select (Whole Clip for now)
- File Browser
- Spectrum Analizer

---------------------------------------------------------------------

NEARLY READY TO USE:

Project Manager:

---------------------------------------------------------------------

NOT WORKING/PRE-CODING/JUST FOR TEST

- Album Projects
- Audio Sources
- Songs
- Audio CD Browser

-------------------------------------------

JMB ACTIONS : QUICK REFERENCE

"FILE STUFF"        <FS>
"CANCEL"       <ESC>
"QUIT"         <<ESC>>
"HELP"         <H>
"ABOUT"        <AB>
"GLOBAL PROPERTIES"   <GP>  
"ZOOM MAGIC KEY"      [Z] + LRUD
"HORIZONTAL ZOOM IN"  <Z>
"HORIZONTAL ZOOM OUT" <ZX>
"VERTICAL ZOOM OUT"   <Z L_ALT>
"VERTICAL ZOOM IN"    <ZA>
"SHUTTLE"             [TAB] + LR
"SCROLL RIGHT"        <RIGHT_ARROW>
"SCROLL LEFT"          <LEFT_ARROW>
"SCROLL UP"           <UP_ARROW>
"SCROLL DOWN"         <DOWN_ARROW>
"TOUCH"                <L_SHIFT >
"TOUCH AND CENTER"     <L_SHIFT L_CONTROL>
"GO TO BEGIN"          <HOME> for the newbiews
"GO TO BEGIN"	 <W> Like reWind (very usual in midi/audio applications)	
"GAIN"         n..[G] Jog Gain for track n..
"PAN"         n..[P] Jog Pan  for track n..
"GAIN/PAN"    [n] Jog Gain/Pan for track n..1
"SELECT"       <S> 
"JOG-EXPAND LEFT"  [EW] + LR # expands/contracts left edge
"JOG-EXPAND RIGHT"  [ER] + LR # expands/contracts right edge
"JOG-EXPAND LEFT AND RIGHT"  [WR] + LR # expands/contracts both edges
"GO/STOP"                   <SPACE>
"TOGGLE TRACK RECORDABLE"  	  <R>
"RENDER TRACK"            	  <ENTER>
"RENDER SONG"            	   <<ENTER>>
"PASTE"                 	     <V> #PROTECTED
"DELETE"               	   	  <<CX>>
"COPY+DRAG+PASTE"     	    	   [C] + LRUD
"DRAG AND DROP"      	     	   [D] + LRUD
"SPLIT"             	      	   <X>
"ADD TRACK"        	       	  <<T>>
"DELETE TRACK"    	       		<T DELETE>
"SOLO/UNSOLO"    	      		<O>
"MUTE/UNMUTE"   	        	<U>
"TUNER"       		         	<TU>
"ADD NODE" 				<E>
"NODE SETUP" 				<<E>>
"FILTER SETUP" 				<<F>>
"SELECT FILTER CONTROLLER" 		[F]
"REMOVE FILTER CONTROLLER"	 	<<FD>>
"ADD FILTER CONTROLLER" 		[FG]
"EDITING MODE : NORMAL" 		<F1>
"EDITING MODE : TRACK CURVES" 		<F2>
"SELECT BUS IN"  			 [BV]
"SELECT BUS OUT" 			[BN]
"CAPTURE FROM BOTH CHANNELS" 		<JL>
"CAPTURE ONLY FROM LEFT CHANNEL" 	<KJ>
"CAPTURE ONLY FROM RIGHT CHANNEL"	<KL>
"SAVE SONG"				<<S>>
"SONG PROPERTIES"			<SP>
"JOG VERTICAL SCROLL" 			[UARR DARR]UD
"MARK REGION START"			<[>
"MARK REGION END"			<]>



