Submitting your WPS for inclusion in Rockbox

If you would like to share a customised WPS you have designed with others, then you can submit it to the Rockbox project for inclusion in the Rockbox distribution.

How to submit your WPS

If your WPS contains images it should be submitted as a ZIP file containing the WPS file and the image directory. So, example.zip might contain

example.wps
example/graphic1.bmp
example/graphic2.bmp

If your WPS is a single file, it may be submitted as is.

This file should be uploaded to the Rockbox patch tracker with category set to WPS. When submitting, please follow the guidelines below:

WPSes submitted for inclusion in Rockbox must be:

Submitted by (or with the permission of) the original author

Licensed under the GPL

Contain only images that are the intellectual property of the author or of the Rockbox project, or are licensed under a GPL compatible license.

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.

%?it<%it|%fn>
%?id<%id|%d1>
%?ia<%ia|%d2>

or variants.

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)
Name:
# Real name of the creator of the WPS
Author:
# Preferred font (including .fnt extension - leave blank for player):
Font:
# Whether the WPS is designed to have the statusbar on or off
Statusbar:
# The minimum required pixel height for the WPS
# 176 for H3xx, 128 for H1xx, 64 for Recorder/Ondio, 14 for player
Height:
# The minimum required pixel width for the WPS (160 for iRiver,
# 220 for H3xx, 160 for H1xx, 112 for Recorder/Ondio, 55 for player
Width:

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