File: frontend.txt

package info (click to toggle)
normalize-audio 0.7.7-21
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 3,032 kB
  • sloc: sh: 9,255; ansic: 8,286; perl: 635; makefile: 139; sed: 16
file content (59 lines) | stat: -rw-r--r-- 2,231 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
                                -*- text -*-

Beginning in version 0.7.1, normalize has an option --frontend that
makes the output very terse, but easy to parse.  The general format of
frontend output is "<message-type> <arg> [<arg>...]".

These message types are experimental and subject to change.  If you're
interested in writing a frontend, and there's something you'd like
added, removed, or changed, email me at chrisvaill@gmail.com.

The current message types are listed below:

NUMFILES <number_of_files>
  This message comes first, and tells how many FILE messages will
  follow.

FILE <index> <filename>
  One of these messages will be printed for each input file.  The
  index is a number that subsequent messages will use to indicate this
  particular file.

PROGRESS <file> <batch>
  *Not implemented*
  I'd like to provide an indicator of how far in the current operation
  normalize has progressed.  This is not in place in the code as of
  v0.7.1, but this is how I expect it to look.  The arguments are
  numbers indicating percent complete for the current file, and for
  the whole batch of files.

ANALYZING <index>
  Normalize is about to begin analyzing the file referred to by index.

LEVEL <index> <level>
  Analysis of the file is finished, and level is the file's volume, in
  dBFS.

AVERAGE_EXCLUDES <index> <difference>
  The file referred to by index is not being considered in the average
  level.  Its level is different from the average by difference, and
  is being considered an aberration.

AVERAGE_LEVEL <level>
  The average level of all the input files, in dBFS.

ADJUSTING <index> <gain>
  Normalize is about to begin adjusting the file referred to by index,
  using gain, given in dB.

ADJUSTED <index> <0|1>
  If the file was actually adjusted, the second argument will be 1.
  If the adjustment was not applied for a non-error reason (e.g. the
  gain was too small to be worth applying), it will be 0.

ADJUST_NEEDED <0|1>
  "ADJUST_NEEDED 1" is printed if a file was adjusted, or if the -n
  option was given and a file would need adjustment.
  "ADJUST_NEEDED 0" is printed if the -n option was not given and no
  file was adjusted, or if -n was given and no file would need
  adjustment.