File locations
Anterior | Capítulo 4. Extending GNU Solfege | Próxima

## File locations

In “Introduction” we showed you just enough to place your lesson file to get started. This sections give you all the details how files and directories are set up.

Where to save your lesson files depends on the operating system you run. On Windows XP:

    C:\Users and Settings\Username\My Documents\GNU Solfege\exercises

Linux:

    /home/Username/.solfege/exercises

And often the directory names are translated too. So to simplify this page we will write `USERDATA` whenever we refer to the directory containing `exercises/`. To find the value of `USERDATA` on your computer you should select Help → File locations and then «Solfege user data» in the dialog that opens.

Lesson files and front page files are grouped together in subdirectories below `USERDATA/exercises`. You can have as many subdirectories as you like in `USERDATA/exercises`. Each file that matches `USERDATA/exercises/*/*` will be read by the program and used as a front page file if it has the correct format. Other files will silently be ignored. This means that you can have more than one front page file is a subdirectory, and extra files, like README and COPYRIGHT files are ignored.

Lesson files should be saved in a directory named `lesson-files` in the same directory as the front page file is saved. So if you create some exercises with jazz progressions, you might have this file structure on your computer:

    USERDATA/exercises/jazzprog/page.txt
    USERDATA/exercises/jazzprog/lesson-files/prog1
    USERDATA/exercises/jazzprog/lesson-files/prog2
    USERDATA/exercises/jazzprog/lesson-files/prog3

### User lesson files

There is one folder name below `USERDATA/exercises` that is special. In addition to what described above, all lesson files in `USERDATA/exercises/user/lesson-files` will be shown when you select User Exercises on the File menu. This was done to make it simple to just write a lesson file, drop it in a directory and use it.

### Nota

In versions prior to 3.20.3, all lesson files matching `USERDATA/exercises/*/lesson-files/*` would be listed.

Anterior | Acima | Próxima
Capítulo 4. Extending GNU Solfege | Principal | Lesson files