[Python-apps-commits] r312 - in /packages/pykaraoke/trunk: ./ debian/ debian/overrides/

baby-guest at users.alioth.debian.org baby-guest at users.alioth.debian.org
Tue Nov 27 10:26:31 UTC 2007


Author: baby-guest
Date: Tue Nov 27 10:26:31 2007
New Revision: 312

URL: http://svn.debian.org/wsvn/python-apps/?sc=1&rev=312
Log:
[svn-inject] Applying Debian modifications to trunk

Added:
    packages/pykaraoke/trunk/debian/   (with props)
    packages/pykaraoke/trunk/debian/changelog
    packages/pykaraoke/trunk/debian/compat
    packages/pykaraoke/trunk/debian/control
    packages/pykaraoke/trunk/debian/copyright
    packages/pykaraoke/trunk/debian/docs
    packages/pykaraoke/trunk/debian/menu
    packages/pykaraoke/trunk/debian/overrides/
    packages/pykaraoke/trunk/debian/overrides/python-pykaraoke
    packages/pykaraoke/trunk/debian/pycdg.6
    packages/pykaraoke/trunk/debian/pykar.6
    packages/pykaraoke/trunk/debian/pykaraoke-bin.install
    packages/pykaraoke/trunk/debian/pykaraoke.6
    packages/pykaraoke/trunk/debian/pykaraoke.install
    packages/pykaraoke/trunk/debian/pykaraoke.links
    packages/pykaraoke/trunk/debian/pykaraoke_mini.6
    packages/pykaraoke/trunk/debian/pympg.6
    packages/pykaraoke/trunk/debian/rules   (with props)
    packages/pykaraoke/trunk/debian/watch
Modified:
    packages/pykaraoke/trunk/setup.py

Propchange: packages/pykaraoke/trunk/debian/
------------------------------------------------------------------------------
    mergeWithUpstream = 1

Added: packages/pykaraoke/trunk/debian/changelog
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/changelog?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/changelog (added)
+++ packages/pykaraoke/trunk/debian/changelog Tue Nov 27 10:26:31 2007
@@ -1,0 +1,53 @@
+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 <little_miry at yahoo.es>  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 <little_miry at yahoo.es>  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 <madcoder at debian.org>  Sat, 12 Aug 2006 21:54:30 +0200
+
+pykaraoke (0.4.2-1) unstable; urgency=low
+
+  * New Upstream Release.
+
+ -- Miriam Ruiz <little_miry at yahoo.es>  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 <little_miry at yahoo.es>  Wed,  1 Feb 2006 22:55:48 +0100
+

Added: packages/pykaraoke/trunk/debian/compat
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/compat?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/compat (added)
+++ packages/pykaraoke/trunk/debian/compat Tue Nov 27 10:26:31 2007
@@ -1,0 +1,1 @@
+5

Added: packages/pykaraoke/trunk/debian/control
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/control?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/control (added)
+++ packages/pykaraoke/trunk/debian/control Tue Nov 27 10:26:31 2007
@@ -1,0 +1,86 @@
+Source: pykaraoke
+Section: games
+Priority: optional
+Maintainer: Miriam Ruiz <little_miry at yahoo.es>
+Uploaders: Ana Guerrero <ana at ekaia.org>
+Build-Depends: debhelper (>= 5.0.37.2), python-dev, python-support (>= 0.4), libsdl-dev | libsdl1.2-dev, python-pygame
+Standards-Version: 3.7.2
+
+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)
+ .
+  Homepage: http://www.kibosh.org/pykaraoke/
+
+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)
+ .
+  Homepage: http://www.kibosh.org/pykaraoke/
+
+Package: python-pykaraoke
+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)
+ .
+  Homepage: http://www.kibosh.org/pykaraoke/

Added: packages/pykaraoke/trunk/debian/copyright
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/copyright?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/copyright (added)
+++ packages/pykaraoke/trunk/debian/copyright Tue Nov 27 10:26:31 2007
@@ -1,0 +1,28 @@
+This package was debianized by Miriam Ruiz <little_miry at yahoo.es> on
+Wed,  1 Feb 2006 22:55:48 +0100.
+
+It was downloaded from http://www.kibosh.org/pykaraoke/
+
+Copyright (C) 2005  Kelvin Lawson <kelvinl at users.sourceforge.net>
+
+Author:       Kelvin Lawson <kelvinl at users.sourceforge.net>
+Contributors: William Ferrell <willfe at gmail.com>
+
+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'.

Added: packages/pykaraoke/trunk/debian/docs
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/docs?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/docs (added)
+++ packages/pykaraoke/trunk/debian/docs Tue Nov 27 10:26:31 2007
@@ -1,0 +1,2 @@
+README.txt
+README.txt

