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
|
.\"Created with GNOME Manpages Editor
.\"http://sourceforge.net/projects/gmanedit2
.\"Replace <program> with the program name, x with the Section Number
.TH dmedia 1 "November 23 2010" "python-dmedia"
.SH NAME
dmedia \- The Distributed Media Library
.SH SYNOPSIS
.B dmedia
.RI DIRECTORY
.RI EXTENSIONS...
.br
.SH DESCRIPTION
dmedia is simple distributed media library. Media files are given a globally unique ID based on their content-hash. Meta-data is stored in CouchDB. Meta-data for a large number of media files can be available locally (meta-data is small). Actual media files can be loaded on-demand from peers or cloud when not available locally (media files are big). Goals are to make synchronization super easy, and to lay groundwork for a distributed content creation workflow.
.SH OPTIONS
.IP \fB\-\-version\fP
Show program's version number and exit
.IP \fB\-\-help,-h\fP
Show a help message and exit
.IP \fB\-\-quick\fP
Do a fast scan without extracting extra metadata
.IP \fB\-\-project=PROJECT\fP
Add imported files to specified PROJECT
.IP \fB\-\-tag=TAG\fP
Add specified TAG to imported files
.IP \fB\-\-type=TYPE\fP
Add specified TYPE to the list of file types to limit the import to. TYPE can be 'image', 'audio', 'video' or 'all'. 'all' is the default and represents 'image', 'audio' and 'video' files.
.IP \fB\-\-extension=EXTENSION\fP
Add specified EXTENSION to the list of file extensions to limit the import to. By default, all file extensions that are recognised as audio, video or image file formats will be imported.
.SH EXAMPLES
.IP \fB\ dmedia\ /media\fp
This will import all media files from all of your connected devices.
.PP
.IP \fB\ dmedia\ /media/EOS_DIGITAL\ --type=image\fp
This will recursively import all image files from your memory card mounted at '/media/EOS_DIGITAL'.
.PP
.IP \fB\ dmedia\ /usr/share/backgrounds\ --type=image\ --tag=wallpaper\ --tag=desktop\fp
This will add all image files in the directory '/usr/share/backgrounds' and its subdirectories. The files will be tagged with 'wallpaper' and 'desktop' in the media database.
.IP \fB\ dmedia\ /usr/share/pixmaps\ --extension=svg\ --tag=desktop\fp
This will import all icons with the 'svg' file extension from /usr/share/pixmaps.
.PP
.IP \fB\ dmedia\ ~/Videos\ --type=video\ --extension=webm\fp
This will import all video files in your Videos folder, as well as any file in that folder with the 'webm' extension. Due to being a new file format your system's MIME database may not recognise this format as a video; this will allow the webm files to be imported along with the other video files.
.PP
.SH NOTES
dmedia is at an early state still, but the functionality it has so far should
be quite stable.
.PP
The `dmedia` script will eventually be turned into a VCS-style script with
several commands. For now it has a single function, to recursively import media
files from a directory. At this point, it's a quick-and-dirty demo of how media
files might be stored and how their meta-data might be stored.
.SH BUGS
If you find any bugs, please report them at http://bugs.launchpad.net/dmedia.
.SH DEVELOPMENT
The development of dmedia is managed at http://launchpad.net/dmedia, where you can find the source code, report bugs and ask questions.
.SH AUTHOR
This man page was originally written by David Green <david4dev@gmail.com> using text from the README by Jason Gerard DeRose and has since been edited by the following authors: David Green <david4dev@gmail.com>.
|