Skip to content
mattlangtree edited this page Jan 10, 2013 · 8 revisions

Welcome to the Dux wiki!

Downloading Dux

There is currently no easy way to download Dux (github has removed the "downloads" feature).

Until some better solution can be organised, the process is:

  • Use the "Clone in Mac" or "Zip Download" features in the Code page to grab the code (perhaps check for experimental branches with major new features, but the master branch is the most stable)
  • Open it with the latest version of Xcode
  • In the Product menu, select Archive
  • Wait for the compile to finish (may take a minute)
  • When the Organizer window opens, click Distribute...
  • Select Export as > Application, and click Next
  • Select Don’t Re-sign, and click Next
  • Save the build to your Applications folder

Or, from the command line:

git clone https://github.com/abhibeckert/Dux.git
cd Dux
xcodebuild -target Dux -configuration Release
rm -r /Applications/Dux.app
mv build/Release/Dux.app /Applications/Dux.app
open /Applications/Dux.app

Or even shorter:

curl https://gist.github.com/raw/4499717/build-latest-dux.sh | sh

Please understand what the script is doing before you run it. We take no responsibility if it eats your cat.

Requirements and Cautions

Since Dux is under active development, it cannot entirely be trusted. Generally it should be used on the latest version of OS X (10.8.2 as of this writing). Be cautious of any data loss bugs; I recommend only editing files that are under Git or SVN and use those tools to verify any file you've opened in Dux.

I always have "Ask to keep changes when closing documents" OFF in System Preferences -> General. It should work fine with any setting but that is the one most thoroughly tested, and it significantly changes how Dux works with document data.

There are currently bugs in some syntax highlighters. PHP/HTML/JavaScript are the most thoroughly tested by me, and are stable. You can always switch to Plain Text if you have issues.