
`m.utils' is a set of scripts for searching, filtering and playing
media using UNIX-like find(1), grep(1) and pipes.

TOOLS

	- m.find - find media files by a shortcut name
	- m.grep - filter files by tags and regexps

	- m.info - get tags and info
	- m.set  - modify tags (using m.grep)
	- m.ls   - browse media directory (using m.find)

	wrappers:

		- m.mpc     - Music Player Client wrapper
		- m.mplayer - MPlayer wrapper

	- mp - simple interface to all other tools

EXAMPLES
	
	$ find ~/music/AC-DC | mpc add
	$ m.find acdc | mpc add                         # matches '$MUSIC/AC-DC'
	$ m.find acdc | grep -i big | mpc add           # filter by filename
	$ m.find acdc | m.grep 'year<1980' | mpc add    # filter by tags

	$ mplayer -shuffle `find ~/music/Pink_Floyd -type f`
	$ m.find pf | m.grep /echo/i | m.mplayer -z       
	# find, filter by title and play

	$ m.find deep_purp | m.grep /Smoke/ -o '%l'     # print song lyrics
	$ mp deep_pur :l - /Smoke/                      # easier way to do it
	$ mp :l                                         # current song lyrics

	$ ls | m.info -l                                # print track info
	$ m.set -F Lazy.mp3 t=Lazy ar='Deep Purple'     # set tags manually
	$ m.set -F Deep_Purple/Lazy.mp3 -f %ar/%t.mp3 -z all
	# parse tags from filename

USAGE

	See man pages for m.find, m.grep, m.info, m.set and mp.
	See config.example for `mp' configuration file.

INSTALL

	# make deps-cpan
	# make install

On Gentoo:

	# make deps-gcpan
	# make install

DEPENDENCIES

	All utilities are written in perl and bash. Run
	`make show-deps` to see required CPAN modules.

FILES

	- /usr/share/doc/m.utils/config.example
	- ~/.m/config

BUGS

	1. `mp' determines if CD contains a filesystem or audio by
	trying an opendir() on the mount point. Maybe this should be reworked.

	2. `m.grep' is slow. Tags processing needs to be optimized.
	3. More player wrappers can be written.

	See also TODO notes in the source code.

AUTHOR

	Victor Gaydov <victor.gaydov@gmail.com>.
	Feel free to send any bugs, suggestions, patches, etc.

LICENSE

	These files are placed in public domain.

