AgOpenGPS

AgOpenGPS - Guidance software

⚠️ Project Status: Maintenance Mode

AgOpenGPS WinForms has reached its final development stage (April 2026).

• ❌ No new features
• ❌ No refactoring
• ✅ Bug fixes only

Active development has moved to the Avalonia version.

---

Ag Precision Mapping and Section Control Software

AgOpenGPS is 2 programs. AgIO is the communication hub to the outside world and AgOpenGPS is the application. You can run either and within each, you can run the other.

You only need to run AgOpenGPS if you are using the simulator.

The software reads NMEA strings for the purpose of recording and mapping position information for Agricultural use. Also it has up to 16 sections of Section Control that can have unique widths or up to 64 same width sections to control implements application of product preventing over-application.

Also ouputs Pure pursuit steer angles from reference line for AB line, AB Curve and Contour guidance. Auto Headland called UTurn on Curve and AB Line with loops for narrow equipment. Mapping as a background can also be added.

Included in this repository is an application, and source folders.

See the PCB repo for PCB layouts, firmware for steering and rate control, machine control, GPS and simulator.

Installation

1. Download the Most Stable AgOpenGPS Release
2. Unzip or extract the contents to a folder (folder accessible by user not the root of C:\) Even on your desktop
3. Run AgOpenGPS.exe

Building

1. Clone this repository (e.g. use Visual Studio to do so)
2. Open the solution (SourceCode/AgOpenGPS.sln) in Visual Studio
3. Add your code and (re)build
4. Execute the following command in the root folder to get a single AgOpenGPS folder containing all the applications:

   dotnet publish SourceCode/AgOpenGPS.sln
   

Contributing

The master branch contains the most stable version of AgOpenGPS, while the develop branch is actively being worked on and may not be ready for production use.

In order to contribute to AgOpenGPS, follow these steps:

1. Checkout the develop branch
2. Create a new branch named after your feature
3. Make your changes and commit to this branch
4. Create a PR targeting the develop branch

Translation

We use Weblate to manage translations for this project.

If you want to help translate AgOpenGPS, follow these steps:

1. Create (or log in to) your free account on Weblate
2. Go to the AgOpenGPS Project on Weblate
3. Select your language (or add a new one if it's missing)
4. Translate strings directly in the web interface

Translation Status

Links

• AgOpenGPS Documentation
• AgOpenGPS Forum
• PCB and Firmware Repository
• SK21 Rate Control Repository

License

If you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights as Outlined in the GPLv3 License.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.