&dhucpackage; &dhsection;

&dhpackage;

backups, transcodes, tags and marks any audio content with metadata

          &dhpackage;
          OPTIONS
          COLLECTION
          OPTIONS
          MEDIA

## DESCRIPTION

`&dhpackage;` is an audio tool which creates audio transcoded collections fast from fresh mastered files. It can be useful to backup digitalized audio media from vinyls, old tapes or whatever and include them in a database.

Telemeta first creates a simple file structure where the original sounds will be backuped. The files can be transcoded to WAV, FLAC, MP3 and OGG including the corresponding tags.

Here are some cool functions:

``

- - XML generation for metadata tags of backuped WAV

  - Audio marking from a given file or from tags thanks to the Festival speech systhesis tool

  - File corruption security with par2 recovery files

  - Collection synchronizing to remote servers (ssh+rsync)

  - Modify metadata from XML or interactive shell

## OPTIONS

These programs follow the usual &gnu; command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the Info files.

`--create`

- creates a collection repository

`--backup`

- backups and transcodes wave files to a collection

`--album`

- proccesses an entire directory (one shot album)

`--backup`

- backups a media to the collection

`--from-xml`

- takes tags and opts in original xml source

`--force`

- forces file conversion (no audio test)

`--par2`

- forces par2 security file creation

`--all-default`

- chooses default argument for all question

`--recover`

- check an repair the backuped media with the previously created "par2" security files

`--rsync`

- synchronizes collection to a remote server (ssh+rsync)

`--erase`

- erases a collection (flac, ogg, mp3 only !)

`--help`

- Show summary of options.

`--version`

- Show version of program.

## EXAMPLES

`telemeta --create my_collection`

`telemeta --backup my_collection file.wav`

`telemeta --backup my_collection --album /path/to/directory/`

`telemeta --backup my_collection --album --par2 --rsync /path/to/directory/`

`telemeta --backup my_collection --album --par2 --rsync --force /path/to/directory/`

## DOWNLOAD

Telemeta is written in python. So it doesn't require any compilation step.

On Debian or Ubuntu just add these lines to your /etc/apt/sources-list:

`deb http://debian.parisson.org/ binary/`

`deb-src http://debian.parisson.org/ source/`

Then,

`sudo apt-get update`

`sudo apt-get install telemeta`

On other linux platforms, download the lastest tar.gz archive, uncompress it, go into the created directory and just type this with your favorite shell :

`python install.py`

See README and INSTALL file for more informations.

You can also get the lastest version of Telemeta with subversion (just type 'enter' for the password:

svn co http://svn.parisson.org/svn/telemeta/trunk telemeta --username=anonymous

## DEPENDS

python (>= 2.3.5-7), python-xml, python-central (>= 0.5), python-mutagen, sox, vorbis-tools, flac, lame, normalize-audio, ecasound, festival, par2

## SEE ALSO

The program is documented fully by Guillaume Pellerin. More info at http://svn.parisson.org/telemeta/.

## AUTHOR

This manual page was written by &dhusername; <&dhemail;> for the &debian; system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the &gnu; General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.