pr0nor Files

--- Installation --------------------------------------------------------------

pr0nor is based on an sqlite-3 database, so you need sqlite to build and use it.
$ sudo pkg_add sqlite3

After extracting the source archive type
$ make depend
$ make
$ sudo make install

--- Configuration -------------------------------------------------------------

If you want to set up some defaults create a ~/.pr0nor/pr0nor.conf file.
It uses a simple name=value style. Comments start with a #-sign at the
beginning of the line.

# Sets the mediadir,
# pr0nor -m /some/other/path overwrites this.
# The default is ./ (the current working directory).
mediadir=/home/foo/files/mediacollection

# Sets the media viewer,
# pr0nor -v otherplayer overwrites this.
# The default is mplayer, which is recommended because it exits when finished.
# This makes the consumption of a set of files with pr0nor a nice experience.
viewer=mplayer

# Sets the path to the pr0nor database file,
# pr0nor -d /some/other/path overwrites this. If the given db file doesn't exist
# already, pr0nor will create it.
# The default is ~/.pr0nor/pr0nor.db 
db=/home/foo/.pr0nor/pr0nor.db

# Sets the desired mime types of the media collection.
# The list items must be seperated by a space or a tab.
# If set, files with other mime types are ignored while initializing or updating
# a collection.
# The default is empty, which means there is no mime type filtering.
mimetypes=application/octet-stream video/

--- DB Management -------------------------------------------------------------

To initialize your database with your media collection type
$ pr0nor -i
or
$ pr0nor -i -m /path/to/your/media/collection
if you don't have your pr0nor.conf file set up with the "mediadir" option.
The default mediadir is ./ (the current working directory).

To update your database with new files or to clean up entries that don't exist
anymore in your filesystem use
$ pr0nor -u

If you have already created some tags you can use "tag auto" (see below) with
-i or -u
$ pr0nor -u tag auto

---- Usage ---------------------------------------------------------------------

-c otherfile		Use the defaults contained in otherfile instead of the
			default configuration file (~/.pr0nor/pr0nor.conf).

-r			Consume a randomly chosen file.

-rl			Consume randomly chosen files in an endless loop.

-l			Consume the whole collection one by one.

-L			Consume the whole collection one by one backwards.

-p			Print the whole file collection.

-s "big"		Consume all files containing a certain expression in
			their path.

-t t			Consume all files tagged with tag t.

-v otherplayer		Use otherplayer to consume the media.

-V			Verbose output. Print the configuration and version.

tag apply t ... f	Tag file f with tag t. If the tag doesn't exist already,
			it will be created. Use the output of -p for the file
			arguement. Use quotes, if there is whitespace in the
			path. You can apply multiple tags at once:
			tag apply t1 "t 2" t3 t4 f

tag auto		Tag all files that have an existing tag name in their
			path value with the respective tag. You can combine this
			with -i or -u:
			-u tag auto

tag create t ...	Create tag t. You can create multiple tags at once:
			tag create t1 "t 2" t3 t4 

tag delete t ...	Delete tag t. You can delete multiple tags at once:
			tag delete t1 "t 2" t3 t4 

tag list		List all tags.

tag remove t ... f	Remove tag t from file f. You can remove multiple tags
			at once: tag remove t1 "t 2" t3 t4 f