Gentoo Wiki


Apparently there isn't a ebuild for FoF in portage yet. I did find a request for one however at (bug #143388)

Note: I assume you have a portage overlay setup and that it is located at /usr/local/portage/. If this isn't the case or your not sure what I'm talking about read (HOWTO Installing 3rd Party Ebuilds) before continuing.



USE Flags

Step By Step Instructions

Step 1 - Create a folder

Create a folder for the ebuild in your portage overlay:

mkdir -p /usr/local/portage/games-misc/fretsonfire/
cd /usr/local/portage/games-misc/fretsonfire/

Step 2 - Download the ebuild

Download the ebuild:

wget "" -O fretsonfire-1.2.512.ebuild

Make sure its named in the proper format "package-version.ebuild"

Step 3 - EBuild Digest

Download the source files needed to preform the install:

cd /usr/local/portage/games-misc/fretsonfire/
ebuild fretsonfire-1.2.512.ebuild digest

Problem: 404 Download Errors

So for whatever reason all the different ebuilds I tried got 404 errors retrieving the needed files. To fix this I just found & downloaded them manually with the following commands.

cd /usr/portage/distfiles/
wget ""
wget ""
wget ""
cd /usr/local/portage/games-misc/fretsonfire/

Now re-run the digest command in step 3. I(t should work this go around)

Step 4 - Remove Soft Masks

Unmask some packages: (these were all soft masked on my system by the ~x86 keyword)

echo "=games-misc/fretsonfire-1.2.512 ~x86"  >> /etc/portage/package.keywords
echo "=dev-python/pyopengl-   ~x86"  >> /etc/portage/package.keywords
echo "=dev-python/PyAmanith-0.3.34       ~x86"  >> /etc/portage/package.keywords
echo "=media-libs/amanith-0.3-r1         ~x86"  >> /etc/portage/package.keywords
echo "=dev-python/glewpy-0.7.4         ~x86"  >> /etc/portage/package.keywords

Step 5 - Compile


emerge fretsonfire

Problem: there are no ebuilds to satisfy "fretsonfire"

As said befor Make sure portage overlay are correctly set .

# echo PORTDIR_OVERLAY=\"/usr/local/portage\" >> /etc/make.conf 

or simply

# PORTDIR_OVERLAY="/usr/local/portage" emerge -av fretsonfire

Problem: Missing (ATI)

I doubt this problem happens with NVidia/Intel brand cards, but unfortunately I have a POS-ATI x1600 ;( For some reason these symlinks aren't made when the ATI drivers are installed. If you make them it seems to resolve the issue

# cd /usr/lib/
# ln -s /usr/lib64/opengl/ati/lib/
# ln -s /usr/lib64/opengl/ati/lib/

Problem: emerging amanith

Amanith has a bug in the glew stuff so it fails to build. Do the following to fix this problem.

Update: on amanith-0.3-r2 you simply emerge glew and it builds.

mkdir -p /usr/local/portage/media-libs/amanith/files
cd /usr/local/portage/media-libs/amanith/files
wget "" -O amanith-0.3-glew-update.patch
cp /usr/portage/media-libs/amanith/files/* .
cd /usr/local/portage/media-libs/amanith
cp /usr/portage/media-libs/amanith/amanith-0.3-r1.ebuild .
wget "" -O amanith-0.3-r1-ebuild-glew.patch
patch -p0 < amanith-0.3-r1-ebuild-glew.patch
ebuild amanith-0.3-r1.ebuild digest
emerge amanith -1

A simple but plain slow workaround is to disable OpenGL support, but you got to have a fast CPU that will do the graphics for you. So this is generally not recommend.

echo "=media-libs/amanith-0.3-r1      jpeg png -opengl -truetype -examples" >> /etc/portage/package.use
emerge amanith -1

UPDATE: There's a new ebuild for amanith on the bugzilla(, which includes the glew-update patch.

Problem: emerging glewpy

When emerging dev-python/glewpy-0.7.4, it failed for me:

i686-pc-linux-gnu-gcc -pthread -fno-strict-aliasing -O2 -march=prescott -pipe -fomit-frame-pointer -fPIC -I/usr/include/python2.5 -c -I/usr/include/python2.5 -c src/glew.c -o build/temp.linux-i686-2.5/src/glew.o
src/glew.c:1:2: error: #error Do not use this file, it is the result of a failed Pyrex compilation.
error: command 'i686-pc-linux-gnu-gcc' failed with exit status 1

Solution was to downgrade dev-python/pyrex:

emerge -va1 =dev-python/pyrex-

Afterwards, dev-python/glewpy emerged fine.

Step 6 - Play It

Test it


Problem: Command not Found

Remember to access games on gentoo the user needs to be part of the games group. Use this command to add the user to the games group:

gpasswd -a username games

Then you need to restart X or reboot If that doesn't work you might see if you can have rights to it manually by looking at /usr/bin/games

Problem: Can't find matching GLX visual

libGL warning: 3D driver claims to not support visual 0x23
libGL warning: 3D driver claims to not support visual 0x25
libGL warning: 3D driver claims to not support visual 0x27
libGL warning: 3D driver claims to not support visual 0x29
libGL warning: 3D driver claims to not support visual 0x2b
libGL warning: 3D driver claims to not support visual 0x2d
libGL warning: 3D driver claims to not support visual 0x2f
libGL warning: 3D driver claims to not support visual 0x31
Traceback (most recent call last):
  File "/usr/games/lib/fretsonfire/", line 60, in ?
    engine = GameEngine(config)
  File "/usr/games/lib/fretsonfire/", line 137, in __init__, height), fullscreen = fullscreen, multisamples =
  File "/usr/games/lib/fretsonfire/", line 68, in setMode
    self.screen = pygame.display.set_mode(resolution, flags)
pygame.error: Couldn't find matching GLX visual

To fix this add/modify your "DefaultDepth 24" in the Screen section of your /etc/X11/xorg.conf (more details here


Everything seemed to compile OK, however I've noticed one small bug.Whenever I change any settings and hit apply I get an error about my sound device. I reported it back to if you want more details.

Good Luck & Have Fun Rock'n . ~Kury

Installing/Using MOD's

Adding Songs

System Wide Song: /usr/share/games/fretsonfire/data/songs/

User Songs: ~/.fretsonfire/songs/

Retrieved from ""

Last modified: Fri, 05 Sep 2008 01:10:00 +0000 Hits: 5,107