The WPS Gallery

What is the WPS Gallery?

Please note that some of these themes require custom builds which are not supported by the Rockbox team (it should be stated in the description). See the forums for more information on unsupported builds.

There are guides to creating your own WPS here and here, and a guide to uploading your completed WPS here.

WPS Galleries (model-specific)

The WPS Gallery has been split into different pages for each model, which can be accessed with the following links:

• Archos WPS Gallery
• iAudio M5 / iriver H1x0 / iPod 1G / iPod 2G / iPod 3G / iPod 4G Grey WPS Gallery
• iriver H3x0 & iPod Color/Photo WPS Gallery
• iPod 5G (Video) WPS Gallery
• iPod Nano WPS Gallery
• iPod Mini WPS Gallery
• iAudio X5 & iriver H10 20GB WPS Gallery
• iriver H10 5/6GB WPS Gallery
• Toshiba Gigabeat Fxx & Xxx WPS Gallery
• Sansa e200 WPS Gallery

WPS Upload Guide

PLEASE DO NOT UPLOAD CONTENT FOR WHICH YOU DO NOT OWN THE COPYRIGHT
Any copyrighted content will be removed. We will also honour any requests from copyright owners to remove copyrighted materials we might have missed. Perhaps a different, suitably licensed image might work as a replacement. See the FreeImages page for some links to sources of images with open licenses.

This is a guide for posting your own WPS creations in the galleries, it will walk you through the steps required to get your WPS shared with the Rockbox community. Please read the ThemeGuidelines page before getting started. For an example of what the final product will look like if it's done properly, click here.

0) SIGN IN/REGISTER

If you have not registered with the Rockbox Wiki yet, you need to do so in order to contribute to the WPS Gallery. Click here to register, and be sure to take note of the second step.

If you have registered already, and took note of the second step when you did, you're ready for step 1.

1) PACKAGE YOUR FILES

If your WPS is simply a .WPS file and does not involve any extra files (i.e. images, fonts, icons, etc.), you can skip to step 2.

A .ZIP file of your WPS and all its associated files needs to be created. Here's what you do:

1. Create a folder called ".rockbox" (note the . at the start)
2. Inside that folder make another called "WPS". Inside this folder is where you put your WPS files.
3. Your WPS file with the ".WPS" extension that contains all the code should go in here.
4. Any pictures or WPS backgrounds need to be in a folder with the exact same name as the .WPS without the extension. (eg: test.WPS would have a folder named "test") This folder should be placed in the "WPS" folder.
5. If you are including a theme file you need to place it in a folder called "themes" and place the folder inside of the ".rockbox" folder.
6. If you are including a menu background you need to place it in a "backdrops" folder inside of the ".rockbox" folder.
7. The same goes for a font that isn't part of the font package. Put it in a folder called "fonts" inside of the ".rockbox" folder.
8. If you are NOT including a menu background then the null background line must be included in your theme file. (eg: "backdrop:" )
9. You can now create a zip file of the .rockbox folder using a program like 7-Zip, WinZip, WinRar or anything else that can get the job done.

If theme files, menu backgrounds, fonts, and so on are required by your WPS but aren't included they will not display properly for others and they will think you are a very bad artist.

2) TAKE SCREENSHOTS

You must include a screenshot of your WPS to display on the page so that people can see what they're downloading before expending precious time and bandwidth. If your WPS changes the appearance of the menu as well, you might as well grab an image of that, too. There are two ways to obtain screenshots:

1. Use a simulator and take a screenshot using F5 or 0 (zero). It will be saved in the "archos" directory.
2. Use the screendump option on the player itself. To enable the screendump, select Menu->Info->Debug (keep out) ->Screendump. Then connect the player via USB and an image of the screen will be "dumped" to the root ditectory of the Rockbox unit instead of connecting to your computer. If the unit has RTC (real-time clock), the files are named "YYYY-MM-DD HH-MM-SS.bmp" (YYYY=year, MM=month, DD=day, HH=hour, MM=minute, SS=second). Otherwise, they are numbered sequentally, dump_0001.bmp etc. To disable the screendump afterwards, select it again in the Debug menu.

It is requested that you convert the images to .PNG files before uploading because .BMPs cause bigger files, are sometimes blurry, and are not supported by all browsers.

3) UPLOAD YOUR FILES

1. Go to the WPS Gallery for the player your WPS is designed for (links at the top of this page). You probably want to open it in a new tab or window so you can continue to follow the guide.
2. Scroll to the bottom of the page and click "Attach".
3. At the bottom of the page in the "Attach new file" section click the Browse button and find the files you have created (.WPS, .ZIP, .PNG).
4. Add a brief description for each file in the "Comment:" textfield.
5. Check the "Hide File" box. This does not hide the file itself but stops it from automatically being displayed at the bottom of the gallery and making a mess of it.
6. Click "Upload file".
7. Repeat if you have more than one file to upload.

If the WPS does not need any images or files to be inculded, uploading a .ZIP file is not necessary as you can just attach the .WPS file.

4) POST IT!

Once you've uploaded all of the necessary files, return to the WPS Gallery page, scroll to the bottom, and click "Edit". If you followed step 0 correctly, the page editor window should pop up.

Now, being the kind, selfless person you are, you're going to put your WPS after everyone else's (how nice!) OR if you see the gallery in alphabetical order, keep it that way. Scroll down to the bottom of the code and hopefully the last line will be three dashes (---). This indicates a line break separating the previous WPS on the page from what will soon be yours. The basic template for a post looks like something like this:

---
---++(Username or WPS Title here)

<img src="%ATTACHURLPATH%/(Name of the image.PNG)" alt="(name again with extension)"  width="(x)" height="(y)"  />

Download: [[%ATTACHURL%/(Name of the file.ZIP or file.WPS)][(Text to be displayed)]]

(Give a short description here of what you made, the things that you like about it and how it does what it does.  
Keep in mind that still pictures can't show everything - so be sure to point out alternating sublines, dancing puffs,
or anything else that changes.  This is also a good time to mention if your WPS is released under a specific
license or requires any special patches not included in the official build.)

(Then sign it by copying and pasting the signature created for you)
---

Where everything inside circular brackets (like this) is something you need to change. Remove the brackets and the text between when entering your info but leave the rest untouched. The width and height ("x" and "y") can be found from your picture's properties or you can just look further up in the code and see what other people have put for the dimensions. If you're on the right page, they should be the same as yours. (This is generally a good trick if you run into problems. Plagiarism is the highest form of flattery, right?)

Now preview the page, making sure everything's looking good and proper (no attachments lingering at the bottom of the page, no broken code uglying up the place, your screenshots shining like diamonds). Once you approve of what you see, scroll to the bottom and click "Save Changes".

You have now uploaded your WPS for the world to see. Well done! Now get cracking on your next one!