[![Build status](https://github.com/GrandOrgue/grandorgue/actions/workflows/build.yml/badge.svg)](https://github.com/GrandOrgue/grandorgue/actions/workflows/build.yml)
[![Release](https://img.shields.io/github/v/release/GrandOrgue/grandorgue)](https://github.com/GrandOrgue/grandorgue/releases)
[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)

# GrandOrgue

GrandOrgue is a sample based pipe organ simulator.

It currently supports Linux, Windows and macOS. Porting to other OS supported by RtMidi, RtAudio and wxWidgets should be possible with some build system adjustments.

## Home page and resources
GrandOrgue is hosted on Github. The repository can be found at [https://github.com/GrandOrgue/grandorgue](https://github.com/GrandOrgue/grandorgue).

GrandOrgue was earlier hosted on SourceForge [https://sourceforge.net/projects/ourorgan](https://sourceforge.net/projects/ourorgan) and a copy of the old source code before migration can be found in the svn branch [https://github.com/GrandOrgue/grandorgue/tree/svn](https://github.com/GrandOrgue/grandorgue/tree/svn).

Development of GrandOrgue is continuous, see [CHANGELOG.md](CHANGELOG.md) for full history of changes.

The discussion forum is available at [https://github.com/GrandOrgue/grandorgue/discussions](https://github.com/GrandOrgue/grandorgue/discussions).

For bug reports and feature requests post issues at [https://github.com/GrandOrgue/grandorgue/issues](https://github.com/GrandOrgue/grandorgue/issues).

Contributors are welcome on Github. You may create pull requests at [https://github.com/GrandOrgue/grandorgue/pulls](https://github.com/GrandOrgue/grandorgue/pulls). But before creating a complex pull request it's usually better to first create an issue for discussing it.

## Installation
See [INSTALL.md](INSTALL.md) for the downloading and installation prebuilt GrandOrgue packages.

## Building from sources
See [BUILD.md](BUILD.md) for instructions on how to build GrandOrgue from the source code.

## External libraries

![ASIO](https://user-images.githubusercontent.com/19529533/139595107-954ae23d-fa37-4346-ada6-3f69f203dcd2.jpg)