performous for Debian
---------------------

More songs for performous are available at

http://performous.org/songs

For more information about finding songs and adding own song folders see also

https://github.com/performous/performous/wiki/Songs

Songs are searched for in the following directories:
    $HOME/.local/share/games/performous/songs/
    $HOME/.ultrastar/songs/
    /usr/local/share/games/ultrastar/songs/
    /usr/local/share/ultrastar/songs/
    /usr/share/games/ultrastar/songs/
    /usr/share/games/performous/songs/
    /usr/share/ultrastar/songs/
    /usr/local/share/games/fretsonfire/data/songs/
    /usr/share/games/fretsonfire/data/songs/

You can see where Performous tries to find songs by launching it from a
terminal with the argument --log info and observing the output.

If your songs are not in UTF-8 (most songs aren't yet), please do:
        recode CP1252..UTF-8 songs/*/*.txt

You can use iconv instead, if you prefer:
    iconv --from-code=ISO-8859-1 --to-code=UTF-8 source.txt > dest.txt

For converting a whole directory of songs to UTF-8 with iconv:
    for i in *; do echo $i; \
    mv "$i/$i.txt" "$i/$i.ISO-8859-1.txt"; \
    iconv --from-code=ISO-8859-1 --to-code=UTF-8 "$i/$i.ISO-8859-1.txt" \
        > "$i/$i.txt"; \
    done

After that make sure that all the characters display correctly. If they don't,
you need to guess which charset the original used (instead of CP1252) and retry.

For more (up to date) information, see http://performous.org/