Added: packages/pykaraoke/trunk/debian/menu
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/menu?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/menu (added)
+++ packages/pykaraoke/trunk/debian/menu Tue Nov 27 10:26:31 2007
@@ -1,0 +1,3 @@
+?package(pykaraoke):needs="x11" section="Games/Arcade" \
+	title="pyKaraoke" command="/usr/games/pykaraoke" \
+	icon="/usr/share/pixmaps/pykaraoke.xpm"

Added: packages/pykaraoke/trunk/debian/overrides/python-pykaraoke
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/overrides/python-pykaraoke?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/overrides/python-pykaraoke (added)
+++ packages/pykaraoke/trunk/debian/overrides/python-pykaraoke Tue Nov 27 10:26:31 2007
@@ -1,0 +1,5 @@
+python-pykaraoke binary: script-not-executable ./usr/share/python-support/python-pykaraoke/pykar.py
+python-pykaraoke binary: script-not-executable ./usr/share/python-support/python-pykaraoke/pycdg.py
+python-pykaraoke binary: script-not-executable ./usr/share/python-support/python-pykaraoke/pympg.py
+python-pykaraoke binary: script-not-executable ./usr/share/python-support/python-pykaraoke/pykaraoke_mini.py
+python-pykaraoke binary: script-not-executable ./usr/share/python-support/python-pykaraoke/pykaraoke.py

Added: packages/pykaraoke/trunk/debian/pycdg.6
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/pycdg.6?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/pycdg.6 (added)
+++ packages/pykaraoke/trunk/debian/pycdg.6 Tue Nov 27 10:26:31 2007
@@ -1,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 <n>    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<whatever>\fP and
+.\" \fI<whatever>\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 <kelvinl at users.sourceforge.net>
+and William Ferrell <willfe at gmail.com>.
+.PP 
+This manual page was written by Miriam Ruiz <little_miry at yahoo.es>,
+for the Debian project (but may be used by others).

Added: packages/pykaraoke/trunk/debian/pykar.6
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/pykar.6?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/pykar.6 (added)
+++ packages/pykaraoke/trunk/debian/pykar.6 Tue Nov 27 10:26:31 2007
@@ -1,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 <n>    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<whatever>\fP and
+.\" \fI<whatever>\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 <kelvinl at users.sourceforge.net>
+and William Ferrell <willfe at gmail.com>.
+.PP 
+This manual page was written by Miriam Ruiz <little_miry at yahoo.es>,
+for the Debian project (but may be used by others).

Added: packages/pykaraoke/trunk/debian/pykaraoke-bin.install
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/pykaraoke-bin.install?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/pykaraoke-bin.install (added)
+++ packages/pykaraoke/trunk/debian/pykaraoke-bin.install Tue Nov 27 10:26:31 2007
@@ -1,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
+

Added: packages/pykaraoke/trunk/debian/pykaraoke.6
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/pykaraoke.6?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/pykaraoke.6 (added)
+++ packages/pykaraoke/trunk/debian/pykaraoke.6 Tue Nov 27 10:26:31 2007
@@ -1,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 <n>    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<whatever>\fP and
+.\" \fI<whatever>\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 <kelvinl at users.sourceforge.net>
+and William Ferrell <willfe at gmail.com>.
+.PP 
+This manual page was written by Miriam Ruiz <little_miry at yahoo.es>,
+for the Debian project (but may be used by others).

Added: packages/pykaraoke/trunk/debian/pykaraoke.install
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/pykaraoke.install?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/pykaraoke.install (added)
+++ packages/pykaraoke/trunk/debian/pykaraoke.install Tue Nov 27 10:26:31 2007
@@ -1,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/
+

Added: packages/pykaraoke/trunk/debian/pykaraoke.links
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/pykaraoke.links?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/pykaraoke.links (added)
+++ packages/pykaraoke/trunk/debian/pykaraoke.links Tue Nov 27 10:26:31 2007
@@ -1,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
+

Added: packages/pykaraoke/trunk/debian/pykaraoke_mini.6
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/pykaraoke_mini.6?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/pykaraoke_mini.6 (added)
+++ packages/pykaraoke/trunk/debian/pykaraoke_mini.6 Tue Nov 27 10:26:31 2007
@@ -1,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 <n>    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<whatever>\fP and
+.\" \fI<whatever>\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 <tab> title <tab> 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 <kelvinl at users.sourceforge.net>
+and William Ferrell <willfe at gmail.com>.
+.PP 
+This manual page was written by Miriam Ruiz <little_miry at yahoo.es>,
+for the Debian project (but may be used by others).

