AMIGIFT Documentation

Browsing /Requirements



AmigaOS Version 3.0 or higher (info)

At time of this write, AmigaOS 4.0 (PPC) and MorphOS are supported under its native m68k emulation. (Petunia and Trance respectively, under os4 you have to have installed the July-2007's update or amigift will not work properly!)

Users of Windws, GNU-Linux or Mac systems could even try AMIGIFT by using an Amiga Emulator such as UAE (or any of its variants), for Windws users there is available WinUAE but you'll still need a copy of the AmigaOS and ROMs, you can purchase Amiga Forever which includes everything you need to have a full working Amiga Operating System. - There is also AmiKit which a recopilation of freeware/shareware programs for AmigaOS running under Windws using the WinUAE core (but with neither OS nor ROMs), you could also purchase Amiga Forever from the AmiKit website to support both projects for the same (cheap!) price.

68020 or better CPU.

Even if it should work under a 68020 CPU, it is highly recommended to use a better CPU (e.g.: 68060), else you could hardly use all of the available compoments.

About 32MB of FREE RAM.

Note that the memory required directly depends on the number of network plugins you use, for a single plugin may the memory required is about 6MB or so only (that also depends on how that particular plugin works internally)

8MB of free Hard Disk space

Minimal installation requires about 8MB of free disk space, while if you intent to save downloaded files at the same installation path (which recommended) thousand of MBs may are needed.

AmiTCP (or compatible) TCP/IP Stack.

Be aware that AMIGIFT, like any other p2p filesharing program on other systems, needs high TCP resources due the high amount of simultaneous connections it may needs to manage, by that reason a good TCP/IP Stack which uses/requires a few system resources is highly recommended (e.g: we recommended Genesis under AmigaOS 3)

A Fast FileSystem which supports long-filenames

Here we recommend SFS (Smart File System) without any doubt.

infoNote: such a file system is really only needed to the incoming and completed folders, where downloads are saved (the incoming folder is used to keep currently being downloaded files, and once finished they are moved to the completed folder), that means you could have the normal installation files at any type of partition (e.g: FFS) but such folders (both) at a SFS partition to properly save downloads with long filenames.   Whatever you decide be sure the completed and incoming folders are on the same partition, else moving a downloaded file from incoming to completed could take a long and unneeded time!

MUI (Magick User Interface) Version 3.8 or higher

MUI is the AmigaOS's state-of-the-art OOP system for creating graphical user interfaces for programs, nothing is better being so easy to create GUIs with such a high-end result </propaganda> :-)

The following MUI's Public Custom Classes are required/used:

BetterBalance.mcc

subclass of Balance class which allows easily save and load all balance settings of a GUI.

Author: Maik Schreiber website, download mirror .readme

BetterString.mcc

BetterString is a stringgadget replacement, using it should eliminate the problems with the original BOOPSI stringclass.

Author: Allan Odgaard. website, download mirror .readme

Busy.mcc

Custom Class to be displayed when the appication is busy doing things...

Author: Klaus Melchior website, download mirror .readme

BWin.mcc   (It's optional)

Window.mui subclass which offers a very simple bordeless window with a drag bar and a size gadget.

Author: Alfonso Ranieri website, download mirror .readme
infoNote: It requires popupmenu.library

GIFAnim.mcc   (It's optional)

Area.mui subclass which can be used to show gif pictures and gif animations. It uses an async decoder to parse the gif file.

Author: Alfonso Ranieri website, download mirror .readme
infoNote: It requires asyncio.library

GuiGfx.mcc   (It's optional)

Area.mui subclass used to display image files in any format datatypes.library understands, guigfx.library image objects, bitmaps and Intuition images. It supports color depths up to 24bit, transparency channels/masks and various scaling modes including aspect correction.

Author: Matthias Bethke website, download mirror .readme
infoNote: It requires guigfx.library and render.library

Lamp.mcc

Lamp.mcc offers a little lamp which can be used for various purposes. It enhances the programmer's abilities to give more informative feedback to the user and thus just adds another level of communication in your programs!

Author: Maik Schreiber website, download mirror .readme

NList.mcc

This is a MUI custom class package containing replacements for List/Listtree/Listview/Floattext/Bitmap MUI default class.

Author: NList Open Source Team website, download mirror .readme

TearOff.mcc   (It's optional)

classe which allow the MUI application to create special groups called TearOffPanels. They can be freely arranged by the user, dragged outside the window or hidden.

Author: Szymon Ulatowski website, download mirror .readme

TextInput.mcc

Advanced String.mui replacement with lots of extra features, used as well as a combined single/multi line editor gadget.

Author: Oliver Wagner website, download mirror .readme

ToolBar.mcc

The name almost says it all. It is a MUI custom class that allows easy (very easy) implementation of toolbars in all kinds of MUI programs. It features a multitude of different settings and the majority of these are configurable for the user via the MUI preferences system.

Author: Benny Kjaer Nielsen website, download mirror .readme

Urltext.mcc

Urltext.mcc is a subclass of Area.mui and offers a very simple text that acts like an active url, as a html link in a browser.

Author: Alfonso Ranieri. website, download mirror .readme

Shared Libraries

xml2.library   (It's optional)

This library is used by the Gnutella plugin to decode meta-data tags returned with the search results, it isn't really required and neither recommended if you don't really need it, better avoid using it...

bzlib.library

bzlib.library is used to decompress the build-in (bzip2-compressed) configuration files, therefore you have to have it installed or you'll be unable to save the core components configs to disk. (It's included with the distribution)

asyncio.library

From AMIGIFT Version 2.0, asyncio.library is used by the daemon to manage downloads on a asynchronous way.   Download it from here.

openurl.library

It's used from programs to open certain URLs on your default browser, as you sure know.   Download it from here.

Other requirements

WAVE Sound Datatype (or compatible)

Several event notifications are handled altogether with a sound, on previous versions there we have mixed sound formats, being IFF/8svx and WAVe, todays all of them are in WAVe format (regardless of the file extension)

You can obtain such a WAVe datatype from Aminet, We recommend the wav.datatype V41.10 by Stephan Rupprecht available here

Users of the MorphOS system are encouraged to use Reggae: The streaming media library for MorphOS, AMIGIFT has native support for it by using the 68k wrapper library included on the package.

infoNOTE: If Reggae isn't found under your MOS system, an additional sub-process to handle sounds will be created due some issues we have noticed by launching sounds on the normal-way from the main task.

info Note: All the sound events are optional, you can disable all of them from the preferences window.

GPatch by Ralf Gruner

GPatch allow us to distribute e.g. ~90KB files rather than 1MB binaries, It is available here, there are also the GPatch program available for Windws and Linux.

Players to watch downloaded files.

A feature AMIGIFT still lacks is an embed player to just downloaded files, well... thats at least at time of this write, as we want to implement it somehow, unfortunately (for OS3 users) this looks like it should be a feature for PPC-systems.., Reggae looks like a good candidate to integrate it on that way when it's ready...

For now we'll give you a list of external players suitable to use from the frontend, remember multiview is of use for most files while you has datatypes installed for the specific files, but anyhow we'll give you that list:

  • Visage: Picture viewer for OS 3.0+ (AGA/RTG), by Magnus Holmgren
  • RIVA: Fastest 68k MPEG Player for AGA/RTG, by Stephen Fellner
  • MooVid: MOV and AVI Movie Player, by Lszl Trk
  • MPEGA: MPEG Audio decoder library, by Stephane Tavenard
  • SongPlayer: Powerful audio player for IFF, AIFF, WAV, AU, MP2, MP3, MP3PRO, and CDDA file formats, by Stephane Tavenard
  • APDF: PDF doc. viewer, by Derek B. Noonburg and Emmanuel Lesueur
  • MPlayer-os4: Universal audio/video player, AmigaOS 4.0 Version ported by Andrea Palmat
  • MPlayer-mos: Universal audio/video player, MorphOS Version ported by Nicolas Det


info Note: Players are optional, you can disable all of them from the preferences window.




Core Components
go to index
General Usage




 $Id: index.php,v 2.0 2009/08/06 22:47:32 diegocr Exp $