Skip to main content

Frets on Fire

                         ___ __  __ __ __
                        /_  /_) /_  / (
                       /   / \ /_  / __)
                      _        __    __  __
                     (_)/\/   /_  / /_) /_
                             /   / / \ /_

             >>------------------------------------>>
              |   http://www.unrealvoodoo.org      |
             >>------------------------------------>>

Frets on Fire is a game of musical skill and fast fingers. The aim of the game is to play guitar with the keyboard as accurately as possible.

Table of Contents

Introduction

Frets on Fire is a game of musical skill and fast fingers. The aim of the game is to play guitar with the keyboard as accurately as possible.

Requirements

Windows

  • 128 MB of RAM
  • Fairly fast OpenGL graphics card (shader support not necessary; antialiasing support recommended)
  • DirectX compatible sound card

Linux

  • 128 MB of RAM
  • Fairly fast OpenGL graphics card (shader support not necessary; antialiasing support recommended)
  • SDL compatible sound card

macOS

  • macOS 10.5 or later
  • OpenGL-accelerated video card

Playing the Game

First of all, these are the keys you'll need to navigate the menus:

  • Arrow Keys – Change menu selection
  • Enter – Accept
  • Escape – Cancel

These keys are used in the game itself:

  • F1–F5 – Frets one through five
  • Enter – Pick

Note that these keys are default keys and they can be changed from the game settings menu.

The easiest way to learn to play the game is to watch the tutorial. The basic idea is to press and hold the approriate frets when notes appear and tap the pick button when the notes hit the row of keys at the bottom of the screen. With longer notes, you need to hold the frets down for the whole duration.

You get points for hitting notes. For each ten correctly played notes, your score multiplier increases up to four times. If you make a mistake, the score multiplier is reset back to one. For long notes, the longer you hold down the frets the more points you get. Chords award you twice the points of normal notes.

Editing and Importing Songs

With the included song editor you can import your own songs into the game. Ideally you should have two versions of your song: the guitar track and the background track. This is because the game needs to be able to mute the guitar when play it incorrectly. Both must be in the Ogg Vorbis format. A song can also be composed of just the main track, but in that case the whole music is muted when mistakes are made.

These keys are used in the editor:

  • Arrow Keys – Move cursor
  • Escape – Bring up the editor menu
  • Enter – Add a note at the current cursor position. Hold down Enter and press the right arrow key to add longer notes
  • Space – Play and pause the song. Note that only the guitar track is played in the editor
  • Delete – Remove notes at the current cursor position
  • Page Up/Page Down – Change difficulty level

Follow these guidelines when composing different difficulty levels:

  • Easy Difficulty: Frets 1-4 used, no chords
  • Medium Difficulty: Frets 1-4 and chords used
  • Amazing Difficulty: Anything goes

Remember that you shouldn't place notes on top of each other.

5. Importing Guitar Hero™ Songs

The game has a built-in importer for the songs in Guitar Hero(tm) by RedOctane. To use it, you'll need to have the game DVD, at least 500 megabytes of free disk space and a lot of patience.

The game supports Guitar Hero, Guitar Hero II, Guitar Hero Encore and Guitar Hero 80s discs. Note that only the Playstation 2 version of the discs are supported.

You'll also need to have the OGG Vorbis command line compressor installed. In Linux, you can usually get it in a package called vorbis-tools. In Windows, copy the encoder (oggenc.exe) into the game directory.

The importer can be started by choosing Song Editor in the main menu, followed by "Import Guitar Hero(tm) Songs". The importer will ask you the path to where the game files can be found. Usually this is just the driver letter of your DVD drive, e.g. 'D:'.

After you have entered the correct path, the importer will start ripping the songs. Note that this will take a very long time. For example, on a 1.8 GHz Pentium M laptop with 2 gigabytes of RAM the process took about 4 hours. It is recommended that you run the game in windowed mode so that you can leave the importer running in the background and do other things while it's doing its magic.

Once the importer is finished, you'll find the songs in the regular song selector. Note that if you abort the importer midway, it will mostly pick up where it left off when you run it again.

Troubleshooting

  • Some chords don’t work.
    Some keyboard manufactures reduce costs by making some key combinations impossible to press. This is especially true with laptop keyboards and some cheaper PC keyboards. The solution is to change the keys to different ones. For example, swapping the Enter key with Shift should help a lot, or changing the frets to i.e. numbers 1-5. Use the key tester in the settings menu to check your chosen key set.

  • Sound crackles.
    Increase your audio buffer size or change to 22050 Hz sampling frequency. You can do this from the Audio Settings.

  • Colors look ugly on my ATI video card.
    Don't use tweaked drivers (e.g. Omega Drivers) that reduce the color depth to 16 bits.

  • I can’t hit those notes!
    You either need to practice more or adjust the A/V delay option in the audio settings. Try increasing or decreasing the delay by 50 and seeing if it helps.

  • I can’t see my scores on the world charts.
    You need to enable score uploading in the settings menu first.

  • I get a strange OpenGL error on startup.
    If your desktop color quality is set to 16 bits, increase it to 32 bits.

  • No matter what I do, I get lousy scores.
    Sell your gear.

Metadata

Release files for fretsonfire 1.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fretsonfire 1.6.1
File Size Uploaded
fretsonfire-1.6.1.tar.gz 30.5 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for fretsonfire 1.6.1
File Interpreter ABI Platform
fretsonfire-1.6.1-py3-none-any.whl Python 3 none any Details

Total release size: 61.0 MB

Release files / fretsonfire-1.6.1.tar.gz

Download URL fretsonfire-1.6.1.tar.gz
Size 30.5 MB
Tags Source
SHA-256 checksum
How to use checksums
9f2091e947d8662cc854f4890536e3a7bb26d95fcfb53129ebea0f808804b28f
BLAKE2b-256 checksum
How to use checksums
cb496f3614e987e03afbf6d01bd37b11770918ca81819f8621f4247254245905
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2025.

Transparency log

Release files / fretsonfire-1.6.1-py3-none-any.whl

Download URL fretsonfire-1.6.1-py3-none-any.whl
Size 30.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
b70fd5d71b19b580c4e19d2a7d0e66b2c8b5f75c430c806017403e3f2f8e98d4
BLAKE2b-256 checksum
How to use checksums
afa2dd70b40c3411f86be7ca335674edba9da1fa0814963c7115e8fea3abf674
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 10, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

1.6.1 This release

2 release files

1.6.0

2 release files

1.5.8

2 release files

1.5.7

2 release files

1.5.6

2 release files

1.5.5

2 release files

1.5.4

2 release files

1.5.3

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.8

2 release files

1.4.6

2 release files

1.4.5

2 release files

1.4

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page