Added: packages/pykaraoke/trunk/debian/pympg.6
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/pympg.6?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/pympg.6 (added)
+++ packages/pykaraoke/trunk/debian/pympg.6 Tue Nov 27 10:26:31 2007
@@ -1,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 <n>    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<whatever>\fP and
+.\" \fI<whatever>\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 <kelvinl at users.sourceforge.net>
+and William Ferrell <willfe at gmail.com>.
+.PP 
+This manual page was written by Miriam Ruiz <little_miry at yahoo.es>,
+for the Debian project (but may be used by others).

Added: packages/pykaraoke/trunk/debian/rules
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/rules?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/rules (added)
+++ packages/pykaraoke/trunk/debian/rules Tue Nov 27 10:26:31 2007
@@ -1,0 +1,94 @@
+#!/usr/bin/make -f
+
+# Uncomment this to turn on verbose mode.
+#export DH_VERBOSE=1
+
+CFLAGS = -Wall -g
+
+ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS)))
+	CFLAGS += -O0
+else
+	CFLAGS += -O2
+endif
+
+configure: configure-stamp
+configure-stamp:
+	dh_testdir
+	touch fonts/DejaVuSans.ttf
+	touch fonts/DejaVuSansCondensed.ttf
+	touch fonts/DejaVuSansCondensed-Bold.ttf
+	touch configure-stamp
+
+build: build-stamp
+
+build-stamp: configure-stamp 
+	dh_testdir
+	python setup.py build
+	touch $@
+
+clean:
+	dh_testdir
+	dh_testroot
+	rm -f build-stamp configure-stamp
+	rm -rf `find . -name "*.pyc"`
+	rm -rf fonts/* build debian/python-pykaraoke
+	dh_clean 
+
+install: build
+	dh_testdir
+	dh_testroot
+	dh_clean -k 
+	dh_installdirs
+	python setup.py install --root=$(CURDIR)/debian/python-pykaraoke --no-compile --verbose
+
+# Build architecture-independent files here.
+binary-indep: build install
+	dh_testdir
+	dh_testroot
+	dh_install -i --sourcedir=debian/python-pykaraoke
+	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
+	dh_installmenu -ppykaraoke debian/menu
+	dh_installman -ppykaraoke-bin debian/pykar.6
+	dh_installman -ppykaraoke-bin debian/pycdg.6
+	dh_installman -ppykaraoke-bin debian/pympg.6
+	dh_installman -ppykaraoke-bin debian/pykaraoke_mini.6
+	dh_installman -ppykaraoke debian/pykaraoke.6
+	rm -rf debian/python-pykaraoke/usr/share/pykaraoke/
+	rm -rf debian/python-pykaraoke/usr/share/applications
+	rm -rf debian/python-pykaraoke/usr/bin
+	dh_strip -i
+	dh_compress -i
+	dh_fixperms -i
+	dh_pysupport -i
+	dh_installdeb -i
+	dh_shlibdeps -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
+	dh_install -a --sourcedir=debian/python-pykaraoke
+	dh_installdirs -ppython-pykaraoke usr/share/lintian/overrides/
+	dh_install -ppython-pykaraoke debian/overrides/python-pykaraoke usr/share/lintian/overrides/
+	rm -rf debian/python-pykaraoke/usr/share/pykaraoke/
+	rm -rf debian/python-pykaraoke/usr/share/applications
+	rm -rf debian/python-pykaraoke/usr/bin
+	dh_strip -a
+	dh_compress -a
+	dh_fixperms -a
+#	dh_makeshlibs -a
+	dh_pysupport -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 configure

Propchange: packages/pykaraoke/trunk/debian/rules
------------------------------------------------------------------------------
    svn:executable = *

Added: packages/pykaraoke/trunk/debian/watch
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/debian/watch?rev=312&op=file
==============================================================================
--- packages/pykaraoke/trunk/debian/watch (added)
+++ packages/pykaraoke/trunk/debian/watch Tue Nov 27 10:26:31 2007
@@ -1,0 +1,9 @@
+# watch control file for uscan
+# See uscan(1) for format
+
+# Compulsory line, this is a version 3 file
+version=3
+
+# Examine a Webpage 
+# <Webpage URL> <string match>
+http://www.kibosh.org/pykaraoke/downloads.php pykaraoke-(.*)\.zip(.*)

Modified: packages/pykaraoke/trunk/setup.py
URL: http://svn.debian.org/wsvn/python-apps/packages/pykaraoke/trunk/setup.py?rev=312&op=diff
==============================================================================
--- packages/pykaraoke/trunk/setup.py (original)
+++ packages/pykaraoke/trunk/setup.py Tue Nov 27 10:26:31 2007
@@ -36,11 +36,11 @@
       '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:




More information about the Python-apps-commits mailing list