Quickstart

This Wiki is an unofficial community project, and Open Pandora Ltd. is not responsible for its content. Neither is the Wiki an official source of information about your device.

Introduction

This page provides a very simple walk-through to get you up and running with playing music and installing games. It will not confuse you by providing choices, or by giving explanations. For that, you might want to go back to the Main Page of the wiki.

Power it up

1. You should have a power-supply, and a pandora with the battery already installed. If the battery is packed in it's shipping case, remove it and follow the printed instructions on correctly inserting it.
2. Plug the charger into the mains, and into the Pandora. You might now need to wait up to 10 minutes. A green light at the right hand side should come on as the Pandora wakes up. Soon after, a red light will appear next to this.
3. Whilst waiting to boot, 'write' with the stylus on some paper. This will polish the tip.

First Run Wizard

Some information is needed at this stage in order to set up important stuff. Make sure you keep the charger plugged in.

1. After booting, a dialogue will offer to shutdown, or start the configuration. Press 'Start Now' with the stylus
2. The first run dialogue will appear and ask you to enter some information. Use the pointer and touchscreen or left nub to move the pointer, move the right nub to the left to click
   1. Name (Conventionally your full name)
   2. Login (Must not contain spaces)
   3. Password (and confirmation). Do not forget this!
   4. Machine Name (Again no spaces. Short is good. How your machine appears on a network.)
   5. Select if you want to login automatically with no password prompt
   6. Prefered GUI (Use XFCE for this tutorial)
   7. Time Zone (can be changed later)
3. Once done, Pandora will reboot. From this point it is safe to unplug from the mains

Around the screen

Connect WiFi

This step is optional, you can use another PC to download apps to an SD card or USB stick.

1. Click the menu buttton, click System, click Toggle WiFi
2. The 3rd light on the left is red, and should come ON (WiFi)
3. A popup might say networks arre available.
4. To the left of the battery indicator (a %charge and small run-time) is the network manager icon - A black square.
5. Move the mouse with the left nub, and left click by moving the right nub to the left.
6. Select your wireless connection. If you have security enabled, you will be prompted for details. You can also right click (nub to the right) to turn networking on and off. WiFi may sometimes be difficult to connect reliably.
7. A spinning circle indicates the connection is in progress.
8. A beacon icon shows the signal strength when connected

Note (advanced users): If your connection is slow, you chould try changing the channel of your WLAN to a higher value. You do this by going to your router's IP and changing the settings of your wireless network.

Download the latest Hotfix

This step is necessary to ensure than any problems which have been fixed since your Pandora was shipped can be corrected. We refer to Hotfix4 here, although a beta version of Hotfix 5 is also out as of January 2011. Always use the latest one. An automated process is being worked on. See the picture for the correct directory structure as seen from a windows PC.

A Pandora SD card as it appears in Thunar, the default file browser on the Pandora. Figure 1 is the SD card itself (yours will have a different name). Figure 2 shows us that a /pandora folder has already been created on the card, and we're browsing inside it. Figure 3 shows the subfolders within the /pandora folder.

