View source for DR14 T.meter


==Introduction to DR14 T.meter==

'''DR14 T.meter''' is a free and opens source command line tool for computing the DR - Dynamic Range of your music according to the procedure used in the off-line meter released by the [http://www.pleasurizemusic.com/ Pleasurize Music Foundation]. 

This tool is very useful to measure how is loud your music and for understanding that a good quality album always has also a good dynamic, and it's also useful for understanding the effects of the so called loudness war. 

'''Dr14 t.meter''' is released under the terms of the  [http://www.gnu.org/copyleft/gpl.html GNU GPLv3] license and  is intended for the Linux users that can not use the Windows application released by the Pleasurize Music Foundation or the [http://www.jokhan.demon.nl/AudioStats/index.htm plugin for Foobar2000]. 

I've largely tested this application and it has always returned results identical to those of the official off-line meter. 


Feedback and Bug report: if you have some problem with the application or the packages open a bug report Here 
or if you prefer send me a feedback via e-mail '''''dr14.tmeter@gmail.com'''''

==Download==
 
 [[File:Ubuntu logo.png|30px]] [http://tiny.cc/dr14deb Ubuntu deb package - Ver.: 0.8.5]  
 [[File:Fedora-logo.png|30px]] [http://tiny.cc/dr14rpm Fedora rpm package - Ver.: 0.8.5]
 [[File:Mint_logo.png|30px]] [http://tiny.cc/dr14deb Linux Mint deb package - Ver.: 0.8.5]
 [[File:Debian-logo.png|30px]] [http://tiny.cc/dr14deb Debian deb package - Ver.: 0.8.5]
 [[File:Arch.png|30px]] [http://tiny.cc/PKGBUILD ArchLinux PKGBUILD]
 [[File:Rpm-logo.png|30px]] [http://tiny.cc/dr14src-rpm Rpm Source package - Ver.: 0.8.5]
 [[File:Tar_logo.png|30px]] [http://tiny.cc/dr14tgz Source TGZ: dr14 tmeter - Ver.: 0.8.5]

==How it works:==

it simply scans a given directory and it compute the DR value of the audio files stored in the directory. Actually we support the mp3, flac, m4a, ape and ogg formats. 
As a result it writes the resulting values in three files located in the same directory of the audio files: 

dr14.txt 
A tabbed text file 
dr14_bbcode.txt 
A table formatted in bbcode (useful for forums) 
dr14.html 
An html table, for your web-site or blog. 

To have an idea of the returned tables visit: [[DR Examples|DR results]] . For a full list of the features visit the featuers page.

==System requirement:==

The tool is written in python (3) so you must install the python package in your system and the libraries numpy and scipy as dependencies. Dr14-tmeter works correctly with python 2 and python 3. 
For decoding the audio-files the packages: lameflacvorbis-toolsfaad (2) and ffmpeg are required! 

==How to use:==

Enter in the directory where you have putted the tool and give the command: 

 > ./dr14_tmeter [your music directory] 

When the computation is finished you will find in your music directory the three files described above.  
I recommend to add the option -m to enable the multi-core mode. 
For example if your favorite album is stored in the directory /home/donald-duck/mymusic/wow music you shold take the command: 

 > ./dr14_tmeter "/home/donald-duck/mymusic/wow music" -m 

For more information type the command: 

 > ./dr14_tmeter --help 

or read the man page. 
Installation:

If you use Ubuntu, Limux Mint and Debian download and install the package in .deb format. 
If you use Fedora you shoould use the packade in rpm format, and for the rpm based distros like Suse or Mandriva you should try the source rpm package. 
If you are an ArchLinux user use the PKGBUILD provided in the AUR repository. 

If you are using another distro use the python installer: 
Enter in the package directory and with the root privileges type the command: 
 > python setup.py install --root="/" --prefix="usr" --optimize=1 

This command will install the tool in your /usr/bin directory. 
After the installation you should use the command dr14_tmeter from the shell.

==Getting dr14_t.meter with GIT==

The source is hosted on www.github.com. To view the history of the project visiti the project page. 
To checkout a copy of the most current source tree, run: 

 > git clone <nowiki>git://github.com/simon-r/dr14_t.meter.git </nowiki>
 > cd dr14_t.meter 

This will create a local copy of the repository under the directory dr14_t.meter/ in the directory in which the command was executed. 

To update your local clone of the dr14_t.meter/ repository, please execute: 

 > git pull 

in your dr14_t.meter/ directory. 


Nice music!

==We support real stereo==

[[Image:Real_stereo.png|link=http://www.tnt-audio.com/topics/realstereo_e.html]]