$OpenBSD: README,v 1.29 2011/09/24 12:23:41 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
"full" GNOME Desktop
--------------------
$ sudo pkg_add \
alacarte \
deja-dup \
ekiga \
empathy \
epiphany-extensions \
evolution-meta-tracker \
evolution-plugins \
evolution-rss \
gedit-plugins \
eog-plugins \
gcalctool \
gnome-games-extra-data \
gnome-icon-theme-extras \
gnome-nettool \
gnome-tweak-tool \
nautilus-evince \
nautilus-file-roller \
nautilus-meta-tracker \
nautilus-sendto \
nautilus-totem \
rhythmbox \
seahorse-plugins \
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(5)).
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. 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-plugins - plugins for Gedit
* ghex - HEX editor
* glade - user interface builder
* gnome-devel-docs - developer documentation
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
* 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
* gcalctool - desktop calculator
* gnumeric - spreadsheet application
* meta-tracker - powerful desktop search tool and indexer
* planner - project management
* gnote - desktop note-taking
Utilities
---------
* alacarte - simple menu editing tool
* 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) - 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
