Version 101 (modified by armin, 6 years ago)

Fixed link to gobby-win32 repos

If you encounter any problems while installing and/or compiling Gobby or its dependencies (obby, net6), write into the WikiForum or to the obby-users mailing list.

Microsoft Windows

Please note: Gobby (>= 0.4.0rc1) needs at least Gtkmm 2.8.0, so please follow all steps again and update your runtime environments. It is also advised to uninstall a previous version of gobby before installing the new release.

This will give you the latest Gobby version. You need to go all three steps. We refuse any support if you fail to install the dependencies beforehand. Note that the 0.3 series is not compatible to the 0.4 one. If you want to share documents with Mac or Linux users, you should stick to version 0.3 at the time being.

Known limitations

The Windows version of Gobby has still some limitations:

  • There is no ZeroConf support.
  • Opening a session may take some seconds.

Compiling Gobby on your own

Alternatively, you can compile the whole source for your own. I suggest the MingW compiler in combination with the MSYS shell replacement (I did not test any other build environments, so I would like to hear from you if you try another one). You will need the gtkmm-2.10 development package from the site mentioned above and a distribution tarball of net6, libobby and gobby which may be found at http://releases.0x539.de.

You will also need gtksourceview and GnuTLS. If you do not want to compile them, there are developement packages containing header files, import libraries and runtime libraries available in the gobby-win32 repos on dalaran.0x539.de. The packages libgpg-error and libgcrypt are also required since these are depenencies of GnuTLS. Note that I disabled the heap walk in libgcrypt because it took way too long to initialize the random number generator on Windows. I also hacked gtksourceview to search in the user app data folder for its language-spec files (this is the place where the Gobby installer installs them when installing for the current user only). Another two prebuilt packages are available for net6 and libobby.

However, I currently strongly recommend to use the installer for Microsoft Windows. There is no real need to compile the whole packages for your own.

If you wish to compile Gobby for Windows via Linux (i.e., cross-compile), there are several prerequisites to this venture:

  • If you are running Gentoo Linux and do not wish to compile all the prerequisites or use the supplied libraries, there is a Bazaar branch of ebuilds available at http://bzr.malept.com/xmingw/ that can be downloaded via 
    bzr branch http://bzr.malept.com/xmingw/
  • If you are running Debian/Ubuntu, these instructions are sorely incomplete and untested, due to the original author not ever trying it on said system. YMMV (Your mileage may vary).
  • Install a package of, or compile the gcc cross-compiler and binutils:
    • Gentoo: emerge xmingw-gcc xmingw-binutils
    • Debian/Ubuntu: apt-get install mingw32 mingw32-binutils
  • Install a package of, or compile the MinGW runtime and w32api:
    • Gentoo: emerge xmingw-runtime xmingw-w32api
    • Debian/Ubuntu: apt-get install mingw32-runtime
  • For Gentoo, re-emerge xmingw-gcc to enable support for C++ compilation. Make sure that nocxx is not in the USE flags.
  • If you use the ebuilds, run emerge -av gobby-xmingw, making sure that the USE flags are to your liking. Note that as of the original writing of this section, the ebuilds for GNOME dependencies have not been written, so YMMV.
  • If you use the supplied libraries from this website:
    • place the DLLs into /opt/xmingw/bin for Gentoo.
    • remember to run all ./configure scripts with the flag --host=i386-mingw32msvc under Gentoo and --host=i586-mingw32msvc under Debian/Ubuntu.
  • If you wish to actually run your cross-compiled gobby.exe on your Linux box, you need to install and configure WINE. YMMV.

Linux

Gobby may be installed as most other applications for the Linux operating system: Get the tarballs from http://releases.0x539.de and run ./configure, make and make install. All packages will complain about missing dependencies during the configure run.

You need to install net6 first. It needs libsigc++ >= 2.0.0 and gnutls >= 1.0.0 to compile.

Then start to compile obby. It does not need any further libraries to compile, except if you want ZeroConf support. For it to work you need to install either the library called Howl or the compatibility package Avahi provides for it. Don't forget to pass --with-howl to obby's configure script if you want the server autodiscovery.

For Gobby additional dependencies apply. You are required to install the development headers of Gtkmm >= 2.6.0 and of all of its dependencies. You'll also need libxml++ >= 2.6.0 and gtksourceview and their respective dependencies.

It is easier to use the packaging system of your distribution. They might provide outdated versions, though. Please be aware that major versions of Gobby are incompatible with each other. Procedures for the following distributions are known:

Fedora Core 4, 5

Gobby is included in Fedora Extras and can be installed via Yum if the Fedora Extras repo is enabled: 

  yum install gobby

Gentoo Linux

Thanks to Gustavo Felisberto, portage contains ebuilds for net6, libobby and gobby. They are kept up-to-date by him. 

  emerge gobby

If the most recent version of gobby is still masked because it is considered as unstable, but you want to install it nevertheless, add the following in your /etc/portage/package.keywords file: 

  app-editors/gobby ~x86

Note that you have to replace x86 corresponding to your architecture. If portage keeps complaining that other packages, which gobby depends on, are also masked, simply add them to your your /etc/portage/package.keywords file like you did with app-editors/gobby.

Debian GNU/Linux

Gobby 0.3.0 is available in Debian Etch (aka. testing) and Sid (aka. unstable) and in Ubuntu Dapper. The version 0.2.2 is available in the universe component of Ubuntu Breezy (you can install v0.3.0, see LatestGobbyOnUbuntuBreezy) . Backports to Sarge and Hoary are currently not available.

Arch Linux

Gobby is maintained in community repository. Make sure you have community repository listed in your pacman.conf and do 

pacman -S gobby

Mac OS X

The recommended and supported method to install Gobby on OS X is currently DarwinPorts only.

Due to breakage with the C++ compiler Apple provided on the installation CDs (i.e. Xcode 2.0) the chances are high that the linking against gmp-cxx-wrappers fails. Please install Xcode 2.1 or any later version before compiling gmp and if possible before installing DarwinPorts. (You'll need an Apple Developer Connection account in order to receive a download link. Registration is free of charge.) You need to reinstall gmp if you updated Xcode in the meantime. The compilation is confirmed to work on Tiger with Xcode 2.1. On Panther you should install the gcc40 port instead. (But no tests were done on this platform by now.)

From an account with administrator privileges: 

$ sudo port sync  # to update darwinport's local package database
$ sudo port install gobby

This takes a very long time and involves many downloads. A night should be sufficient for the building of all libraries and Gobby, though. NOTE! This gives you Gobby 0.3, and if you want to coedit documents with Windows or Linux users, you should urge them to download the 0.3 rather than the 0.4 version. TODO: Get (instructions to install) Gobby 0.4 on the Mac.

It always helps to keep plenty of space available. The Xcode download weights one CD and then you have to install half a Linux distribution through DarwinPorts, but well... You should be safe with 3 GiB of free space during build. Most probably it does not need that much afterwards, but disk space is cheap even on iBooks, isn't it?

FreeBSD

As of obby 0.2.1 and Gobby 0.2.2 all components should compile on FreeBSD without problems.