AMule Project FAQ - User contributions [en]

HowTo Compile In Debian/Ubuntu

2007-12-02T13:17:31Z

58.91.33.227:

<center>'''English''' | [[HowTo_Compile_In_Debian-de|Deutsch]] | [[HowTo_Compile_In_Debian-es|Español]] | [[Compilare_aMule_In_Debian-it|Italiano]] </center>

'''NOTE:''' This howto will also work for [http://www.ubuntulinux.com Ubuntu Linux].

See also general [[Compilation Installation]]

== Are you sure you want to compile? ==

If not, (which is pretty common) decide if you want the [[aMule]] stable release or the [[aMule CVS]] release.

=== [[aMule]] stable release ===

'''These packages are for Debian 3.1 Sarge only!'''

You can just install latest stable [[aMule]] version through [http://packages.debian.org deb]s adding the following lines into your ''/etc/apt/sources.list'' file:

deb http://amule-debian.dyndns.org/ debian/

Now run <code>apt-get update && apt-get install amule</code>

Packages in this repository:
*amule
*amule-daemon
*amule-remote-gui
*amule-gui-utils (alc, wxcas)
*amule-console-utils (amuleweb, alcc, cas)
*amule-utils (metapackage for amule-gui-utils and amule-console-utils)

'''NOTES:'''
* If [[aMule]] exits with error message complaining about being unable to open libbfd-2.15.so this usually means you are NOT running Debian Sarge. Don't start making symlinks or doing other workarounds, they can quite easily bork your whole system.

* http://dude.gemil.de is deprecated. http://amule-debian.dyndns.org is (for now) just a redirect, but this might change in the future (if the repository has to move due to traffic limitations).

=== [[aMule CVS]] release ===

You can also get the latest [[aMule CVS]] through debs adding the following line into your ''/etc/apt/sources.list'' file:

For Debian Testing (aka Lenny). In most cases this works for sid/unstable, too

deb http://www.vollstreckernet.de/debian/ testing amule

For Debian Stable (aka Etch)

deb http://www.vollstreckernet.de/debian/ stable amule

If you need a recent Version of wx (2.8 atm), just append '''" wx"''' to the lines above.
Be careful, between amule and wx is a space needed.
If you only want wx binaries installed, replace amule with wx.

packages are GPG signed, so follow this steps:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 > /tmp/key''
''apt-key add /tmp/key'' (requires superuser privileges)

Another, shorter, method utilizing '''"sudo"''' is as follows:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 | sudo apt-key add -''

Now run ''apt-get update && apt-get install amule''

You might also want to take a look at the other available [[aMule]] utilities:

'''[[aMule CVS]]'''

* amule
* amule-alc
* amule-alcc
* amule-alcc-dbg
* amule-alc-dbg
* amule-cas
* amule-cas-dbg
* amule-cmd
* amule-cmd-dbg
* amule-common
* amule-daemon
* amule-daemon-dbg
* amule-dbg
* amule-ed2k
* amule-ed2k-dbg
* amule-i18n-ar
* amule-i18n-bg
* amule-i18n-ca
* amule-i18n-da
* amule-i18n-de
* amule-i18n-en-gb
* amule-i18n-en-us
* amule-i18n-es
* amule-i18n-es-mx
* amule-i18n-et-ee
* amule-i18n-eu
* amule-i18n-fi
* amule-i18n-fr
* amule-i18n-gl
* amule-i18n-hr
* amule-i18n-hu
* amule-i18n-it
* amule-i18n-it-ch
* amule-i18n-ko-kr
* amule-i18n-nl
* amule-i18n-pl
* amule-i18n-pt-br
* amule-i18n-pt-pt
* amule-i18n-ru
* amule-i18n-sl
* amule-i18n-sv
* amule-i18n-tr
* amule-i18n-zh-cn
* amule-i18n-zh-tw
* amule-remote-gui
* amule-remote-gui-dbg
* amule-skin-gnome
* amule-skin-kde4
* amule-skin-tango
* amule-skin-xfce
* amule-theme-chicane
* amule-theme-default
* amule-theme-php-default
* amule-utils
* amule-utils-gui
* amuleweb
* amuleweb-dbg
* amule-wxcas
* amule-wxcas-dbg
* amule-xas

For example, if you think [[aMule]]'s [[Webserver|Web interface]] rocks and you want to have it too, enter this line after the one above:

For [[aMule CVS]]: ''apt-get install amuleweb''

For [[aMule]] stable: ''apt-get install amule-console-utils''

If you still want to compile [[aMule]] instead of just installing a binary, keep reading...

==Info: What aMule release needs what wxwidgets release?==
* Debian Etch includes aMule 2.1.3 and wxwidgets 2.6.3

* aMule 2.1 needs wxwidgets 2.6. You cannot compile it with newer versions of wxwidgets.
* aMule 2.2 needs wxwidgets 2.8. You cannot compile it with older versions of wxwidgets.

==What developement packages do I need for compiling?==

For compiling [[aMule-CVS]] and [[aMule 2.2.0]] you need the following packages installed:

* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev (if you compile wx by hand, this isn't needed. This package is atm only available for debian from Vollstreckers repository)
* libgd2-xpm-dev
* bison
* flex
* libreadline5-dev
* libgeoip-dev
* libupnp-dev

If you want to use the external crypto-library you need in addition:

* libcrypto++-dev

==Preparing: Compiling and installing wxwidgets==
This algorithm works for all Debian flavours.

To compile aMule, You need to have a current version of [[wxWidgets]] installed. To achieve that:
Uninstall every possibly previously installed wxwidgets stuff (see [[How to uninstall wxWidgets]]
and [[Check if wx is installed twice]])
You need the following packages installed:

* flex
* bison
* gettext
* libgtk2.0-dev
* python-dev (>= 2.4.3)
* python-dbg
* zlib1g-dev
* libjpeg62-dev
* libpng12-dev
* libtiff4-dev
* libgl1-mesa-dev '''or''' libgl-dev
* libglu1-mesa-dev '''or''' libglu-dev
* libesd0-dev
* libgnomeprintui2.2-dev
* libgconf2-dev
* libgstreamer0.10-dev
* libgstreamer-plugins-base0.10-dev
* python-central
* bc

# Download current wxwidgets wxGTK stable release source code tar ball from <tt>http://www.wxwidgets.org/downloads/</tt>
# <tt>$ tar xvzf wxgtk-''version''.tar.gz</tt>
# <tt>$ cd wxGTK-''version''</tt>
# <tt>$ ./configure --prefix=/usr --with-gtk --enable-unicode --disable-compat24 --enable-optimise</tt>
# <tt>$ make</tt>
# <tt># make install</tt>
# <tt># ldconfig</tt>

$ = command executed with normal user account 
<nowiki>#</nowiki> = command executed with root account

==Compiling and installing aMule==
Now that You have installed current wxGTK, go on to compile aMule:
# Install the needed packages mentioned in '''"What developement packages do I need for compiling?"'''
# Download aMule source code tar ball from <tt>http://www.amule.org</tt> (note: For compiling aMule 2.1.3 you'll need a patch aviable [http://cvs.pld-linux.org/cgi-bin/cvsweb/SOURCES/aMule-wx.patch?rev=1.2 HERE]
# <tt>$ tar xvjf aMule-''version''.tar.bz2</tt>
# <tt>$ cd aMule-''version''</tt>
# To have a look what features of aMule You can enable or disable: <tt>$ ./configure --help</tt>
# You should be right with <tt>$ ./configure --disable-debug --enable-optimize</tt>
# <tt>$ make</tt>
# <tt># make install</tt>

$ = command executed with normal user account 
<nowiki>#</nowiki> = command executed with root account

That's it! Now You can start aMule with command "amule".

== Building your own debian packages ==

First you have to get a source tarball. Note, that only aMule-CVS and Releases of aMule 2.2.0 or later are able to build debain-packages directly.

First install all needed tools:

* build-essential
* debhelper
* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev
* libgd2-xpm-dev
* bison
* flex
* libcrypto++-dev
* libreadline5-dev
* libgeoip-dev
* libupnp-dev
* devscripts

'''All commands after here are entered in the top-dir of the extracted aMule-source-tarball (usually .../amule-cvs or .../aMule-<version>)'''

Create a new changelog Entry with (the version in the changelog indicates the version your packages will get):
dch -v `date +%Y%m%d` New Upstream CVS Release
Now start the packages creation with:
dpkg-buildpackage -uc -b -rfakeroot
Now you have all created debian-packages in the parent dir of you source-dir and can install them with:
dpkg -i <package>
or build your own repository.

If you want to build just a few packages instead of all, you can obtain information about how this works with:
debian/rules help

== You're done... ==

That's it! Your own compiled [[aMule]] is installed on your system and ready to go.

To run [[aMule]], just type <code>"amule"</code>. You can check if everything worked by typing <code>"amule -v"</code> and check if the displayed version corresponds with the one you were compiling/installing.

If this HowTo didn't help, you have a rare problem on your system ;-) Take a look at http://www.amule.org ([http://www.amule.org/amule aMule Forums] at http://forum.amule.org ) or visit us in #amule on irc.freenode.net and (don't doubt) we'll try to do our best to help you.

== Final notes ==

If you are in one of those rare cases when you wish to compile [[aMule]] statically, install also ''libtiff4-dev'' (through ''apt-get install libtiff4-dev''). Anyway, this is '''NOT''' recommended and, in fact, will probably not do any better or even, not work at all.

HowTo Compile In Debian-de

2007-12-02T13:10:35Z

58.91.33.227: Methode mit sudo einen GPG Schluessel in den apt-key Schluesselhalter anzubringen

<center>'''Deutsch''' | [[HowTo_Compile_In_Debian|English]] | [[HowTo_Compile_In_Debian-es|Español]]</center>

'''ANMERKUNG:''' Diese Anleitung funktioniert auch für [http://www.ubuntulinux.com Ubuntu Linux].

Siehe auch allgemein [[Compilation Installation-de|Kompilieren/Installieren]]

== Bis du sicher das du kompilieren willst?? ==

Wenn nicht, (was normal ist) eintscheide dich ob du das stabile [[aMule-de|aMule]] oder die Entwicklerversion [[aMule CVS-de|aMule CVS]] willst.

=== [[aMule-de|aMule]] stabile Veröffentlichung ===

'''Diese Pakete sind ausschließlich für Debian 3.1 Sarge!'''

Du kannst du aktuell stable [[aMule-de|aMule]] Version als [http://packages.debian.org deb]s beziehen. Dazu musst du nur folgendes deiner ''/etc/apt/sources.list'' Datei hinzufügen:

deb http://amule-debian.dyndns.org/ debian/

Und anschließend <code>apt-get update && apt-get install amule</code> ausfüren.

Pakete in diesem Repository:
*amule
*amule-daemon
*amule-remote-gui
*amule-gui-utils (alc, wxcas)
*amule-console-utils (amuleweb, alcc, cas)
*amule-utils (metapackage für amule-gui-utils und amule-console-utils)

'''ANMERKUNGEN:'''
* Wenn [[aMule-de|aMule]] mit einer Fehlermeldung über libbfd-2.15.so abbricht bedeutet das, das du NICHT Debian Sarge benutzt. Fange lieber nicht mit irgendwelchen Symlinks oder anderen Tricks an, das kann dir das ganze System versauen.

* http://dude.gemil.de ist veraltet. http://amule-debian.dyndns.org is (zumindest vorerst) leitet zur Zeit nur um, aber das könnte sich in Zukunft ädern (Wenn das Repository wegen Bandbreitenbeschränkungen verschoben werden muss).

=== [[aMule CVS-de|aMule CVS]] Veröffentlichung ===

Du kannst auch die aktuelle [[aMule CVS-de|aMule CVS]] als Paket beziehen. Dazu muss du folgende Zeile deiner ''/etc/apt/sources.list'' Datei hinzufügen:

Für Debian Testing (aka Lenny). Meistes auch fü sid/unstable geeignet:

deb http://www.vollstreckernet.de/debian/ testing amule

Für Debian Stable (aka Etch)

deb http://www.vollstreckernet.de/debian/ stable amule

Wenn du auch eine aktuelle Version von wx (2.8 zur Zeit) benötigst, hänge einfach '''" wx"''' and die oben genannten Zeilen an..
Beachte das ein Leerzeichen zwischen amule und wx stehen muss.
Wenn du nur die wx-Pakete installieren willst, ersetze amule durch wx.

Die Pakete sind mit gpg signiert. Diesen bekommst du durch ausfüren von:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 > /tmp/key''
''apt-key add /tmp/key'' (requires superuser privileges)

Eine Methode die '''"sudo"''' gebraucht, und etwas kürzer ist, lautet:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 | sudo apt-key add -''

Jetzt starte ''apt-get update && apt-get install amule''

Sieh dir auch die anderen [[aMule-de|aMule]] Zubehörprogramme an:

'''[[aMule CVS-de|aMule CVS]]'''

* amule
* amule-alc
* amule-alcc
* amule-alcc-dbg
* amule-alc-dbg
* amule-cas
* amule-cas-dbg
* amule-cmd
* amule-cmd-dbg
* amule-common
* amule-daemon
* amule-daemon-dbg
* amule-dbg
* amule-ed2k
* amule-ed2k-dbg
* amule-i18n-ar
* amule-i18n-bg
* amule-i18n-ca
* amule-i18n-da
* amule-i18n-de
* amule-i18n-en-gb
* amule-i18n-en-us
* amule-i18n-es
* amule-i18n-es-mx
* amule-i18n-et-ee
* amule-i18n-eu
* amule-i18n-fi
* amule-i18n-fr
* amule-i18n-gl
* amule-i18n-hr
* amule-i18n-hu
* amule-i18n-it
* amule-i18n-it-ch
* amule-i18n-ko-kr
* amule-i18n-nl
* amule-i18n-pl
* amule-i18n-pt-br
* amule-i18n-pt-pt
* amule-i18n-ru
* amule-i18n-sl
* amule-i18n-sv
* amule-i18n-tr
* amule-i18n-zh-cn
* amule-i18n-zh-tw
* amule-remote-gui
* amule-remote-gui-dbg
* amule-skin-gnome
* amule-skin-kde4
* amule-skin-tango
* amule-skin-xfce
* amule-theme-chicane
* amule-theme-default
* amule-theme-php-default
* amule-utils
* amule-utils-gui
* amuleweb
* amuleweb-dbg
* amule-wxcas
* amule-wxcas-dbg
* amule-xas

Zum Beispiel, wenn dir [[aMule-de|aMules]] [[AMuleWeb-de|Web interface]] gefällt und du das auch haben willst, starte nach den obigen Befehlen:

Für [[aMule CVS-de|aMule CVS]]: ''apt-get install amuleweb''

Für [[aMule-de|aMule]] stabile Veröffentlichung: ''apt-get install amule-console-utils''

Wenn du [[aMule-de|aMule]] immernoch kompilieren willst anstatt ein Paket zu verwenden: Lies weiter...

==Info: Welche aMule Version braucht welches wx?==
* Debian Etch liefert aMule 2.1.3 und wxwidgets 2.6.3

* aMule 2.1 braucht wxwidgets 2.6. Neuere Versionen von wxwidgets werden nicht unterstützt.
* aMule 2.2 braucht wxwidgets 2.8. Ältere Versionen von wxwidgets werden nicht unterstützt.

==Welche Entwicklerpakete benötige ich zum kompilieren?==

Zum kompilieren von [[aMule CVS-de|aMule CVS]] und [[aMule-de|aMule 2.2.0]] müssen folgende Pakete installiert sein:

* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev (Wenn du wx von Hand kompilieren willst, brauchst du das nicht. Dieses Paket gibt es für Debian nur aus Vollstrecker`s Repository)
* libgd2-xpm-dev
* bison
* flex
* libreadline5-dev
* libgeoip-dev
* libupnp-dev

Wenn du die externe Kryptobibliothek verwenden willst brauchst du zusätzlich:

* libcrypto++-dev

==Vorbereitung: wxwidgets compilieren und installieren==
Dieses vorgehen ist für alle Debian Veröffentlichungen gleich.

Um aMule kompilieren zu künnen muss eine aktuelle Version von [[wxWidgets-de|wxWidgets]] installiert sein. Um das zu erreichen:
Deinstalliere alle früher erstellten Versionen von wx (vergleiche [[How to uninstall wxWidgets-de|Wie deinstalliere ich wxWidgets]]
und [[Check if wx is installed twice-de|Prüfen ob wx doppelt installiert ist]])
Folgende Pakete müssen installiert sein:

* flex
* bison
* gettext
* libgtk2.0-dev
* python-dev (>= 2.4.3)
* python-dbg
* lib1g-dev
* libjpeg62-dev
* libpng12-dev
* libtiff4-dev
* libgl1-mesa-dev '''oder''' libgl-dev
* libglu1-mesa-dev '''oder''' libglu-dev
* libesd0-dev
* libgnomeprintui2.2-dev
* libgconf2-dev
* libgstreamer0.10-dev
* libgstreamer-plugins-base0.10-dev
* python-central
* bc

# Lade das aktuelle wxwidgets wxGTK Quelltextarchiv von <tt>http://www.wxwidgets.org/downloads/</tt> herunter
# <tt>$ tar xvzf wxgtk-''Version''.tar.gz</tt>
# <tt>$ cd wxGTK-''Version''</tt>
# <tt>$ ./configure --prefix=/usr --with-gtk --enable-unicode --disable-compat24 --enable-optimise</tt>
# <tt>$ make</tt>
# <tt># make install</tt>
# <tt># ldconfig</tt>

$ = als normaler Nutzer ausgeführt 
<nowiki>#</nowiki> = als root ausgeführt

==aMule kompilieren und installieren==
Jetzt da du ein aktuelles wxGTK hast, mach weiter mit aMule:
# Installiere alle benötigten Paket die unter '''"Welche Entwicklerpakete benötige ich zum kompilieren?"'''
# Lade das aMule Quelltextarchiv von <tt>http://www.amule.org</tt> herunter (Beachte: Zum kompilieren von aMule 2.1.3 benötigst du noch [http://cvs.pld-linux.org/cgi-bin/cvsweb/SOURCES/aMule-wx.patch?rev=1.2 DIESEN] Patch.
# <tt>$ tar xvjf aMule-''Version''.tar.bz2</tt>
# <tt>$ cd aMule-''Version''</tt>
# Fü eine Übersicht welche Funktionen die (de)aktivieren kannst: <tt>$ ./configure --help</tt>
# Im einfachsten Fall führe <tt>$ ./configure --disable-debug --enable-optimize</tt> aus
# <tt>$ make</tt>
# <tt># make install</tt>

$ = als normaler Nutzer ausgeführt 
<nowiki>#</nowiki> = als root ausgeführt

Das wars! Jetzt starte aMule mit dem Befehl "amule".

== Eigene Debianpakete bauen ==

Zuerst brauchst du das Quelltextarchiv. Beachte; Nur aMule-CVS und Veröffentlichen von aMule 2.2.0 oder neuer können direkt zum bauen von Paketen verwendet werden.

Zuerst musst du alle nötigen Werkzeuge installieren:

* build-essential
* debhelper
* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev
* libgd2-xpm-dev
* bison
* flex
* libcrypto++-dev
* libreadline5-dev
* libgeoip-dev
* libupnp-dev

'''Alle Befehle müssen im obersten Verzeichnis des entpackten Quelltextarchives ausgeführt werden (normalerweise .../amule-cvs oder .../aMule-<Version>)'''

Erstelle einen neuen Changelogeintrag (die Version im Changelog gibt die Version deiner Pakete vor) mit:
dch -v `date +%Y%m%d` New Upstream CVS Release
Nun starte den Paketbau mit:
dpkg-buildpackage -uc -b -rfakeroot
Nun wurden alle Pakete im übergeordneten Verzeichnis erstellt.
Zum installieren verwende:
dpkg -i <Paket>
oder erstelle dein eigenes Repository.

Du kannst auch nur einzelne Pakete bauen. Informationen hierzu gibt:
debian/rules help

== Geschafft... ==

Das wars! Dein selbstkompiliertes [[aMule-de|aMule]] ist auf deinem System installiert und wartet darauf benutzt zu werden.

Um [[aMule-de|aMule]] zu starten, tippe einfach <code>"amule"</code>. Um zu sehen ob alles funktioniert hat tippe <code>"amule -v"</code> und vergleiche die Ausgabe mit der Version die du installiert/kompiliert hast.

Wenn diese Anleitung dir nicht geholfen hat, hast du ein seltenes Problem auf deinem System ;-) Suche auf http://www.amule.org ([http://www.amule.org/amule aMule Forum] auf http://forum.amule.org ) oder besuche und in #amule auf irc.freenode.net und (nicht verzweifeln) wir werden unser besten tun dir zu helfen.

== Abschlußbemerkung ==

Wenn du einer der seltenen Fälle bist die [[aMule-de|aMule]] statisch kompilieren wollen, musst du zusätzlich ''libtiff4-dev'' (mit ''apt-get install libtiff4-dev'') installieren. Allerdings, dies wird '''NICHT''' empfohlen und, im Ernst, wird nicht wirklich besser funktionieren oder überhaupt funktionieren.

HowTo Compile In Debian/Ubuntu

2007-12-02T13:05:23Z

58.91.33.227:

<center>'''English''' | [[HowTo_Compile_In_Debian-de|Deutsch]] | [[HowTo_Compile_In_Debian-es|Español]] | [[Compilare_aMule_In_Debian-it|Italiano]] </center>

'''NOTE:''' This howto will also work for [http://www.ubuntulinux.com Ubuntu Linux].

See also general [[Compilation Installation]]

== Are you sure you want to compile? ==

If not, (which is pretty common) decide if you want the [[aMule]] stable release or the [[aMule CVS]] release.

=== [[aMule]] stable release ===

'''These packages are for Debian 3.1 Sarge only!'''

You can just install latest stable [[aMule]] version through [http://packages.debian.org deb]s adding the following lines into your ''/etc/apt/sources.list'' file:

deb http://amule-debian.dyndns.org/ debian/

Now run <code>apt-get update && apt-get install amule</code>

Packages in this repository:
*amule
*amule-daemon
*amule-remote-gui
*amule-gui-utils (alc, wxcas)
*amule-console-utils (amuleweb, alcc, cas)
*amule-utils (metapackage for amule-gui-utils and amule-console-utils)

'''NOTES:'''
* If [[aMule]] exits with error message complaining about being unable to open libbfd-2.15.so this usually means you are NOT running Debian Sarge. Don't start making symlinks or doing other workarounds, they can quite easily bork your whole system.

* http://dude.gemil.de is deprecated. http://amule-debian.dyndns.org is (for now) just a redirect, but this might change in the future (if the repository has to move due to traffic limitations).

=== [[aMule CVS]] release ===

You can also get the latest [[aMule CVS]] through debs adding the following line into your ''/etc/apt/sources.list'' file:

For Debian Testing (aka Lenny). In most cases this works for sid/unstable, too

deb http://www.vollstreckernet.de/debian/ testing amule

For Debian Stable (aka Etch)

deb http://www.vollstreckernet.de/debian/ stable amule

If you need a recent Version of wx (2.8 atm), just append '''" wx"''' to the lines above.
Be carefull, between amule and wx is a space needed.
If you only want wx binaries installed, replace amule with wx.

packages are GPG sighned, so follow this steps:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 > /tmp/key''
''apt-key add /tmp/key'' (requires superuser privileges)

Another, shorter, method utilizing '''"sudo"''' is as follows:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 | sudo apt-key add -''

Now run ''apt-get update && apt-get install amule''

You might also want to take a look at the other available [[aMule]] utilities:

'''[[aMule CVS]]'''

* amule
* amule-alc
* amule-alcc
* amule-alcc-dbg
* amule-alc-dbg
* amule-cas
* amule-cas-dbg
* amule-cmd
* amule-cmd-dbg
* amule-common
* amule-daemon
* amule-daemon-dbg
* amule-dbg
* amule-ed2k
* amule-ed2k-dbg
* amule-i18n-ar
* amule-i18n-bg
* amule-i18n-ca
* amule-i18n-da
* amule-i18n-de
* amule-i18n-en-gb
* amule-i18n-en-us
* amule-i18n-es
* amule-i18n-es-mx
* amule-i18n-et-ee
* amule-i18n-eu
* amule-i18n-fi
* amule-i18n-fr
* amule-i18n-gl
* amule-i18n-hr
* amule-i18n-hu
* amule-i18n-it
* amule-i18n-it-ch
* amule-i18n-ko-kr
* amule-i18n-nl
* amule-i18n-pl
* amule-i18n-pt-br
* amule-i18n-pt-pt
* amule-i18n-ru
* amule-i18n-sl
* amule-i18n-sv
* amule-i18n-tr
* amule-i18n-zh-cn
* amule-i18n-zh-tw
* amule-remote-gui
* amule-remote-gui-dbg
* amule-skin-gnome
* amule-skin-kde4
* amule-skin-tango
* amule-skin-xfce
* amule-theme-chicane
* amule-theme-default
* amule-theme-php-default
* amule-utils
* amule-utils-gui
* amuleweb
* amuleweb-dbg
* amule-wxcas
* amule-wxcas-dbg
* amule-xas

For example, if you think [[aMule]]'s [[Webserver|Web interface]] rocks and you want to have it too, enter this line after the one above:

For [[aMule CVS]]: ''apt-get install amuleweb''

For [[aMule]] stable: ''apt-get install amule-console-utils''

If you still want to compile [[aMule]] instead of just installing a binary, keep reading...

==Info: What aMule release needs what wxwidgets release?==
* Debian Etch includes aMule 2.1.3 and wxwidgets 2.6.3

* aMule 2.1 needs wxwidgets 2.6. You cannot compile it with newer versions of wxwidgets.
* aMule 2.2 needs wxwidgets 2.8. You cannot compile it with older versions of wxwidgets.

==What developement packages do I need for compiling?==

For compiling [[aMule-CVS]] and [[aMule 2.2.0]] you need the following packages installed:

* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev (if you compile wx by hand, this isn't needed. This package is atm only aviable for debian from Vollstreckers repository)
* libgd2-xpm-dev
* bison
* flex
* libreadline5-dev
* libgeoip-dev
* libupnp-dev

If you want to use the external crypto-librarie you need in addition:

* libcrypto++-dev

==Preparing: Compiling and installing wxwidgets==
This algorithm works for all Debian flavours.

To compile aMule, You need to have a current version of [[wxWidgets]] installed. To achieve that:
Uninstall every possibly previously installed wxwidgets stuff (see [[How to uninstall wxWidgets]]
and [[Check if wx is installed twice]])
You need the following packages installed:

* flex
* bison
* gettext
* libgtk2.0-dev
* python-dev (>= 2.4.3)
* python-dbg
* zlib1g-dev
* libjpeg62-dev
* libpng12-dev
* libtiff4-dev
* libgl1-mesa-dev '''or''' libgl-dev
* libglu1-mesa-dev '''or''' libglu-dev
* libesd0-dev
* libgnomeprintui2.2-dev
* libgconf2-dev
* libgstreamer0.10-dev
* libgstreamer-plugins-base0.10-dev
* python-central
* bc

# Download current wxwidgets wxGTK stable release source code tar ball from <tt>http://www.wxwidgets.org/downloads/</tt>
# <tt>$ tar xvzf wxgtk-''version''.tar.gz</tt>
# <tt>$ cd wxGTK-''version''</tt>
# <tt>$ ./configure --prefix=/usr --with-gtk --enable-unicode --disable-compat24 --enable-optimise</tt>
# <tt>$ make</tt>
# <tt># make install</tt>
# <tt># ldconfig</tt>

$ = command executed with normal user account 
<nowiki>#</nowiki> = command executed with root account

==Compiling and installing aMule==
Now that You have installed current wxGTK, go on to compile aMule:
# Install the needed packages mentioned in '''"What developement packages do I need for compiling?"'''
# Download aMule source code tar ball from <tt>http://www.amule.org</tt> (note: For compiling aMule 2.1.3 you'll need a patch aviable [http://cvs.pld-linux.org/cgi-bin/cvsweb/SOURCES/aMule-wx.patch?rev=1.2 HERE]
# <tt>$ tar xvjf aMule-''version''.tar.bz2</tt>
# <tt>$ cd aMule-''version''</tt>
# To have a look what features of aMule You can enable or disable: <tt>$ ./configure --help</tt>
# You should be right with <tt>$ ./configure --disable-debug --enable-optimize</tt>
# <tt>$ make</tt>
# <tt># make install</tt>

$ = command executed with normal user account 
<nowiki>#</nowiki> = command executed with root account

That's it! Now You can start aMule with command "amule".

== Building your own debian packages ==

First you have to get a source tarball. Note, that only aMule-CVS and Releases of aMule 2.2.0 or later are able to build debain-packages directly.

First install all needed tools:

* build-essential
* debhelper
* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev
* libgd2-xpm-dev
* bison
* flex
* libcrypto++-dev
* libreadline5-dev
* libgeoip-dev
* libupnp-dev
* devscripts

'''All commands after here are entered in the top-dir of the extracted aMule-source-tarball (usually .../amule-cvs or .../aMule-<version>)'''

Create a new changelog Entry with (the version in the changelog indicates the version your packages will get):
dch -v `date +%Y%m%d` New Upstream CVS Release
Now start the packages creation with:
dpkg-buildpackage -uc -b -rfakeroot
Now you have all created debian-packages in the parent dir of you source-dir and can install them with:
dpkg -i <package>
or build your own repository.

If you want to build just a few packages instead of all, you can obtain information about how this works with:
debian/rules help

== You're done... ==

That's it! Your own compiled [[aMule]] is installed on your system and ready to go.

To run [[aMule]], just type <code>"amule"</code>. You can check if everything worked by typing <code>"amule -v"</code> and check if the displayed version corresponds with the one you were compiling/installing.

If this HowTo didn't help, you have a rare problem on your system ;-) Take a look at http://www.amule.org ([http://www.amule.org/amule aMule Forums] at http://forum.amule.org ) or visit us in #amule on irc.freenode.net and (don't doubt) we'll try to do our best to help you.

== Final notes ==

If you are in one of those rare cases when you wish to compile [[aMule]] statically, install also ''libtiff4-dev'' (through ''apt-get install libtiff4-dev''). Anyway, this is '''NOT''' recommended and, in fact, will probably not do any better or even, not work at all.

HowTo Compile In Debian/Ubuntu

2007-12-02T13:03:54Z

58.91.33.227: added another method to add GPG key to user apt-key keyring

<center>'''English''' | [[HowTo_Compile_In_Debian-de|Deutsch]] | [[HowTo_Compile_In_Debian-es|Español]] | [[Compilare_aMule_In_Debian-it|Italiano]] </center>

'''NOTE:''' This howto will also work for [http://www.ubuntulinux.com Ubuntu Linux].

See also general [[Compilation Installation]]

== Are you sure you want to compile? ==

If not, (which is pretty common) decide if you want the [[aMule]] stable release or the [[aMule CVS]] release.

=== [[aMule]] stable release ===

'''These packages are for Debian 3.1 Sarge only!'''

You can just install latest stable [[aMule]] version through [http://packages.debian.org deb]s adding the following lines into your ''/etc/apt/sources.list'' file:

deb http://amule-debian.dyndns.org/ debian/

Now run <code>apt-get update && apt-get install amule</code>

Packages in this repository:
*amule
*amule-daemon
*amule-remote-gui
*amule-gui-utils (alc, wxcas)
*amule-console-utils (amuleweb, alcc, cas)
*amule-utils (metapackage for amule-gui-utils and amule-console-utils)

'''NOTES:'''
* If [[aMule]] exits with error message complaining about being unable to open libbfd-2.15.so this usually means you are NOT running Debian Sarge. Don't start making symlinks or doing other workarounds, they can quite easily bork your whole system.

* http://dude.gemil.de is deprecated. http://amule-debian.dyndns.org is (for now) just a redirect, but this might change in the future (if the repository has to move due to traffic limitations).

=== [[aMule CVS]] release ===

You can also get the latest [[aMule CVS]] through debs adding the following line into your ''/etc/apt/sources.list'' file:

For Debian Testing (aka Lenny). In most cases this works for sid/unstable, too

deb http://www.vollstreckernet.de/debian/ testing amule

For Debian Stable (aka Etch)

deb http://www.vollstreckernet.de/debian/ stable amule

If you need a recent Version of wx (2.8 atm), just append '''" wx"''' to the lines above.
Be carefull, between amule and wx is a space needed.
If you only want wx binaries installed, replace amule with wx.

packages are GPG sighned, so follow this steps:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 > /tmp/key''
''apt-key add /tmp/key'' (requires superuser privileges)

Another, shorter, method utilizing '''"sudo"''' is as follows:
''gpg --keyserver wwwkeys.eu.pgp.net --recv 50D0AE60''
''gpg -a --export 50D0AE60 | sudo apt-key add /tmp/key''

Now run ''apt-get update && apt-get install amule''

You might also want to take a look at the other available [[aMule]] utilities:

'''[[aMule CVS]]'''

* amule
* amule-alc
* amule-alcc
* amule-alcc-dbg
* amule-alc-dbg
* amule-cas
* amule-cas-dbg
* amule-cmd
* amule-cmd-dbg
* amule-common
* amule-daemon
* amule-daemon-dbg
* amule-dbg
* amule-ed2k
* amule-ed2k-dbg
* amule-i18n-ar
* amule-i18n-bg
* amule-i18n-ca
* amule-i18n-da
* amule-i18n-de
* amule-i18n-en-gb
* amule-i18n-en-us
* amule-i18n-es
* amule-i18n-es-mx
* amule-i18n-et-ee
* amule-i18n-eu
* amule-i18n-fi
* amule-i18n-fr
* amule-i18n-gl
* amule-i18n-hr
* amule-i18n-hu
* amule-i18n-it
* amule-i18n-it-ch
* amule-i18n-ko-kr
* amule-i18n-nl
* amule-i18n-pl
* amule-i18n-pt-br
* amule-i18n-pt-pt
* amule-i18n-ru
* amule-i18n-sl
* amule-i18n-sv
* amule-i18n-tr
* amule-i18n-zh-cn
* amule-i18n-zh-tw
* amule-remote-gui
* amule-remote-gui-dbg
* amule-skin-gnome
* amule-skin-kde4
* amule-skin-tango
* amule-skin-xfce
* amule-theme-chicane
* amule-theme-default
* amule-theme-php-default
* amule-utils
* amule-utils-gui
* amuleweb
* amuleweb-dbg
* amule-wxcas
* amule-wxcas-dbg
* amule-xas

For example, if you think [[aMule]]'s [[Webserver|Web interface]] rocks and you want to have it too, enter this line after the one above:

For [[aMule CVS]]: ''apt-get install amuleweb''

For [[aMule]] stable: ''apt-get install amule-console-utils''

If you still want to compile [[aMule]] instead of just installing a binary, keep reading...

==Info: What aMule release needs what wxwidgets release?==
* Debian Etch includes aMule 2.1.3 and wxwidgets 2.6.3

* aMule 2.1 needs wxwidgets 2.6. You cannot compile it with newer versions of wxwidgets.
* aMule 2.2 needs wxwidgets 2.8. You cannot compile it with older versions of wxwidgets.

==What developement packages do I need for compiling?==

For compiling [[aMule-CVS]] and [[aMule 2.2.0]] you need the following packages installed:

* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev (if you compile wx by hand, this isn't needed. This package is atm only aviable for debian from Vollstreckers repository)
* libgd2-xpm-dev
* bison
* flex
* libreadline5-dev
* libgeoip-dev
* libupnp-dev

If you want to use the external crypto-librarie you need in addition:

* libcrypto++-dev

==Preparing: Compiling and installing wxwidgets==
This algorithm works for all Debian flavours.

To compile aMule, You need to have a current version of [[wxWidgets]] installed. To achieve that:
Uninstall every possibly previously installed wxwidgets stuff (see [[How to uninstall wxWidgets]]
and [[Check if wx is installed twice]])
You need the following packages installed:

* flex
* bison
* gettext
* libgtk2.0-dev
* python-dev (>= 2.4.3)
* python-dbg
* zlib1g-dev
* libjpeg62-dev
* libpng12-dev
* libtiff4-dev
* libgl1-mesa-dev '''or''' libgl-dev
* libglu1-mesa-dev '''or''' libglu-dev
* libesd0-dev
* libgnomeprintui2.2-dev
* libgconf2-dev
* libgstreamer0.10-dev
* libgstreamer-plugins-base0.10-dev
* python-central
* bc

# Download current wxwidgets wxGTK stable release source code tar ball from <tt>http://www.wxwidgets.org/downloads/</tt>
# <tt>$ tar xvzf wxgtk-''version''.tar.gz</tt>
# <tt>$ cd wxGTK-''version''</tt>
# <tt>$ ./configure --prefix=/usr --with-gtk --enable-unicode --disable-compat24 --enable-optimise</tt>
# <tt>$ make</tt>
# <tt># make install</tt>
# <tt># ldconfig</tt>

$ = command executed with normal user account 
<nowiki>#</nowiki> = command executed with root account

==Compiling and installing aMule==
Now that You have installed current wxGTK, go on to compile aMule:
# Install the needed packages mentioned in '''"What developement packages do I need for compiling?"'''
# Download aMule source code tar ball from <tt>http://www.amule.org</tt> (note: For compiling aMule 2.1.3 you'll need a patch aviable [http://cvs.pld-linux.org/cgi-bin/cvsweb/SOURCES/aMule-wx.patch?rev=1.2 HERE]
# <tt>$ tar xvjf aMule-''version''.tar.bz2</tt>
# <tt>$ cd aMule-''version''</tt>
# To have a look what features of aMule You can enable or disable: <tt>$ ./configure --help</tt>
# You should be right with <tt>$ ./configure --disable-debug --enable-optimize</tt>
# <tt>$ make</tt>
# <tt># make install</tt>

$ = command executed with normal user account 
<nowiki>#</nowiki> = command executed with root account

That's it! Now You can start aMule with command "amule".

== Building your own debian packages ==

First you have to get a source tarball. Note, that only aMule-CVS and Releases of aMule 2.2.0 or later are able to build debain-packages directly.

First install all needed tools:

* build-essential
* debhelper
* libglib2.0-dev
* libgtk2.0-dev
* zlib1g-dev
* libwxgtk2.8-dev
* libgd2-xpm-dev
* bison
* flex
* libcrypto++-dev
* libreadline5-dev
* libgeoip-dev
* libupnp-dev
* devscripts

'''All commands after here are entered in the top-dir of the extracted aMule-source-tarball (usually .../amule-cvs or .../aMule-<version>)'''

Create a new changelog Entry with (the version in the changelog indicates the version your packages will get):
dch -v `date +%Y%m%d` New Upstream CVS Release
Now start the packages creation with:
dpkg-buildpackage -uc -b -rfakeroot
Now you have all created debian-packages in the parent dir of you source-dir and can install them with:
dpkg -i <package>
or build your own repository.

If you want to build just a few packages instead of all, you can obtain information about how this works with:
debian/rules help

== You're done... ==

That's it! Your own compiled [[aMule]] is installed on your system and ready to go.

To run [[aMule]], just type <code>"amule"</code>. You can check if everything worked by typing <code>"amule -v"</code> and check if the displayed version corresponds with the one you were compiling/installing.

If this HowTo didn't help, you have a rare problem on your system ;-) Take a look at http://www.amule.org ([http://www.amule.org/amule aMule Forums] at http://forum.amule.org ) or visit us in #amule on irc.freenode.net and (don't doubt) we'll try to do our best to help you.

== Final notes ==

If you are in one of those rare cases when you wish to compile [[aMule]] statically, install also ''libtiff4-dev'' (through ''apt-get install libtiff4-dev''). Anyway, this is '''NOT''' recommended and, in fact, will probably not do any better or even, not work at all.