HOWTO giFT p2p

From Gentoo Linux Wiki

Jump to: navigation, search

Contents

[edit] What is giFT?

giFT is a collection of various software components geared towards improving the overall usability of a multitude of peer-to-peer file-sharing networks. This goal is accomplished by unifying the components such that a user of the software may choose any of the available interfaces to access any of the available networks. The central application, giftd, uses a plugin-based architecture capable of using multiple networks simultaneously through a single user interface.

giFT is available through Portage for the following architectures:

alpha amd64 ia64 ppc sparc x86 x86
fbsd
+ + + ~ + + ~

[edit] Unmasking giFT

If you architecture is ppc or x86 fbsd, you will need to unmask the giFT package itself:

echo "~net-p2p/gift-0.11.8.1" >> /etc/portage/package.keywords

[edit] Network plugins

There are currently four giFT plugins in Portage.

If your architecture is shown in yellow, you must unmask the package to emerge it.

gift-ares

Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
+ ~ + - ~ + ~
To unmask:
echo "~net-p2p/gift-ares-0.3.0" >> /etc/portage/package.keywords

gift-fasttrack

Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
+ + + ~ + + ~
To unmask:
echo "~net-p2p/gift-fasttrack-0.8.9" >> /etc/portage/package.keywords

gift-gnutella

Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
+ + + ~ + + ~
To unmask:
echo "~net-p2p/gift-gnutella-0.0.11" >> /etc/portage/package.keywords

gift-openft

Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
+ + + ~ + + ~
To unmask:
echo "~net-p2p/gift-openft-0.2.1.6" >> /etc/portage/package.keywords

[edit] GUI frontends

There are currently five giFT frontends in Portage.

If your architecture is shown in yellow, you must unmask the package to emerge it.

apollon

UI base: Qt
Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
- + - ~ ~ + -
To unmask:
echo "~net-p2p/apollon-1.0.2.1" >> /etc/portage/package.keywords

giftcurs

UI base: Ncurses
Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
+ + ~ ~ + + ~
To unmask:
echo "~net-p2p/giftcurs-0.6.2" >> /etc/portage/package.keywords

giftoxic

UI base: GTK+
Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
- + - ~ - + -
To unmask:
echo "~net-p2p/giftoxic-0.0.10" >> /etc/portage/package.keywords

giftui

UI base: GTK+
Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
- ~ - ~ ~ + -
To unmask:
echo "~net-p2p/giftui-0.4.1" >> /etc/portage/package.keywords

yaggui

UI base: Java
Available for:
alpha amd64 ia64 ppc sparc x86 x86
fbsd
- ~ - ~ - + -
To unmask:
echo "~net-p2p/yaggui-0.9" >> /etc/portage/package.keywords

[edit] Installation

The emerge process is painless (and can be quite short depending on the frontend you've chosen).

Enable USE flags corresponding to plugins you have chosen to use:

echo "net-p2p/gift ares fasttrack gnutella openft" >> /etc/portage/package.use

Emerge giFT:

emerge -atv gift

Emerge any GUI frontends you have chosen to use:

emerge giftcurs

[edit] Setup

To configure giFT, run:

gift-setup

The process is relatively straightforward; you can hit ENTER to select defaults for pretty much everything except for the first, which must be toggled, and the plugins list, which you will probably want to modify.

[edit] Using giFT

Before running giFTcurs, you will have to run giftd -d to start the daemon. You can simplify this to the one-liner:

giftd -d && giFTcurs

Apollon, giFToxic, and giFTui should start the daemon automatically themselves.

Note that the executables for all the frontends except Apollon will require the "FT" in their names to be capitalized.