Development

Prerequisites and Development environment

Windows

1. Install Visual Studio. The community edition works great and is free!
2. Clone the repository or download a source ZIP.
3. In the source code folder you'll find a file named runprebuild.bat - run this file to copy needed files to the bin folder so that you can compile.
4. Open the resulting project file in Visual Studio and build it!

NOTE: If you downloaded a release zipfile under windows and compiled it, you will have to unblock all executable files in the /bin directory before halcyon will run properly. This can be done by using powershell as noted here: https://marcofranssen.nl/unblock-downloaded-files-with-powershell/

Ubuntu Linux 64bit

Linux support is a work in progress. Right now it builds, but may not run like it should.

1. Install Mono and MonoDevelop - yes, you need to grab it from there, the version of Mono in the standard repositories are often very out of date.
2. Clone the repository or download a source ZIP.
3. In the source code folder you'll find a file named runprebuild.sh - run this file to copy needed files to the bin folder so that you can compile.
4. Open the resulting project file in MonoDevelop and build it!

Collaboration, Development, Debugging

While there are several ways to go once you've decided you want to dig in, the best way is to fork the repo, make our changes to your fork, and then send us a pull request!

Deploying / Installing

For what you need to get what you've compiled running, see the Installation page.