plamv - v0.20 - README ====================== DESCRIPTION ----------- plamv is a media jockey script for linux. it can play your mp3s, mpegs, [anime] music videos, whatever. It supports many command line based media players for linux, random play, and regexp pattern match file selection. INTRODUCTION ( or, why this exists ) ------------------------------------ plamv stands for 'play anime music video', and was originally written for that purpose. You see, we have a machine that was originally intended to play mp3's while we play magic: the gathering (r), or just while we hang out downstairs in the 'magic' room. When my brother got a new workstation he upgraded the mp3 machine to a dual-celeron 450, and all the sudden we could use it to play anime music videos. And, instead of playing them one by one we needed something to be our amv (anime music video) jockey. plamv is the perl script that was born for this purpose. I think it will work just as good on normal music videos, porn or whatever you'll be playing with it, but please always remember plamv's original design was for anime music videos, and we do not make any garuntee that it will work with anything else. ;-) INSTALLATION ------------ see the file INSTALL file for installation instructions. < it's way too complicated to fit in here. :) > REQUIREMENTS ------------ - perl - player - media - LWP::Simple perl module ONLY IF USING RANDOM.ORG SUPPORT see RANDOM.ORG USAGE ----- usage: plamv [-c ] [-d ] [-f ] [-g] [-l] [-m ] [-o ] [-p ] [-r] [-s] [-v] -c config file (Default='/usr/local/etc/plamv.conf') -d path to get amvs from (Default='/home/amvs') -f playlist file -g gestapo mode (Default=off) -l lcdproc mode (Default=off) -m regular expression match pattern (Default='.') -o extra options to pass to player (Default='') -p player to use (Default='/usr/local/bin/mplayer') -r turn on random (Default=off) -s turn on random.org support (Default=off) -v verbose mode (Default=off) DETAILS ------- is the location of your video archive. is a regexp =~ m/match_pattern/ on the filename. in our amv archive we've named the video files very descriptively with such diverse fields as band, song, anime involved, release company, director (of amv), etc. to make the -m option very useful. needs to be the (movie) player executable. needs to accept the filename as an option, and must exit on it's own when done playing. is extra options that get passed to the player before the filename of the file to play. * a couple notes about the -g option: gestapo mode runs in an endless loop that allows you to select the regexp, full screen (if using mplayer), and randomness. gestapo also ignores -m because it asks for it. in our scenario before we were concerned about random people (really only one specific person) being able to sit in front of this computer and do whatever they wanted, so we needed a restricted version that didn't need to be run from a shell. one we could put into the wmaker menu by calling xterm and telling it to run plamv, and by doing this we began to feel better about leaving the room to goto the bathroom and not worry about our entire network getting compromised. there is one user who has no password that can only login on the console that has a few simple things in the menu "xmms", "plamv", "su", etc. CONTACT ------- The authors can be reached for comment at : Phil Freeman Pat Freeman FUTURE ------ Where are we going with this ? Good question, i have an answer. Question the answer. Good Answer.