$OpenBSD: README,v 1.42 2011/11/12 15:39:59 ajacoutot Exp $
+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------
Installing the GNOME Desktop
============================
The gnome-session package only takes care of installing some core
components. Running the GNOME Desktop requires several other packages.
Below are examples of typical GNOME packages sets focused on standard
usage (i.e. accessibility, development, and office type packages are
left out on purpose).
It is advised to _always_ install the "minimal" set (see also: the
"Installing more packages" section below).
"minimal" GNOME Desktop
-----------------------
$ sudo pkg_add \
eog \
file-roller \
gedit \
gnome-control-center \
gnome-keyring \
gnome-media \
gnome-system-monitor \
gnome-terminal \
gnome-utils \
nautilus
"full" GNOME Desktop (additions to the "minimal" set)
-----------------------------------------------------
$ sudo pkg_add \
deja-dup \
ekiga \
empathy \
epiphany-extensions \
evolution-meta-tracker \
evolution-plugins \
evolution-rss \
gedit-plugins \
eog-plugins \
gcalctool \
gnome-contacts \
gnome-games-extra-data \
gnome-icon-theme-extras \
gnome-nettool \
gnome-tweak-tool \
gnote \
nautilus-evince \
nautilus-file-roller \
nautilus-meta-tracker \
nautilus-sendto \
nautilus-totem \
rhythmbox \
seahorse-plugins \
seahorse-sharing \
simple-scan \
vinagre \
vino
Starting the GNOME Desktop
==========================
Before running gnome-session(1), a system-wide DBus daemon needs to be
running ("dbus_daemon" needs to be added to the "pkg_scripts" variable
in rc.conf.local(8)).
Then the following line needs to be added:
exec ${LOCALBASE}/bin/ck-launch-session ${TRUEPREFIX}/bin/gnome-session
in ~/.xinitrc when using startx(1) (console login)
in ~/.xsession when using xdm(1) (X Display Manager login)
mDNS/DNS-SD support
===================
The avahi-daemon(8) daemon provides Zeroconf support (aka. Bonjour /
Rendezvous) in GNOME. Several applications can optionally benefit from
it (e.g. the "Network" shortcut in nautilus(1)) while some others
will not work at all without it (e.g. seahorse-sharing(1)).
To make use of it, rc.conf.local(5) needs to contain the following line:
multicast_host=YES
and "avahi_daemon" needs to be added to the "pkg_scripts" variable
_after_ "dbus_daemon".
A note about accessibility
==========================
Dependency on a11y packages is never enforced so to activate an
assistive technology you need to explicitely install the corresponding
package (see "Accessibility" under the "Installing more package" section
below).
Installing more packages
========================
If your needs aren't satisfied yet, there are many other packages you
can install. The most obvious ones will be mentioned by category.
(if you have access to an OpenBSD ports tree, you can find most GNOME
related ports under the x11/gnome category)
Accessibility
-------------
* mousetweaks - mouse accessibility enhancements
* orca - assistive technology for visually impaired
Communication
-------------
* ekiga - SIP and H.323 conferencing application
* empathy - Telepathy based messenger for e.g. MSN, Jabber, etc
* epiphany (+epiphany-extensions) - lightweight and simple web browser
* evolution (+evolution-plugins +evolution-rss +evolution-meta-tracker)
- integrated email and PIM software
Development
-----------
* anjuta (+anjuta-extras) - full blown IDE
* devhelp - API documentation browser
* gedit-latex - LaTeX plugin for gedit(1)
* gedit-plugins - plugins for gedit(1)
* ghex - HEX editor
* glade - user interface builder
* glom - database designer and user interface
* gnome-devel-docs - developer documentation
* yelp-tools - create, modify and manage documentation for Yelp and the web
Graphics & Multimedia
---------------------
* byzanz - makes a desktop recording optimized for webpages
* eog-plugins - plugins for EOG
* evince - viewer for multiple document formats
* f-spot - photo management application
* gnome-games (+gnome-games-extra-data) - collection of games
* grilo (+grilo-plugins) - network media discovery and browsing
* nautilus-evince - display document information in the properties window
* nautilus-totem - display media information in the properties window
* rhythmbox - music management application
* rygel - easily share, play and control audio/video media over the network
* simple-scan - simple scanning utility
* totem - multimedia player
Office & Productivity
---------------------
* abiword - WYSIWYG word processor
* dia - technical diagrams drawing tool
* gcalctool - desktop calculator
* gnome-contacts - contacts manager for your different online accounts
* gnote - desktop note-taking
* gnumeric - spreadsheet application
* meta-tracker - powerful desktop search tool and indexer
* planner - project management
Utilities
---------
* deja-dup - simple (encrypted) backup tool
* gconf-editor - editor for GConf settings
* gnome-nettool - interface for various networking tools
* gnome-tweak-tool - tool to tweak hidden GTK/GNOME settings
* gnomebaker - CD/DVD burning application
* nautilus-file-roller - handle archives directly from Nautilus
* nautilus-meta-tracker - edit (meta-)tracker-search(1) tags from within Nautilus
* nautilus-open-terminal - open a terminal under a nautilus folder path
* nautilus-sendto - integrate applications into Nautilus
* seahorse (+seahorse-plugins +seahorse-sharing)
- encryption, keys and passwords manager
* vinagre - VNC Client (remote Desktop client)
* vino - VNC server (allows remote access to your Desktop)
Themes
------
* gnome-icon-theme-extras - extra icons
* tango-icon-theme (+tango-icon-theme-extras) - Tango icon theme