XDS-Viewer

Revision as of 11:28, 3 April 2026 by Kmizutani (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

XDS-viewer is a open source program that was written by Michael Hoffer (Kabsch lab). It replaces the now obsolete VIEW program, and is available from http://xds-viewer.sourceforge.net/ .

Source code adapted to Qt5 is available as [1] (Thomas Hauß, HZB).

To compile the program, use the following recipe:

wget http://downloads.sourceforge.net/xds-viewer/xds-viewer-0.6.tar.gz
tar xf xds-viewer-0.6.tar.gz
cd xds-viewer-0.6
sh compile.sh 
# If this complains about missing tools or libraries, use e.g. "yum search cmake" 
# I had to "yum install cmake qt-devel"
# on CentOS6 I had to install and use cmake3 instead of cmake 
# installation of the 0.7 version works in the same way

The following patch makes the x and y values fit into the upper right window:

--- xds-viewer-old/src/mainwindow.ui    2009-03-08 15:00:55.000000000 +0100
+++ xds-viewer-new/src/mainwindow.ui    2009-03-05 22:22:37.000000000 +0100
@@ -142,7 +142,7 @@
            <property name="font" >
             
              <family>Monospace</family>
-             <pointsize>12</pointsize>
+             <pointsize>11</pointsize>
              <weight>75</weight>
              <bold>true</bold>
              <strikeout>false</strikeout>

Linux binaries are available at https://wiki.uni-konstanz.de/pub/linux_bin . The default one is a Qt5 binary (a Qt4 binary is available as XDS-viewer.qt4).

A Qt5 binary for MacOS 10.13, and one for 10.15 and newer was made available by Thomas Hauß (HZB). Mac users must decide which one is appropriate.

These Qt5 macOS apps are likely unusable because they have a bug where the File Load dialog does not appear (tested by Kimihiko Mizutani). This issue is caused by an error in the Info.plist file inside the app package (Contents/Info.plist), where CFBundleIdentifier is missing or empty. It needs to be corrected by adding a proper identifier, for example:

<key>CFBundleIdentifier</key>
<string>org.example.xdsviewer</string>


A Qt6 port of xds-viewer has been made available by Kimihiko Mizutani (Kyoto University). It runs on Mac (Apple silicon) and modern Linux (64-bit) systems. Source code and binaries are available from this page (in Japanese; a Google Translate option is available at the top-left of the page).

Source code is available as xds-viewer 0.6-qt6 source code.

A standalone Mac binary is available as xds-viewer 0.6-qt6 Apple Silicon binary. For terminal use, this standalone binary is recommended. It can be launched from xdsgui by creating a symbolic link, for example:

sudo tar xvzf XDS-Viewer-qt6mac.tgz
sudo ln -s XDS-Viewer-qt6mac xds-viewer

Qt6 installed via Homebrew is required.

A Mac app package is available as xds-viewer 0.6-qt6 Apple Silicon app package. It can be launched as a normal application; however, because the XDS 2cbf program cannot be started from it, only CBF files can be opened. Use of the standalone binary from the terminal is therefore recommended. The app bundle uses its own internal library layout and will not run correctly if its contents are moved outside the bundle.

A script for building the Mac app package is available as make_xds_viewer_dmg.sh.

A Linux 64-bit binary is available as xds-viewer 0.6-qt6 Linux binary. After downloading, please make it executable with:

sudo chmod a+x xds-viewer-qt6
sudo ln -s xds-viewer-qt6 xds-viewer

Binaries at the sourceforge site

These binaries are really old.

See also

Installation