dev builds
themes manual
device status forums
mailing lists
IRC bugs
dev guide

Rockbox mail archive

Subject: Guidelines for submitting WPS patches

Guidelines for submitting WPS patches

From: Christi Alice Scarborough <>
Date: Wed, 16 Nov 2005 22:45:08 +0000

Been poking through the various WPS patches that have been submitted,
and I can see we're going to have quality control problems here. I'd
like to propose the following guidelines for WPSes submitted for
inclusion into Rockbox:


WPSes submitted for inclusion in Rockbox must be:

1) Submitted by (or with the permission of) the original author
2) Licensed under the GPL
3) Contain only images that are the intellectual property of the
submitter or of the Rockbox project.
4) Tags for the track title, album and artist should be encoded in such
a way that they fall back to the file name (%fn), the name of the
directory immediately above (%d1), and the directory immediately above
that (%d2) respectively i.e.


or variants.

5) Must include the following information in the text submitted with
your patch (NOT just inside the ZIP file):

# Name of the WPS (_including_ .wps extension)
# Real name of the creator of the WPS
# Preferred font (including .fnt extension - leave blank for player):
# Whether the WPS is designed to have the statusbar on or off
# The minimum required pixel height for the WPS
# 176 for H3xx, 128 for H1xx, 64 for Recorder/Ondio, 10 for player
# The minimum required pixel width for the WPS (160 for iRiver,
# 220 for H3xx, 160 for H1xx, 112 for Recorder/Ondio, 77 for player

Also a link to a screen capture of the WPS (can be from the simulator).

6) Must contain a statement that the submitter has read and complied
with the guidelines for WPS files laid out at (wiki link to these


Comments? Suggestions? Anything else that needs to be in there?


Received on 2005-11-16

Page template was last modified "Tue Sep 7 00:00:02 2021" The Rockbox Crew -- Privacy Policy