About Porthole

What is Porthole

Porthole is a GTK-based frontend for Portage (the Gentoo package management system, http://www.gentoo.org).  It features a hierarchical view of packages and supports fast searches and dependency calculations.  Porthole also supports basic emerge features such as emerge, unmerge, sync and upgrade world.  Porthole is written in Python.

License

Porthole is released under the GNU General Public License (GPL) version 2, see COPYING for details.

History

Porthole is partially based on an earlier program, called gportage ( http://www.stacken.kth.se/~foo/gentoo/), which has been discontinued in favour of Porthole.

For a detailed history of changes, please see NEWS.

How to Install Porthole

The easiest and recommended way of installing Porthole is by using the ebuild that is available from the webpage.  We assume you know how to put ebuilds in the portage overlay.  If not, please consult the documentation and forums on the Gentoo web site (http://www.gentoo.org), or follow the instructions on this gentoo-wiki page.

If you don't want to use the ebuild, you can download the tarball (porthole-x.x.x.tar.bz2) and install it yourself.  The following packages must be installed for Porthole to work:

Use the following commands to install Porthole:

> tar xvjf porthole-0.6.1.tar.bz2
> cd porthole-0.6.1
> python setup.py install

How to Run Porthole

From a terminal window enter:

> porthole

Porthole has three possible command line flags:

For Gnome users, Porthole will install a menu item under Applications -> System Tools.

Tip! If you run into a problem, try running porthole --debug from a terminal.

Problem Reporting

We absolutely love bug reports!  Please use the bugtracker at SourceForge: http://sourceforge.net/projects/porthole/.

Contact Information


Notes: