Install and Start

emFileMan Customiz.

Download

Project Philosophy

Future Plans

Forum

Contact

Hosted at:

All trademarks are the property of their respective owners.

Good news: I feel like to continue my work on this project! ...but first I need to refill my nest egg. Therefore I am seeking for a freelance software developer job, either as telework or in North or Middle Germany, any humane topic, in C/C++ or Java, under Unix/Linux or Windows, on PC or embedded. Contact: Oliver Hamann, olha@users.sourceforge.net

Eagle Mode -
Install and Start

1 How to install Eagle Mode
2 How to start Eagle Mode
3 Special cases
      3.1 Proper installation to /usr
      3.2 FreeBSD
      3.3 Cygwin

1 How to install Eagle Mode

For installing Eagle Mode, first unpack the source package and cd into the unpacked directory. After that, the project has to be compiled (built) and then it can be installed. Here are the basic commands for doing that:

perl make.pl build
perl make.pl install

This would build the project using the GNU compiler, and it would install to a default directory (on UNIX-like systems it is /usr/local/eaglemode). There are some options you could give to the commands. For example, if you want to install to another directory, say something like:

perl make.pl install dir=/opt/eaglemode

A full description of all the options can be seen with:

perl make.pl help

Hints:

You could skip the install step and run Eagle Mode directly from the source directory after build.

make.pl installs nothing outside the installation directory.

There is no problem in moving the installation directory afterwards. Its path and name are not stored in any files.

2 How to start Eagle Mode

For starting Eagle Mode, go into the directory where Eagle Mode has been installed, and run the file eaglemode.sh. Exception: Windows users have to run eaglemode.wsf instead.

If you wonder about the files in the bin directory: These executables need some special environment variables and cannot be run directly.

3 Special cases

3.1 Proper installation to /usr

Originally, Eagle Mode is designed for being installed in an own directory like /usr/local/eaglemode or /opt/eaglemode. But if you want to have it divided in /usr/bin, /usr/lib, /usr/share and so on, you could do it like in this example:

perl make.pl build
perl make.pl install dir=/usr/lib/eaglemode

cd /usr/lib/eaglemode
mv -T doc ../../share/doc/eaglemode
ln -s ../../share/doc/eaglemode doc
mv -T res ../../share/eaglemode
ln -s ../../share/eaglemode res
mv -T etc /etc/eaglemode
ln -s /etc/eaglemode etc

cd /usr/bin
ln -s ../lib/eaglemode/eaglemode.sh eaglemode

cd /usr/lib
ln -s eaglemode/lib/*.so .

cd /usr/include
ln -s ../lib/eaglemode/include/* .

3.2 FreeBSD

Before building Eagle Mode on FreeBSD, you should execute the following commands, otherwise certain plugins may fail to build.

CPATH=/usr/local/include
export CPATH
LIBRARY_PATH=/usr/local/lib
export LIBRARY_PATH

3.3 Cygwin

Rebase DLL's!

After installing Eagle Mode on Cygwin, and before starting it for the first time, you must rebase all Cygwin DLL's including those of Eagle Mode. Please get familiar with the rebaseall program. The basic steps are as follows (remember to replace the paths according to your installation):

Quit all programs, stop the "CYGWIN cygserver" service (if running), open a Windows Command box and type these commands:
# set PATH=c:\cygwin\bin
# ash
# bash
# ls -1 --indicator-style=none /usr/local/eaglemode/lib/*.dll > /tmp/extra.lst
(At this point you could add further non-standard DLL's to /tmp/extra.lst)
# cat /tmp/extra.lst
(Check that the Eagle Mode DLL's are shown by the above command)
# exit
(Back in ash, never do the following in bash or while any other Cygwin program is running)
# rebaseall -T /tmp/extra.lst -v

You have the choice: emX11 or emWnds

If you want Eagle Mode to use the Windows API directly instead of X11, set the environment variable EM_GUI_LIB=emWnds before starting. But note that the file manager commands require X11 in any case.

Flaws

Eagle Mode does not perform very fast on Cygwin.
Do not enter the fullscreen mode with emX11 on Cygwin. Otherwise the keyboard focus may get lost.