--- pykaraoke-0.5.1.orig/debian/pykar.6 +++ pykaraoke-0.5.1/debian/pykar.6 @@ -0,0 +1,87 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.TH "PYKAR" "6" "july 16, 2006" "" "" +.SH "NAME" +pykaraoke \- free CDG/MIDI/MPEG karaoke player +.SH "SYNOPSIS" +.B pykar +karfilename.kar +.SH "OVERVIEW" +.\" TeX users may be more comfortable with the \fB\fP and +.\" \fI\fP escape sequences to invode bold face and italics, +.\" respectively. +\fBpykaraoke\fP is a free karaoke player for Linux, FreeBSD and Windows. +.PP +\fBpykar\fP is a MIDI/KAR karaoke player built using python. It was written for the PyKaraoke project but is in fact a general purpose KAR player that could be used in other python projects requiring a KAR player. +.PP +The player uses the pygame library (www.pygame.org), and can therefore run on any operating system that runs pygame (currently Linux, FreeBDS, Windows and OSX). +.PP +You can use this file as a standalone player, or together with PyKaraoke. PyKaraoke provides a graphical user interface, playlists, searchable song database etc. +.PP +For those writing a media player or similar project who would like KAR support, this module has been designed to be easily incorporated into such projects and is released under the LGPL. +.PP +To play the MIDI songs on Linux, Timidity++ is also required. +.SH "USAGE" +To start the player, pass the KAR filename/path on the command line: +.PP + pykar /path/song.kar +.PP +You can also incorporate a KAR player in your own projects by importing this module. The class midPlayer is exported by the module. You can import and start it as follows: +.PP + import pykar +.br + player = pykar.midPlayer("/path/song.kar") +.br + player.Play() +.PP +If you do this, you must also arrange to call pycdg.manager.Poll() from time to time, at least every 100 milliseconds or so, to allow the player to do its work. +.PP +The class also exports Close(), Pause(), Rewind(), GetPos(). +.PP +There are two optional parameters to the initialiser, errorNotifyCallback and doneCallback: +.PP +errorNotifyCallback, if provided, will be used to print out any error messages (e.g. song file not found). This allows the module to fit together well with GUI playlist managers by utilising the same GUI's error popup window mechanism (or similar). If no callback is provided, errors are printed to stdout. errorNotifyCallback should take one parameter, the error string, e.g.: +.PP + def errorPopup (ErrorString): +.br + msgBox (ErrorString) +.PP +doneCallback can be used to register a callback so that the player calls you back when the song is finished playing. The callback should take no parameters, e.g.: +.PP + def songFinishedCallback(): +.br + msgBox ("Song is finished") +.PP +To register callbacks, pass the functions in to the initialiser: +.PP + midPlayer ("/path/song.kar", errorPopup, songFinishedCallback) +.PP +These parameters are optional and default to None. +.PP +If the initialiser fails (e.g. the song file is not present), __init__ raises an exception. +.SH "SEE ALSO" +. +You can find PyKaraoke's home page at: +.URL http://www.kibosh.org/pykaraoke/ +http://www.kibosh.org/pykaraoke/ +.P +.SH "AUTHOR" +PyKaraoke was written by Kelvin Lawson +and William Ferrell . +.PP +This manual page was written by Miriam Ruiz , +for the Debian project (but may be used by others). --- pykaraoke-0.5.1.orig/debian/changelog +++ pykaraoke-0.5.1/debian/changelog @@ -0,0 +1,90 @@ +pykaraoke (0.5.1-1ubuntu1) jaunty; urgency=low + + * Rebuild for Python 2.6. + * debian/rules: + - Call setup.py with --install-layout=deb. + + -- Siegfried-Angel Gevatter Pujals Sun, 01 Mar 2009 21:13:25 +0100 + +pykaraoke (0.5.1-1) unstable; urgency=low + + [ Miriam Ruiz ] + * New Upstream Release. + + GUI: Now works with WxPython v2.8 + + GUI: Improved search results layout + + CDG player: Improved handling of corrupt CDG files + + CDG player: Solved minor scrolling issues + * Removed Ana Guerrero from Uploaders + * Set Python Applications Packaging Team as Maintainer + * Added Homepage label to control + * Updated menu: Games/Arcade -> Games/Action + * Replaced deprecated ${Source-Version} by ${source:Version} in control + * Added dh_desktop to rules + + [ Piotr Ożarowski ] + * Build Python extension for all supported Python versions + - python-all-dev added to Build-Depends + - debian/rules file updated + * patches added: (quilt added to Build-Depends) + - fix_desktop_files + - disable_fonts_installation + - remove_hashbangs + * debian/watch file updated + * python-pykaraoke's section changed to python + * Standards-Version bumped to 3.7.3 (no changes needed) + + -- Miriam Ruiz Sun, 16 Dec 2007 20:01:35 +0100 + +pykaraoke (0.5.0.ds1-2) unstable; urgency=low + + * Moved python-support from Build-Depends-Indep to Build-Depends. + Closes: #390533. + * Removed dependency from libwxgtk-python in binary package pykaraoke. + + -- Miriam Ruiz Sun, 1 Oct 2006 20:45:56 +0200 + +pykaraoke (0.5.0.ds1-1) unstable; urgency=low + + [Miriam Ruiz] + * New Upstream Release. + + CDG: Much improved performance for running on lower spec machines. + + New C file which gives the major performance boost to the CDG player. + + It's still possible to have an ultra-portable install without the + compilation for which Numeric is required, but otherwise Numeric is + no longer required. + + CDG: Smoother scrolling and fixed horizontal scrolling. + + MIDI: Fixed mid-song tempo changes. + + MIDI: Smoother font-scaling and word-wrap. + + pykaraoke_mini: New simple GUI for simpler environments. + + Added support for GP2X. + + Many other internal changes. + * Python 2.4 is needed. + + [Ana Beatriz Guerrero Lopez] + * Updating compat to 5. + * Updated to new Python Policy and NMU ack. (Closes: #380907) + + -- Miriam Ruiz Tue, 12 Sep 2006 00:54:57 +0200 + +pykaraoke (0.4.2-1.1) unstable; urgency=low + + * Non-maintainer upload. + * Update package to the last python policy (Closes: #380907): + + use dh_pysupport. + * Bump Standards-Version to 3.7.2. + + -- Pierre Habouzit Sat, 12 Aug 2006 21:54:30 +0200 + +pykaraoke (0.4.2-1) unstable; urgency=low + + * New Upstream Release. + + -- Miriam Ruiz Wed, 19 Apr 2006 23:44:08 +0200 + +pykaraoke (0.4.1-1) unstable; urgency=low + + * Initial release Closes: #345897 + * Replaced vera.ttf font with a symbolic link to Debian's already packaged version. + + -- Miriam Ruiz Wed, 1 Feb 2006 22:55:48 +0100 + --- pykaraoke-0.5.1.orig/debian/compat +++ pykaraoke-0.5.1/debian/compat @@ -0,0 +1 @@ +5 --- pykaraoke-0.5.1.orig/debian/pympg.6 +++ pykaraoke-0.5.1/debian/pympg.6 @@ -0,0 +1,85 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.TH "PYMPG" "6" "july 16, 2006" "" "" +.SH "NAME" +pykaraoke \- free CDG/MIDI/MPEG karaoke player +.SH "SYNOPSIS" +.B pympg +mpegfilename.mpg +.SH "OVERVIEW" +.\" TeX users may be more comfortable with the \fB\fP and +.\" \fI\fP escape sequences to invode bold face and italics, +.\" respectively. +\fBpykaraoke\fP is a free karaoke player for Linux, FreeBSD and Windows. +.PP +\fBpymng\fP is an MPEG player built using python. It was written for the PyKaraoke project but is in fact a general purpose MPEG player that could be used in other python projects requiring an MPEG player. +.PP +The player uses the pygame library (www.pygame.org), and can therefore run on any operating system that runs pygame (currently Linux, FreeBSD, Windows and OSX). +.PP +You can use this file as a standalone player, or together with PyKaraoke. PyKaraoke provides a graphical user interface, playlists, searchable song database etc. +.PP +For those writing a media player or similar project who would like MPG support, this module has been designed to be easily incorporated into such projects and is released under the LGPL. +.SH "USAGE" +To start the player, pass the MPEG filename/path on the command line: +.PP + python pympg.py /path/song.mpg +.PP +You can also incorporate a MPG player in your own projects by importing this module. The class mpgPlayer is exported by the module. You can import and start it as follows: +.PP + import pympg +.br + player = pympg.mpgPlayer("/path/song.mpg") +.br + player.Play() +.PP +If you do this, you must also arrange to call pympg.manager.Poll() from time to time, at least every 100 milliseconds or so, to allow the player to do its work. +.PP +The class also exports Close(), Pause(), Rewind(), GetPos(). +.PP +There are two optional parameters to the initialiser, errorNotifyCallback and doneCallback: +.PP +errorNotifyCallback, if provided, will be used to print out any error messages (e.g. song file not found). This allows the module to fit together well with GUI playlist managers by utilising the same GUI's error popup window mechanism (or similar). If no callback is provided, errors are printed to stdout. errorNotifyCallback should take one parameter, the error string, e.g.: +.PP + def errorPopup (ErrorString): +.br + msgBox (ErrorString) +.PP +doneCallback can be used to register a callback so that the player calls you back when the song is finished playing. The callback should take no parameters, e.g.: +.PP + def songFinishedCallback(): +.br + msgBox ("Song is finished") +.PP +To register callbacks, pass the functions in to the initialiser: +.PP + mpgPlayer ("/path/song.mpg", errorPopup, songFinishedCallback) +.PP +These parameters are optional and default to None. +.PP +If the initialiser fails (e.g. the song file is not present), __init__ raises an exception. +.SH "SEE ALSO" +. +You can find PyKaraoke's home page at: +.URL http://www.kibosh.org/pykaraoke/ +http://www.kibosh.org/pykaraoke/ +.P +.SH "AUTHOR" +PyKaraoke was written by Kelvin Lawson +and William Ferrell . +.PP +This manual page was written by Miriam Ruiz , +for the Debian project (but may be used by others). --- pykaraoke-0.5.1.orig/debian/pykaraoke.6 +++ pykaraoke-0.5.1/debian/pykaraoke.6 @@ -0,0 +1,66 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.TH "PYKARAOKE" "6" "july 16, 2006" "" "" +.SH "NAME" +pykaraoke \- free CDG/MIDI/MPEG karaoke player +.SH "SYNOPSIS" +.B pykaraoke +.SH "DESCRIPTION" +.\" TeX users may be more comfortable with the \fB\fP and +.\" \fI\fP escape sequences to invode bold face and italics, +.\" respectively. +\fBpykaraoke\fP is a free karaoke player for Linux, FreeBSD and Windows. +You can use this program to play your collection of CDG, MIDI and MPEG karaoke songs. +.PP +PyKaraoke Features: + * CDG (MP3+G, OGG+G) playback \- Play standard CDG karaoke files + * MIDI (.MID/.KAR) playback \- Play MIDI format karaoke files + * MPEG playback \- Play karaoke songs and movies in MPEG format + * Playlist \- Queue up songs, sit back and enjoy + * Searchable song database \- Easily find your songs from the main screen + * Search inside ZIP files \- Play MP3+G/MIDI files wrapped in ZIP files + * Cross\-platform \- Runs on Linux, FreeBSD and Windows +.SH "USAGE" +The player starts in Search View. From here you can search for songs in your song database. You need to first set up the database, however, by clicking "Add Songs". +.PP +To set up the database, add the folders that contain your karaoke songs. Select which type of files you are interested in adding to the search database (CDG, MPG etc). Click "Look Inside Zips" if you also want to search inside any ZIP files found in the folders for more karaoke songs. +.PP +When you have finished adding folders, and setting your preferences, click "Scan Now" to start building the database. This can take some time but only needs to be done once. The search engine then searches your database, rather than searching the hard disk every time you search for a song. +.PP +Once you have set up your database, clicking "Save" will save the database and settings for the next time you run the program. (The information is saved in a .pykaraoke folder in your home directory). +.PP +If you get more karaoke files, don't forget to rescan the hard disk and build the database again. Otherwise the new files won't be visible in the search engine. +.PP +With your database set up, you are ready to start searching for and playing your karaoke songs. From the main window, enter the name of the song you would like to find and click "Search". This will populate the Search Results panel below with the matching song files. From here double\-clicking a song plays it directly. You can also add the song to your playlist by right\-clicking on the song and using the popup menu. +.PP +There is also a simple explorer\-like interface that can be selected using a drop\-down box on the main window ("Folder View"). Using this you can also play songs directly or add them to the playlist, by right\-clicking on the song and using the popup menu. +.PP +In the right\-hand side of the window you will find your playlist. Songs can be added from the search results or folder browser, until you have built up your playlist. Once ready, click on the song you would like to start with. When the song is finished playing, the next song down the playlist will automatically start playing. You can also delete single songs, or clear the entire playlist by right\-clicking on an item in the playlist. +.PP +pykaraoke is actually a GUI frontend which controls three libraries, pycdg for CDG files, pykar for MIDI/KAR files and pympg for MPEG files. If you do not wish to use the GUI you can actually start a player directly from the command\-line (or by associating file\-types in your operating system). +.SH "SEE ALSO" +. +You can find PyKaraoke's home page at: +.URL http://www.kibosh.org/pykaraoke/ +http://www.kibosh.org/pykaraoke/ +.P +.SH "AUTHOR" +PyKaraoke was written by Kelvin Lawson +and William Ferrell . +.PP +This manual page was written by Miriam Ruiz , +for the Debian project (but may be used by others). --- pykaraoke-0.5.1.orig/debian/control +++ pykaraoke-0.5.1/debian/control @@ -0,0 +1,88 @@ +Source: pykaraoke +Section: games +Priority: optional +Maintainer: Ubuntu MOTU Developers +XSBC-Original-Maintainer: Python Applications Packaging Team +Uploaders: Miriam Ruiz +Homepage: http://www.kibosh.org/pykaraoke/ +Build-Depends: debhelper (>= 5.0.37.2), python-all-dev, python-support (>= 0.4), + libsdl-dev | libsdl1.2-dev, python-pygame, quilt (>= 0.40-1) +Standards-Version: 3.7.3 + +Package: pykaraoke +Architecture: all +Depends: pykaraoke-bin (= ${source:Version}), + python-pykaraoke (>= ${source:Version}), + ${python:Depends}, python-pygame, python-wxgtk2.6 +Suggests: python-numeric +Description: free CDG/MIDI/MPEG karaoke player + PyKaraoke is a free karaoke player. You can use this program to play your + collection of CDG, MIDI and MPEG karaoke songs. + . + pykaraoke is a frontend for the pycdg and pympg karaoke players. It provides + a search engine to find your songs, a file/folder browser to pick songs from + disk, as well as a playlist. + . + Features: + * CDG (MP3+G, OGG+G) playback - Play standard CDG karaoke files + * MIDI (.MID/.KAR) playback - Play MIDI format karaoke files + * MPEG playback - Play karaoke songs and movies in MPEG format + * Playlist - Queue up songs, sit back and enjoy + * Searchable song database - Easily find your songs from the main screen + * Search inside ZIP files - Play MP3+G/MIDI files wrapped in ZIP files + * Cross-platform - Runs on Windows and Linux + . + MIDI/KAR support on Linux, requires the following: + * Timidity++ + * Sounds/patches for Timidity++ (e.g. freepats or eawpatches) + +Package: pykaraoke-bin +Architecture: all +Depends: ${python:Depends}, python-pykaraoke (>= ${source:Version}), + python-pygame, ttf-dejavu +Description: free CDG/MIDI/MPEG karaoke player + PyKaraoke is a free karaoke player. You can use this program to play your + collection of CDG, MIDI and MPEG karaoke songs. + . + This package includes the command-line programs to play CDG files, MIDI/KAR + files and MPEG files. + . + pykaraoke-mini is a frontend for the pycdg and pympg karaoke players. It is + similar to pykaraoke, but it is designed for use on small portable devices + rather than PC's. In particular, it could be useful on any device lacking a + keyboard and mouse. + . + Features: + * CDG (MP3+G, OGG+G) playback - Play standard CDG karaoke files + * MIDI (.MID/.KAR) playback - Play MIDI format karaoke files + * MPEG playback - Play karaoke songs and movies in MPEG format + . + MIDI/KAR support on Linux, requires the following: + * Timidity++ + * Sounds/patches for Timidity++ (e.g. freepats or eawpatches) + +Package: python-pykaraoke +Section: python +Architecture: any +Depends: ${shlibs:Depends}, ${python:Depends}, python-pygame, ttf-dejavu, + ${misc:Depends} +Recommends: timidity, freepats +Suggests: python-numeric +Description: free CDG/MIDI/MPEG karaoke player + PyKaraoke is a free karaoke player. You can use this program to play your + collection of CDG, MIDI and MPEG karaoke songs. + . + This package includes the python modules needed to play CDG files, MIDI/KAR + files and MPEG files. + . + This package also includes the arch-dependent modules that gives a major + performance boost to the CDG player. + . + Features: + * CDG (MP3+G, OGG+G) playback - Play standard CDG karaoke files + * MIDI (.MID/.KAR) playback - Play MIDI format karaoke files + * MPEG playback - Play karaoke songs and movies in MPEG format + . + MIDI/KAR support on Linux, requires the following: + * Timidity++ + * Sounds/patches for Timidity++ (e.g. freepats or eawpatches) --- pykaraoke-0.5.1.orig/debian/watch +++ pykaraoke-0.5.1/debian/watch @@ -0,0 +1,5 @@ +# watch control file for uscan +# See uscan(1) for format + +version=3 +http://sf.net/pykaraoke/pykaraoke-(.*)\.zip --- pykaraoke-0.5.1.orig/debian/menu +++ pykaraoke-0.5.1/debian/menu @@ -0,0 +1,3 @@ +?package(pykaraoke):needs="x11" section="Games/Action" \ + title="pyKaraoke" command="/usr/games/pykaraoke" \ + icon="/usr/share/pixmaps/pykaraoke.xpm" --- pykaraoke-0.5.1.orig/debian/pykaraoke.links +++ pykaraoke-0.5.1/debian/pykaraoke.links @@ -0,0 +1,4 @@ +/usr/share/fonts/truetype/ttf-dejavu/DejaVuSans.ttf usr/share/pykaraoke/fonts/DejaVuSans.ttf +/usr/share/fonts/truetype/ttf-dejavu/DejaVuSansCondensed.ttf usr/share/pykaraoke/fonts/DejaVuSansCondensed.ttf +/usr/share/fonts/truetype/ttf-dejavu/DejaVuSansCondensed-Bold.ttf usr/share/pykaraoke/fonts/DejaVuSansCondensed-Bold.ttf + --- pykaraoke-0.5.1.orig/debian/docs +++ pykaraoke-0.5.1/debian/docs @@ -0,0 +1 @@ +README.txt --- pykaraoke-0.5.1.orig/debian/rules +++ pykaraoke-0.5.1/debian/rules @@ -0,0 +1,85 @@ +#!/usr/bin/make -f + +# Uncomment this to turn on verbose mode. +#export DH_VERBOSE=1 + +include /usr/share/quilt/quilt.make + +PYVERS=$(shell pyversions -vr) +CFLAGS = -Wall -g + +ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) + CFLAGS += -O0 +else + CFLAGS += -O2 +endif + +build: patch build-stamp +build-stamp: $(PYVERS:%=build-ext-%) + touch $@ +build-ext-%: + dh_testdir + python$* setup.py build + touch $@ + +clean: unpatch + dh_testdir + dh_testroot + find . -name "*.pyc" -delete + rm -rf build + dh_clean build-stamp install-stamp python-ext-* build-ext-* + +install: install-stamp +install-stamp: $(PYVERS:%=install-ext-%) + touch $@ +install-ext-%: + python$* setup.py install --install-layout=deb --skip-build \ + --root $(CURDIR)/debian/python-pykaraoke + touch $@ + +# Build architecture-independent files here. +binary-indep: install + dh_testdir + dh_testroot + dh_install -i --sourcedir=debian/python-pykaraoke + dh_installmenu -ppykaraoke debian/menu + dh_installman -ppykaraoke-bin debian/pykar.6 debian/pycdg.6 \ + debian/pympg.6 debian/pykaraoke_mini.6 + dh_installman -ppykaraoke debian/pykaraoke.6 + dh_link -ppykaraoke usr/share/doc/python-pykaraoke usr/share/doc/pykaraoke + dh_link -ppykaraoke-bin usr/share/doc/python-pykaraoke usr/share/doc/pykaraoke-bin + rm -rf debian/python-pykaraoke/usr/share/pykaraoke/ + rm -rf debian/python-pykaraoke/usr/share/applications + rm -rf debian/python-pykaraoke/usr/bin + dh_compress -i + dh_fixperms -i + dh_pysupport -i + dh_desktop -i + dh_installdeb -i + dh_gencontrol -i + dh_md5sums -i + dh_builddeb -i + +# Build architecture-dependent files here. +binary-arch: build install + dh_testdir + dh_testroot + dh_installchangelogs -ppython-pykaraoke + dh_installdocs -ppython-pykaraoke + rm -rf debian/python-pykaraoke/usr/share/pykaraoke/ \ + debian/python-pykaraoke/usr/share/applications \ + debian/python-pykaraoke/usr/bin + dh_strip -a + dh_compress -a + dh_fixperms -a +# dh_makeshlibs -a + dh_pysupport -a + dh_desktop -a + dh_installdeb -a + dh_shlibdeps -a + dh_gencontrol -a + dh_md5sums -a + dh_builddeb -a + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install --- pykaraoke-0.5.1.orig/debian/pykaraoke_mini.6 +++ pykaraoke-0.5.1/debian/pykaraoke_mini.6 @@ -0,0 +1,75 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.TH "PYKARAOKE" "6" "july 16, 2006" "" "" +.SH "NAME" +pykaraoke_mini \- free CDG/MIDI/MPEG karaoke player +.SH "SYNOPSIS" +.B pykaraoke_mini +.SH "DESCRIPTION" +.\" TeX users may be more comfortable with the \fB\fP and +.\" \fI\fP escape sequences to invode bold face and italics, +.\" respectively. +\fBpykaraoke\fP is a free karaoke player for Linux, FreeBSD and Windows. +You can use this program to play your collection of CDG, MIDI and MPEG karaoke songs. +.PP +PyKaraoke Features: + * CDG (MP3+G, OGG+G) playback \- Play standard CDG karaoke files + * MIDI (.MID/.KAR) playback \- Play MIDI format karaoke files + * MPEG playback \- Play karaoke songs and movies in MPEG format + * Playlist \- Queue up songs, sit back and enjoy + * Searchable song database \- Easily find your songs from the main screen + * Search inside ZIP files \- Play MP3+G/MIDI files wrapped in ZIP files + * Cross\-platform \- Runs on Linux, FreeBSD and Windows +.SH "USAGE" +pykaraoke_mini is a frontend for the pycdg and pympg karaoke players. It is similar to pykaraoke.py, but it is designed for use on small portable devices rather than PC's. In particular, it could be useful on any device lacking a keyboard and mouse. +.PP +It presents a scrolling list of songs to choose from, sorted by title, artist, or filename. It works within the same pygame window used to render the karaoke songs themselves, so the scrolling interface is not available while a song is being performed. The biggest strength of pykaraoke_mini is that it does not rely on a keyboard or a windowing interface, so it is ideal for use with a joystick or even an IR remote control in a bar. +.PP +Unlike pykaraoke, pykaraoke_mini does not store a database of song files, nor does it search around through different folders to find your song files. Instead, it is your responsibility to build a catalog file, which is a text file that contains one line per each song. Each line should be of the form: +.PP + filename title artist +.PP +You can include international characters by encoding the file in UTF\-8. All three of these fields will be presented to the user in the scrolling list. The filename is assumed to be relative to the catalog file itself. +.PP +If you like, you can maintain multiple different catalog files ofthis form, which will allow you to run pykaraoke_mini with different subsets of your song files. Use the \-\-catalog command\-line option to specify the full path to your catalog file; the default filename is songs/catalog.txt. +.PP +While navigating the scrolling menu, the following keys are available: +.PP + up / down : scroll through the list. Hold the button down to scroll very rapidly. + + pageup / pagedown : scroll a page at a time. + + enter : select the highlighted song for performance. + + tab : change the sort mode between title, artist, and filename. + The current sort key is displayed first for each file. + + + / \- : enlarge or reduce the font scale. This also affects the font scale when a MIDI file is selected (but does not affect CDG or MPG files). + + a\-z : search for a song beginning with the indicated letter. If you type multiple letters, search for a song beginning with the string you type. +.SH "SEE ALSO" +. +You can find PyKaraoke's home page at: +.URL http://www.kibosh.org/pykaraoke/ +http://www.kibosh.org/pykaraoke/ +.P +.SH "AUTHOR" +PyKaraoke was written by Kelvin Lawson +and William Ferrell . +.PP +This manual page was written by Miriam Ruiz , +for the Debian project (but may be used by others). --- pykaraoke-0.5.1.orig/debian/copyright +++ pykaraoke-0.5.1/debian/copyright @@ -0,0 +1,28 @@ +This package was debianized by Miriam Ruiz on +Wed, 1 Feb 2006 22:55:48 +0100. + +It was downloaded from http://www.kibosh.org/pykaraoke/ + +Copyright (C) 2005 Kelvin Lawson + +Author: Kelvin Lawson +Contributors: William Ferrell + +License: + + This package is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This package is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this package; if not, write to the Free Software + Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + +On Debian systems, the complete text of the GNU Lesser General +Public License can be found in `/usr/share/common-licenses/LGPL'. --- pykaraoke-0.5.1.orig/debian/pykaraoke.install +++ pykaraoke-0.5.1/debian/pykaraoke.install @@ -0,0 +1,5 @@ +usr/bin/pykaraoke usr/games +usr/share/pykaraoke/icons/* +usr/share/applications/pykaraoke.desktop +usr/share/pykaraoke/icons/pykaraoke.xpm usr/share/pixmaps/ + --- pykaraoke-0.5.1.orig/debian/pycdg.6 +++ pykaraoke-0.5.1/debian/pycdg.6 @@ -0,0 +1,92 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.TH "PYCDG" "6" "july 16, 2006" "" "" +.SH "NAME" +pykaraoke \- free CDG/MIDI/MPEG karaoke player +.SH "SYNOPSIS" +.B pycdg +[ options ] songfilename.cdg +.SH "OVERVIEW" +.\" TeX users may be more comfortable with the \fB\fP and +.\" \fI\fP escape sequences to invode bold face and italics, +.\" respectively. +\fBpykaraoke\fP is a free karaoke player for Linux, FreeBSD and Windows. +.PP +\fBpycdg\fP is a CDG karaoke player which supports MP3+G and OGG+G tracks. +.PP +The player uses the pygame library (www.pygame.org), and can therefore run on any operating system that runs pygame (currently Linux, FreeBSD, Windows and OSX). +.PP +You can use this file as a standalone player, or together with PyKaraoke. PyKaraoke provides a graphical user interface, playlists, searchable song database etc. +.PP +For those writing a media player or similar project who would like CDG support, this module has been designed to be easily incorporated into such projects and is released under the LGPL. +.PP +Numeric module (numpy.sourceforge.net) is required only if you do not use the compiled C low\-level CDG implementation in _pycdgAux.c +.SH "USAGE" +To start the player, pass the CDG filename/path on the command line: +.PP + python pycdg.py /path/song.cdg +.PP +You can also incorporate a CDG player in your own projects by importing this module. The class cdgPlayer is exported by the module. You can import and start it as follows: +.PP + import pycdg +.br + player = pycdg.cdgPlayer("/path/song.cdg") +.br + player.Play() +.PP +If you do this, you must also arrange to call pycdg.manager.Poll() from time to time, at least every 100 milliseconds or so, to allow the player to do its work. +.PP +The class also exports Close(), Pause(), Rewind(), GetPos(). +.PP +There are two optional parameters to the initialiser, errorNotifyCallback and doneCallback: +.PP +errorNotifyCallback, if provided, will be used to print out any error messages (e.g. song file not found). This allows the module to fit together well with GUI playlist managers by utilising the same GUI's error popup window mechanism (or similar). If no callback is provided, errors are printed to stdout. errorNotifyCallback should take one parameter, the error string, e.g.: +.PP + def errorPopup (ErrorString): +.br + msgBox (ErrorString) +.PP +doneCallback can be used to register a callback so that the player calls you back when the song is finished playing. The callback should take no parameters, e.g.: +.PP + def songFinishedCallback(): +.br + msgBox ("Song is finished") +.PP +To register callbacks, pass the functions in to the initialiser: +.PP + cdgPlayer ("/path/song.cdg", errorPopup, songFinishedCallback) +.PP +These parameters are optional and default to None. +.PP +If the initialiser fails (e.g. the song file is not present), __init__ raises an exception. +.SH "OPTIONS" +pycdg also takes various command\-line options for setting the window size, position, and update rate. Type the following for a full list of options: + +$ pycdg \-\-help + +.SH "SEE ALSO" +. +You can find PyKaraoke's home page at: +.URL http://www.kibosh.org/pykaraoke/ +http://www.kibosh.org/pykaraoke/ +.P +.SH "AUTHOR" +PyKaraoke was written by Kelvin Lawson +and William Ferrell . +.PP +This manual page was written by Miriam Ruiz , +for the Debian project (but may be used by others). --- pykaraoke-0.5.1.orig/debian/pykaraoke-bin.install +++ pykaraoke-0.5.1/debian/pykaraoke-bin.install @@ -0,0 +1,6 @@ +usr/bin/pycdg usr/games +usr/bin/pykar usr/games +usr/bin/pympg usr/games +usr/bin/pykaraoke_mini usr/games +usr/share/applications/pykaraoke_mini.desktop + --- pykaraoke-0.5.1.orig/debian/patches/disable_fonts_installation.patch +++ pykaraoke-0.5.1/debian/patches/disable_fonts_installation.patch @@ -0,0 +1,22 @@ +Index: pykaraoke-0.5.1/setup.py +=================================================================== +--- pykaraoke-0.5.1.orig/setup.py ++++ pykaraoke-0.5.1/setup.py +@@ -36,11 +36,12 @@ data_files = [ + 'icons/microphone.ico', + 'icons/pykaraoke.xpm', + 'icons/splash.jpg']), +- ('share/pykaraoke/fonts', [ +- 'fonts/DejaVuSans.ttf', +- 'fonts/DejaVuSansCondensed.ttf', +- 'fonts/DejaVuSansCondensed-Bold.ttf', +- ])] ++# ('share/pykaraoke/fonts', [ ++# 'fonts/DejaVuSans.ttf', ++# 'fonts/DejaVuSansCondensed.ttf', ++# 'fonts/DejaVuSansCondensed-Bold.ttf', ++# ])] ++ ] + + # These data files only make sense on Unix-like systems. + if env != ENV_WINDOWS: --- pykaraoke-0.5.1.orig/debian/patches/remove_hashbangs.patch +++ pykaraoke-0.5.1/debian/patches/remove_hashbangs.patch @@ -0,0 +1,45 @@ +Index: pykaraoke-0.5.1/pycdg.py +=================================================================== +--- pykaraoke-0.5.1.orig/pycdg.py ++++ pykaraoke-0.5.1/pycdg.py +@@ -1,4 +1,3 @@ +-#!/usr/bin/env python + + # pycdg - CDG/MP3+G Karaoke Player + +Index: pykaraoke-0.5.1/pykar.py +=================================================================== +--- pykaraoke-0.5.1.orig/pykar.py ++++ pykaraoke-0.5.1/pykar.py +@@ -1,4 +1,3 @@ +-#!/usr/bin/env python + + # pykar - KAR/MID Karaoke Player + # +Index: pykaraoke-0.5.1/pykaraoke.py +=================================================================== +--- pykaraoke-0.5.1.orig/pykaraoke.py ++++ pykaraoke-0.5.1/pykaraoke.py +@@ -1,4 +1,3 @@ +-#!/usr/bin/env python + + # pykaraoke - Karaoke Player Frontend + # +Index: pykaraoke-0.5.1/pykaraoke_mini.py +=================================================================== +--- pykaraoke-0.5.1.orig/pykaraoke_mini.py ++++ pykaraoke-0.5.1/pykaraoke_mini.py +@@ -1,4 +1,3 @@ +-#!/usr/bin/env python + + # pykaraoke - Karaoke Player Frontend + # +Index: pykaraoke-0.5.1/pympg.py +=================================================================== +--- pykaraoke-0.5.1.orig/pympg.py ++++ pykaraoke-0.5.1/pympg.py +@@ -1,4 +1,3 @@ +-#!/usr/bin/env python + + # pympg - MPEG Karaoke Player + # --- pykaraoke-0.5.1.orig/debian/patches/series +++ pykaraoke-0.5.1/debian/patches/series @@ -0,0 +1,3 @@ +disable_fonts_installation.patch +fix_desktop_files.patch +remove_hashbangs.patch --- pykaraoke-0.5.1.orig/debian/patches/fix_desktop_files.patch +++ pykaraoke-0.5.1/debian/patches/fix_desktop_files.patch @@ -0,0 +1,37 @@ +Index: pykaraoke-0.5.1/install/pykaraoke.desktop +=================================================================== +--- pykaraoke-0.5.1.orig/install/pykaraoke.desktop ++++ pykaraoke-0.5.1/install/pykaraoke.desktop +@@ -1,6 +1,5 @@ + [Desktop Entry] + Type=Application +-Encoding=UTF-8 + Name=PyKaraoke + Name[lt]=PyKaraoke + GenericName=Karaoke player +@@ -9,5 +8,5 @@ Comment[lt]=Universalus karaoke muzikos + Icon=/usr/share/pykaraoke/icons/pykaraoke.xpm + Exec=pykaraoke + Terminal=false +-MimeType=audio/x-karaoke;audio/x-midi;audio/midi +-Categories=Application;AudioVideo;Player; ++MimeType=audio/x-karaoke;audio/x-midi;audio/midi; ++Categories=AudioVideo;Player; +Index: pykaraoke-0.5.1/install/pykaraoke_mini.desktop +=================================================================== +--- pykaraoke-0.5.1.orig/install/pykaraoke_mini.desktop ++++ pykaraoke-0.5.1/install/pykaraoke_mini.desktop +@@ -1,11 +1,10 @@ + [Desktop Entry] + Type=Application +-Encoding=UTF-8 + Name=PyKaraoke Mini + GenericName=Karaoke player + Comment=Minimum-interface PyKaraoke + Icon=/usr/share/pykaraoke/icons/pykaraoke.xpm + Exec=pykaraoke_mini + Terminal=false +-MimeType=audio/x-karaoke;audio/x-midi;audio/midi +-Categories=Application;AudioVideo;Player; ++MimeType=audio/x-karaoke;audio/x-midi;audio/midi; ++Categories=AudioVideo;Player;