Software Licence

All software on this site has been written by Nicola Amanda Mackin FRAS.

The downloading and or use of this software means that the downloader and or user agrees to abide by this agreement. The software is provided on an AS IS basis without warranty of any kind, express or implied, including fitness for any particular purpose. In no event shall the copyright holder be liable for any damages of any kind, whether in contract, tort or otherwise arising out of or in connection with the software, its use, or any other dealings with the software.

In plain words, you use this software entirely at your own risk and you agree that the copyright holder provides no warranty of any kind and will not be liable in any way for anything arising from the use of the software. The software may not be re-distributed, repackaged or sold. If you do not agree with this agreement, then you do not have permission to download or use the software.


Any procedures suggested on this website should be used carefully and will be at the users risk. Performing these procedures implies acceptance that the responsibility is with the user and the author of this website will not be held responsible for any problems arising from the use of these procedures.

AstroDMx Capture

AstroDMx Capture - Dark Theme Screenshot

AstroDMx Capture running under Fedora 26 / Cinnamon. The dark theme has been inherited from the Cinnamon desktop theme.

Updated 25th September 2018

Due to a serious issue with a camera manufactures SDK, the next release of this software will be delayed. Hopefully, this won't be very long, once the issue is resolved, a new version will be released.

The latest version of AstroDMx Capture for Linux is The software is distributed in three packages and can be downloaded by clicking the following links.

The manual installer's tarball contains a readme file which explains how to install the software. The RPM and DEB can be installed in the usual way (either via the GUI or via the command-line). If the options to start AstroDMx Capture do not appear in the system's menus then logout and log back in. The software can be uninstalled by using the following standard procedure:

  • Fedora: yum remove AstroDMx_Capture
  • Debian: dpkg --remove astrodmx_capture

Runtime Problems

If the software fails to run then drop to a command prompt and execute the following commands. The error messages will show what is causing the problem, for example, if you have missing dependencies.

  • cd /usr/local/AstroDMx_Capture/bin
  • ./astrodmx_capture -D

If the software throws a segmentation fault on startup (discovered from the procedure above) and you have had a previous version installed then you might have to delete the configuration file as detailed below and then rerun the software.

  • Do NOT do the following as root.
  • cd $HOME/.AstroDMx
  • rm config

Some Linux distributions do not support SELinux. While AstroDMx Capture does not directly use SELinux it does require the library to run. If you have such a distribution then you will need to use our dummy SELinux library; details of which follow:

RPM Installation - Missing SELinux Dependency

If installing via the RPM package and your system does not have SELinux then you will need to install the RPM from the command-line by typing the following command before downloading the dummy SELinux library below:

  • rpm --nodeps -ivh AstroDMx_Capture*.rpm

Please note, installing an RPM without dependency checking will allow the application to install regardless of the system's dependencies. Therefore, it is possible that you might have to manually check to see which dependencies are missing and then install them via your distributions package management system.

Dummy SELinux

If the software fails to run because is missing (details obtained from running the software from the command-line) then download the archive below. This download is not an implementation of SELinux, instead it simply supplies the required dependency and reports back to AstroDMx Capture that SELinux is not available and so allows the software to run.

Once downloaded, extract the archive and copy it to /usr/local/AstroDMx_Capture/lib