1. Find an SD or SDHC card.
2. If not connected to WiFi, do this on another computer
3. Click the blue globe icon (3rd from left)
4. type open-pandora.org into the address bar
5. Click on Support
6. Click the Click here to download HotFix Package 4 link for the latest HotFix Package (It's located under the "HotFix Package 4 - for Pandora OS Release 2010-05 (Zaxxon)"). (31-8-2010 - Hotfix 4: [1])
7. Select save as
8. Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
9. Click create folder and enter then name pandora
10. Double click on the pandora folder (right nub up once)
11. Click create folder and enter then name apps
12. Double click on the apps folder
    

    This is where you can find the hotfix installer. Click for a larger view.
13. Click save
14. Wait for the download to finish
15. Put the SD card in your pandora if done on a PC
16. Press the pandora button in between the nubs (short press)
17. Use the D-pad to scroll up to System then right, and down to HotFix 4 Installer. Press enter
18. Follow the prompts and enter your password when requested

Download the codec pack

This step is necessary because of different licensing laws in different countries. Please understand that you need to take responsibility for any patent restrictions which apply in your country. The codec pack also includes a video player (not fully optimised to used the DSP yet) Note: You must perform the previous step in order to do this one!

1. If not connected to WiFi, do this on another computer
2. Click the blue globe icon (3rd from left)
3. type open-pandora.org into the address bar, click on Support
4. Click the download the package here link for the codec pack. (2-8-2010 - Hotfix 3: [2])
5. Select save as
6. Scroll the left hand list down, select the name of your SD card or mmcblkxxx if your card is not labeled.
7. Double click on the pandora folder (right nub up once)
8. Double click on the apps folder (right nub up once)
9. Click save
10. Wait for the download to finish
11. Put the SD card in your pandora if done on a PC
12. Press the pandora button in between the nubs (short press)
13. Use the D-pad to scroll up to System then right, and down to Community Codec pack installer. Press enter
14. Follow the prompts and enter your password when requested

Play some Music

Put your music in a folder somewhere on your SD card, then open GNOME Mplayer and navigate to that folder (read Basic Linux Guide to learn about the directory structure on the Pandora).

Download a game

Well, no instructions for a specific game, but for a simple starting point of legaly redistributable games, emulators and ROMs, check out the PandaPacks which you can download, copy to SD card and just run.

Switch to MiniMenu

Assuming you are in Xfce:

1. Open up the Xfce menu
2. Go to System, then Switch GUI
3. Highlight MiniMenu and press OK

Switch to Xfce

Assuming you are in MiniMenu:

1. Go to System, then Switch GUI
2. Highlight XFCE4 and press OK

Change the default GUI

1. If in Xfce, open up the menu by pressing the Pandora button
2. Go to Settings, then Startup
3. Highlight Change Default GUI for current user and press OK
4. Highlight the GUI you want and press OK

The next time you log in, the chosen GUI should load.

Fix known problems with the default installation

It is assumed your are using Xfce for these fixes. If you wish to switch back to MiniMenu after making these changes see above.

Take ownership of your desktop

Your desktop is owned by root in the default installation. Until this is fixed you won't be able to write to your desktop.

1. In Xfce, open up the menu by pressing the Pandora button
2. Select Terminal from the menu.
3. Type whoami and press [ENTER]
4. Note your user-name which has just been printed to the terminal
5. Type sudo chown {your user-name} Desktop
6. Enter your password and press [ENTER] if it is required
7. Type sudo chgrp {your user-name Desktop
8. Enter your password and press [ENTER] if it is required

Fix the installer's time-zone set-up

There appears to be a problem with Pandora's first-run wizard that incorrectly sets up your time-zone. This can cause confusing behaviour when you or a program attempts to change the system time. Instructions are taken from this [3] board post.

1. In Xfce, open up the menu by pressing the Pandora button
2. Select Terminal from the menu.
3. Enter the following commands:
4. cd /usr/share/zoneinfo
5. ls
6. Note the continents listed, such as America and Australia
7. Enter the following commands, where America is your continent:
8. cd America
9. ls
10. Find a listed city in the same timezone as you
11. Determine the full path of the file you have chosen. For instance for the Eastern timezone use /usr/share/zoneinfo/America/New_York
12. Enter the following commands, replacing 021915402011 with the current date in MMDDHHMMYYYY format, and America/New_York with your city:
13. sudo ln -sf /usr/share/zoneinfo/America/New_York /etc/localtime
14. export TZ=America/New_York
15. echo "export TZ=America/New_York" >>~/.bashrc
16. date 021915402011

Shutdown

To really shutdown, the charger must not be plugged in. The Pandora will power up when the charger is plugged in.

From Xfce:

1. Press the Pandora button for the menu.
2. Select LogOut
3. Select Shutdown

From MiniMenu:

1. Press the Select button
2. Select Shutdown Pandora