//
// Nagraudio  V0.5
// Nagravision sound decoder for linux.
// http://asterix.uc3m.es/nagraudio
//

Installation:

To compile    -> "make"
To install    -> "make install"
To uninstall  -> "make uninstall"

The default directory is /usr/local. If you wanna use
another one edit the Makefile and change it to whatever
directory you want.

Running:

Write nagraudio to start listening something :-).
To look at every option available type nagraudio -h or --help.

Options:

-8

  Do not use it unless you can't use anything else!!! XD.
  Under Linux, there is not (for now) full-duplex support for
  16 bits cards like SB16, so the only way is using 8 bits. It's
  awful and sounds horrible, but there is nothing else..... :(

-i

  With this option the program ignores any config files and only
  uses the command-line parameters.(See "config file" above)

-a

  This option is the best if you are a "zapping guru" :-)
  If you love zapping use it. It works great (at least to me)
  and its very cool. 

-d device

  This changes the default decoding device, /dev/dsp, for any
  other (just in case you have more than one sound card)

-nogui

  Disable the GUI in ncurses. You won't either be able to change
  the filter deep nor save audio files

-g 

  This parameter will compensate the signal lost due to decoding.
  A value of 1 will multiply the signal by 2, a value of 2 will
  multiply the signal by 4 and with a value of 3, the signal will
  be multiplied by 8.


-pre n

  This parameter will shows the filter level "pre modulation".
  This filter is used to remove the pitch added by some tunners
  to the signal.

-post n

  With this one we will chose the filter depth "post modulation".
  This filter will remove unnecesary noise in the signal.


REMARKS: From version 0.5 the meaning of depth filters has changed.
  A depth of 4 on new versions is equivalent to a depth of 7 on
  the old ones.


Config file:

Included with the sources there is an example of a config file.
Variables are very easy to understand, although I have included
comments just in case (in English though, sorry [no problem :) ])

The config file can be located in two places:
1) It can be put as "/etc/nagraudiorc" so all users would read
   that config every time
2) You can have your own config file ".nagraudiorc" in your
   home path (Example: "/home/galtor/.nagraudiorc")

Personal settings (in your home path .nagraudiorc) will override
general settings (on /etc/nagraudiorc). Command line options
will override personal settings.

GUI:

Simple interface and almost intuitive. I will comment the
keys available:

d - Activate/Deactivate decoding
a - Activate/Deactivate autodecoding
p - Changes prefilter depth
o - Changes postfilter depth
g - Changes output gain
r - Records an audio file in .raw format
w - Records an audio file in .wav format


Audio files will (for now) be saved on /tmp and their names
will be "ragraudio???.raw" o "nagraudio???.wav". The program
can save a maximum of 999 files of the same type without
overwriting them. It will automatically look for one name
with a number not already taken


Comments:

I have a SB-PCI64, and it seems that with Sb16 and compatibles
the 16 bits full-duplex does not work. For those cads use
option -8 o buy another card (and send me the old one to make
tests and improve the decoder :-) )

Besides that, only kernels higher than 2.1.120 support full
duplex, so you have to upgrade :-)

All users that have a card like mine (PCI64 or PCI128)
should remember to use this trick. Using the mixer put the balance
of the input line on the left, and on the outpout line, put the
balance on the right. Now you can hear only the decoded sound in
the right speaker. 


Acknowledgments:

Thanks to Ajo for publishing his sources.

A million thanks to Vigata, for his technical support provided
and for his web. 

Thanks to Zipher, for his translations to English (I would like
to be told what is wrong in order to improve it :) ).

Doubts?, Suggestions?, Looking forward to send me money :-)?

Write to me: galtor@gsyc.inf.uc3m.es 
