This guide (updated 2024) will guide you through the steps of installing OLPC OS build 883 (v11.3.0) with Gnome desktop and making modifications necessary to add full support for MP3 playback and other functionalities that Fedora did not add with shipping versions. This document will guide you how to flash the OLPC OS-1 build 883, which seems to be the best version available for the OLPC XO-1. Other versions are probably fine, but I found this version doesn't lag too much, and still has support for modern features.

• First, flash the internal NAND with OLPC OS Build 883 (see 11.3.0 release notes, section for XO-1: https://wiki.laptop.org/go/Release_notes/11.3.0#XO-1 for instructions how to flash)
• Once flashing is complete, boot the laptop into OLPC OS.
• Go to OLPC settings (right-click on the OLPC logo in app view). Switch to Gnome and reboot.

Once rebooted, you should be booting into the Gnome OS.

• Connect to your Wi-Fi network (click on the top-right corner with the wifi-logo).
• Open Terminal, change directory to /etc/yum.repos.d/
• All fedora*.repo files must be edited to replace “https:” with “http:” since the stored SSL keys are no longer valid.

$ su
$ cd /etc/yum.repos.d/
$ nano fedora.repo
$ nano fedora-updates.repo
$ nano fedora-updates-testing.repo

$ yum install ntpdate

Optional: If you prefer to use a different text editor than vi, such as nano, type:

$ echo "export EDITOR=nano" >> /root/.bashrc

This will add a variable that tells which text editor to use by default.

Edit crontab and add ntpdate to be run every 10 minutes.

$ crontab -e

• Open terminal, go to /etc/yum.repos.d/
• Create new file “rpmfusion.repo”

$ nano rpmfusion.repo

• Add the following contents to the file:

[rpmfusion]
name=RPM Fusion $releasever - $basearch
failovermethod=priority
mirrorlist=http://mirrors.rpmfusion.org/mirrorlist?repo=free-fedora-$releasever&arch=$basearch
enabled=1
include=file:///etc/yum/olpc-exclude
metadata_expire=7d

If you want to install a RPM package manually, you can also go to https://mirrors.rpmfusion.org/mm/publiclist/ , and once you have selected your OS version and architecture, scroll down to bottom to click on either http or rsync methods. You can the download whatever RPM package you need, and use the rpm -i utility to install the RPM package.

Now that you have RPM Fusion enabled, to install X Multimedia System (xmms) with MP3 support, run the following:

$ yum install xmms

This will install xmms music player from official Fedora repositories without MP3 input plugin.

$ yum install xmms-mp3

This will install the MP3 input plugin from the RPM Fusion repository and place it under /usr/lib/xmms/input.