File: ncdt.1

package info (click to toggle)
ncdt 2.1-7
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 144 kB
  • sloc: ansic: 358; makefile: 40
file content (142 lines) | stat: -rw-r--r-- 3,119 bytes parent folder | download | duplicates (6)
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
.\" NcdT - directory tree printer with extended capabilities
.\" (C) 1999-2001 by Pawel Wiecek <coven@vmh.net>
.\" See Copying file for licence.

.TH NcdT 1

.SH NAME

ncdt \- directory tree printer with extended capabilities

.SH SYNOPSIS

.B ncdt
.RB [-db?]
.RB [--dirs]
.RB [--bitrate]
.RB [--prefix
.I text
]
.RB [--help]
[
.I directory
[
.I name
]]

.SH DESCRIPTION

.B ncdt
is a small utility for printing directory trees. It has some additional
features not found in tree(1). Additional capabilities are:
.TP
\-
size field for directories displays the summary size of directory subtree
instead of the size of the special file (which is somewhat more useful)
.TP
\-
sizes are displayed in a more readable format (that's a minor improvement, but
it helps a little)
.TP
\-
MP3 files are detected; additional info is displayed for them (which is
probably the nicest thing about NcdT)
The info is displayed in a compact form, like
.B <2:53 v168JR+>
where
.I 2:53
is play time,
.I v
(if present) means the file is encoded using VBR,
.I 168
is bitrate (average bitrate for VBR files),
.I J
describes channel encoding (Mono, Stereo, Joint-Stereo, Dual channel),
.I R
(if present) means the file has a RIFF header at the beginning,
.I +
(if present) means the file has ID3v2 tag attached
.I -
(if present) means there's no ID3 tag at all (none of these means there's only
ID3v1 tag present).

.PP
.B NcdT
is particularily nice for indexing CDs.

.SH OPTIONS

.TP
.B \-d --dirs
Print only directories, omit files. This mode is a rough equivalent of du(1).

.TP
.B \-b --bitrate
Print bitrate info for directories. Bitrates are displayed both for ordinary
files and directories. If all MP3 files in a given directory subtree have the
same bitrate only one number is printed, if they have various bitrates the
range is printed.

.TP
.B --prefix text
Prefix listing with given text. This option is not intended for general use.
It might be used by programs using
.B NcdT
to index CDsor doing similar operations to record additional information.

.TP
.B \-? --help
Display usage summary.

.SH USAGE

When called without any parameters
.B ncdt
displays directory tree for current directory (.).

When called with one parameter
.B ncdt
displays directory tree for specified directory.

When called with two parameters
.B ncdt
displays directory tree for the directory specified as its first parameter.
Second parameter is used as directory label for the top level directory
(instead of directory name from parameter 1).

.SH EXAMPLES

.TP
.B ncdt
prints directory tree for the current directory. It will be labeled
.I .

.TP
.B ncdt /usr
prints directory tree of /usr. It will be labeled
.I /usr

.TP
.B ncdt /cdrom 'CD #21'
prints directory tree of /cdrom. It will be labeled
.I CD #21

.TP
.B ncdt -db /cdrom
lists directory sizes, play times and bitrate ranges

.SH SEE ALSO

tree(1), du(1)

.SH BUGS

.B NcdT
uses quite a lot of memory. It's also not very fast, but on a decent CPU it
should not be noticeable.

There are no real bugs I'm aware of. I don't think there are any now.

.SH AUTHOR

Pawel Wiecek <coven@vmh.net>