Began versioning
[dirtag.git] / README
1 Dirtag
2 ------
3
4 Tag files using symbolic links.
5
6 This makes it easy to tag music, pictures, etc., but retain simple
7 access tagged categories using the command line or dumb tools.
8
9 For example, with a raw directory like this::
10
11     raw
12     |-- a
13     |   |-- a1.dat
14     |   |-- a2.dat
15     |   `-- a3.dat
16     `-- b
17         |-- b1.dat
18         |-- b2.dat
19         `-- b3.dat
20
21 You could create a tag directory like this::
22
23     tag/
24     |-- 1
25     |   |-- a1.dat -> ../../raw/a/a1.dat
26     |   `-- b1.dat -> ../../raw/b/b1.dat
27     `-- x
28         |-- a2.dat -> ../../raw/a/a2.dat
29         |-- b3.dat -> ../../raw/b/b3.dat
30         `-- y
31             `-- b1.dat -> ../../../raw/b/b1.dat
32
33 Corresponding to the following tags::
34
35     a1.dat      1
36     a2.dat      x
37     a3.dat
38     b1.dat      1, x/y
39     b2.dat      
40     b3.dat      x
41
42 Then you could play all your x/y music with::
43
44     $ ogg123 tag/x/y/*
45
46 Or do whatever appropriate actions you want.  Dirtag provides a nice,
47 clean web interface to maintaining such a system, so that those who
48 are less familiar with the command line can comfortably maintain the
49 tag database.