mcandy Files

WELCOME TO MCANDY

I wrote this utility as a front end for controlling  Music Player Daemon (MPD) 
on my car computer. 
It works great on a 7" in-dash monitor and either a numeric keypad or scroll-wheel mouse.
(don't worry, only the buttons on the mouse are used, I'm not mousing and driving!)
It's also pretty useful for home media type setups, and who knows what else. 

I sort of patterned it's design off of dmenu, which is a cool, highly configurable tool for 
desktop environments, but not what I wanted for the car. Thanks to the guys at suckless.org
for the ideas!

The latest version should be at:
http://sourceforge.net/projects/mcandy/

BUILD
to build:

$ make 

to install to /usr/bin/

$ make install


to clean up (does not uninstall
$ make clean


BASIC OPERATION

mcandy reads stdin and builds the menu, then returns when the user makes a selection, or cancels.
invoke like:

$ ls | mcandy

and you get a menu of the filenames in the current directory. 



DEFAULT BINDINGS

Up and down arrows and the scroll wheel change the current selection

Enter, return or scroll wheel button accept the selection and exit.

Right arrow/right mouse button will skip to the next item that starts with the next letter 
alphabetically. Only useful for long lists that are sorted alphabetically, like artists. 

Left arrow, left mouse button and escape all cancel the menu with no selection returned.



SAMPLE SCRIPTS

The sample scripts are designed to control Music Player Daemon (MPD). 
You'll need a working installation of MPD and the command line client tool MPC.

To try out the sample scripts, copy the sample scripts fodler to your home directory and rename it
to .minky. 
To invoke the menus use: 
$ .minky/menu.sh





LICENSE
	   mcandy
	   sort of like dmenu
	 
	  Created by Don Ashe on 5/5/09.
	  MIT License
		Copyright (C) <2009> <Don Ashe>
	 Permission is hereby granted, free of charge, to any person obtaining a
	 copy of this software and associated documentation files (the "Software"),
	 to deal in the Software without restriction, including without
	 limitation the rights to use, copy, modify, merge, publish, distribute,
	 sublicense, and/or sell copies of the Software, and to permit persons to 
	 whom the Software is furnished to do so, subject to the following conditions:
	 
		The above copyright notice and this permission notice shall be included
		in all copies or substantial portions of the Software.
	 
	 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
	 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
	 THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
	 OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
	 ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 
	 OTHER DEALINGS IN THE SOFTWARE.