Known Issues (version

Due to an issue with the ZWO SDK, the heartbeat monitor does not work and will be automatically disabled when a ZWO camera is connected. If the ZWO camera goes offline, for example, due to a bad USB bandwidth setting, the camera will not automatically reset. If this happens then the user will need to reconnect the camera and then restart the software. All other cameras will be automatically reset and continue from the previous settings if they encounter a issue which causes them to go offline, for example, a loose USB cable.

Kernel Versions greater than 4.16.4 There is currently an issue with Linux kernel versions 4.16.4, 4.16.5 and 4.16.6. Video4Linux cameras, such as webcams and the Imaging Source cameras, are currently showing two devices for each camera. This problem has been reported to the Kernel developers, but for now, simply select the first device in the list. This problem has not been observed in kernel versions older than 4.16.4.

The next version of AstroDMx Capture will have a workaround to fix this problem.

All Versions: If multiple camera controls are changed during a long exposure then the last control will take effect, all others will be cancelled. For example, if the user changes the exposure to one minute and then immediately changes the gain, then the exposure control will be cancelled. To avoid this issue, change one control and wait for the exposure to complete. This behaviour will be changed in a future version.

Previous Versions

A version compiled for the Raspberry PI3, will be released in due course. Currently, there are no plans for a 32 bit version of this software.

Changelog (version

  • Full support for the QHY-5L-II MONO
  • Full support for the QHY-5L-II COLOUR
  • Other QHY cameras should work but have not been tested
  • Histogram Added. The histogram supports both Linear and Logarithmic scales and shows channels in RGB combined, Luminance, RGB Average, Red, Green, Blue or Greyscale.
  • Histogram image saved as a TIFF file
  • Automatic Exposure, Automatic Gain and Automatic White Balance improvements (If supported by camera)
  • Frame integration now works for all cameras operating in 8-bit modes
  • Improvements to the camera log file
  • Improvements to the over-exposure markers
  • Over-exposure markers now have a sensitivity control
  • Improvements to the Reticle
  • Custom colours now allowed for the over-exposure markers and the reticle
  • Right-click to reset controls now works for the exposure control
  • Reset all controls implemented
  • Long exposure countdown indicator improvements
  • Long exposures are now cancelled before the new exposure is set
  • Installers now create menus to launch the software
  • Detailed debugging mode added - which can be invoked from the menus or manually by passing -D to the astrodmx binary
  • Status area now shows the connected camera's bit-depth and calibration frame status
  • Added a dark theme compatibility mode - if you are using a dark theme and the controls are still light then this option will force the controls to be dark. This option is only works with dark themes.
  • Bug fixes and other improvements

Changelog (version 0.9.11-18)

  • Now allows dark and flat field calibration to be used simultaneously
  • Improvements to the long exposure countdown indicator
  • Bug fixes

Changelog (version 0.9.11-15)

  • Initial Release

Important Note: DFK / DBK cameras on modern computers

Imaging Source colour CCD cameras, such as the DFK-21AU04.AS do not work correctly on some modern computers. For example, the Imaging Source camera mentioned is able to stream normally but the camera controls do not work when using YUYV. The simplest solution to this problem is to use the camera's Bayer mode (which works perfectly and has higher frame rates) but if YUYV is important to the user then the following may help.

Generally, computers have both an xHCI and an EHCI controller and the camera mentioned above does not work correctly with the xHCI controller.

The following procedure will cause the xHCI controller to forward USB 2 packets to the EHCI controller which solves this problem. However, it is important to note that some very new computers are no longer shipped with a EHCI controller. In this case this procedure will not work. In such a case, the DFK-21AU04.AS will only work correctly in its Bayer or Greysclae modes.

Drop to a command prompt and execute the following commands as root. This can be done by typing su or by prefixing the commands with sudo.

  • lspci -nn | grep USB

The output will look something like the following, the exact output will be dependent upon your hardware. Do not use the information from this sample because it will not work on your system.

00:14.0 USB controller [0c03]: Intel Corporation 7 Series/C210 Series Chipset Family USB xHCI Host Controller [8086:1e31] (rev 04)

00:1a.0 USB controller [0c03]: Intel Corporation 7 Series/C216 Chipset Family USB Enhanced Host Controller #2 [8086:1e2d] (rev 04)

00:1d.0 USB controller [0c03]: Intel Corporation 7 Series/C216 Chipset Family USB Enhanced Host Controller #1 [8086:1e26] (rev 04)

Make a note of the sequence which is highlighted in bold. The above example is: 8086:1e31 and then type the following command as root. If you do not see an EHCI controller (sometimes listed as an 'Enhanced Host Controller' as in the example above) listed then this procedure will not work.

  • setpci -H1 -d 8086:1e31 d0.l=0

This change will only last until the system is rebooted and so the procedure will have to be repeated each time. Once you have obtained the controller information you only need to type the setpci command. For convenience, this command can be entered into a script and then the script can be run to invoke the change when required.

Important Note: Ubuntu Unity Users

Please note, if you are using Ubuntu Unity then you will need to download the following archive. Once downloaded, extract the archive and copy '' into '/usr/local/AstroDMx_Capture/lib'. This is required because there is an issue with Ubuntu Unity and without this file the UI will not render correctly. Once this is implemented the AstroDMx Capture UI will render with a generic theme instead of the operating system's theme.

This is not required for any other operating system, including other flavours of Ubuntu.

Important Note: ZWO USB2 Cameras

In order for USB2 ZWO cameras to work, one of two things must be done. The ZWO manufacturer recommends that the camera firmware should be flashed with their compatible firmware. The compatible firmware can be download directly from the manufacturer by clicking the link below. However, doing this causes issues with 16-bit long exposure (greater than 1 second). There is a second option, which does not require the camera to be re-flashed. This involves patching the Linux kernel. More information and instructions will be added to this site in due course. The second option does not suffer from the long exposure issue.

ZWO also have a Windows flashing tool which can be downloaded from the downloads section of the ZWO website.

AstroDMx Capture has been tested on the following 64-bit Linux operating systems.

  • Linux Mint 18.2 Cinnamon
  • Linux Mint 18.2 Mate
  • Linux Mint 18.2 xfce
  • Debian 9 Cinnamon
  • Debian 9 LXDE
  • Debian 9 xfce
  • Debian 9 GNOME
  • Kubuntu 16.04 LTS
  • Kubuntu 17.04
  • Xubuntu 17.04
  • Lubuntu 17.04
  • Ubuntu Gnome 3 or classic
  • Fedora 24, 25, 26 with Gnome 3
  • Fedora 26 with Cinnamon
  • Peppermint OS
  • Ubuntu 16.04 with Unity (with the additional download package)
  • Ubuntu 17.04 with Unity (with the additional download package)
  • Antergos Linux
  • PC Linux Mate
  • Mageia Linux
  • Elementary OS. Runs from the command line only at the moment


The latest version of AstroCrop for 1.1.0, Engine Version: 1.0.3 and can be downloaded by clicking the following link:

Aspect Ratio Corrector

The latest version of Aspect Ratio Corrector for Windows is 1.0 and can be downloaded by clicking the following link. Although there is no native Linux version, the Windows version runs perfectly under Wine.