FAQ: Installing and Running Scribus

Installing and running Scribus
Which Scribus should I install on my computer?

How do I get Scribus for Linux?

 * If you don't need anything fancy, use your packet manager to install Scribus (synaptics, yum, apt-get, ...). This is the preferred way to install Scribus.
 * If you want to be more up to date than your distribution is, you can add Scribus's own repositories. They are available for Debian, Ubuntu, Fedora, CentOS, Red Hat, OpenSuse, SUSE Linux Enterprise, and Mandriva. This is the preferred way to install Scribus.
 * If you want to test the newest feature (or if there are no binaries for your platform) you can compile the source code you get from sourceforge or from the subversion server (svn://scribus.info/Scribus/)

How do I get Scribus for OS X?

 * The stable version is only available through Fink or Darwinports
 * Snapshots of the development version are availabe on Sourceforge.
 * At the moment, there is no (easy) way to compile yourself Scribus for OS X
 * You can get a Ghostscript .dmg from here
 * Images (.dmg) for more recent development versions won't work on OS X 10.4. If you want to install Scribus 1.3.8 or later you will have to install it through Fink:
 * Install Fink.
 * Then install finkcommander.
 * Activate the unstable packages (fink commander > preferences > fink, Use unstable packages").
 * Install scribus-135+ from sources or binaries (if you also install qt4 from sources, it will take a long time, but it will work).

How do I get Scribus for Windows?

 * Binaries are available on Sourceforge
 * stable (1.3.3.14)
 * development (1.3.5+)
 * svn snapshots
 * It's not easy to compile. The BUILDING_win32.txt explains how to do it.

Which version should I use?
New users doing productive work should stick with the stable version (1.3.3.14). However, if you don't care about some minor incoveniences, you may want to use 1.3.8+ for new projects, since it has many more features than 1.3.3.14 and will become the stable 1.4 version soon.

As a rule of thumb: all versions that have an odd number as a second (minor) version number (1.1, 1.3, 1.5, 1.7) are unstable/development versions, all version with an even minor number are stable versions (1.0, 1.2, 1.4, 1.6, ...)

1.3.3.x is an exception and has been declared stable because 1.2 was too old and 1.4 was too far away.

Stable version
1.3.3.14 is the stable version – use it for your normal work.

Development version
1.3.8+ is the development version. You can use it if you want to use features which are not in the stable version. It has now become quite usable, but keep in mind that if you save work with it, you will not be able to then load it into 1.3.3.14, since the file format has changed. You can load a file created with 1.3.3.14 or an earlier version into later versions. If you are using Mac OS X 10.5+, 1.3.8 is recommended since it avoids some Qt3-related problems, and also because a universal binary is available.

(todo: link to a page which describes how to protect yourself when you're using the development version)

1.3.4 is an old unstable Qt3-based version which unfortunately was latched onto by some distros. It had a number of bugs, most of which were never fixed. It quickly led to the 1.3.5 version which was based on Qt4, and has since advanced to 1.3.8 mentioned above.

Experimental branch
1.5 is the current experimental branch: Only for people wanting to experiment with the latest Scribus features should use it. Remember that if you use this latest version, its file format will not allow its files to be loaded on any older versions.

Compatibility
Since its beginnings, Scribus has always maintained backward compatibility, so that every later version will be able to load a file from an earlier version. Because new features are added, the reverse is not true. For example, you can't load a 1.3.6 file into 1.3.3.14, but you can load 1.3.3.x files into 1.3.6+ and 1.5.

So which one should I use?
If you are still wondering, please use the stable 1.3.3.14 – it will be hard to go wrong with this one (exception: Mac OS X as noted above). If you have purchased or plan to purchase Scribus: The Official Manual, the book was based on the 1.3.3.x series, but it can be used with later versions, too.

How do I compile Scribus?
There may be a few reasons for you to compile Scribus yourself:
 * There is no current Scribus for your platform (like Linux PPC or Mac OS X 10.4).
 * You need a fix that has been applied after the latest binary snapshot has been released.
 * You want to follow Scribus development to stay up to date and to test.

In the first case you should download a snapshot source package from Sourceforge. In all the other cases you're better off if you get the source code via subversion.

Further reading:
 * Building_SVN_versions_with_CMake
 * Scribus 1.3.5svn (Ubuntu; in French)

Dependencies
See http://docs.scribus.net/index.php?lang=en&page=install2

Where is my Ghostscript?
You have successfully installed Scribus and now you see a warning that Ghostscript is missing.

One approach is to simply ignore the warning, as you only need it for EPS import and the Print Preview. Or you can install it later.

Linux
It's highly unlikely you would ever get this alert under Linux, unless you have installed Ghostscript in some quite nonstandard location. If it happens anyway, just use your package manager to install Ghostscript.

Mac OS X

 * You can get a Ghostscript .dmg from here (it may not be the latest version, but will probably be sufficient).
 * You can install Ghostscript via Fink or MacPorts.

Once Ghostscript has been installed, go to Scribus > Preferences > External Tools, and browse (Change...) for the gs executable (the path will be something like "/usr/local/bin/gs").

Microsoft Windows

 * First of all, you need to download the Ghostscript installer.
 * Once installed, Scribus needs to find it, which may or may not work automatically on Windows. If Scribus doesn't detect the Ghostscript executable after the installation, go to File > Preferences > External Tools, and browse ("Change...") for the gs executable. For 32-bit, its gswin32c.exe, the important thing being that "c", since there is another executable without a "c" in the file name.