This is a translation/English adaption of the INSTALL-file given with the package. I hope it's helpful for you. Remember that the most up-to-date instructions always will be in the Esperanto files on the website.

Dependencies

Beside the files in the package, you'll need SCIM. Install mentioned files and all their dependencies:

• scim
• scim-m17n
• m17n-db
• scim-gtk2-immodule (Thanks to Antono and ash_rabbi. Because of (as it seems) an error in Debian it can be that you'll have to download and install this dependency apart from the others...)

How to install?

• Install the above mentioned packages and their dependencies. (This can take some time. At least in Ubuntu I was ready soon, because everything was in their repository.)
• Put the mim-files you want to use into /usr/share/m17n or into /usr/local/share/m17n , whichever is valid for your system. [administration rights are neccesary]
• Start the program scim and setup by the steps mentioned below, to let it use the right IME. Probably you will need to reboot several times.

Setting up SCIM to type in Esperanto

Warning: If you have the Ubuntu-distribution or a similar one, it is possible that the SCIM-package you got has an error, because of which you will need to perform additional steps. You can read about this here. In the newest version of Ubuntu this problem seems solved. In essence the page says you to use the command im-switch -z en_US.UTF-8 -c, in which you have to replace en_US.UTF-8 with the appropriate locale.

• Start SCIM with the command scim. ({Alt+F2} scim {Enter})

(Less neccesary steps, but recommended because otherwise the program loads all input methods and that can be heavy for your system.)

• Right-click the icon of SCIM (which shows a keyboard and can be found in the system tray).
• Select SCIM Setup
• Go to IMEngine > Global Setup
• Click Disable All
• Go to Other and select there the layouts with eo in the name and maybe other layouts out of other groups to your liking. Warning! If you don't choose anything, SCIM will not work like you want to!
• Confirm everything

(End of less neccesary steps)

• Reboot your system, or only the graphical system (X). ({Ctrl+Alt+Backspace})
• Try whether it works
• Start the program in which you want to type.
• Click on the icon of SCIM (which shows a keyboard and can be found in the system tray).
• Select an inputmethod, for example eo-x-sistemo or eo-plena, in the menu Other. (You can switch it on and off afterwards with {Ctrl+Space})
• Type "Eĥoŝanĝo ĉiuĵaŭde" to try whether the Esperanto letters work.
• When it doesn't work, reboot again the graphical system ({Ctrl+Alt+Backspace}) or your computer, and try again.

Much fun!