mpy3

libraries

MPy3 has a number of libraries packaged with it, and they are all designed to be used elsewhere. Check the documentation within each file for help, or contact me. Check the downloads section to get ’em.

Currently, the libraries can be broken down into four sections -- audio, display, input, and other.

audio

pymix.py - this controls ’aumix’, the popular unix console/X audio mixer. Pretty easy.

pyrx.py - a python library to control and read from rxaudio from Xaudio, which is an mp3 playing suite that includes the aforementioned rxaudio, a text-controlled mp3 player. Pretty solid!

pympg123.py - a library to control and read info from mpg123, the ubiquitous mp3 player for the console -- mpg123 has interactive mode (-R filename) that allows you to enter commands on the fly. How handy.

display

pyLCDProc.py - a python library, modeled after pyCFontz.py that makes MPy3 into an LCDProc client. Brand new in v2.1! This may become the de-facto standard, because you can use damn near any serial/parallel LPT out there, and there is a consistent set of commands for it.

pyCFontz.py - a python library to control an CrystalFontz Intelligent Serial LCD. Great LCD’s, and with the great documentation for these reasonably inexpensive LCD’s, the library should be rather solid.

pyLCDemu.py - a python library to emulate an LCD, and it uses the same function calls as pyCFontz, and attempts to mimic it -- it requires wxWindows for Python, ’cause I liked it better than Tk, and I could re-write the MainLoop for wxWindows. It works exactly the same as pyCFontz -- handy if you can’t use your LCD (like I couldn’t for a while!)

input

pyttyinput.py - input from a TTY! (shocking!). This is the standard "input" library for MPy3.

pyjoyinput.py - simple input from a joystick, with pyjoyinput.conf as the configuration. it can autodetect the number of buttons and axes yer joystick has, however it doesn’t automatically detect which was is pos/neg on your axis, so you may have to fiddle with the configuration file (which is really just a file that says "if buttonX is pressed, then send this character", or if "axisX-up, send charX"

pylircinput.py - written by Paul Jennings, and based off pyjoyinput, this little library controls mpy3 via LIRC, the Linux IR Control package -- handy!

other

pyplaylist.py - a python library for playlisting control. It’s pretty simple at the moment. It recursively will scan a directory for mp3’s, and keep them in an array. That is the "master list" by which the "playlist" for the class references. It uses mp3infor.py from Eduardo Roldan to yank the id3v1 tags.