Professional Documents
Culture Documents
Para nosotros es muy grato que hayas seleccionado MFRockola entre todos los programas para
video rockolas existentes. Estamos contentos de poder liberar el cdigo fuente de ste importante
software, utilizado como un entretenimiento popular, en Centro amrica y Sur Amrica. Esto ha sido
producto del esfuerzo de varias personas, que como los creadores de muchos proyectos libres, lo
que los motiva, es la colaboracin de sus usuarios, aportando, ya sea de manera monetaria al
proyecto, o dando ideas de cmo mejorar cada da.
Te invitamos a seguir siendo participe del desarrollo de esta cultura popular, en pases como
Colombia, Venezuela y Mxico, construyendo una video rockola de tu propiedad o usando este
software de manera personal. Tambin puedes compartirlo en las redes sociales para que nos
ayudes a llegar a ms y ms personas. Si eres desarrollador o programador, puedes unirte y
colaborar, a travs de nuestro sitio en Github.com
Si quieres ms informacin puedes seguir estos enlaces donde encontraras muchsima ayuda.
http://mfrockola.com
Paginas donde encontraras toda la informacin para la construccin de tu propia video rockola
http://www.construyasuvideorockola.com
http://www.videorockola.com
http://www.github.com/runegame/mfrockola
Contenido
Caractersticas de MFRockola
MFRockola est diseado a partir de analizar los dems programas de rockola existentes en este
momento, buscado reunir sus mejores caractersticas y eliminar sus debilidades.
Caractersticas Tcnicas
Caractersticas de funcionamiento
Requisitos mnimos
Requisitos Recomendados
* Para que MFRockola pueda ejecutar los archivos de msica y video, requiere la biblioteca LibVLC,
que viene incluida en el Reproductor de video VLC, por lo que se hace indispensable instalarlo
previamente.
** MFRockola est desarrollado en Java, por lo que es necesario descargar la mquina virtual de
java Runtime Environment (JRE) antes de proceder a ejecutar el programa.
*** Es de vital importancia saber la arquitectura del sistema operativo Windows que tenemos
instalado en nuestro computador. Esto es simplemente tener claro si nuestro equipo trabaja a
32Bits o a 64Bits. En el caso de no tener en cuenta esto y equivocamos el Java, MFRockola NO
FUNCIONA. Tienen que ser de la misma arquitectura de todos los programas.
6
MFRockola est desarrollado bajo la tecnologa de Java. As; para que MFRockola pueda ser
ejecutado, debemos previamente descargar e instalar la mquina virtual de java. Recordemos que
lo primero es conocer la arquitectura del equipo. Si por ejemplo somos usuarios de la versin de 64
Bits, entonces debemos seleccionar la versin que nos corresponde, o sea la de 64Bis.
A continuacin, estn los enlaces a las descargas de ambos javas, segn sea su requerimiento.
https://www.java.com/es/download/manual.jsp
El proceso de instalacin es tan sencillo como cualquier otro programa comn. Lo describiremos a
continuacin:
7
MFRockola utiliza las libreras LibVLC que vienen incluidas en el software de reproduccin
multimedia VLC. Recuerda que, si tienes el Java a 64 Bits, debes descargar la versin de VLC a 64
Bits. Para instalarlo, primero nos dirigimos al link de descarga:
VLC 32 Bits
https://get.videolan.org/vlc/2.2.4/win32/vlc-2.2.4-win32.exe
VLC 64 Bits
https://get.videolan.org/vlc/2.2.4/win64/vlc-2.2.4-win64.exe
Se seleccionan los complementos que se desean instalar. Esta opcin se puede dejar como viene
por defecto.
11
Luego se selecciona la ruta en la que se desea instalar el VLC. Lo mejor es dejar la que viene
predeterminada, para que luego coincida con la que usa el MFRockola. En caso de querer cambiarla,
deber memorizarla, ya que la necesitar ms adelante, para configurar el MFRockola
Instalacin de MFRockola
La instalacin de MFRockola es muy sencilla. Pero antes debemos tener preparada nuestra carpeta
con la msica y muy bien organizada.
Recomendamos hacer dos particiones al disco duro. Una pequea en la que tendremos el sistema
operativo y el programa MFRockola, y otra particin de gran tamao, para organizar la msica. As,
en caso de que un da tengamos que reinstalar Windows, no tendremos que volver a organizar
nuestra base de datos de msica.
Veamos un ejemplo de cmo debe ir organizada la msica. Podemos crear una carpeta llamada
Msica en la particin D: sta ser la carpeta general. Dentro de sta carpeta creamos ms sub-
carpetas, con el nombre de cada gnero musical. Veamos en detalle:
Y dentro de cada carpeta de gnero, creamos sub-carpetas con el nombre de cada artista.
Por ltimo, dentro de cada carpeta de artista, copiamos los archivos de msica o videos que
tengamos.
14
NOTA: Al momento de copiar nuestros archivos de msica y videos, debemos revisar que los
nombres no tengan apostrofes, smbolos raros, ni la letra (), ya que el programa en ocasiones
muestra una ventana de error. Esto ser corregido prximamente.
http://mfrockola.com/descargas.html
El archivo .RAR descargado se debe descomprimir en el disco duro C:, en una carpeta llamada
MFRockola.
Luego demos doble clic sobre el archivo MFRockola.jar y nos deber aparecer la siguiente pantalla.
15
Configuracin de MFRockola
En esta ventana podemos configurar tres opciones: la primera es el tiempo de espera para
reproducir las canciones aleatorias. Estas son canciones gratis que la rockola ejecuta cuando no la
estn usando, con el fin de llamar la atencin de los clientes e incentivarlos a colocar canciones.
La tercera opcin permite adicionar un video promocional, que se va a ejecutar cuando en la lista
de reproduccin no existan canciones en espera. ste video desaparece inmediatamente cuando un
usuario seleccione una cancin.
17
En primer lugar, en sta ventana podemos determinar cuntos crditos queremos obtener por cada
moneda insertada en la video rockola.
La segunda opcin nos permite tener crditos libres, es decir, podemos seleccionar canciones sin
necesidad de insertar monedas. Esta opcin es ideal para reuniones y fiestas caseras, donde
deseamos disfrutar de la rockola sin ninguna restriccin.
La tercera opcin no tiene que ver con los crditos. Es nicamente esttica. Podemos cambiar el
tamao de letra de los nmeros que se muestran, al momento de ingresar el cdigo de la cancin.
18
Configuracin de Carpetas
La segunda casilla es para buscar la ruta de los videos que hacen entretenida la pantalla, cuando la
cancin no tiene video, es decir, cuando se ejecuta archivo MP3. En el directorio de Videos para
MP3, colocamos la ruta donde estn guardados los videos sin audio que se ejecutan aleatoriamente,
al tiempo que suena una cancin en formato MP3. Esto se hace con la intencin de llamar la
atencin del usuario.
La tercera casilla es para determinar la ruta donde haya quedado instalado el VLC. La ruta
predeterminada de instalacin del VLC es la siguiente:
C:\Program Files\VideoLan\VLC
Cmo sta opcin ya viene configurada por defecto, no es necesario modificarla, a menos que
hayamos cambiado manualmente la ruta al momento de instalar VLC.
19
En esta ventana se configuran las teclas con las que se opera la interfaz. Tambin se configura la
manera de agregar los crditos con el mouse.
Para cambiar la tecla de una funcin, hacemos clic en la caja de texto y luego presionamos la tecla
deseada.
Tambin se selecciona el clic con el que se van a agregar los crditos, ya sea el derecho o el izquierdo.
Por ltimo, se puede activar la opcin para eliminar una cancin o video que est siendo ejecutado.
Esto se hace con el clic izquierdo del mouse. Al activar sta opcin, los crditos slo se podrn
agregar con el clic derecho. Tambin se hace obligatorio colocar una contrasea, para que slo el
personal autorizado pueda eliminar las canciones.
20
Podemos dejar el fondo predeterminado o hacer uno personalizado a nuestro gusto y colocar la ruta
de ubicacin en la casilla Directorio de los fondos.
Tambin podemos seleccionar el color de las celdas de la lista de canciones y reproduccin, tipo de
fuente, tamao de fuente, color y si la deseamos en negrita.
Para ver el estilo entre una celda y otra, se puede hacer clic en el cuadro de ejemplo y se cambiar
automticamente de color.
21
Configuracin de Estadsticas
En la ventana de las estadsticas podemos observar cuantas monedas se han insertado y cuantos
crditos se han usado. Con ste dato podemos calcular el dinero recaudado.
Al dar clic en el botn de Canciones ms populares vemos un listado de las 30 canciones ms sonadas
en la rockola.
22
Promociones y premios
En sta ventana podemos activar y configurar la cantidad de crditos que se desean regalar por cada
cierto nmero de monedas insertadas. Es decir: Cada cierta cantidad de crditos, se regalar uno o
ms crditos adicionales. La opcin se puede configurar si se desea que sean crditos continuos o
no.
Tambin podemos regalar premios. Al gusto del dueo, se configura a cuantos crditos se desean
entregar un premio y el nombre del premio. A medida que modificamos estas opciones, abajo se
muestra el resultado del premio que se entregar.
23
Interfaz y controles
Controles.
Tradicionalmente se ha creado una cultura detrs de las video rockolas que permite conocer
previamente los controles que se usan para manejar MFRockola. Por lo tanto:
El teclado numrico es el principal protagonista en este tipo de software. Por lo tanto, tenemos que:
Teclas asterisco (*) y slash (/): Se utilizan para navegar por la lista de canciones.
Teclas Ms (+) y menos (-): Se utilizan para navegar entre los diferentes gneros musicales.
Click Izquierdo y Derecho del mouse: se configuran para adicionar los crditos. El monedero va
conectado al mouse.
Tecla A: su funcin es agregar crditos adicionales. Tecla adicional pensada para utilizar con
controles remotos.
Tecla N: su funcin es saltar las canciones o videos que se estn ejecutando. Tecla adicional pensada
para utilizar con controles remotos.
Tecla B: borra los crditos que se pudieron agregar por equivocacin o alguna otra razn. Tecla
adicional pensada para utilizar con controles remotos.
Agradecimientos
A Rubert Flores, por sus importantes ideas aportadas al desarrollo de MFRockola y su constante
control de calidad de todas las funciones liberadas hasta ahora. Tambin por siempre estar
pendiente del desarrollo y dar un constante apoyo al proyecto.
A Ampletos, por su aporte monetario y por ayudar a retomar el proyecto, que estaba congelado
desde hace meses. Gracias a l, este es ahora un proyecto libre y de cdigo abierto, que puede ser
adquirido por ustedes, sin costo alguno.
A todos los usuarios como t, que apoyan este proyecto dndole uso y compartindolo con sus
amigos y familiares.