OpenCPN User Manual

Table Of Contents

GPS Setup and Status

GPS Setup

Please refer to the "Getting Started" Section GPS Setup

GPS Status

The default Ownship icon is rendered as grey if there is no valid gps position fix available and like this when a gps fix is available

The GPS status is also indicated all the way to the right along the top of the screen, together with the North Up/ Course Up Indicator, unless this position is covered by the floating ToolBar. The GPS status is then found bottom left.

This windows visibility is user settable in Options->User Interface-> Show Compass/GPS Status Window. Short cut "Ctrl-I"
The status icons should be interpreted as follows:

No GPS data at all, or position not available.

GPS position available, and good for navigation

Active/Valid GPS data + GPS reporting 1 - 4 satellites, if available from GPS receiver.

Active/Valid GPS data + GPS reporting 5 - 9 satellites, if available from GPS receiver.

Active/Valid GPS data + GPS reporting 10+ satellites, if available from GPS receiver.

In real life, various gps receivers may behave slightly different, especially when starting up and finding satellites.

The small dialog, containing the GPS indicator and the Course Up / North Up indicator, can be toggled on/off with the "Ctrl+i" shortcut.

The GPS status, including available satellites, is also available as an instrument on the DashBoard.

GPS and low accuracy charts.
OpenCPN is checking loaded charts for accuracy as far as possible. If there is a problem with a chart, the chart info box that becomes visible when holding the cursor over the chart rectangle in the chart bar, will say " Warning: Chart georef accuracy is poor."

A visual warning is that Own Ship turns from Red to Yellow when receiving a gps signal.

First is a real scale vector version and then. the default OwnShip bitmap

There is no quick fix for a bad chart, but try to switch to another chart if using single mode chart display. If quilting is on, right-click on the chart button in the chart-bar and select "Hide this chart". Both suggestions assumes that the bad chart can be replaced by other charts, which of course isn't always possible.

Go to Table Of Contents

Getting Started

OpenCPN 4.4.0


This is the Documentation for the OpenCPN 4.4.0 stable release.

It is very easy and intuitive to get started with OpenCPN. The different menus, including the clever context-sensitive right-click menu, make it likely that you will find what you need. The program contains a lot of options to fit users with special demands and hardware.

The most frequently asked questions by new users, seen in the OpenCPN Forum, are, in most cases, already answered in this document. If you are going to use this program for actual navigation, you need to read through this document to fully understand the scope of the program, as well as all the details.

If you have difficulties finding a particular subject, please use your browser's built-in search ability, often called just "Find". This works best using the stable release which is all on one web page.

Press and then the Help Tab to access the built-in version of this document. To help you get started: Links in italic are internal to this document. Placing your cursor over a link will cause the link to be underlined. External links may be Bold, Underlined, or in the "http://..." format and need an Internet connection. Marks and Waypoints may have somewhat different definitions; however, in this document they generally mean the same thing.

NOTE Buttons Above!

Copy Settings File to Clipboard and Copy Log File to Clipboard

If you encounter difficulties in using OpenCPN you may be asked to submit your Settings File and/or your Log File. This data will help the developers to diagnose your problem. The locations of these files on your system are displayed when you click on the "About" tab.

The installed documentation will open in your default browser.
To download a current snapshot of this wiki as one huge web page, click here (only works if you are online).

As you can see above, also documents the people contributing to OpenCPN and a copy of the license OpenCPN uses, GNU GENERAL PUBLIC LICENSE Version 2.

The About tab also tells you where important settings and the log are located on your system and makes it easy to copy them.

First before using OpenCPN, here is the note that all users have to approve when installing the program.

OpenCPN is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied
See the GNU General Public License for more details.

OpenCPN must only be used in conjunction with approved
paper charts and traditional methods of navigation.

DO NOT rely upon OpenCPN for safety of life or property.

This is not a text on general navigation. We assume that you are familiar with nautical navigation. Reading this text and using OpenCPN will not in itself make you a "navigator".


Getting started using OpenCPN consists of 4 basic steps:

  1. OpenCPN Installation will lead you through installing OpenCPN on your particulat OS and computer.
  2. Chart Installation of Charts to be read by OpenCPN (OpenCPN does not include charts)
  3. Charts Basic Features - Main Source for using charts
  4. GPS Setup to communicate with your computer and OpenCPN (Optional, but very useful)
Completing these 4 steps will get you started and allow you to check out the program.

If you still have questions or would just like to get in touch with other OpenCPN users, there is also a fairly large community behind OpenCPN. You can find us in this Cruisers Forum.

* For advanced users we recommend the Developers Manual.

Go to Table Of Contents

OpenCPN Installation

Download your version of OpenCPN here.
  • Use a "stable", official release for actual navigation. The latest stable release is always available at the top of the download page or from Source Forge.
  • Beta releases are snapshots of the development process, and may contain errors or temporarily be unstable. Show stoppers are normally fixed very quickly however. This is where the latest features first are seen. Most of the time the beta releases are quite stable and the OpenCPN team appreciate it if more experienced users test the releases and report back.
  • The place to report bugs and suggest features is the Tracker. To reach the Tracker from the OpenCPN Web pages click on the "Tracker" tab at the upper right (above the blue bar). The sticky thread "Tracker/Flyspray - How and When to use it" (tab Forum) gives some hints.
  • To see what version you are using either look in ?->about or at the top of your display. A lot of information is also available in the log file. See below.


Location of Important Files. Log and config files.

  • It is important to know the location of the log file and the configuration file, opencpn.conf(Linux) or opencpn.ini (Windows), on your computer. If you ask questions on the forum, there is a fair chance that you will be asked about the content in these files. Once you get familiar with OpenCPN, have a look at the files!
  • Through out this documentation there will be many references to the configuration file, as it often is possible to change the default settings. This is an advanced subject once you are familiar with OpenCPN. All editing in the config files must be done with a text-editor, such as "notepad" in Windows.
  • The configuration file is where all data, that needs to be persistent between sessions, are stored. The logfile keeps tab of what's going on in the current session.
  • To find the locations of the files go to the ToolBar click on "About OpenCPN", the button looks like a blue book with a "?" on the cover. Look at the bottom of the "About" Tab, highlighted below. The illustration below is from a Win XP. A quick way to view the logfile is to copy the full file path and then paste this into the address field in a web browser.

  • For quick copying of the opencpn.ini and Log files use the two "Copy" buttons. This is useful for publishing on the forum if asked to do so. Please use the Forum "Code" button before pasting, as this guarantees an exact copy.
  • On Linux the "opencpn.log" is in your home directory.
    The "opencpn.conf" is in a hidden directory, called "opencpn", also in your home directory.
    For a quick way to view the files you can try these commands.
    $gedit `echo $HOME/opencpn.log`
    $gedit `echo $HOME/.opencpn/opencpn.conf`
    Of course you can swap "gedit" for your favorite editor.
  • On Windows 8, Windows 7, Windows 2000, XP and Vista the two files are more difficult to find, so use the "About" dialog as described above. On many windows installs the folder containing the logfile will also be hidden, so you need to change your systems "Folder Options" to show it.
For example, the C:\ProgramData folder is by default hidden in Windows 7. Here's how to get to it:

To access it you need to un-hide it by doing the following:

1. Go to Control Panel > Folder Options
2. Switch to View tab
3. Select "Show hidden files, folders and drives".
4. Unselect "Hide extensions for know file types" to get this state:

Now you will be able to find your logfile.
  • On Mac OS X, the logfile, "opencpn.log", is in /Users/"user name"/Library/Logs/ and the "opencpn.ini" is in the /Users/"user name"/Library/Preferences/opencpn/ directory.

Go to Table Of Contents


Windows XP SP3/Vista/7/8 (except W8 RT)
  • Download the installation package for Windows from Download OpenCPN.
  • Use the stable release for navigation en route, or if you just started using OpenCPN.
  • Exit all other programs, including your anti virus program - known to create problems in some cases. Unplug your network cable, to be on the safe side.
  • Run the downloaded installer. Re-start your anti-virus. Re-connect the network
  • If upgrading from a previous version of OpenCPN, there is no need to un-install the old version. Simply install the new version and it will upgrade OpenCPN, saving all your existing configuration and preferences.
  • If this is a new installation, click on the Toolbox icon Toolbox Settings and configure your GPS source, chart directories, and other settings. It is highly recommended that you use the Chart Downloader Tab to setup directories and download charts.
  • If your installation goes well, but OpenCPN does not start as expected, try to download and install these runtime components.
  • Not Supported Windows versions:
    Win 8 RT is not supported.
    Win CE is not supported.
    Win XP SP 2 or 1 are not supported. The last OpenCPN version that included support was 2.6.1624.
    Win 2000 is not supported. The last OpenCPN version that included support was 2.5.0.
    Win 98/ME are not supported. The last OpenCPN version that included support was 2.1.0.
  • Old versions of OpenCPN are available on SourceForge.

Ubuntu PPA

How to add the OpenCPN PPA into an Ubuntu system

You have two options to add the PPA to your system, either using the commandline Terminal or the GUI provided by the system, chose one that suits you better, not both.

If you are using a non-standard variant of Ubuntu or a newer/older/whatever version than the one used while creating this guide, the GUI may be slightly different, try to use common sense before you start to be furious that the guide below does not work - it does. If it still does not work for you, ask in the support forum, providing exact steps you performed and exact error output you get.

There are two PPA repositories, one for stable versions only and one that includes beta versions. If you want the beta versions replace the "ppa:opencpn/opencpn" string in the following instructions with "ppa:nohal/opencpn".

From the command line

Open a Terminal and enter the following commands:
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:opencpn/opencpn
sudo apt-get update
sudo apt-get install opencpn

Using the graphical configuration tools

Start the Ubuntu Software Center

From the Edit menu, select Software Sources...

On the Other tab, click on Add... button

In the dialog shown, fill in ppa:opencpn/opencpn (for stable versions) or ppa:nohal/opencpn (for beta versions) and click on the Add Source button

Wait until Ubuntu Downloads the necessary information and the progress indicator disappears

From now on you are able to install OpenCPN as any other software. You will also get new stable versions automatically while updating your system.


32/64 bit Ubuntu/Debian Distributions

32/64 bit Fedora / Cent OS

If you are installing OpenCPN for the first time on a computer with Ubuntu, or any other Linux flavor, you have to go through a few steps to make sure that all dependencies are met. Ubuntu uses "deb" packages and Fedora uses the "rpm" packages.
  • For Debian based Linuxes: Make sure that you belong to the "dialout" group. To find out, run the "$groups" command. If you're not in "dialout", add yourself with the command "$sudo usermod -a -G dialout $USER". Check this straight away, it will save you from frustration later on. If there is a problem connecting the GPS to a physical port, such as /dev/ttyS0, the reason is probably that you don't belong to "dialout".
  • For other Linux distributions, replace "dialout" above, with the result of this command: $stat -c %G /dev/ttyS0
  • It is recommended that you install the "xcalib" program, that is necessary to dim the screen for night time usage. Use your favourite package manager or just issue $sudo apt-get install xcalib from the command line (for debian based distros).
  • It is recommended that you install the "xdg-utils" program, that helps the grib plugin compose a SailDoc grib-request-mail. Use your favourite package manager or just issue $sudo apt-get install xdg-utils from the command line (for debian based distros).
  • On Ubuntu, start "System->Administration->Synaptic". In Synaptic go to "Settings->Repositories" and tick the box "Community-maintained Open Source software (universe)". Close Synaptic.
  • Download the correct .deb or .rpm from Download OpenCPN.
  • For Ubuntu, only use the download with an Ubuntu version number if you have exactly that version. Otherwise use the link "Download OpenCPN 3.X.X for all other *Ubuntu's".
  • Use the stable release for navigation en route, or if you just started using OpenCPN.
  • Click on the downloaded package. An installation manager will guide you on most Linux distributions. All dependencies should automatically be installed. For most Linux installations, this is all you have to do. Consult the following 3 paragraphs if you run into trouble.
  • If you have problems with dependencies, run the recommended command line in the next paragraph. First check that you really have downloaded the correct version of OpenCPN. se above.
  • sudo gdebi <downloaded_opencpn_file.deb>. The command "gdebi" will automatically install the dependencies for you.
  • It is also possible to install the package via dpkg or rpm, on the condition that all dependencies are met. To make sure that this is the case on Ubuntu, open a terminal window to get a command line, (Applications->Accessories->Terminal) and copy and paste the following line:
    sudo apt-get install libwxgtk2.8-0 libwxbase2.8-0 wx-common libglu1-mesa libgl1-mesa-glx zlib1g bzip2 gpsd gpsd-clients xcalib xdg-utils libportaudio2 libkml0 libtinyxml2.6.2 liburiparser1 zlib1g libexpat1
    Then proceed with the commands below.
    • For Ubuntu: $ sudo dpkg -i <downloaded_file.deb
      For Fedora: # sudo yum install --nogpgcheck <downloaded_file.rpm>

    • The binary will be installed to /usr/bin/opencpn and the static data used by the program will be in /usr/share/opencpn
  • If this is a new installation, click on the Options icon Toolbox Settings and configure your GPS source, chart directories, and other settings.
  • If there is a problem with sound, make sure that you, as a user, belongs to the "audio" group. To find out, run the "$groups" command. If you're not in "audio", add yourself with "$sudo usermod -a -G audio $USER"
  • If you are running Debian Squeeze and want to install OpenCPN from the distributions .deb package, you will need to install with something like this in order to satisfy install dependencies related to libtinyxml:
    $sudo dpkg -i --force-depends opencpn_3.1.1327-1_i386.deb

Using Linux repositories, an easier way to install and update.

Installing in a different, easy way.

Installing on Ubuntu

Add the OpenCPN ppa repository as explained in configuring Ubuntu PPA
- If you are using Synaptic, add the repository, reload the software sources as it suggests, search for and install opencpn
- No need to install anything manually

Other 32, 64bits, the armhf architecture, Linux Distributions and the BSD operating systems

  • Currently other distributions requires compiling the source. This will involve resolving various dependencies and is for folks comfortable with developing on Linux.
  • Download the source from or directly from the Git server. The SourceForge link for this project is More about compiling on Linux here Compiling - Linux.
  • Interested in maintaining a package for your favorite Linux distribution? Follow the SourceForge link above.
  • This also includes the different BSD distributions. Report your experiences back to the forum.

openSUSE notes

Starting with openSUSE 11.4 and onwards, wxWidgets framework is shipped in several mutually exclusive flavors — “STL”, “noSTL” (“wxContainer”), “ANSI”, — of which OpenCPN is only compatible with “noSTL” (“wxContainer”) flavor.

  • Older versions of OpenCPN support wxWidgets 2.8, which does not have a “default” flavor in openSUSE, and of which any flavor may be installed alongside with each other, but OpenCPN stricly requires “wxContainer”.
  • Modern versions of OpenCPN, starting with beta branch 4.5, use functionality that is only available in wxWidgets 2.9, but since that branch is not packaged by openSUSE maintainers, then wxWidgets 3.0 becomes a must. That one defaults to “STL” flavor, which is not appropriate for OpenCPN and will result in multitude of mysterious compilation errors if used, — OpenCPN requires “noSTL”.

To install the required wxWidgets 3.0, use the following command:

sudo zypper install wxWidgets-3_0-nostl-devel

For legacy OpenCPN builds against the older wxWidgets 2.8, some virtual wx libraries (with no real content) must also be installed in addition to real-deal wx libraries themselves:

sudo zypper install wxWidgets-wxcontainer-compat-lib-config libwx_baseu-2_8-0-compat-lib-wxcontainer libwx_baseu_net-2_8-0-compat-lib-wxcontainer libwx_baseu_xml-2_8-0-compat-lib-wxcontainer libwx_gtk2u_adv-2_8-0-compat-lib-wxcontainer libwx_gtk2u_aui-2_8-0-compat-lib-wxcontainer libwx_gtk2u_core-2_8-0-compat-lib-wxcontainer libwx_gtk2u_gl-2_8-0-compat-lib-wxcontainer libwx_gtk2u_html-2_8-0-compat-lib-wxcontainer

The above commands will also automatically trigger installation of underlying real-deal libraries and other dependencies if they were not present before.


Using Linux repositories, an easier way to install and update.

Installing in a different, easy way. RPM

Installing on Fedora A full repo is now available and can be used to install and update opencpn.
To install the repo, please run this as root:

dnf install

Install above RPM

You can install the above rpm, no matter if you're using i386 or x86_64, be it Fedora 22 or Fedora 23, it'll work on all these (you should be able to install it right from your browser clicking the above link and then install)
By default, only the stable repo is enabled ; you can install opencpn-4.2 from your favorite package manager (dnf, Gnome package kit or KDE package kit).

I've created two separate packages:

"opencpn" with the program and the two default plugins and
"opencpn-doc" with the whole html doc to browse it offline.

When a new stable is released, you'll be automatically notified and able to update... so easy!

Security/Trust: all packages are signed with Key ID: 7e53dbe19add462d

OpenSUSE and Fedora

From Dominig,
I keep a precompiled version of OpenCPN for OpenSUSE and Fedora ready to install in the OpenSUSE build system (OBS). As both distro are rpm based, it's very easy for me to suport both.

Getting the correct wx release built and installed is a pain as notonly you need to get the right version built, but you also need to compile it with the right option set (no stl) and then make sure that the system does load what you want. Getting the right wx installed may require to change some priority oreven wx repo manually on the target PC.

My repo is here.

I hope that it can help. Regards Dominig

Mac OS X

Mac OS X

  • OpenCPN is distributed as a Mac ".dmg" file.
  1. Download the .dmg file.
  2. Open the dmg file by double-clicking on it - this will mount the dmg as a virtual device and create a mount on your desktop.
  3. Drag the application from the dmg image to your Applications folder in a finder window. This may require the administrator password.
  4. Unmount the dmg by right-clicking on the desktop icon and selecting "Eject"
  • You can have a look at this tutorial How to Install and Remove Apps for general instructions on installing Mac OS X applications.
  • If you have a message that installations are only accepted for programs from qualified developers, navigate to Applications in Finder, Control-click, select Open from the context menu and confirm that you want to start it in the displayed dialog.
  • To save a previously installed version rename the app in the Applications directory before installing the new version.
Installation of Plugins
  • Download the installation package (*.pkg)
  • Double-click the downloaded file to start the installation.
  • Follow the instructions provided by the installer
  • In case your security settings are tigh and the OS refuses to start the installer, control-click it, select Open from the context menu and confirm your intention to install the plugin in the subsequent dialog.

Dedicated Marine OS


Another way to run OpenCPN or test it without install on your current system is to use a specialized marine OS, which also include essential marine applications. Xinutop is a free an opensource Linux-Ubuntu based solution and can operate on a large variety of x86 processors compliant. It can run as a live system on USB key or can be installed on a HDD, as primary or secondary OS.

Infos and download at
See also in Supplementary Software Xinutop Marine OS


The open-source sailing platform for ARM computers

There are people who buy boats but there are also people who build them, why not build your own electronics too? OpenPlotter is a combination of software and hardware to be used as navigational aid on small and medium boats. It is also a complete home automation system onboard. It works on ARM computers like the Raspberry Pi and is open-source, low-cost and low-consumption. Its design is modular, so you just have to implement what your boat needs. Do it yourself.

You will need the basic parts and some optional parts. It will depend on what kind of data you want to collect, process or display and what kind of equipment your boat already has.
Openplotter Cruisers Forum

Orange Pi

What’s Orange Pi PC

It’s an open-source single-board computer. It can run Android 4.4, Ubuntu, Debian, as well as the banana pi Image. It uses the AllWinner H3 SoC, and has 1GB DDR3 SDRAM. It also has a Mali-400 gGPU that can run acellerated OpenGLES.

One of the Linux distrobutions available is armbian, a linux for ARM development boards.
These instructions are for the armbian Debian Jessie release (5.05). And OpenCPN 4.2.0 in Apr 2016.
Updated to include armbian Debian Jessie release (5.14). And OpenCPN 4.4.0 in Jun 2016.

To install from a debian package please see:

To compile your own version please see the developer manual: and
KB7KMO Projects: OpenCPN on Orange Pi an Allwinner H3 Arm SBC

RaspberryPI RPI2

Installing OpenCPN on RaspberryPi 2 (RPI2)

It may help to review King Tide Sailing "How To Install OpenCPN on a Raspberry Pi"
with additional helpful step by step installing NOOBS.
Part I: Setting Up the Raspberry Pi for OpenCPN
Part II: Installing OpenCPN

NOOBS ( stands for New Out of the Box Software) is an easy operating system installer which contains Raspbian. Raspbian is the official supported operating system. It also provides a selection of alternative operating systems which are then downloaded from the internet and installed, we are interest in Raspian Jessie.

Part I: Setting Up the Raspberry Pi for OpenCPN

Download NOOBS (Jessie)
Getting Started
Install NOOBS (an easy operating system install manager) on a formatted SD Card. Follow the instructions for First Boot and Logging in.

Then follow instructions for installing Raspbian Jessie.

Part II: Install OpenCPN from Launchpad without compilation

Install OpenCPN on a Raspberry Pi 2 running Raspian Jessie from a Launchpad repository without compilation.

Add some repositories. To do this, you may:
  1. Use Synaptic OR
  2. Edit the package sources file (/etc/apt/sources.list)directly as desired.
For more information and tutorial, see:

We need the following repos:
1. deb jessie main
2. deb trusty main
3. We also need to get a PGP key compatible with repo(2) above.
$sudo apt-key adv --keyserver --recv-keys 9C18FD9F
4. Update the repositories. $sudo apt-get update
5. Install opencpn $sudo apt-get install opencpn

Optional. $sudo apt-get install libgl1-mesa-swx11

This gives you OpenGL support with a Software rasterizer.
There is not much speed improvement in OpenCPN with the rasterizer.

Alternative to Part II: Requires Compiling OpenCPN

Install the list from OpenCPN for compiling linux..

OpenCPN must be compiled for installation.

sudo apt-get install build-essential cmake gettext git-core gpsd gpsd-clients libgps-dev wx-common libwxgtk3.0-dev libglu1-mesa-dev libgtk2.0-dev wx3.0-headers libbz2-dev libtinyxml-dev libportaudio2 portaudio19-dev libcurl4-openssl-dev libexpat1-dev libcairo2-dev

Then ..
git clone -b rpi_fixes
cd OpenCPN
sudo mkdir build
cd build
sudo cmake ..
sudo make
sudo make install

It should compile and run. OpenGL mode is just a white screen, no charts and no frame rate displayed.
With Opengl turned off it seems the same as 4.0.

Conachair advises:

When compiling using -j can force use of all the cores, ie. make -j5 will use 4 cores to compile. Except it crashed the Pi! or seemed to, it hung for ever before I rebooted it. make -j3 seemed to speed things up a bit without crashing, though I never did get it to finish without at least 1 crash. At least it picks up where it left off so you don't have to start again.
I still haven't managed to get Seans fix for using hte hardware acceleration which would be great. This possible improvement in the launcher repos and Openplotter the Pi will be within reach of many sailors less inclined to get into command line.

Current Raspberry Pi Hardware

Pi 2 Model B, the second generation of the Raspberry Pi. The Pi 2 has four USB ports, 40 GPIO pins, and an Ethernet port, uses a 900MHz quad-core ARM Cortex-A7 CPU and has 1GB RAM. The Pi 2 is completely compatible with first generation boards. RAM on the Model 2B is on a separate chip on the bottom of the PCB, but 1GB is the maximum RAM that the SoC used by the Model 2B can support.

Release History

1.2.0 2007-04-20
Opencpn was built with the following objectives in mind.

i. Intended use as primary navigation interface for vessels
with full-time helm-visible navigational suites.
Other tools may be better for offline route planning, tide
and current prediction, online logging, etc.
ii. Quick startup and shutdown.
iii. Those and only those toolbar buttons really needed for
daily operation.
iv. Portability, thus wxWidgets core components. Currently
tested and in production use on W98, XP, and Linux.
v. Conventional ( i.e. popular and modern ) chart format
support. In the real world, this means BSB format raster
charts, and S57ENC format vector charts.

1.2.2 2008-01-02
Improved AIS symbology and diagnostics, including RateOfTurn indication.
Improved toolbar icon symbology, supporting day/dusk/dark color schemes.
Rationalized home directory selection for Windows, allowing program installation in
arbitrary directory/folder.
Improved accuaracy of Great Circle distance/bearing calculations.
Optional Depth Units displayable on chart as embossed character image.
Ownship position indicator on thumbnail charts accurately follow true GPS position.

1.2.4 2008-04-20
Configure/build modifications for Unicode systems, especially Ubuntu.
Added Route and Mark property sheets.
Improved S57 ENC symbology

1.2.6 2008-08-31
This is a maintenance and feature update release,
containing some S57 ENC symbology improvements,
greater compliance with IHO S52 standards, and various enhancements and
bug fixes. Especially interesting are the DUSK and NIGHT display modes,
for which user feedback is highly desired....

1.2.8 2008-12-25
Mac OS X Support, including installable application bundle (OpenCPN.dmg), GNU/gcc compatible system build files, and XCode project files.
Garmin USB GPS device support for Windows platforms.
Miscellaneous bug fixes and user optimizations.

1.3.0 2009-05-09
1. CM93 worldwide vector chart support, with automatic chart scaling.
2. Improved AIS target tracking with configurable CPA/collision warning options.
3. GPX compatible waypoint and route exporting tools.
4. Configurable range rings centered on ownship position.
5. And, as usual, miscellaneous bug fixes and user optimizations.

1.3.2 2009-07-11
1. Improved AIS target depiction and collision detection alerts.
2. Hot keys and scroll mouse support.
3. Help File.
4. Various display speed and quality optimizations, especially for CM93 charts.

1.3.4 2009-10-01
1. Ship's position tracking function, with GPX export and import.
2. Enhanced icons and screen graphics, for improved visibility.
3. Import and export of Routes using GPX interface protocol.
4. Implement CM93 vector chart detail control slider.
5. Assorted usability and reliability improvements.

1.3.6 2010-01-07
1. Add basic GRIB file decoding and chart overlay display.
2. Improve and expand NMEA message type support.
3. Improved documentation.
4. Add modular international language support.
5. Assorted usability and reliability improvements.

2.1.0 2010-06-26
-BSBv3 raster and S57 ENC chart support.
-CM93 vector chart support.
-IHO S52 compliant display of S57 vector charts.
-Single-chart and Quilted display modes.
-North-up and Course-up display modes.
-Moving-map display mode.
-Route navigation with ship tracking functions.
-Waypoint navigation.
-NMEA 0183 GPS interface at selectable baud rate.
-gpsd library support.
-Autopilot output support.
-AIS input with full target tracking and collision alerting.
-Anchor watch/alarm functions.
-GRIB file input and display for weather forecasting.
-GPX Waypoint and Route input and output file support.
-Tide and Current prediction and display by location.
-Multi-language support.
-linux and Windows compatible.

2.3.0 2010-12-18
1. Integrated PlugIn architecture, allowing third-party development and deployment of auxiliary features.
2. Two useful PlugIns available immediately:
Graphical overlay of GRIB (weather)file data
Dashboard for configurable on-screen display of ship's NMEA data.
3 Enhanced Route, Track, and Waypoint management functions by selectable dialog.
4. Many new languages added to basic package, including:
5. Support Garmin Host mode Route and Waypoint interchange and upload to remote GPS receivers.
6. Advanced internationalized Windows Program Installer.
7. Full support for North-up and Course-Up display of all chart types.
8. Expanded AIS target message decoding to include European Inland AIS specifications.
9. AIS Target List Dialog, allowing easy selection and monitoring of all active AIS targets.
10. Many, many improvements in the basic User Interface, while maintaining the ease-of-use that

2.3.1 2010-12-31
1. Correct logic regarding ownship AIS messages (AIVDO)
2. Correct fault closing AIStarget list with target query dialog open (FS#310)
3. Correct occasional geolocation problem with routes on BSB chart switch.
4. Improve Toolbar refresh logic.
5. Increase maximum chart stack size from 20 to 30. (FS#316)
6. Correct GoTo waypoint and subsequent route delete logic. (FS#244)
7. Various language file updates.
8. Correct Depth unit display for quilted charts, with non-english language setting.
9. Correct Win7 Garmin USB Device interface reset in User Mode.
10. Correct Windows vc redistributable installation command in NSIS script.

2.5.0 2011-07-26
1. Per-Cell offset adjustment for cm93 charts
2. Transverse Mercator chart quilting.
3. Selectable full screen quilting option.
4. Configurable lat/lon gid lines.
5. Variable screen dimmer function.
6. Improved Tide/Current information window.
7. Configurable "Layers" function, enabling selectable display of fixed objects.
8. Improved and extended AIS functions, including
a. Euro Inland support
b. Base Stations and ATONs
9. Selectable FullScreen display mode.
10. Integrated Route Planner function, with Tide table support.
11. Enhanced GUI functions, with floating transparent Toolbar.
12. Several new language options.
13. Improved internal memory management.
14. Improved Autopilot output support.
15. New Multi-leg Measurement tool.
16. Improved Vector chart symbology.
17. Improved integrated Tide/Current data accuracy.
18. Improved Route definition interface, including selectable Route colors.
19. Full conformance for all platforms, especially including Macintosh OS X.
20. Greatly improved staility on all platforms, as a result of extended Beta testing.
21. Many, many improvements in the basic User Interface, while maintaining the ease-of-use that OpenCPN is widely known for.

3.0.0 2012-06-05
New and Enhanced Features for OpenCPN Version 3.0
1. OpenGL support, for enhanced graphics performance and functionality.
2. Improved ENC object Query interface
3. Portable execution option, allowing easy migration to new systems.
4. Upgrade to wxWidgets 2.8.12.
5. Support ENC Overlay cells.
6. Upgrade gpsd support to Version 2.96
7. Implement enhanced PlugIn system, enabling a wide variety of PlugIn types.
8. Implement DSC and GPS_Gate Buddy tracking.
9. Implement user defined Chart Groups.
10. Implement AIS SART transponder display and tracking.
11. Improved ENC object rendering and display.
12. Implement user definable Tide/Current datasets.
13. Full conformance for all platforms, especially including Macintosh OS X.
14. Greatly improved stability on all platforms, as a result of extended Beta testing.
15. Many, many improvements in the basic User Interface, while maintaining the ease-of-use that OpenCPN is widely known for.

3.0.2 2012-07-07
This Service Release corrects several small bugs found in the recent 3.0.0 field release.
It incorporates no new features.

3.2.0 2013-02-27
1. Complete update of user Options dialogs and context menus, incorporating modern graphics and uniform styles.
2. Significantly enhanced navigation instrument input and output options, including extensive network connection capabilities supporting TCP, UDP, and GPSD data sources.
3. New User Interface theme support, with OpenCPN traditional as well as two new low profile themes.
4. Enhanced clipboard support, including interfaces to external KML data sources.
5. Enhanced Tide and Current dataset support, including modern fully binary datasets.
6. Various improvements in the display and tracking of AIS data targets.
7. Automatic Great Circle route generation options.
8. Significant enhancement of the Dashboard PlugIn, including new user interface options and a variety of stylish, new instruments.
9. Improved sound system support for linux hosts.
10. Major update to embedded Users Manual.
11. Measurably improved performance and reliability over all supported platforms.

3.2.2 2013-05-08
This Service Release corrects several small bugs found in the recent 3.2.0 field release.
It incorporates a command line switch to turn off OpenGL completely.

4.0.0 2015-01-08
A major release.
Increased performance in all modes, particularly when using OpenGL graphics acceleration.
- Additional network interface methods, including TCP/IP client/server and UDP broadcast.
- Support for multiple data source instances, including
- Filtering and prioritization of messages
- Output of NMEA data streams for real-time integration into ship systems
- Improved support for Mac OS X systems, including 64 bit native support.
- Integrated Tablet/Touch screen support.
- AIS Personal Locater Beacon (PLB) configuration and tracking.
- Enhanced AIS target tracking modes.
- GRIB PlugIn feature additions.
- Graphical GRIB email request generation.
- Moving particle wind overlay.
- Enhanced GRIB data type support.
- Dashboard PlugIn feature additions.
- More selectable instruments.
- Several new and updated Plug-ins, including
- Digital Radar overlay for popular radar scanners
- World Magnetic Model variation compensator
- Climatology analysis
- Dynamic route planning
- Integrated logbook
- Realtime datastream capture, record and playback
- Google Earth integration
- Weatherfax overlay
- Vector chart object and feature search tool
- S63 Encrypted vector chart support
- Major update to embedded Users Manual.
- Measurably improved performance and reliability over all supported platforms.
- And much more

4.2.0 2016-02-03
Increased performance in all modes, particularly when using OpenGL graphics acceleration.
Integrated Chart Downloader PlugIn, allowing systematic tracking and donwload of latest online charts from several popular sources.
Integrated World Magnetic Model (WMM) PlugIn, providing accuratley calculated magnetic variation worldwide.
Major update to embedded Users Manual.
Measurably improved performance and reliability over all supported platforms.

4.4.0 2016-06-13
Support for GRIB V2 format files.
Measurably improved performance and reliability over all supported platforms.

OpenCPN First Use

Here is what happens once OpenCPN is installed and you start the program for the first time.

First this message greets you. Please remember what you agrees to when clicking OK.

Next OpenCPN prompts you to install charts.

And sends you to "Options" to do so. Click on the Charts tab, to install charts. Read all about installing charts in Installing Charts
If you're not quite ready to install yet just click "OK" in the Options dialog.

The worldwide background Map will greet you.
From here explore the different features in OpenCPN by clicking around, or read on...


Getting started using OpenCPN consists of 3 basic steps:

  1. Chart Installation of Charts to be read by OpenCPN (OpenCPN does not include charts)
  2. Charts Basic Features - Main Source for using charts
  3. GPS Setup to communicate with your computer and OpenCPN (Optional, but very useful)
Completing these 3 steps will get you started and allow you to check out the program.

If you still have questions or would just like to get in touch with other OpenCPN users, there is also a fairly large community behind OpenCPN. You can find us in this Cruisers Forum.

Go to Table Of Contents

GPS Setup

Below we describe only the basics of getting a gps up and running.
For a full description of all options read Options Setting

Make sure your GPS is set to output positions using the WGS 84 Geodetic Datum. This is less of an issue nowadays, compared to, say 10 - 15 years ago.
Some units can't be changed, and is permanently set to WGS 84. The BU-353 is one of those.

Matrix of GPS Devices

Windows 10

Windows 10 users generallly must purchase a new GPS Puck specifically configured for Windows 10. For Example, the BU-353 which works with earlier versions of Windows does not work without an elaborate work around invovling preventing automatic update of Prolific USB drivers by the OS. It is far easier and more reliable to simply purchase another Windows 10 compatible GPS Puck (similar to the BU-353 S4) and use the associated drivers.

This Windows 8 Microsolft GNSS driver has been found to be helpful. (Also described more completely below.)

Windows XP/Vista/7/8

Note that the extensive use of the cheap gps mouse BU-353 as an example below, should only be seen as an illustration.

To use OpenCPN with a GPS, a GPS receiver is needed.

There are a variety of possible choices for a GPS receiver:

  • A computer, such as a Sony Vaio P has a built in GPS receiver
  • A NMEA Expander to amplify a nmea stream to multiple listeners
  • A hand-held GPS receiver
  • A dedicated GPS receiver

The remainder of this section describes using OpenCPN with a dedicated GPS receiver, however, the instructions for a dedicated receiver will be similar for any serial/USB connected NMEA data stream.

A Dedicated GPS Receiver

There are several companies making dedicated GPS receivers. The Supplementary Hardware section for GPS devices lists several manufacturers.

NMEA has traditionally been implemented as a serial protocol and therefore, even if a USB connection is used, there needs to be a USB to Serial Port conversion. The specific driver for the each GPS receiver will handle this conversion.

An Example - Configuring BU-353

It is not necessary to use the installation disk to setup the BU-353. Following the steps listed below will result in the latest driver being installed.

  1. Download the latest driver from Prolific -
  2. Unzip and install the driver
  3. Plug in the BU-353.
  4. Start -> (Right Click) My Computer -> Properties -> Hardware ->Device Manager
    or Start->Run devmgmt.msc
  5. Expand Ports
  6. Look for the “Prolific USB-to-Serial Comm Port” and note the com port number (e.g., COM4)
  7. Right click on the “Prolific USB-to-Serial Comm Port”. Choose Driver
  8. Select 4800 bits per second, 8 data bits, None parity, 1 stop bit, and None for Flow Control
  9. Start OpenCPN
  10. Click on the Options Icon Toolbox Settings
  11. Select "Connections", and "Add Connection" and "Serial"
  12. Under "Data Port" select the Com port noted in #6
  13. Choose OK
  14. Select Auto Follow to center the map over your GPS location


There is a small LED located on the BU-353. If the LED is off there is no power being received. Check the connection.

If the LED is solid it indicates the BU-353 is searching for a GPS signal. Try moving the GPS receiver to a clear location.

If the LED is flashing it indicates the BU-353 has a position fix and is transmitting data.

  1. Try viewing the NMEA data stream in OpenCPN. Choose Options->Connections->Show NMEA Debug Window
  2. Alternatively, a diagnostic program is included on the installation CD called GPSInfo.exe. Launch this program to install the diagnostic utility.

If it appears that the NMEA data stream is being received, the most likely issue is that OpenCPN is not centered over your location. Click AutoFollow to center the map at your GPS location.

Known Issues

If you change the USB port for the GPS receiver Prolific will reassign the COM port number. This will require repeating steps 4-12 above. If you are having trouble with Prolific drivers and an Error Code, try reading this page

On some computer / GPS receiver combinations when the computer resumes from Stand By the GPS receiver will no longer transmit its NMEA data stream, and only garbage instead of ASCII characters will be visible in the NMEA Data Stream Window. The red indicator led will not work.

To change back to NMEA mode search for and download SIRFDemo.exe.
Unpack and start. Set correct Baud rate and and com port as above.
Click connect to data source button. Action -> Switch to NMEA protocol, then exit.
There are many more settings available in SIRFDemo.exe

An alternative workaround for this issue is provided by using a COM port splitter such as XPort

  1. Download XPort.
  2. Unzip it to a folder of your choice
  3. Double Click XPort.exe
  4. Set the Baud Rate to 4800
  5. Under Enable Ports add an entry for COM10
  6. Click “Find GPS”. The port returned should match the port identified in Step #6 in the Configuring BU-353 Section
  7. Select Prolific USB-to-Serial Comm Port in the check box section
  8. Return to OpenCPN
  9. Click on the ToolBox Icon Toolbox Settings
  10. Select GPS
Under NMEA Data Source change the Com port to COM10

How to use OpenCPN on a tablet windows 8 with GNSS Sensor
A small application that enables windows 8 tablets (or notebooks with GNSS sensor) to use OpenCPN. Tested and GNSS sensor seems to be able to pick up the signal quite well. See the details here:
Also refer to


To proceed, the "user" you use on your computer must belong to a group that is allowed to open serial connections. This group is normally "dialout" on Debian based Linuxes, including Ubuntu, and "uucp" on Red Hat based distributions. Read more in Connections.
Check your status by writing "groups" on a command line. The response will be all groups that the user belongs to. Make sure that "dialout" or "uucp" is included. If not, you have to add your user to this group. There are many ways to do this, one is to issue this command:
"sudo usermod -a -G dialout $USER". Logout of your current session for group changes to take effect.
This applies to many Debian based distibutions, for other distros just drop the sudo and do the command as root, using "su".
All major Linux distribution includes a graphical user settings dialog, where adding a user to a group, could be fixed.

Two methods are available, direct connection or through gpsd.

We start with gpsd.
  • Install the gpsd and gpsd-clients packages
    • $ sudo apt-get install gpsd gpsd-clients
  • Go to Options-> Connections-> Add Connection and select "Network" plus the GPSD radio button. Address should be "localhost" and DataPorts should be set to 2947.
  • On Ubuntu 10.04 and later, that is really all you have to do. When you plug in your gps this will trigger gpsd to start.
  • "xgps" is client that comes with the gpsd-clients package, and is useful for testing that the gps and gpsd is working properly. If xgps isn't working, it's a gps or gpsd problem, not an OpenCPN problem
Direct connection.
  • Make sure that gpsd isn't running then connect your gps and start OpenCPN. On Ubuntu 12.04 the easiest way to achive this is to unistall gpsd.
  • In the Options->Connections -> Add Conection, select "Serial".Set "dataPort to the port where you plugged in your gps. If you plugged in BU 353 this will probably be /dev/ttyUSB0.
  • Choose 4800 baud, unless you know that the gps is set to something else.
  • The gps should now work....if not, check the NMEA data stream window. If only binary garbage is visible, the gps has to be reset to NMEA mode, see more about this above in windows section. An alternative is to use gpsd, that will work with the gps in Sirf mode.
  • To do this in Linux for BU 353 as well as many other gps:es, make sure that gpsd is running and that the package "gpsd-clients" is installed. On Ubuntu 12.04 gpsd needs to be temporarily installed. Make sure to kill any instances of gpsd with the command "sudo killall gpsd"
  • The command $gpsctl -n will put the GPS into NMEA mode.
  • If that doesn't work, try $ gpsctl -f -n /dev/ttyUSB0 .This will force a low-level access, bypassing gpsd. For more information: $man gpsctl
  • More information is as always available through "man gpsctl" Close down OpenCPN before running gpsctl.

    None of this is normally noticed when using gpsd, as this program reads both NMEA and SIRF binary sentences.
  • More Linux hints

  • If you can't connect to a physical port, such as /dev/ttyUSBO, indicated by a line in the opencpn.log file. Check that you, as a user, belongs to the group "dialout". To see which groups you belong to, run the command "groups". Not all Linux distributions add the user to this group by default. To add your self to the dialout group -> "sudo usermod -a -G dialout $USER"
  • Check if gpsd is working:
    $ ps aux | grep gpsd
    nobody 12338 0.3 0.1 4124 1448 ? S<s 18:31 0:00 gpsd -F /var/run/gpsd.sock
    you 12356 0.0 0.0 3036 800 pts/3 S+ 18:32 0:00 grep --color=tty -d skip gpsd
    This or similar responses indicate that gpsd is running. If you only have something like the second line, is not running.
  • Run the command "$ls -lrtd /dev/*|tail -10", and see the 10 latest created device files. Run this just after plugin in your gps to see which device was created.
  • Determine which device your GPS is on your linux system by checking the startup. Look for a line that says something about GPS and /dev/ttyUSB# in the command "dmesg"
  • Or even better, after connecting a gps mouse, BU-353, we look for a dmesg by running this command.
    $ dmesg | grep tty
    and get this response back.
    [13616.095305] usb 2-3: pl2303 converter now attached to ttyUSB0
  • Add a script to start gpsd, if this is not done by your distribution. I saved mine as startgps and set the executable attribute. Edit line 3 to match your device, ie /dev/ttyUSB0
    • #!/bin/sh
       sudo killall gpsd
       sudo gpsd -n -D 2 /dev/ttyUSB0
  • Run the script:
    • $ ./startgps
If this is a new installation, click on the Toolbox icon Toolbox Settings and configure your GPS source, chart directories, and other settings.

Other Distributions

Udev Rules

  • If you have problem with, for example gps, connecting to different ports each time you restart udev is your friend.
  • udev supports persistent device naming, which does not depend on, for example, the order in which the devices are plugged into the system. The default udev setup provides persistent names for storage devices.
  • There is a lot about udev on the Internet. For OpenCPN specifics, read the cruisersforum.

Bluetooth GPS

More user experience of setting up bluetooth GPS are welcome, as the notes below just reflects a few users experience. Please use the Forum.

Ubuntu 10.10 and older.

If you have a bluetooth GPS you will need to first configure it through the standard Ubuntu Bluetooth "set up new device " proceedure. Once you have done that you will need to find what the address of the GPS is. To do that you run this command:

"sudo hcitool scan"

it will then start looking for the Bluetooth GPS and hopefully find your GPS. You should see something similar to:

Scanning ...
00:1C:88:10:D3:4D iBT-GPS

In this case i have a IBT-GPS at address 00:1C:88:10:D3:4D (Your GPS address will be different)

Next we have to bind the GPS address to a "virtual" device OpenCPN understands in this case rfcomm0. We do this with the following command:

sudo rfcomm bind /dev/rfcomm0 00:1C:88:10:D3:4D Note put your GPS address in this line

You should not have to run these commands each time your linux is restarted as it will remeber your GPS address.

Now all you need to do is go into OpenCPN Toolbox and select GPS. Now in the NMEA Data Source options select from the pulldown menu: "/dev/rfcomm0", or write it in the box, if not present as an alternative.

Thats it - you should now have a Bluetooth GPS Connected.

Ubuntu 12.04
-Pair GPS with bluetooth icon
-break connection with bluetooth icon
-get device id: sudo hcitool scan
-get channel for gps: sdptool records 00:02:78:0A:4E:E9 (put your actual number here)
-sudo gedit /etc/bluetooth/rfcomm.conf #edit rfcomm input file. Text should be:
	# RFCOMM configuration file.
	# $Id: rfcomm.conf,v 1.1 2002/10/07 05:58:18 maxk Exp $

	rfcomm0 {
	        # Automatically bind the device at startup
	        bind yes;

	        # Bluetooth address of the device
	        device xx:xx:xx:xx:xx:xx;

	        # RFCOMM channel for the connection
	        channel 1;#use channel number as provided by sdptool records XX:XX:XX:XX:XX:XX

	        # Description of the connection
	        comment "Your GPS Device Here";
- sudo rfcomm release 0 (not strictly neccesary)
- sudo rfcomm connect 0 (you only need to to this once, not required if you reboot at this point)
...connected /dev/rfcomm0 to 00:00:00:00:00:00 (whatever)
...Press CTRL-C for hangup
in a seperate terminal, you can test the connection with rfcomm show /dev/rfcomm0
...rfcomm0: 00:08:1B:14:18:B6 channel 1 connected [tty-attached]
your bluetooth GPS should now be working in open CPN. run sudo opencpn to check that it works (/dev/rfcomm0 under GPS NMEA data source).
if it works, try running opencpn without sudo, chances are that you cannot see the gps. if this is the case, use the following fix: sudo usermod -a -G dialout $USER


Run "hcitool scan" to get the ID of your bluetooth gps device
Make a file "rfcomm.config" and put it in /etc/bluetooth.
This file is already present in Ubuntu, but needs editing for persistent connection.

# RFCOMM configuration file.
# $Id: rfcomm.conf,v 1.1 2002/10/07 05:58:18 maxk Exp $
rfcomm0 {
# Automatically bind the device at startup
bind yes;
# Bluetooth address of the device
device XX:XX:XX:XX:XX:XX;
# RFCOMM channel for the connection
channel 1;
# Description of the connection
comment "Your GPS Device Here";

Change XX:XX:XX.... to your device ID

Open Opencpn and write /dev/rfcomm0 as GPS NMEA device. Note that you can add it yourself by writing directly into the scroll down box.
Permissions for /dev/rfcomm0 are for group "dialout". Make sure you belong to that group.
The command "groups" will show all the groups you belong to.
Make sure that "gpsd" isn't running, issuing "killall gpsd" as root.


Attaching a GPS device to a Mac is done via one of the USB ports. Whether using a device with its own USB lead or via a serial-USB adapter lead or an NMEA multiplexer with USB port, the appropriate OS X driver needs to be installed. Nearly all hardware uses one of just two chip makes: those from FTDI or Prolific. Both those companies make OS X drivers available on their web sites, but manufacturers of GPS devices usually package the driver with device.

When the driver is installed and the device connected, start OpenCPN, select the Toolbox and click the GPS tab. Open the "NMEA Data Source" menu & select the the device from the list. It is not always obvious which is the correct one, but in general the device will have a name starting: "/dev/cu." or "/dev/tty.". Some manufacturers make it obvious, like "/dev/cu.MiniPlex-99000125", but others may be more generic, like: "/dev/cu.usbserial". Set the "NMEA Baud Rate" to 4800 and click "OK". If the correct selection has been made, you should see the GPS status icon change from red to green.

Virtualized Environments

Use of Virtuallized Environments such as Parallels, VM, VirtualBox, etc to run an alternative version of Opencpn on your Mac or PC are beyond the scope of this section. However experienced users are invitied to report the specifics about using USB ports with Virtual Configurations. Please be specific about the setup and software and explain how virtual USB ports work in that environment. These comment will eventually make their way into this section.

It should be noted that each Virtual Software handles virtualization of USB and Sharing differently. This can affect the connection and reliability of the connection for GPS.

OpenCPN is user powered, so we depend on User's sharing their experiences. Please assist us.

Go to Table Of Contents

Chart Installation

Several steps suggested to obtain & setup charts.

For first time users we suggest you use the Chart Downloader Plugin which helps to find and download free charts and is included with the installation of OpenCPN 4.2. If you choose to manually load charts please pay close attention to the following:
  • Know the path to the the "Chart" directory. Please make note of the path you selected for the Charts Folder.
  • If you choose to manually download charts, be sure uncompress and install them in your Charts directory
  • Please read Installing Charts (Chart Files Tab) which is Under the Main "Charts" section.

Charts Overview

OpenCPN itself does not come with charts.
Charts are a complex subject. Having accurate and current charts is important for safe navigation.
There are a number of resources on this website and others to obtain charts.
However thee USA provides free NOAA Charts and many other countries do as well. See Chart Sources below.

  • Chart Files Tab OpenCPN does not come with charts. Description of how to Install Charts.
  • Charts Main resource for Charts.
  • Chart Downloader Plugin Chart Downloader provides an easy way to download and install free NOAA and RNC and ENC charts around the world. It is the easiest way to get started with charts. Download a few charts in your area and use them to learn, then later add more as needed. NOTE: Free charts are not assured everywhere.
  • Chart Sources (Extensive list of free charts available, mostly covered by Chart Downloader Plugin)
  • Chart Formats (You will see why this is a complex subject)
  • Manual Installation - download and install yourself
  • Background Map (GSHHS Low Res) - The initial rough background map that OpenCPN uses.
  • High Resolution Background Map (GSHHS 230 mb) here We suggest this should be used if Watchdog Landfall alarms are being used.
  • Links with Chart Information

Manual installation

For this example, I will be using the freely distributed NOAA US charts.
  • Head over to NOAA's Chart website here
  • On the left, click on Download ENCs (electronic navigational charts for Vector Style charts, vs Raster Charts)
  • Download your desired region. For this example, I grabbed the State of California,
  • Unzip all those folders (US1EEZ1M, etc...) to a location on your hard drive. I used My Documents/charts.
  • Fire up OpenCPN, and point it to your chart directory
    • Settings > Charts > Chart Files > Add Directory (remember My Documents is actually something like C:\Users\user-name\Documents\Charts)
    • Click Select Folder
    • Tick boxes "Scan Charts and Update Database" and "Force Full Database Rebuild"
  • Fix up a few of your Chart settings, mine are below, more info here
  • ​Check your new ENC charts into the Chart Downloader to stay current with Chart Updates, more info here
    • Go to Settings > Charts > Chart Downloader
    • Click Add
    • Navigate to the section that you downloaded. For me it is USA > ENC > by States > CA - California
    • You should also hit the Select Folder button and navigate to where you put your ENC charts. Once you hit OK on that window, a list of all your charts should populate in the bottom half of the window.
    • Click Update All, and your charts will update, and continue to update.
that's it!

Setting Options

Options contains user configurable settings.
Read more here:

Options Setting

OpenCPN uses some basic settings or limitations.
  • Courses are by default true, not magnetic. Change this in Options -> Display -> Units.
  • All distances and routes are calculated using Mercator Sailing. Great Circle Sailing is an option in route creating.
  • For Windows: only one instance of OpenCPN is allowed. Use the portable option if more instances are needed.
  • Do not edit the opencpn.ini (opencpn.conf) file when OpenCPN is running.

Marks and Routes

Activate Route & Active Route Console

Marks Routes

Route Triangle Shipwreck MOB Create Route

First right-click on the chart and pick "Drop Mark"

Then right click nearby and select "Undo Create Waypoint"

Or right-click on the Mark and select "Delete"


are the basic points that is used for many things, such as creating routes, marking fishing spots, good anchorages or anything of interest.

Once a mark is created a focused right-click dialog becomes available, when clicking on the mark.

Creating a mark
There are a few ways to directly create marks.
  • Pressing "Ctrl +O" creates a mark at the boats position.
  • "Ctrl + M" creates a mark at the cursor position.
  • Right-click and and press "Drop Mark" creates a mark, at the position of the cursor, when clicking.
  • Marks are created at the start of each leg in a route, and one at the end of the route. More about routes a bit further down this page.
Marks created these ways will have a triangular icon, except for routes that uses a diamond, but no name.

The default icon, when creating a mark, is settable by changing the the value "DefaultWPIcon" in the opencpn.ini(config) file. Use the name of any available icon in the properties dialog.
More Details

In the [Settings/Others] section set the option DefaultWPIcon to one of [empty, airplane, anchorage, anchor, boarding, boundary, bouy1, bouy2, campfire, camping, coral, fishhaven, fishing, fish, floating, food, fuel, greenlite, kelp, light, light1, litevessel, mooring, oilbouy, platform, redgreenlite, redlite, rock1, rock2, sand, scuba, shoal, snag, square, triangle, diamond, circle, wreck1, wreck2, xmblue, xmblue_, xmgreen, xmgreen_, xmred, xmred_, activepoint] values representing the default set of built-in icons or to a filename of any of your UserIcons, without the the path and .xpm extension. If you have a file called MyICON.xpm in the user icons folder, the value will be simply MyICON

You can move the mark by left-click-dragging it around. To prevent accidental movement of marks go to Options>Display>Advanced and click the box "Lock Waypoints".

You can delete a mark by right-clicking its icon, and selecting "Delete".
There is an built in undo/redo buffer for creating, deleting or moving marks or waypoints. If you have just created, deleted or moved a mark the right-click dialog will have relevant entries. The undo/redo, for moving or creating marks, follows a straight time-line and is not tied to an individual mark.

Above is a right-click menu just after moving a mark a few times and undoing the last move, and one mark was deleted, and then the deletion was undone. CTRL + Z and CTRL + Y works as hot-keys for undo/redo.

All marks have properties that can be seen by right-clicking and pressing "Properties", or even simpler just double click the mark.

Read all about the properties dialog in Extended Marks
Marks can be manipulated through the Route & Mark Managers Waypoints tab as well. Deleting a mark that is part of a route, will also change the route. Marks that are a part of a "layer" cannot be changed at all. Marks can also be imported into OpenCPN in a number of ways. Hidden waypoints are not offered as "Use nearby WPT" while creating a route.

Read all about this in the Route & Mark Manager

A general locking of all marks is available. Goto Options -> Display ->Advanced

and tick the box. This feature is handy, to prevent accidentally moving a mark. Activate this feature when underway, deactivate it when planning.

The Man OverBoard mark can be activated through the icon in the toolbar, or through hitting Ctrl + Space-bar. The mark looks like the button and is dropped on own boats present gps position. This mark cannot be moved or deleted with the cursor or keyboard (by mistake), but can still be deleted from the Route/Waypoint manager dialog. More about Man OverBoard here.

All the details of the Mark/WP Properties dialog are dealt with in Extended Marks

Use your own Icons

OpenCPN comes with a handful of different icons that can be assigned to a mark. Right click or use the Route Manager and activate the properties dialog. The Mark Icon window in the dialog shows the available icons.

A user can install his or her own icons to use with marks and "own ship".

1. Create a directory called "UserIcons" in the same place that holds your opencpn.ini(config) file. Instructions to find the directory (folder) location here:OpenCPN Installation

2. Add .png image files to this directory. The legacy .xpm format works as well. The icons can be any size. The name of the file (without the extension) becomes the name of the new waypoint icon. These new icons will appear on the Waypoint Properties dialog, and can be assigned to any waypoint. They can also be assigned in GPX Import files.

3. The User Icons page contains links to a few sets of user contributed icons.

4.To replace the default own ship icon , just put a file "ownship.png" or "ownship.xpm", containing the ownship picture you prefer, in the UserIcons directory, described above.
More about "ownship" icons and setting "ownship" size in Options Setting.

Read about Creating Routes in Create Route

(Duplicate information below.)

Create Route

Press the -button and start the creation of a route. Hotkey "CTRL R" is an alternative way to start a route and "Esc" ends the route. The cursor changes to a ( ) pencil. Left click along the desired route you want to make. This will leave sequential numbered waypoints as you click along, the numbers will not be visible, but are available in the Route Properties Dialog, accessible through the right click menu or the Route Manager. The running total distance of the whole route will be shown along the "pencil" together with the course and distance from the last marked waypoint. When creating routes, OpenCPN will ask if it should use a nearby mark, when a route point is added that is close to an already existing mark. If answering "yes", the existing mark is copied to the route.

For longer distances, specially on east.west courses on higher latitudes, the Create Rout tool seamlessly switches to also offer a great circles alternative, instead of Mercator rhumb-line route legs. Read more Great-circle Sailing.

Holding the cursor over the route brings up a roll-over info. The name of the route, if it is set in the properties dialog, the total length of the route, the course and distance for the leg under the cursor and distance run so far along the route, to the first waypoint in the current leg.
Looking at the four legged route above. The total distance is 8.8 NMi. The third leg is 1.89 NMi i true direction 160° and the accumulated distance in the first two legs is 4.76 NMi.

If your desired route extends off the currently displayed chart, move the route cursor in the desired direction and the display will automatically pan to show the area. You can zoom in and out with the mouse scroll wheel or keyboard +/- keys during route creating. You can also right click and select 'MAX DETAIL HERE' or 'Scale Out' during route creation. When finished right click and choose end route from the context menu, alternatively just press the "Esc" key.
You should now have an inactive (Blue) route. Active routes are Red, inactivated routes are Blue.
Right-clicking on a route brings up a focused menu

To prevent deleting a route by mistake, a confirmation dialog is activated when pressing "Delete..." if the box "Confirm deletion of tracks and routes" is ticked in Options->User Interface.
If a waypoint is deleted, the rightclick menu will have
"Undo Delete Waypoint" in the rightclick menu, with a hotkey Ctrl + Z.

Multiple Routes

In OpenCPN multiple routes can be handled in a couple of different ways.
Many routes can be created in a session or imported into a session.
The visibility of every route is controlled in the Route Manager. There is an "eye" to the far left on the line for each route. This works as a toggle switch. A PLAIN Eye means that the route is visible, while an eye with a red cross, means that it's hidden.
This way only the route(s) of interest for the moment can be shown.

Another way is to create and export routes, and later import them when needed.
To keep the chart clear of useful, but not needed routes follow these steps:
• Create a folder called, 'GPX_Routes', or another suitable name.
• Create your route.
• Use the Route Manager to export the route, with a descriptive file name and save it in GPX_Routes.
• Delete the route from the chart.
• You can export all your routes as one big file or export and delete a route as you create them
• When needed, simply use the Route Managers "Import" Button to open the route file.

To get rid of the way points left on the chart when a route has been imported and then deleted, which may happen depending on the imported gpx file.

1. Open the Route Managers Waypoint tab and press the "Delete All" button
2. Say 'Yes' to: 'Are you sure you want to delete <ALL> waypoints?'

Saving and Loading Routes and Marks

Activating Routes and Active Route Console

Right clicking on the track, changes the color from blue to orange and brings up a comprehensive menu.

Clicking "Activate Route" or performing the same action through the Route Manager, changes the route color to red and new, route information window or "Active Route Console Window" appears on the upper right side of the display. This console displays data particular to the active leg (XTE, Bearing, VMG, RNG & TTG). Once a route is activated, you are presented with the choice of "Deactivate Route" in the different menus.

There is one unique item in the route focused right-click menu above.

Zero XTE Sets the present XTE (Cross Track Error) to zero. This comes in handy if you for some reason if off course following a route and want the autopilot to follow the route, but adjusted for your current position rather than the position of the last route waypoint.

Right clicking on a waypoint in a route brings up a few options, otherwise not available.
  • Properties. The dialog is the same as for an individual mark.
  • Activate - Gives the direction to the chosen waypoint instead of the first waypoint in the route, which is the default. Useful when joining, for example, an imported route, at an arbitrary waypoint.
  • Remove from Route, but don't delete it.
  • Copy as kml, for use with Qtvlm or Google Earth.
  • Delete Waypoint from Route.
  • Send to GPS is seen in the rightclick menus for routes and waypoints. If a port is not selected, the case in the picture above, a dialog is shown to select an output port. To change the selected port, go to the route manager and select "Send to GPS".
  • Ctrl + N, a shortcut that activates the next waypoint in an active route.

Active Route Console Window - Showing Active Leg Data

Appears in the upper right corner of the screen when a route is set to Active.
To change the Font Sizes go to Options > User Interface > Fonts and pick "Console Legend" and "Console Value".

XTE Cross Track Error. How far off course your boat is. "L"=left, "R"=right

BRG Direction to next waypoint.

VMG Velocity made good to next waypoint

RNG Distance to next waypoint.

TTG Time To Go to next waypoint.

Right clicking on "This Leg" above brings up this dialog

Show just the current leg or the entire route. Show or hide the highway.

Route to Autopilot

For sending a Route to an Autopilot several settings and conditions must be met.

Read more in "Sending an Active Route to the Autopilot" in Options > Data Connections (at the bottom) for more information about connections and testing. Note that a Connections Output Port must be configured to send ECRMB, ECRMC and ECAPB NMEA sentences to the Auto Pilot.

Also read about "Route to Autopilot" in Advanced Features for more details.

Under Options Settings > Own Ship see :
Advance route waypoint on arrival only
Waypoint Advance (normal default)

Go to Table Of Contents

Help Fix Bugs!

If you experience a crash in OpenCPN, the developers are very keen on knowing why. This is how you can help making OpenCPN, even better.


In OpenCPN ver 4.0 the semi-automatic Crash reporting for Windows is disabled by default.
Crash Reports are saved in the OpenCPN config directory, i.e. where the log file is stored now. End users may occasionally be asked privately to send these reports to a designated recipient.

The semi-automatic Crash reporting can be enabled by editing the opencpn.ini file.
Here is what you will see if OpenCPN causes a crash with the crashreport enabled.

Provide additional information, such as your email or forum name, so the developers can contact you for more info, if necessary.

This is what the report will contain. Use the "Export" button if yoy don't have an Internet connection at the time of the crash. Mail the report later.

Also, for fun, you may test this option by the keystroke Alt-F12. This will induce a benign crash, and give you a chance to see what it will look like before the real thing happens.
Please don't send this kind of report by pressing "Send report". Just press "Close the program" when you are done. Restart OpenCPN!
This feature is temporary and will not be available in the Beta Release following 3.3.814.


In Linux there is an excellent tool, "ddd", the Data Display Debugger, to help the developers pinpoint where an error, or bug, is located in the source code. "ddd" is a graphical front-end to the text based "gdb", the GNU debugger.

Install ddd through Synaptic, Ubuntu Software Center or similar for other Linux distributions.
From a command line, in a Debian based Linux, such as Ubuntu, issue this command:
$sudo apt-get install ddd
  • The "$" sign above, just marks that this is a command line for a normal user. Do not include it in the actual command. This is a Linux convention used everywhere.

Start ddd

To start ddd, find a command-line and
$ddd opencpn

ddd starts and this is what you will see.

Click "Run". If you don't get this small dialog, go to Program -> Run, or hit F2
This will start OpenCPN. Just continue in OpenCPN and proceed to create a crash.
Then go back to the ddd window.
This is how it will look like after a crash.

Notice "Program received signal SIGSEGV, Segmentation fault."
This is programmers way of saying a "crash". Exactly what this means, does not matter for a normal user. Interested anyway? Read more,
To actually help the developers we need a back trace from the crash. This is the path that the program followed in the source code, leading to the crash.

Go to Status -> Backtrace.
This is what comes up, from this particular crash.

The crash happened at #0 and this very short back trace started at #9.
Your job now is to take a screen-dump, similar to the picture above, and send it on.
Try to get as much of the back trace as possible, by expanding the Back trace dialog.
This is important, so the developers can see the trouble point in the source code.
Look at #3 above, ending in "....chart1.cpp:2367". "chart1.cpp" is a part of the OpenCPN source code, and something on line 2367 was involved, directly or indirectly in the crash.
Lines ending in "......... .so.0" are external libraries used to run OpenCPN.

On the odd occasion, when the back trace is very long, the developers may still complain that they need to see more.

Using gdb

Gdb, the command line debugger, is the answer.
Start like this
$gdb opencpn
Gdb starts and you get the gdb command prompt (gdb).
Just type "r", for run and hit Enter. Like this:
(gdb) r

OpenCPN will now start, once again, make it crash.
The console will look similar to below.

All the lines before the "Segmentation fault" line, are just "chatter" from PortAudio and Gdk, and are not directly related to OpenCPN.

To get a back trace, simply
That is type "bt", for back trace, and hit enter.

You will now have access to the full back trace, with more details and reverse order to "ddd".
Copy the text, and send it on.
Press "q" to exit gdb.

Send it on to the Programmers
Tell the programmers about your findings through an entry in the tracker , or through posting on the forum , if you have found a new bug.

Go to Table Of Contents


The Toolbar is floating and can be placed anywhere on the screen, vertical or horizontal.
Note the "grabber" symbol at the far right side of the toolbar. Use this handle to drag the toolbar wherever you want it. The default position is horizontal and docked top left. It "snaps" to the edges. Right click on the grabbe and a cross will appear. Left click on the cross and the toolbar shifts its oreintation, to vertical or horizontal format. Right click on the cross to return to the "grabber". On Windows (at least), unless in OpenGL display mode, the toolbar dims down transparently until you roll over it.

There are three different styles of Toolbars to choose from. Go to the ToolBox->"User interface"-> "Toolbar and Window Style" and select one of the following styles:



Journeyman Flat

There are a lot of buttons available in the standard Toolbar, even more, counting the many plugins. To control exactly which buttons to display, hold the cursor over any button and right-click. This dialog pops up.

Only the buttons with a ticked box will be displayed. The available shortcuts are also shown in parenthesis to the right of the button description.
The MOB button is special. If unticked, you will get these choices:

#1: The MOB button will still be there, but anyone (crew?) may later hide it.

#2: If OpenCPN is used to handle a MOB situation, choose this option. The MOB button will always be there. It is not possible to change the state as long as OpenCPN is running. The MOB button option will not even appear in the right-click menu.
To reset this option open the opencpn.ini(config) file and change the value below from
"1" to "0". Restart and all the options are once again available.

#3: Use this option if a MOB situation is handled by other means, and OpenCPN is not a part of the standard operational MOB procedure.

If the MOB button is visible, it will always be the button furthest to the right. This way it's always easy to find in bad light etc.

The visibility of the plugin buttons is controlled in the ToolBox->Plugins Tab, by pressing the Enable/Disable toggle button.

Note that the Toolbar must have at least one active button.

When a toggle button is pressed, it changes and becomes darker, Traditional style also adds a stronger outer frame. For example, tracking off , tracking on .

A brief explanation of the use of each button is available by just hovering with the cursor

over a button.

Traditional Style (from left to right) :
(For translation to other styles, check the buttons just below the Traditional in the above pictures.)

Zoom In (Zooming)

Zoom Out (Zooming)

Scale Next Chart Down (Scaling Charts) 1

Scale Next Chart Up (Scaling Charts) 1
Create Route (Create Route)

Find/Follow Boat. Toggles on/off.(Auto Follow and Display Orientation)

Launch Toolbox(Options Setting )

Show/Hide Text Labels on Vector Chart.(Vector Display)

Show/Hide AIS Targets 2 (AIS)

Show/Hide Currents On Chart (Tides and Currents)

Show/Hide Tides On Chart (Tides and Currents)

Print. Prints your current view, using a simple dialog.

Route/Track/Waypoints/Layer- Manager.(Route & Mark Manager)

Toggle Track On/Off (Ship Track)

About OpenCPN and Help File (Getting Started)

Adjust Screen Brightness for Dawn/Dusk and Night viewing.(Night Navigation)

Show/Hide the Dashboard Plugin (Dashboard )

Show/Hide the Grib Overlay Plugin (Grib Weather)

WMM Magnetic (WMM)

Drop Man Over Board marker(Man OverBoard) Always the far right Button.

More Buttons may be present if certain Plugins are activated. See the Documentation for Install and Enable Plugins

A separate GPS status and Chart Orientation Status is normally in the upper right corner of the display, unless the floating ToolBar covers this position. Then the "Staus-bar" will be moved to the lower left corner, were it will stay, unless the main ToolBar iis moved to cover this position, in which case the "Status Bar" goes back to the default position.

Course Up/North Up 2( Display Orientation)

GPS status 2 (GPS Status)

Note 1: These icons are "grayed out" when only CM93 vector-charts are available, as the feature makes no sense.
Note 2: These icons changes, depending on status.

Go to Table Of Contents


It is essential to understand what happens when both zooming in and zooming out in a chart view. Vector charts have their own issues, with both over- and under- zooming. Both can be potentially dangerous, and it's essential to understand what's going on.

How too Zoom in/out

Zooming in makes the chart scale larger while zooming out makes the scale smaller

These buttons allow you to zoom in and out on the chart currently being displayed.

Will zoom the chart in for more detail, larger scale.

Will zoom the chart view out for more area, smaller scale.

Alternatively, the + and - keys on your keyboard will zoom in and out. If you have a mouse with a scroll wheel, it can also be used to quickly zoom in and out.

Other alternatives for zooming includes:

  • Page Up for zooming in.
  • Page Down for zooming
  • Menu Bar->Navigate click Zoom In / Zoom Out
For zooming in smaller steps try
  • Alt + for fine scale zooming in.
  • Alt - for fine scale zooming out.
  • Alt + scroll wheel, zooming in/out in small steps.

Some settings for zooming are available in the Options -> Display->General tab. Read more about "Smooth Panning/Zooming" and "Zoom to Cursor" in Options Setting.

Note that

  • Keyboard, Menubar, and Toolbar zooms always zoom to the center of the screen.
  • Wheel zoom behaviour changes depending on "Zoom To Cursor" and "SmoothZoom" settings.


Overzooming a raster chart.

Overzooming a vector chart.

If you zoom in enough there will appear a warning "OverZoom" in the upper left part of the chart area.
This means that you have zoomed in way to far, and is using the chart at a scale that was never intended, and that is not supported by the original survey. No new information will be seen, and the situation is potentially dangerous as it could give the impression of increased distance between dangers.
On a raster-chart pixelation will be seen, but on a vector chart it is not so obvious when you have over zoomed. This is where the warning is useful.
Your first action when the warning appears should be to zoom out at least one snap.
Charts are generally based on surveys in twice the scale of the released chart, so when zooming in beyond a factor of 2, there is no support, increased details etc, in the underlying survey. OpenCPN warns for "OverZoom" when zooming with a factor of 4 or more.

Overzooming settings are explained in Options Setting . In short OpenCPN, by default, blurs vector-charts and expands the text an lines, to imitate what happens with raster charts, when zooming in beyond a factor 10.0 x .

Unlimited zooming is available using the background Map. Just create an empty chartgroup and switch to this map at any time. More in Chart Groups Tab.


Underzooming is only a general problem with CM93 V2, in OpenCPN. The reason is the very poor graphical representation in small scale charts, of reefs, small islands and other dangers.
The case with the Cargados Carajos Shoals in Indian Ocean is well known since Team Vestas grounding in the 2014/2015 Volvo Ocean Race.

This is what you see. All pictures are in a scale of approximately 1:650.000.
The "normal view. No indication at all of islands or reefs, even though the name in it self indicates, to a seasoned navigator, that more information should be sought elsewhere.
Look upon a blue area as a warning sign. Zoom in to see if more deatails are available.
If no more details show up, even using a large scale view, it indicates that the CM93 coverage is poor in the area. Once again, use alternative sources.

Switching to single mode view, and with chart outlines active, OpenCPN shows that a larger scale chart is available. This will show on zooming in further. The available chart does not cover the southern end of the reef where Vestas ran aground. In some editions of CM93 more charts of the area are available, including the southern part.

Compare this to the well thought out representation in the raster chart INT 702 in scale 1:3.500.000.

Using CM93 in OpenCPN

It all starts with passage planning. The bottom line is: Don't trust CM93. Always check with other reliable sources, meaning, for example, Raster charts (paper charts) Pilot Books, or ENC charts, not another privately issued vector chart, with similar problems ( for example Navionics).

Doing the best you can with OpenCPN and only CM93 available.
For passages including small scale CM93 charts (A or Z scale):
Create a route that you plan to follow.
Switch to Single chart mode. Short Key "Q".
Avtivate chart outlines.Short Key "O".
"Fly" along the route, making sure you are zoomed in to a factor of at least 2.5 x.
Available charts should now be outlined in magenta.
Drop suitable marks documenting these charts, and the dangers they represent, for later reference.

Nigel Calder "How to read a Nautical Chart, Second ed. 2012", is recommended to all users who want to know more about charts, the surveys they are based on, and their horizontal and vertical accuracy.

Go to Table Of Contents

Scaling Charts

These buttons will allow you to change the scale of chart you are using, unless only CM93 charts are loaded, in which case these buttons has no effect, and are grayed out. If just a yellow bar is visible in the Chart Selection Bar, above the Status Bar, then CM93 is the only available chart for the area.

Shift to larger scale chart. Will change to next chart of greater detail, covering less area, if available, within the current view.

Shift to smaller scale chart. Will change to the next chart of less detail, covering a greater area, if available, within the current view.

Chart Bar Buttons

The charts in the Chart Bar just above the Status Bar (The User Interface) are ordered according to scale. The leftmost chart, is the largest scale chart available, and the rightmost chart is the smallest scale chart.

Above the largest scale chart is a raster chart ( blue ) on the far left. To the far right is CM93 ( Yellow), and it will always be there, if available. The green ENC vector chart, next to CM93, is the smallest scale raster/ENC chart available at the center of the display.

The scale of the displayed chart.

The chart display indicates the true scale of a particular chart at the present zoom level. Look to the far right on the bar above: "TrueScale 22600 Zoom 0.73x.
There is also an always present quick reference visual indicator in the SW part of the display.

When the indicator is gray and orange the total length is 1 nautical mile an each segment is 1 cable.
When the indicator is gray and black the total length is 10 miles and each segment is 2 miles.

Go to Table Of Contents

Create Route

Press the -button and start the creation of a route. Hotkey "CTRL R" is an alternative way to start a route and "Esc" ends the route. The cursor changes to a ( ) pencil. Left click along the desired route you want to make. This will leave sequential numbered waypoints as you click along, the numbers will not be visible, but are available in the Route Properties Dialog, accessible through the right click menu or the Route Manager. The running total distance of the whole route will be shown along the "pencil" together with the course and distance from the last marked waypoint. When creating routes, OpenCPN will ask if it should use a nearby mark, when a route point is added that is close to an already existing mark. If answering "yes", the existing mark is copied to the route.

For longer distances, specially on east.west courses on higher latitudes, the Create Rout tool seamlessly switches to also offer a great circles alternative, instead of Mercator rhumb-line route legs. Read more Great-circle Sailing.

Holding the cursor over the route brings up a roll-over info. The name of the route, if it is set in the properties dialog, the total length of the route, the course and distance for the leg under the cursor and distance run so far along the route, to the first waypoint in the current leg.
Looking at the four legged route above. The total distance is 8.8 NMi. The third leg is 1.89 NMi i true direction 160° and the accumulated distance in the first two legs is 4.76 NMi.

If your desired route extends off the currently displayed chart, move the route cursor in the desired direction and the display will automatically pan to show the area. You can zoom in and out with the mouse scroll wheel or keyboard +/- keys during route creating. You can also right click and select 'MAX DETAIL HERE' or 'Scale Out' during route creation. When finished right click and choose end route from the context menu, alternatively just press the "Esc" key.
You should now have an inactive (Blue) route. Active routes are Red, inactivated routes are Blue.
Right-clicking on a route brings up a focused menu

To prevent deleting a route by mistake, a confirmation dialog is activated when pressing "Delete..." if the box "Confirm deletion of tracks and routes" is ticked in Options->User Interface.
If a waypoint is deleted, the rightclick menu will have
"Undo Delete Waypoint" in the rightclick menu, with a hotkey Ctrl + Z.

Multiple Routes

In OpenCPN multiple routes can be handled in a couple of different ways.
Many routes can be created in a session or imported into a session.
The visibility of every route is controlled in the Route Manager. There is an "eye" to the far left on the line for each route. This works as a toggle switch. A PLAIN Eye means that the route is visible, while an eye with a red cross, means that it's hidden.
This way only the route(s) of interest for the moment can be shown.

Another way is to create and export routes, and later import them when needed.
To keep the chart clear of useful, but not needed routes follow these steps:
• Create a folder called, 'GPX_Routes', or another suitable name.
• Create your route.
• Use the Route Manager to export the route, with a descriptive file name and save it in GPX_Routes.
• Delete the route from the chart.
• You can export all your routes as one big file or export and delete a route as you create them
• When needed, simply use the Route Managers "Import" Button to open the route file.

To get rid of the way points left on the chart when a route has been imported and then deleted, which may happen depending on the imported gpx file.

1. Open the Route Managers Waypoint tab and press the "Delete All" button
2. Say 'Yes' to: 'Are you sure you want to delete <ALL> waypoints?'

Saving and Loading Routes and Marks

Activating and using routes

Right clicking on the track, changes the color from blue to orange and brings up a comprehensive menu.

Clicking "Activate Route" or performing the same action through the Route Manager, changes the route color to red and new, route information window appears on the right side of the display. Once a route is activated, you are presented with the choice of "Deactivate Route" in the different menus.

There is one unique item in the route focused right-click menu above.

Zero XTE Sets the present XTE (Cross Track Error) to zero. This comes in handy if you for some reason if off course following a route and want the autopilot to follow the route, but adjusted for your current position rather than the position of the last route waypoint.

Right clicking on a waypoint in a route brings up a few options, otherwise not available.
  • Properties. The dialog is the same as for an individual mark.
  • Activate - Gives the direction to the chosen waypoint instead of the first waypoint in the route, which is the default. Useful when joining, for example, an imported route, at an arbitrary waypoint.
  • Remove from Route, but don't delete it.
  • Copy as kml, for use with Qtvlm or Google Earth.
  • Delete Waypoint from Route.
  • Send to GPS is seen in the rightclick menus for routes and waypoints. If a port is not selected, the case in the picture above, a dialog is shown to select an output port. To change the selected port, go to the route manager and select "Send to GPS".
  • Ctrl + N, a shortcut that activates the next waypoint in an active route.

XTE Cross Track Error. How far off course your boat is. "L"=left, "R"=right

BRG Direction to next waypoint.

VMG Velocity made good to next waypoint

RNG Distance to next waypoint.

TTG Time To Go to next waypoint.

Right clicking on "This Leg" above brings up this dialog

Show just the current leg or the entire route. Show or hide the highway.

Auto Follow

Clicking the Auto Follow button will center the chart directly on your vessel's current location. This is a toggle button that is slightly larger and greyer when on. If the the gps is working own ship is red otherwise the icon is gray. . It's also possible that a yellow own ship icon will appear. Read more: GPS Setup and Status. Read If zoomed out to a scal that is smaller than 1:300.000 the icons changes to , when receiving gps signals and otherwise. More about he OwnShip icon is available in Marks and Routes
  • The default own ship icon can be replaced by putting a file "ownship.png" in the User icons shared data directory. More about this shared directory here: Marks and Routes
  • The Auto Follow button useful for two different situations:
  1. When you have panned the map away from your current location and want to quickly move back to your vessel.
  2. When underway, this will keep the display on the chart around your vessel, with the boat at the center of the chart.
  • Panning the chart will disable Auto Follow mode. Simply click again to turn Auto Follow mode back on. Zooming in/out with the scrollwheel is OK as no panning takes place unless Options->Display->"Zoom-to Cursor" is ticked.
  • If the option "Show skewed raster charts as North-up" in the Options->Display->Advanced tab, is not ticked, the right-click toggle option "Course Up Mode/North Up Mode" will be replaced by "Course Up Mode /Chart Up Mode", for skewed charts.
  • If an electronic compass is available in the NMEA stream the own ship icon will be orientated according to this heading. The difference can be seen on the chart if there is a cross current, for example. The boat below is heading WNW but is being set SW. An AIS CPA, Closest Point of Approach is also visible.

Options Setting

The Display

The Chart
Chart Files
Vector Charts Display

Chart Groups
Tides & Currents

The Connections

The Ships
Own Ship
AIS Targets
MMSI Properties

The User Interface

The Plugins

Click the icon to open the Options Dialog which has 6 tabs, as seen below.
All Settings that are not context sensitive, are set in Options.
The Settings are persistent, meaning that settings entered in one session will still be there on restart.

The Display


Navigation Mode
North Up /Course Up. North Up is the of course the normal way charts are shown. Course Up makes the whole chart turn so what you see in front of the boat in real life, is above the own ship icon on the display.
Lookahead Mode: The Own Ship icon will be offset from the center of the screen so that more of the chart are in front of Own Ship than behind. More in Auto Follow and Display Orientation

Chart Display
Enable Chart Quilting: The screen shows several charts seamlessly stitched together. More in Chart Quilting.

Preserve scale when switching charts: Normally when switching charts OpenCPN will open the new chart scaled close to it's natural scale, the zoom factor stays the same. With this box ticked OpenCPN will keep the scale from the last chart, when switching, not exactly, but generally of the same magnitude. The zoom-factor will increase as you switches to smaller scale charts.

Smooth Panning/Zooming: This works best together with OpenGL. Test to see how it works with your graphic card. If you are using OpenGL, tick this box as well.

Zoom to Cursor: Normally when clicking on the screen, the display centers on the clicked point. The wheel zooms in/out always using the center of the display. With this box ticked, the zooming happens at the point of the cursor. This means that as soon as you start to zoom in the cursor stays in the same place on the screen and on approximately the same geographical position. The advantage is that the zooming in position can be fine tuned just using the cursor.
The "Zoom in" and "Zoom Out" buttons, as well as the short cuts "+" and "-", will still use the center of the display for zooming, even when "Zoom to Cursor" is on.

Zoom to Cursor Summary:
  1. Keyboard, Menubar, and Toolbar zooms always zoom to center screen. Always.
  2. Wheel zoom behaviour changes depending on ZTC (Zoom to Cursor) and SmoothZoom settings.
  3. ZTC (Zoom to Cursor) applies only to wheel zooms.
Display Features
Show Grid: Activate a latitude and longitude layer on the display. This feature only works if the display is in North Up mode. The grid is handy on vector charts, that normally lacks this feature.

Show Chart Outlines: The borders of the available charts are shown. Vector charts are green, raster charts are red, and on CM93 available larger scale charts are purple. The CM93 chart outlines are not shown if using quilting mode. As a safety precaution, the outlines of isolated dangers with large scale charts available, are shown in CM93 even if "Show Chart Outlines" is off, provided that quilting is not used and the scale is large enough. At a scale of 1:200.000 or larger these isolated Islands and dangers will be shown. Hence it is recommended not to use quilting with CM93 when on a longer offshore passage. More on Installing Chart Files Tab

Show Depth Units: Shows the charts depth units on the screen in embossed letters in the upper right corner. When in quilt mode, depth units are only shown if all charts in the quilt has the same depth unit.


Choose the units that suits your way of navigating. These settings apply to everything in the core program. The exception is Radar rings, where the units for distance between rings is selected separately.
Plugins have their own settings for units.

Distance. The options are: Nautical Miles, Statue miles, Kilometers and Meters.
Short distances, less than 0.1 Nautical Mile or Kilometer are always shown in meters. Short distances less than 0.1 Statue Miles are shown in feet.
Speed. The options are: Knots, Mph, km/h, and m/s.
Depth. The options are: Feet, Meters and Fathoms.
Lat/Long. The options are: Degrees + Decimal Minutes, Decimal Degrees and the traditional Degrees + Minutes + Seconds

Show Magnetic bearings and headings
: OpenCPN by default uses true courses and bearings etc. This box is for navigators who prefers to work with magnetic courses and bearings, or want to test this method. Note that OpenCPN knows nothing about deviation.
All courses and bearings will have a (M) post-fix, to show that they are magnetic.

The following settings will be affected: Bearings and Courses in the Route Properties dialog, route leg rollovers, and Active Route console will be (M). COG displayed on the bottom status line will be COG(M). AIS target reports will show target COG(M).
Variation will be calculated at Own Ships position, if possible. AIS targets however, will use the targets position for variation, if possible.

How does OpenCPN know about the variation?
  1. If a GPS receiver that reports variation as part of RMC sentence, is available, this value will be used.
  2. Otherwise, if the WMM plugin is installed and activated, it will supply the variation.
  3. Lacking the above alternatives, the manually entered "Assumed Magnetic variation", will be used for all calculations. See below.
Assumed Magnetic variation.
This value will be used if variation is not available through the GPS or the WMM plugin.
The default value is 0°. As usual, positive values are also called "easterly variation" , and negative values are also described as "westerly variation".


Chart Display
Show skewed raster charts as North-up: Skewed chart are normally shown as intended by the cartographer, "Chart up". With this option they are rotated to show North-Up. If you are looking for speed, don't tick this box. I slows down the screen rendering . Skewed charts are a common along the US Inter-coastal Waterway. More here: Auto Follow and Display Orientation

Disable Full Screen Quilting: By default all visible charts of an appropriate scale are used in the quilt. With this box checked only charts that overlap the center of the screen are used in the quilt. Checking this box is easier on the system and may give a performance boost in certain circumstances.

OpenCPN and over-zooming
It is very common that charts are based on surveys that are twice the scale of the charts natural scale. For example a chart in 1:50.000 would be based in a survey in 1:25.000.
Once a vector chart is zoomed in to a factor 2, no more details can be found. OpenCPN makes the navigator aware of this fact in a few different ways.

This screen-shot shows an example how over-zooming warning is treated.
Overzoom Warning (default)
At a zoom factor of 4 the embossed OverZoom warnings will be displayed in the NW part of the screen. From a factor 10 to 30 a blur or gentle bluish fog will be overlaid on the chart. This applies to vector charts and raster charts using the Mercator projection.
Overzoom blur/fog effect (default)
Overzoom blurring is performed only for those systems with modern and fully capable OpenGL drivers/cards. Otherwise, a very gentle "fog" is applied to extreme overzoom displays, as a visual que to the user that the chart is highly overzoomed.
From a factor 10, lines and depth numbers on vector charts will be scaled and appear bigger, to further indicate the imprecision of chart feature geographical location at high over-zoom. This imitates what happens with a raster chart, when the individual pixels gets bigger and bigger.

Options - Make sure you understand all the implications of the following two options, before activating them.
Suppress blur/fog effects on overzoom
The blurring or bluish fog, will be turned off.
Suppress scaled vector charts on over-zoom
The scaling of lines and number will be turned off. Applies to vector charts only.

Note that the blurring effect and scaled vector charts does not aply to single chart mode, so an alternative to this option is to toggle the "Q" hotkey.

Below is how it looks like with both the above options activated.

Course-Up Mode Display Update Period: This relates to how often the entire displayed chart is updated. The own-ship and AIS icons are still updated every second. The default value is 15 seconds. A "zero" value is allowed! The default mode is North-up. It's easy to switch between the two modes through the right-click menu.

Chart Zoom/Scale Weighting
This option has a short description, on screen. Here are some further notes.
The slider applies to zoom operation dynamics, not to static chart selection.
The option really asks you this question.
"On zooming in, when do we switch to a smaller scale chart if available?"
Your answer may depend on your screen resolution and other preferences.
The slider affects zoom-in operations most directly.
-5...delay switching to smaller scale to improve performance and visibility.
0....As OCPN always was, default
+5...Switch sooner to a smaller scale chart, if you want more detail.

It was not intended that a user exercise this control very often. Maybe experiment, set it to your liking for average charts in your area, and leave it set.

Lock Waypoints. Unless a waypoint property dialog is visible. Locks waypoints, and prevents accidental moving of them. This box should normally be ticked when under way.

Confirm deletion of tracks and routes. A safeguard against deleting important data by mistake.

Physical Screen Width
This is the default were OpenCPN will use the size that the operating system reports. Unfortunately this is not always correct, leading to an incorrect scale on screen for the charts.
The OpenCPN log will state what your operating system thinks about your screen size.
19:03:44 CET: Detected display size: 338 mm

If the value in the logfile is differs from your screens real width, activate this option.
To calibrate your screen, measure and enter the width of your screen.
The value shown is just from a sample 17" screen.

Use Accelerated Graphics (OpenGL) The net effect of full OpenGL optimization on raster charts with compatible hardware is nothing short of amazing, especially with low-spec, low-power systems. Unfortunately the support for OpenGL on Windows is sometimes problematic. Intel's OpenGL graphics drivers on Windows are very buggy, for example.
Read more on the OpenGL page!
If you have started OpenCPN without OpenGL support, this option will be greyed out.

The standard Option dialog looks like this

An expert version is available by adding a line to the opencpn.ini (opencpn.conf) file.
To turn the expert version off, change the value from "1" to "0", or delete the line.

Use Accelerated Panning works if your graphics card supports Frame Buffer Objects.
Texture Compression greatly improves the speed of raster chart display. It works by treating raster charts as compressed textures instead of bitmaps, and these textures are loaded and displayed much more efficiently by the graphics hardware. They also consume much less GPU memory space.
Texture Compression with Caching A further improvement to raster chart display loading and panning. This option uses the system hard drive to store pre-calculated raster chart compressed images in a way that is optimized for direct loading into the graphics card. When enabled, the texture cache is created dynamically, as charts are visited in normal navigation. Depending on the OpenGL hardware capabilities, there may be some slight, but noticeable, delay as a chart is accessed the very first time while the textures are created, compressed, and written to disk. Once a particular chart section has been cached, subsequent accesses are very fast. If the OpenGL hardware texture buffer is capable, then rendering on-screen is virtually instantaneous.
* The cache understands color scheme changes. Cache entries are automatically created for each of the 4 possible BSB color schemes, as they are encountered in normal operation.
* The cache understands chart Edition Dates. So, if one manually updates a chart (thus changing the chart's Edition
Date), the old cache contents will be discarded, and a new cache will be built automatically as the new chart(s) are visited.
* Using compressed texture caching retains all the benefits described earlier. It is very much faster on low spec hardware, at the expense of more disk space usage.
* There is a command line option which will build/update your compressed texture cache. You may execute opencpn like this: opencpn /rebuild_gl_raster_cache (-rebuild_gl_raster_cache on linux)
  • * "Texture Compression" and "Texture compression caching" may actually slow down some machines, depending on the capabilities of the video system.
  • If you are using OpenGL on a low-spec machine, you will have better performance if you
    a) disable texture caching, or
    b) Pre-build the texture cache in a region of interest. That is, move the boat to say Dover. Then do Options->openGLOptions->Build Texture Cache. You do not need to wait the entire time, which may be hours for a large chart set. "Skip" out when the distance reported is 100 miles or so.
    Eventually, after steady use, your texture cache will be filled automatically in the background, and performance Show FPSwill increase steadily.
The Size of the current "Texture Cache" appears just to the right of the button "Clear Texture Cache". In the picture above this value is 101.8 MB.

  • Show FPS FPS stands for Frames Per Second, and is one way measure OpenGL performance. The number appears in the lower right hand corner of the display, to the right of "Scale". Above you see "26 fps". If you report a graphical problem, expect the devolopers to ask you about this figure.
  • Enable Transparent Toolbar. This option is greyd out in OpenGL mode, as the feature only works in traditional mode. On Linux it is necessary to activate a window manager compositing system, such as Compiz or GNOME Shell, to have a transparent toolbar.

The Chart

Chart Files

Add Directory In OpenCPN charts are added by adding the directory (folder) that contains the chart files. This tab is where charts are added and removed, read about the details in Installing Chart Files Tab

Remove Selected Mark the chart directories that are no longer needed, press the button an then "Apply" or "OK" .

Scan Charts and Update Database Use this option if you have made any changes to the contents of your chart directories, as for example after downloading new charts from NOAA, etc. It need not be checked if directories are added or subtracted, as the entire database will be scanned and updated automatically in this case.

Force Full Database Rebuild is mainly aimed at users converting or correcting existing charts, in a situation where changes are made to the geo-referencing, outline of the chart, or other attributes in the kap file header section.

Vector Charts Display

Read more about Vector Display Tab

Chart Groups

Read more about Chart Groups Tab !

Tides & Currents

Read more about Tides and Currents!

The Connections

For a full explanation of this tab read Connections.

The Ships

Own Ship

Display Options
COG Predictor Length (min): Shows a red dashed line in front of your own boat, with present COG and ends in a small square, which represents where you will be in the set number of minutes, with the present speed. 6 minutes is a good starting value for piloting. If your vessel has a SOG of 10 knots the dashed line will be 1 nautical mile long. 60 minutes makes sense on a coastal passage and 24 x 60 = 1440 minutes on longer blue water passages.
Heading Predictor Length
If a heading sensor is available and outputs an nmea data stream, this is shown as a finer line with shorter dashes ending in an open small circle. The length is set in Nautical miles.

The width of the COG Predictor can be adjusted in the opencpn.ini configuration file. Find the line below and adjust the value.
Warning: Don't edit to the opencpn.ini (opencpn.conf) file when OpenCPN is running.

Ship Icon Type: The following options are available for ownship

Default: This will use the icon that comes with OpenCPN, unless you have installed
your own icon, "ownship.png". More about installing your own icons in Marks and Routes .
Real Scale Bitmap: This option will adjust the size of the default icon, depending on your settings. When using this setting, the dialog expands and five more options related to the size of "ownship" becomes available. See picture below

Length Over All (m)
Width Over All (m)
GPS Offset from Bow (m)

These settings needs no further explanation as their names are clear.
GPS Offset from Midship (m): Use a positive value for an offset to Starboard and a negative value for an offset to Port.
Minimum Screen Size(mm): The size of the ownship icon on the screen. Default is set to 1mm.

Real Scale Vector, works the same as the previous option with the exception that ownship is a somewhat boxy, computer rendered ship. It's currently not possible to change the vector-own-ship.

The dot represents the set location of the GPS.

Show radar rings: These show up as red rings centered on your gps position, and can be useful in different circumstances, such as keeping clear of dangers. The settings are, hopefully, intuitive.

Once the number of radar rings are selected, and not equal to "None" the dialog expands, and shows more settings. The Distance Unit for Radar rings is set here, and does not follow the the global settings in Options->Display->Units. The choices are Nautical Miles and Kilometers

Automatic Daily Tracks.
Automatic Daily Tracking ensures that the track-points collected throughout a single day (midnight to midnight in local zone time) are stored and managed as a single (possibly multi-segment) track.
If the Automatic Daily Tracking check-box is selected, the "Toggle Tracking" tool will - as before - turn tracking on and off. However, on turning it off, the accumulated track will be extended with the previous one, if it does not extend into yesterday. Disjoint segments are kept separate, time-adjacent segments are merged into a single segment.
Disjointed track segments, can be joined through the right-click menu, when they are selected in the Route Managers Tracks Tab.
Every Midnight the tracking is turned off and on again automatically, to ensure that the track does not span dates.
If Automatic Daily Tracking is selected during the day, when some tracks have already been created, only the last one will be merged with future daily tracks.
Assuming Automatic Daily Tracking is on, normally during tracking periods there will be two tracks visible in the Route Manager: the current track (red color track-points on the chart) and the previously accumulated track for the day. After toggling tracking off there will be just one track for this day.
If the timezone needs to be changed, it is a good idea to close OpenCPN application before..
With the manual capability of splitting and extending, the daily tracks can be easily managed at any time.
The daily tracks will be automatically named with the date in the local Time Zone, but can of course be changed manually.
The Automatic Daily Tracks follows the settings in Tracking Precision, see below.
Without Automatic Daily Tracks selected, OpenCPN handles tracks as before.

Highlight Tracks shows a 7 to 10m wide highlighting, either side of the track. This is not selectable for individual tracks. The idea of the highlighting is to remind us that following a previous track exposes us to the inherent inaccuracy of GPS, and that the real track followed is most likely within the highlight region, but not necessarily in the middle. And this says nothing about the accuracy of the underlying cartography. For many charts it is prudent to assume at least 1.5 mm inaccuracy using the nominal scale of the chart. For a chart in scale 1:20,000 this translates to 30m.

Tracking Precision

With track button in the ToolBar activated this setting affects the size of the data saved. It also affects the "smoothness" of the track, though this is only visible when zoomed in to a very large scale.
OpenCPN uses smart dynamic tracking, and only uses those track points that actually contributes anything to the track. A straight line track for example is only represented by it's endpoints. This is done by analyzing the track just behind the boat. The process is visible in real time, close to "ownship". The end result is good track accuracy while keeping the size small.
Low: Good for offshore passages.
Medium: Very good for all normal uses.
High: Only necessary when very tight maneuvering needs documenting.

Waypoint Arrival Circle Radius, gives an answer to this question.
When following a Route, with the autopilot engaged, at what distance from the upcoming waypoint should OpenCPN tell the autopilot to change to the next waypoint?
The default is 0.05 nautical miles. This is equal to about 93 meters or 300 feet.
The default setting does not fit all circumstances. A number of factors are involved, for example, the type of navigation, the waypoint selected, own ships turning radii and speed. Find what setting(s) suits your boat by testing.

The arrival radius can also be set individually for each waypoint in the Waypoint Properties dialog.

Advance route waypoint on arrival only.
Routes are explained in +. With an active route, the Dialog "This Leg" is visible near the upper right corner of the screen.
This dialog contains "RNG", the "actual range", or distance to the next waypoint.
The "normal range" is different. It is the distance from ownship to a line which passes through the destination waypoint and is at right angles to the current route segment.
The actual range is always equal to or greater than the normal range. When the difference is greater than 10% both values are shown in "RNG" (Shown in the Active Route Console )

The "normal" range is the second number shown. 1.88 in this case.

When following a Route OpenCPN normally decides to advance to the next waypoint if at least one of the following two conditions apply.
  1. The "normal range" is less than the declared arrival radius.
  2. Ownship is moving away from the target waypoint, and has been for more than two seconds.
With Advance route waypoint on arrival only activated, OpenCPN only advances the route to the next waypoint, if condition 1 above is true. Condition 2 is ignored.

This feature is useful when sailing and you can't lay the next mark and are forced to tack a few times to reach it. It allows a ship to move away from waypoint without automatically advancing to next waypoint.
This ensures that the next waypoint stays active until you either reach it, or you reach a line through it, which is perpendicular from the marked route. In the latter case you have a cross track error greater than the arrival radius.

On the other hand....
Option 2 helps you if you really want to cut a corner by a large distance, in such a way that the "normal range" will never be less than {arrival radius}. We want to automatically advance the route in this case.

AIS Targets

Read more about AIS.

MMSI Properties

Maritime Mobile Service Identifier (MMSI) is a number identifying a ship in communication. MMSI consists of nine digits. All VHF units using Digital Selective Call (DSC), are programmed with the vessels MMSI. The same applies for AIS and EPIRBs.

MMSI numbers, individual targets, can be handled in a few, preset ways.
Below we have set 970000099 as an MMSI that should be tracked as a MOB.
The number could for example belong to a crew members Personal Locator Beacon.
Several MMSI IDs below are set to never show there tracks. This can used on frequently targets in your neighborhood, like ferries etc.
The MMSI 219000368 is set to never be shown. Be aware that this target nor its track will then never be seen on your screen.
The MMSI 219010183 is set as “Follower”. This is a buddy and no AIS Alert is shown
The "MMSI Properties" popup becomes available when right-clicking. Doubleclicking on the MMSI bypasses the popup an takes you directly to Properties edit dialog.

Add a new target to track

Add MMSI Properties

MMSI: Enter the MMSI number that the new action should apply to.

Note: A MMSI Id use to be nine digits. A warning message will be shown if the entry is more or less.


If you for some reason, wish to save a non nine digit number click – OK, otherwise “Cancel” will take you back to edit the number.

Default tracking: This is the normal tracking controlled by Options->Ships "OwnShip" and "AIS TArgets" tabs.
Always track and Never track: The MMSI Properties dialog allows one to preset the tracking behavior of a particular MMSI target, even if the target is not presently visible. Always track a friend or a ship you are interested in. Ignore that ferry that just clutters your screen. Just a few examples.

Ignore this MMSI: The target will not show at all on the screen

Handle this MMSI as SART/PLB MOB.
With this setting a MOB from your ownship will be signalled immediately.
Special Search and Rescue Transponders, SARTs, are now available, using the AIS system. Personal Locator Beacons transmitting on the AIS frequencies are also available.These are sometimes called Personal AIS MOB Devices. Don't confuse these with the more common personal EPIRB, that cannot be tracked by OpenCPN.
Entering the the MMSI number makes it possible to use these devices as an onboard emergency MOB tracking system. Setting off a device, alarms all vessels that can receive the signal, but it tells you that this emergeny is directly related to your vessel.
OpenCPN will now treat this MMSI as a standard MOB. Read more Man OverBoard
The alarm is entered in Options -> Ships-> AIS Targets ->"Play Sound on CPA/TCPA and DSC/SART emergencies."
Have a look at AIS SART to see how OpenCPN reacts to an alarm.

Convert AIVDM to AIVDO for this MMSI
AIVDM NMEA 0183 sentence -> AIS position reports from other vessels
AIVDO NMEA 0183 sentence -> AIS position reports from own vessel

The setting is intended for at least the following very specific scenario:
1. You have an AIS transponder, not connected to your computer.
2. You have a separate AIS receiver, used to monitor your own AIS signal, as well as all other traffic.
3. You desire not to collide with yourself, virtually. So you instruct O to convert the AIVDM
for your MMSI coming in via your AIS receiver into AIVDO, or "ownship". Thus, no collision.
There may be other uses for this VDM->VDO conversion.

This MMSI is my follower – No CPA Alert
When this option is active no AIS Alert will be shown for that target. This can be used for a buddy sailing close to you and you don't wont a CPA alert message for that target but still for other ships coming to close.

Ships name
The Ship name connected to a MMSI ID will be added to the list once the new ID is saved or edited.
The ship name is automatically printed provided that the actual ship is present on screen or has previously been and was saved in the AIS ship name file. In either case the ship name will be added first time the boat is present in OpenCPN.

The User Interface

Languages: The following languages are available in OpenCPN :
Brazilian Portuguese
Chinese, Traditional
Norwegian Bokmaal
Choose your language here. Make sure your selected language has the support files installed on your computer (Linux). Default language is US English.

Remark: Changing the language will reset the font settings.

Toolbar and Window Style Menubar. The alternatives are described in Toolbar Buttons and Windows/Mac style MenuBar

Fonts. On a new installation OpenCPN uses the operating systems default fonts. This can be changed to suit the user through this dialog. Fonts can be selected for many elements on the display. Selecting the right size of font can have a dramatic impact on how values are presented. It's well worth playing around with these settings if you think that something is difficult to read for example. Note that even the text displayed on vector-charts, can be adjusted.
AIS Target Name - Target List font size
AISRollover - Yellow rollover font size
AISTargetAlert - Popup alert font size
AISTargetQuery -Query Popup
ChartTexts -
Console Legend - Active Route Console XTE, Bearing, etc (upper right black box, see below)
Console Value - Active Route Console - Font Size of the data presented.
CurrentValue -
Dialog - AIS Target List
ExtendedTideIcon -
Marks - Properties font size
Menu - Main menu font size
ObjectQuery -Object Query font size
OD_PathLegInfoRollover - OD Plugin Yellow Rollover font size
OD_PointInfoRollover - OD Plugin Yellow Rollover font size
RouteLegInfoRollever - Route Leg Yellow Rollover font size
StatusBar - Status Font at bottom
TideCurrentGraphRollover -
ToolTips -

The result of adjusting the "Console Value" font size.
There is a side effect of the Font management module, which is worth noting.
One must actually display something in a particular Font List category (ChartText, Console Legend, Console Value, etc.) in order for the item to appear in the list for the first time. Thereafter, the item should stay in the list and be available for editing.
For Example: You may not see the Font List entry for "AIS Rollover" unless you have actually displayed an AIS
Rollover message at least once.
Of course, if you re-install
OpenCPN, or start with a new config file, there may be limited entries in the FontList.

Change Font Color to suit your taste.

Show Status Bar. The status bar at the bottom of the display contains a lot of navigation information. If you have this info available elsewhere, turning this setting off increases the available space for the chart.

Show Menu Bar. Show /Hide the Menu Bar. More about MenuBar
Short Cut: "Alt"

Show Chart Bar. Show /Hide the Chart Bar. More info available on the Chart Status Bar page.
Short Cut: "Ctrl + B"

Show Compass/GPS Status Window. Show /Hide the Compass/GPS Status Window. More info on the GPS Status page.
Short Cut: "Ctrl + I"

Enable Toolbar Auto Hide. Enter number of seconds for the Toolbar to automatically hide.

Play ship bells: Every half-hour the traditional ship bell will be heard. Refer to if you are not familiar with them.

Graphical User Interface

Enable Touchscreen/Tablet Interface: Read more at Touch Screen Tablets

Enable Responsive graphics interface for Touchscreens. The option is intended for small (~8") tablets with high definition displays. What it does is adjust the various graphic elements such as menus, icons, etc. so that they meet the best-practice size standards for Win8/Android system displays. This makes them "big enough" to facilitate touching, dragging, etc with normal human fingers. You should not see much difference when selecting this option for normal desktop or laptop systems

If either of the Graphical User Interface boxes are checked, the slider "User Interface scale factor" changes the size of the Tool Bar, Chart Bar and the GPS status icon.

If the "Enable Tablet Scaled Graphics interface" is checked, the slider "Chart Object scale factor" changes the size of chart objects including: Marks, Routes, Buoys, Daybeacons, Wrecks, Rocks, and Depths.

The Plugins


The Plugin tab is treated on these pages

Install and Enable Plugin
Dashboard Plugin
Grib Weather Plugin
WMM Plugin
Chart Downloader
External Plugins Third Party

Goto Top of Option

Go to Table Of Contents

Vector Display

OpenCPN makes a serious effort to be compliant with IHO standards for ECDIS display of cartography.
First, one very important setting for vector charts is handled directly from the main toolbar.
This button toggles all text displayed on a vector chart On and Off.
The hotKey "T" is an alternative for toggling the text.
In OpenGL mode, all text will always be horizontal when using the "Course Up" option.

Second, double clicking on a vector chart, as long as the cursor hasn't changed to a green arrow near the edges, brings up an information dialog, displaying the available vector-chart information at the selected point. Scroll down to see all the information. An alternative to double clicking is right-clicking an select "Object Query".
Note that a single normal (left) click will center the chart at that point.

The example is taken from double-clicking on a lighthouse in a busy area.
Exactly what is shown in this dialog depend on the settings described below in "Display Categories".

Third, it is possible to select what font is used for the text on vector charts. There is an entry in theToolBox->Languages/Fonts->Choose Fonts tab, called ChartTexts. Here you select what font-face to use, and a template size. Weight and final size of the displayed texts depends on the charts you are using, but if the charts contain various weights and sizes, they will all scale together depending on what size you select.

The Options-Charts-Vector Charts Tab is where everything else is handled.
If the S63 chart plugin is active, there will also be a "S63 Charts" tab. Read more about S63 Vector Charts,when you have read this page.


For a general introduction to AIS, Wikipedia is a good place to start.

AIS Operating Controls
AIS Target Query
Aids to Navigation AtoN

AIS Target List
AIS Transponder and Ownship
AIS data port

ToolBox AIS Tab
To track or not to track?
Suppress anchored/moored targets
Attenuation of less critical targets
Toolbox MMSI Tab
When exactly is an alarm activated?

The screen-dump below gives you a first feel for how AIS targets are presented and used in OpenCPN.

The Lookahead mode is activated here and our own vessel is proceeding 352 deg at 13.8 kts, leaving an activated track behind, and projecting a dashed line ahead representing the course. This ends in a dot, that represents where we will be in 6 minutes, or 1.38 nautical miles ahead. We are meeting a vessel, steaming in the opposite direction following the traffic separation. This target also has a line and a dot in-front of it representing course and where it will be in 6 minutes(user configurable), and a track behind it.. The two blue dots with a red/yellow line between them, represents where the vessels will be at CPA - closest point of approach, or when the are nearest each other, with present courses and speeds. The meeting vessel is red, as it is a potential danger to us. An AIS target alert dialog has just popped up.

There is a lot of information about the vessels that transmits AIS signals.

The cursor is on top of the the meeting vessel on a SW course. As we have not yet received full information, this can take a while, we don't get the name but an id number, the so called MMSI number, instead. Exactly what is shown in the yellow pop-up is configured in the AIS tabs Rollover heading.

This vessel is identified by name, and has a green color, as it does not represent any danger to our navigation.

AIS Operating Controls

The Menubar-AIS and Toolbar-AIS provide useful operating controls of key AIS parameters which may need to be adjusted during use.

MenuBar > AIS Dropdown

(To turn on the Menubar use Options > User Interface > Show Menubar)
  • Show AIS Targets
  • Hide Moored AIS Targets
  • Attenuate Less critical AIS Targets
  • Show AIS Target Tracks
  • Show CPA Alert Dialogs
  • Sound CPA Alarms
These controls appear to work together and in sync, as expected:
Menubar AIS: Show AIS Targets = Options > Ships > AIS Targets > Display: (Show AIS is not shown. -Should it be?)
Menubar AIS: Hide Moored AIS Targets = Options > Ships > AIS Targets > Display: Suppress Anchored/Moored Targets...
Menubar AIS: Attenuate Less.. [Exception, see below]
Menubar AIS: Show AIS Target tracks = Options > Ships > AIS Targets > Display: Show Target Tracks Length (min)
Menubar AIS: Show CPA Alerts = Options > Ships > AIS Targets > CPA/TCPA Alerts: Show CPA/TCPA Alert Dialogs
Menubar AIS: Sound CPA Alarms = Options > Ships > AIS Targets > CPA/TCPA Alerts: Play sound to CPA/TCPA Alerts...

Options > Ships > AIS Targets > Display: "Allow attenuation of less critical targets..." must be checked to enable
Menubar AIS: "Attenuate Less Critical AIS Targets" so that it become un-greyed and available.
Also when unavailable, the Toolbar AIS Icon click rotation drops the selection for "Attenuate all AIS targets".

Toolbar > AIS

Toolbar AIS Icon Message (Clickable Rotation to change settings. Read the pause message.)
  • Attenuate Less Critical AIS Targets (if enabled under Options > Ships > AIS)
  • Hide AIS Targets
  • Show all AIS Targets
  • Attenuate all AIS Targets (dropped in rotation if unchecked under Options > Ships > AIS Targets)

AIS Target Query

What is an MMSI number?
Maritime Mobile Service Identifier (MMSI) is a number identifying a ship in communication. MMSI consists of nine digits. All VHF units using Digital Selective Call (DSC), are programmed with the vessels MMSI. The same applies for AIS and EPIRBs.

What is an IMO Number?
International Maritime Organization (IMO) numbers are a unique reference for ships and for registered ship owners and management companies. They were introduced under the SOLAS Convention to improve maritime safety and security and to reduce maritime fraud. For ships, the IMO number remains linked to the hull for its lifetime, regardless of a change in name, flag, or owner. ( from Wikipedia )

If we instead of just hovering the cursor on an object, double click it, the dialog above pops up. A lot of relevant information is displayed. CPA, "Closest Point of Approach", to ownship is 12.7 miles in 12min 57s.
More information about the target itself, is available on Internet address:"MMSI number here", in this case:

Buttons in the Target Query Dialog

Create Waypoint drops a mark at the targets current position.

Record Track/ Stop Recording
Pressing the "Reckord Track" button brings up a new dialog

The recently recorded track of the "Poseidon Leader" will appear in the Route & Mark managers track tab on a line starting with "AIS Poseidon Leader.....".
If the "Yes" button is pressed, the Target Query Dialog button ""Record Track" changes to "Stop Recording". All tracks recorded will behave just like any other track.

Right-clicking a target brings up a dialog focused on AIS.

More and more aids to navigation are equipped with an ais transmitter, and shows up as a target in OpenCPN like this

Note the word "Real", that says that this is an object that exists in reality.

Here we have an AIS transmitter on a floating W Cardinal Mark.
This is of course real and the buoy is on position. If the buoy is off position, for some reason, the Aton icon becomes red.

There are also Virtual AtoNs marked with their own icon .
Virtual AtoNs are used to quickly make mariners aware of things like new wrecks, uncharted hazards and floating debris. They are normally used for a short duration until replaced by real buoy, charted, removed or dispersed.

Virtual AtoNs are also used for information. An example...the position of the Italian Maritime Rescue Coordinating Center. Note the word "Virtual" in the dialog.

OpenCPN handles the situation where MMSI is set to 0 (zero). This can occur with an incorrectly configured Aton. Nevertheless, all available information is shown.

AIS update rate

How often are the AIS information updated from each target?
The required update rates from an AIS target transmitter is shown below.

Update Rates
Class A Class B
Static Data 6min 6min
Dynamic Data < 3kn moored 3min
upto 2kn 10s 3min
> 2kn 30s
< 14kn (turning) 10s (3.33s)
< 23kn (turning) 6s (2s)
> 23kn 2s

AIS Target List

Another way to present the AIS information. The AIS target list is available through the right click menu.

Sorting targets
Click on the header in a column to sort according to this criteria. For example, clicking "Range" sorts the targets with the nearest target on top. Click one more time to get the target, furthest away on top. There is an "autosort" checkbox. When checked, auto sort is on. May be unchecked/rechecked any time. The autosort checkbox is automatically unchecked when target count exceeds 1000. However... It may be rechecked directly by the user, even if the target count is exceeded, and will stay checked.
Active Search And Rescue Target (SART) and Digital Selective Calling (DSC) distress targets, will always stay at the top of the list, even when sorting.

AIS targets with Lat > +/-85 deg will show brg "unavailable". OpenCPN is not suited for Polar Navigation.
Target Info button: Click on a target to highlight it and then click the button to display the information dialog.
Center View button: Highlight a target an click this button and the screen will center on the target.
Create WPT. Drop a waypoint at the current position of the target.
Hide All Tracks If tracking is on in Options->Ships->Ais Targets, all tracks will disappear from the screen. Read more furher down this page.
Show All Tracks Will reverse the previous option, and show all available tracks. If Options->Ships->Ais Targets is off, tracking will start for all targets.
Toggle Tracks

Note the first column in the list "Trk". This indicates the current status of tracking for each target.

AutoSort See "Sorting Targets" above, for an explanation of this box.
Limit Range: The list will only show targets with a range less than, or equal to this value.
Target Count: Total number of AIS targets.

AIS Transponder and Ownship

OpenCPN does not show the ownship (i.e. AIVDO message) neither as an AIS target, nor in the target list. AIVDO is processed only in the main navigation thread.
Earlier releases did show ownship, but this was a bug, simply an illusion.
The earlier presence of AIVDO (ownship) information in the data stream, really only indicated that the transponder was turned on and received GPS signals. The only true way to monitor the output of a transponder, is with a separate AIS receiver.

AIS data port

Select your AIS input port in the Connection Tab. The AIS button in the ToolBar, appears different according to the following conditions.
AIS Alive. The default AIS button. This icon appears as soon as an AIS port is active in the tool-box. It is also the normal state with an AIS receiver working and with no targets of interest.

AIS Alive and Activity, a small green circle will illuminate in the lower right corner of the Ais buton. If there is at least one AIS message every 4 seconds, the light will remain illuminated.

AIS Suppressed. This icon indicates only that target suppression is activated in the AIS tab in the ToolBox. Referring to the picture above there are two sort of suppression:
* Suppress display of all moored/anchored targets, max speed specified in dialog.
* Suppress Alerts for moored/anchored targets.
This icon will be over-ridden with the AIS alarm button if an alarm is, or becomes, active according to the AIS tab alarms settings in the toolbox.

AIS Alarm. A target exist that raises the alarm as defined in the AIS tab in the ToolBox. It is the three settings "CPA Calculations", that rules if and when an alarm is raised.

AIS Disabled. No targets, if available, are shown on the screen. This button toggles with the other buttons. For example, if the AIS alarm button is visible, click the button and it will change to the "AIS Disabled" button, and all targets, alarms etc, disappears from the display. Click again and the original button and AIS display comes back.


The AIS toolbar tool cycles with each mouse click as follows: (hover for next control action)

  • AIS show all targets (normal, default)
  • AIS Scale non-critical targets. (Provided it has been enabled under Options > Ships > AIS Tab)
  • AIS Hide all targets
  • ...and back to AIS Show All targets.

Also please refer to AIS Operating Controls above, under Toolbar > AIS Icon which shows how to change key AIS settings by pausing the mouse on the AIS Icon to view the popup message indicating how the AIS controls will change with the next click on the icon. These controls rotate or cycle with each click.

ToolBox AIS Tab


This tab controls the behavior of many thing in the AIS display. There are no "best" settings. It all depend on where you are, what kind of navigation you are into and what kind of vessel you are on. It is your responsibility to evaluate this.

CPA calculation: Rules for when the Closest Point of Approach- CPA (when two vessels are nearest each other) and the Time For Closest Point of Approach (TCPA) is calculated, and when warnings are activated.
There are three tick boxes, which can be activated with user set values.

No CPA Calculation if target range is greater than (NMi)
If the vessel is far away it is less interesting to calculate CPA. In a busy waterway this could cut down on clutter and processing speed if a reasonable value is set.
Warn if CPA is less than(NMI)
Similar arguments to No 1. This controls when a warning for minimum CPA distance is given. A warning can be both on the screen and a sound. The CPA is shown on the screen when a warning is active.
..and TCPA is less than (min)
This Box can only be activated if the previous box is active. If the minimum CPA is far in the future, it's not so interesting. If it's hours away, both vessels have probably changed speed and course in the meantime. Set TCPA to a reasonable value value depending on circumstances. A lower value if negotiating a busy waterway. A higher value when offshore. Many factors plays a role here. If you need to get off watch crew up on deck for a manoeuvre, take this into account, for example. Do you find that you get to many useless alarms? Consider lowering this value and/or the CPA value.

If a target is within the distance set in #1 and without an active warning, theCPA can be shown anyway through right-clicking on the target.

"Show Target CPA" toggles with "Hide Target CPA"

Target CPA Details, a few more tricks are available.

Lost Targets: Rules for how lost targets should be handled on the display.

Mark Target as lost after (min)
Target is regarded as lost if no transmission are received for the number of minutes set here, the target will change on the display and have a black bar across.
Remove lost targets after (min)
The lost target will be removed from the display after the number of minutes set here.

Display: If and how a vessels course and speed should be displayed and if stationary vessels should be on the screen.

Show target COG predictor arrow, length (min)
An arrow will be shown in front of the vessel representing it's COG (Course Over Ground). The length of this arrow and the dot at the end of it represents the calculated position in the number of minutes set here. Set easily calculated values. If a vessel approaches you doing 15 kts and the time is set to 6 minutes, the dot will be 1.5 nautical miles ahead of the vessel.

The width of the "Target COG predictor arrow" can be adjusted in the opencpn.ini configuration file. Find the line below and adjust the value.
Warning: Don't edit to the opencpn.ini (opencpn.conf) file when OpenCPN is running.

To track or not to track?

This choice below boils down to two basic scenarios.

  • All targets will be tracked, with the option of turning off tracks for selected targets.
  • No targets will be tracked, with the option of starting to track selected targets
There are more about tracks in the section "AIS Target List" above.
Note the first column in the Target list -> "Trk". This indicates the current status of tracking for each target.

Show target tracks, length (min)
This is the basic setting that can be refined in the "AIS Target list". With this box ticked targets are tracked even if they are not displayed. Start out with this option ticked, if you hesitate. Come back and finetune the settings later on, if necessary.

A track will be shown behind a target. This helps to judge the target vessels intentions.

When this option is ticked, the context sensitive AIS menu changes to include the toggle option "Hide Target Track" / "Show Target Track".

When this option is not ticked, the context sensitive AIS menu changes to include the toggle option "Show Target Track" / "Hide Target Track". A big difference, in this case, is that OpenCPN has no record of the track. The tracking will start from the moment "Show Target Track" is clicked.

Suppress anchored/moored targets

Suppress anchored/moored targets, speed max (kn)
A target will not be displayed if the speed is less than the value set here. There are two exceptions to this rule, Aids to Navigation (Aton) and "Vessels Not Under Command". The rule is aimed at catching anchored or moored vessels. The "Navigational Status" is set by the ships and may not be correct.
Be aware that the COG arrow will not be shown for any target with a COG less than this value, hence it's important to enter a very low value.

Attenuation of less critical targets

Allow attenuation of less critical targets if more than ...targets [number]
If checked AND selected under Menubar-AIS or Toolbar-AIS then at least [number] of targets will be displayed normally. If unchecked then all AIS targets are displayed normally and this option is greyed out and unavailable.

Note smaller attenuated green ship on lower left
Attenuation of Less Critical Targets will declutter the display without removing AIS targets from the display, by reducing the size of less critical targets. Less critical targets are determined with a weighted rules filter. The important targets remain unchanged, including display of the ships name. Less critical targets are reduced in size and do not display ship name, to reduce clutter on the chart.

Details for Attenuation of Less Critical Targets
The "importance" of a target depends on:
Speed of the target. Faster targets are more important (max speed acknowledged is hard coded at 12 knots).
CPA. The closer a target will come the more important it is.
TCPA. If the time to 'collision' is small the target is more important.
Distance to the target. Far away is less important.
Size of target. Larger targets are more important. Class B targets don't transmit ships size and is set to 0(zero).
For each parameter above a factor is calculated. The highest value of this factor depends on the value in the config file. All these values are then added, which gives each target a 'weight'.

From all AIS targets the top [number, say 10] targets which are most important, are displayed at full scale. Only [number, say 10] important targets are displayed, depending of the value in Options > Ships > AIS > Under Display: "Allow attenuation of less critical targets if more than ...targets [number]". The weighted importance is frequently calculated and as long as a target remains in the top [number, say 10], it will be displayed normally.

The less critical targets are still displayed, but at reduced size. The size of the less critical targets can be adjusted with the [AISScaledSizeMinimal=50] setting in the config file, where 50 stays for 50%. Scaled down targets don't have names , no nav status symbols, and no heading line.

Show Area Notices(from AIS binary messages). More about Area Messages here.

Show AIS targets real size. Zooming in on a target will eventually show a rectangle using the real size , if available. The picture below also shows how differences in course and heading are treated.

Show names with AIS targets at scale greater than 1:[select value]
With this box activated.....this is what you get!

Note that this setting also controls if a numerical value will be displayed alongside a tidal current arrow.

Treat WPL sentences as APRS position reports.
APRS (Automatic Packet Reporting System) is utilized by HAM radio operators around the world.The NMEA WPL sentence is shorthand for for "waypoint location". If this box is ticked, a WPL sentence will be assumed to be an AIS-like APRS target.

Rollover: Tick the boxes for the kind of information shown when hovering with the cursor over a target. This is what you get with all the settings ticked.

CPA/TCPA Alerts and DSC/SART Emergencies: When an alert is triggered, a jagged circle in red is drawn around the target that set off the alarm. Additional events can be set here, drawing more attention to the alarm. For practical navigation, make sure your alarm sound is set.

Show CPA/TCPA Alert Dialog
Shows an alert dialog on the screen with target information when an alarm is triggered. This setting only applies to AIS CPA/TCPA alerts. A DSC/SART emergency will always generate a dialog.
Play Sound on CPA/TCPA Alert Dialog and DSC/SART emergencies
Sounds an alarm when an alarm is triggered.
Supress alerts for anchored /moored targets
Don't show alarms for anchored and moored targets.

Select Alert Sound. Select an alarm that suits you, instead of the installed default sound. This alarm will also be used if an anchor watch is set. Due to copyright issues, only a few sound files are included. The default location for these files are "/usr/share/opencpn/sounds/" on Linux and typically C:\Program Files\OpenCPN\sounds on Windows XP. Users can add their own generic ".wav" sound files. These files can be in any suitable place in the file-system.

Test Alert Sound. Test the selected sound and make sure this important feature is working

Enable Target Alert Acknowledge timeout. Once a target alert is acknowledged, wait the set number of minutes before the alert comes up again (if still applicable).

Toolbox MMSI Tab

Read all about this tab here MMSI Properties

When exactly is an alarm activated?

An alert is set off if your boat is approaching the CPA, the blue dot on the extension of the course line, and the previously discussed set of conditions are met. Once the distance to the CPA increases, this happens when the involved vessels has passed each other, the alarm stops, even if the other conditions still apply.

One user noticed an alert every few seconds, yet the target was still green. The explanation is:
Variation between alert status and ship icon color is due to rapid changes in target course/speed. The target color can change from red to green while the alert dialog is showing. This may happen so fast that the red icon is not actually seen. OpenCPN does not automatically cancel the alert dialog in this case, in order to not mask information.


Types of Transponders recognized by OpenCPN
Class A
Class B
APRS Automatic Packet Reporting System Targets
ARPA Automatic Radar Plotting Aid Tagets
ATON Aid to Navigation, both "Virtual" and "Real".
BASE Base Station
DSC Digital Selective Calling Targets
GPSG_BUDDY GpsGate Buddy Targets
SAR Aircraft Aircraft participating in Search and Rescue.
SART Search and Rescue Transponder Targets

OpenCPN Remembers the Names of seen and fully identified target. The names are cached internally and helps Identify targets quicker on next start. Targets not yet fuly identified, were the name comes from the cache, are displayed lime green. See example below.
The AIS name caching can be turned off in the opencpn.ini/opencpn.config file by adding a line like this.

The name of the file where the list of previous mmsi and ship names are stored is "mmsitoname.csv" in case you would like to clear it. This file is in the same folder as your configuration file (Click the ? icon in the toolbar to see the location, it is platform dependent).


Quick Reference for targets:
Note that AIS targets reporting position unavailable will be rendered in grey colour.

AIS SART Symbols
An active AIS SART and is a distress call equal to a "Mayday" transmission. More about AIS SART.
The V-shape stern indicates a Class B target. Tugboats and pilot boats very often carry Class B transponders. These are often designed specifically for small commercial boats, fishing boats and pleasure crafts.
Icon displayed when testing an AIS-SART device. Targets is complying with the Euro AIS Inland specification.
Aircraft participating in Search and Rescue. This vessel has the "Inland Blue Flag" set, it's a part of the European, Inland AIS standard. The "Blue Flag" signal, commonly seen on inland waters, indicates that the vessel requests a "stbd-stbd" passage or crossing. This Blue Signal is manually switched on/off, by the target.
Potential Danger. Aton, Aid to Navigation, for example a Lighthouse or a Buoy with an AIS transmitter.
No Danger. Not Identified (Voyage data not received) Aton, Aid to Navigation, that is off it's suposed position. For example a buoy equiped with AIS that has come adrift.
No Danger. Not Identified (Name from cached data) Virtual Aton, Virtual Aid to Navigation, not a real marker. Can be useful for a range of situations. A new wreck, is one example. Further explanations.
No Danger. Identified Virtual Aton, off position. Actually seen in the wild, but may be a user config error.
Lost Target AIS Base Station
Ship which has lost fix - position unavailable. Displayed at the last known position. The following tagets only displays if DSC messages, GpsGate mesages, Radar or APRS messages are mixed in to the incomming AIS stream, by using, for example a multiplexer. More on the following pages.
Vessel not under command. DSC Station. Only the DSC message received. The position contains only degrees and minutes of Latitude and Longitude.
Vessel restricted in ability to manoeuvre. DSC Station. DSC and DSE messages received. The DSE message contains the missing decimals of minutes of Latitude and Longitude. The result is a much more accurate position.
Vessel constrained by draft. DSC Station transmitting a distress signal. Treat this as a "Mayday" call.
Vessel aground. GpsGate Buddy target.
Vessel engaged in fishing. ARPA Target
High Speed- and Wing In Ground- crafts. This includes Hydrofoils, Hovercrafts and low flying crafts utilising the ground effect. APRS Target
Anchored or moored. Displayed when the transmitted "Navigation status" is "at anchor" or "Moored". There is no guarantee that this status is correct, as it is set manually on the transmitting ship...
...illustrated by this ship. Note the black line on the yellow circle. This indicate that the vessel is turning to port (left), also illustrated by the lag in the display update. ROT - Rate Of Turn is available in the "Ais Target Query" dialog, through the right click menu.

Go to Table Of Contents


The US FCC has recently approved transmissions by AIS SART devices. These devices were originally designed for SOLAS class ships as an alternative to radar SARTs for carriage on life boats, but the efficiency of design has encouraged applications down to man-over-board devices.

Search And Rescue Transponders (SART) or PLB transmitting AIS messages are now available on the market. In an emergency situation the position will be displayed as an AIS target in OpenCPN. AIS SART can be a device on a vessel, in a life raft or a personal Man Over Board (MOB) device. MMSI always begins with 97.

If you and your crew have PLB personal locator beacons, transmitting AIS emergency messages, and the MMSI number of each device is entered in Options->Ships->MMSI Properties->New, OpenCPN from version 4.0, will automatically work as a man overboard tracking device.
Read more in Man OverBoard .

The common thing is that the icon below marks an emergency.

SART icon, distress target display. This is a "Mayday".

On OpenCPN a distress signal sent by a SART, triggers an visual alert and a warning sound, if this is activated in the ToolBox-->AIS Tab.

Once the alert is "Acknowledged", the target behaves as any other AIS target. In the picture below the cursor is over the target. The SART target will persist on screen for 18 minutes after the last transmission irrespective of other settings for AIS.
SART alerts always have priority over DSC and CPA alerts.

And here is an AIS target query.

AIS SART messages and DSC distress calls are always found at the top of the AIS target list.

It is possible to test a SART, to make sure it works.

Icon displayed when testing an AIS-SART device.

Go to Table Of Contents

Area Messages

To display the messages, tick the Options->Ships->AIS Targets->Show area notices(from AIS binary messages).

Many countries around the maritime world are testing the AIS binary messages. Expect a lot of development in this area.

In OpenCPN, this is very much a work in progress, the areas were only added April 2012 and the messages in December 2012.

Areas and the messages included for each area, are available.
In the US, Cape Cod is transmitting experimental Right Whale information. For testing, copy into a text file and point the VDR (Voyage Data Recording) plugin to this file.
These messages are updated quite often.

The area messages are found as the first entries in a normal object query for vectorcharts. The easiest way to display this dialog is to just double click in an area. The screen picture above shows that this works for RNC:s (raster charts) as well as ENC:s (vector charts). The first notice above is for the yellow tinted rectangular area while he second notice is for one of the circles outlined in green.

An overview of available massages compiled by IALA.
IALA has agreed to maintain a collection of regional applications for the AIS Application Specific Messages that are in use. The intent is to provide an overview to all interested parties of what currently exists.
The overview of available messages is available here.

Go to Table Of Contents

Radar Targets

3.3 Beta feature.
Some radars are able to create NMEA radar sentences from observed targets.
The ARPA targets, except for the way the data is acquired, are treated exactly as if they were AIS, including timeouts.

Arpa Target

Arpa Target

Arpa Target

Implementation details:

Target CPA Details

OpenCPN displays warnings about targets CPA & TCPA according to the setup in the AIS tab. But it's also possible to show CPA & TCPA for any target, that is no immediate danger, but where internal CPA calculation is still done, to assist in the decision making.

The AIS rollover window shows the CPA and TCPA of a target :

But it doesn't tell us where we and the target are at CPA, and if the target passes in front of us or behind us (i.e. should we speed up or slow down ?).

See the following (real) example:
We are sailing hard on the wind, while a vessel is approaching us, more or less from the wind direction. A CPA of 0.78 miles is normally safe, but there is this island in our way, meaning we had to tack towards the vessel, and it is still 14 minutes to go ...

What will happen with our CPA after the tack ?
Have we already passed each other or do we get closer when tacking just in front of the island ?
The answer to these questions is a context sensitive menu for AIS targets. Move the
mouse over the target, and when you see the CPA / TCPA info in the rollover window,

you can right click and select “Show AIS Target CPA”.

The function is only available when we have a “valid CPA”, i.e. when the rollover shows
CPA and TCPA (it uses the internal CPA calculation).

It simply shows the “CPA line” which is used in case of a CPA alert :

Showing the CPA-line as in the screen-shot above, makes life much easier. Nothing to worry about ...

At CPA ...
• we will be just in front of the island, exactly at our tacking position and
• she'll already be behind us (CPA line points backwards from our CPA position)
The CPA line is constantly updated, so you can follow the situation.

This is, what it looked like directly after our tack

To get rid of the CPA line for a specific target, right-click on the target and select “Hide AIS Target CPA”.

As already mentioned, the CPA line is shown only, when there is a valid CPA.
A minute later, we don't have a CPA anymore for the target --> the CPA line isn't drawn anymore !.

Another example :

He'll pass behind us, so “full steam ahead !”

Monitoring several targets
You can also monitor more than one target in parallel. Simply right-click on a second target and “Show AIS target CPA line”
Situation could be :
What happens to a second target if I get out of the way of the first one ?

Go to Table Of Contents

DSC Buddy via AIS.

If DSC or GPSGate Buddy-messages are available in an incoming NMEA 0183 data stream, OpenCPN will show them with their own icons, and they will show in the "AIS Target list". They are not a part of AIS, but are displayed the same way, for convenience.

DSC is used on all new VHF set (or should be!). More on Wikipedia. To use this feature, check that your VHF set outputs NMEA 0183, in a way that can be connected to OpenCPN.

GPSGate is a commercial GPS tracking and sharing service. GPSGate Buddy Tracking is part of that service.

Make sure that Options--> AIS Targets -->"Play Sound on CPA/TCPA Alerts" box is ticked, otherwise the alarm sound (see below) will not be heard.

If OpenCPN receives a DSC Distress call, an alarm will be triggered, both visually and by sound.

A VHF/DSC distress call is treated in the same way as an AIS/SART call. Both should be treated as MAYDAY calls.

Two different types of alerts.
DSC Distress alert, coming from a specific vessel, presumably by crew activating a switch on the transponder. These are occasionally seen as false alerts, for testing. For the second type look under AIS SART section. SART, which is a SearchAndRescueTransponder. The MMSI starts with 97..... and will have Class: SART. This might be from a PLB (and PLB-AIS) on man overboard, for instance. PLB AIS devices are under the AIS SART type.

Quick Reference

DSC Station. Only the DSC message received. The position contains only degrees and minutes of Latitude and Longitude.

DSC Station. DSC and DSE messages received. The DSE message contains the missing decimals of minutes of Latitude and Longitude. The result is a much more accurate position.

DSC Station transmitting a distress signal. This is a "Mayday".

GpsGate Buddy target.

A normal DSC target, is someone using a dsc-capable VHF

Distress message via DSC, Digital selective Calling, from an unidentified AIS target.

A green Buddy target on an island.

The AIS Target List View

Go to Table Of Contents


Shows all possible AtoN's. From top, Real or Synthetic and Virtual

Real or Synthetic AtoN


Virtual AtoN

AtoN Virtual

AtoN in Practice

More AtoN in Practice

Chart with Aton

Route & Mark Manager

Through the Route Manager OpenCPN can save and load waypoints, routes, tracks and layers using the GPX transfer format. This lets you save your routes and marks so you can have more than the active ones - for example to do route planning, or archive existing data.
  • GPX format is supported by a wide variety of programs.
  • You can have as many saved files as you wish, there are no limits on the number of saved files.
  • Use this for passage planning by saving multiple possible routes for a passage.
  • Save routes and tracks for historical/log purposes.
  • Prepare layers as an aid to navigation en route.
All Navigation Objects on this page, except for "Temporary Layers", are persistent between sessions. More here:Navigation Data Backup
All objects visibility is toggled by clicking the "eye" , or other icon, to the left of the route/track/waypoint/layers name, on each line. A red X across the "eye" or icon (for marks) means that the object is invisible.
All objects can be sorted by the header in the columns in the Manager. By clicking "Route Name below, the routes will be sorted alphabetically, pressing once again reverses the order. Similar for the column "To", the destination.
Select multiple objects in the Routes, Tracks, or Waypoints tabs, individually by CTRL + leftclick, or in group by SHIFT + leftclick, for export or deletion.
Double-clicking on a Waypoint, Route or Track brings up the respective Properties dialog.


  • The route points have exactly the same properties as the isolated waypoints, but does not show in the waypoint tab, to avoid clutter. To create a route that uses real waypoints, create them first and join them with the route tool.

  • Click the "eye" to the far left on the line with the route to toggle if the route is displayed or hidden on the chart. A small dialog let you choose, if existing marks, included in a route, will also become invisible. When a route is turned visible, all the shared waypoints are also made visible. Once a route is deleted, such a mark will go back to be a "normal" waypoint.
  • To Sort routes click "Route Name" or "To"
  • Properties:This button brings up a new dialog with settings that can be changed for each route.
  • Wpt 005 is right-clicked, and new dialog has popped up. The waypoint properties can be reached and edited. For example, change the default name, "005" in this case, to something more appropriate. Read more in the Extended Marks section. The waypoint can also be deleted. The last entry, "Copy all as text" copies all Route Properties for pasting into a text or Spreadsheet document.
  • Plan Speed The overall planned speed for the route. The speed for each leg can be set by going to the waypoint Properties->Description tab for the waypoint that starts the leg, and write in the speed. For example " VMG=9.7". [Unfortunately this approach presently excludes writing descriptions for the waypoint. One or the other, be warned!] The Plan Speed value is persistent and will be used for further routes, unless changed. The default value is 6.0 knots.
  • Departure Time: For Planning: With no departure time the ETE (Estimated Time En route) is calculated. Route is Inactive and normal calculation is ETE. The ETE will be calculated from the First Waypoint of the Route.
  • ETA For Planning Date & Time: with Route Inactive or Active. Enter a Departure Date and Time eg: 06/07/2014 14:00 and the ETA will be calculated. Make sure to press "Enter/Return" after entering a departure time. This guarantees that the entered time is used in calculations. The ETA will be calculated from OwnShip to the first Waypoint of the Route and then for each waypoint. Note the Active Waypoint Console.
  • ETA Planning Now Route can be Inactive or Active with first WP active. To enter the present time, enter ">" (meaning: "Now") in the departure time box. This works provided "Time shown as" -> Local@PC is selected. Press "Enter" and all the times in the "ETA" column will change. ">" differs from entering the same time manually, say "06/04/2016 14:23". Distance from Ownship to first Waypoint (active) will be shown with ETA's for all waypoints in the route. Calculates departure Now from the current boat position, including the distance to the first waypoint of the route
    Use prior to leaving harbour, all calculations pass through the very first WP of the route and ETA is calculated from the boat position through the first waypoint and then to the end of the route. Note the Active Waypoint Console.
  • ETA Planning Now from Intermediate WP If the Route is Active and an intermediate Waypoint is Active, say WP5, then "- ">" - issued at 14:00 on 06/04/2016 - calculates departure "Now" from the current boat position, including the distance to the currently "active waypoint" of the route. Waypoints before the active waypoint are left empty.
  • During Passage - Set Route "Active" Route & & time shown as "Local@PC". If you are simulating this condition you may need to right click on the next WP and pick "Active". On an ocean passage, after a week of sailing, calculate ETA to the following WP. Set the route as "active" & next WP as "active". Then, when entering ">" = "now" as Departure Time, all the ETAs are from your real position TO THE NEXT WP, not to the beginning of the route. The ETA to the active waypoint is from Ownship to the WP. Note the Active Waypoint Console.
  • Times shown as: UTC is a new name for GMT. LMT is a local mean time based on the present longitude. For Local Zone Time one can also enter the keyword "now".
  • Color: Set the displayed color of the track or keep the default.
  • Style: Solid, dashes, dots, a combination or keep the default.
  • Width: Set the width of the track or keep or keep the default.
  • Marking a line with the leg number and the destination Waypoint in the Properties Dialog also marks the Waypoint on the chart with a blue square.
  • The lower part of the Route properties dialog now has a Print Route button. It is possible to first select what features to print before being sent to the normal print routine.
  • Extend Route:Extending is possible only when it is obvious, what should be joined with the current route (current = visible in the Dialog). Eligible are all visible route points shared with, or lying nearby to the current route's endpoint. If there is exactly 1 such point, then it is considered obvious, and the Extend button is enabled. If there are more, some should be hidden before proceeding, until just 1 remains.
    Routes are extended forward, based on the geographic location, next route point must be very near, as when mouse-extending the route. If the next route point is to far away for extending, just create the joining leg and extend twice.
  • Split Route:For splitting, the split point is selected as the row in the listing. The point-of-split becomes part of both new routes (shared) or tracks (cloned). Original route/track is deleted.
  • Here is a basic example of first splitting then extending. The test route is shown below
  • "Split Test_A"
  • In the Route Managers property dialog for the route we have selected a waypoint where we would like to split the route. The "Split Test" Route now consists of two parts, that has been renamed.
  • Next we extend the first leg "Split Test_A" with the second leg "Split Test_B". This extended route s now named "Split Test_B_plus.
  • Activate/Deactivate: Activates/Deactivates a route marked in the left part of the window.
  • Zoom to: Zooms in on a route marked in the left part of the window.
  • Reverse: Reverses a selected route. It's possble to cancel the reverse operation through a confirmation dialog.
  • Delete: Deletes selected route or track. Use the Shift key to mark multiple routes for deletion. This also work in the other Route manager tabs.
  • Export Route: Save the route on your computer for later use (import)
  • Send to GPS. Send the Route to your GPS. Pressing the button activates a dialog were an output port is selected. This port does not have to be listed in "Connections" as it is an independent feature. This choice also appears in the right click menu for routes and waypoints. For Garmin Users, make sure that the ToolBox->GPS->"Use Garmin GRMN/GRMN(Host) mode for Waypoint and Route uploads" box is ticked. The reason for this is that Garmin units cannot accept route uploads via NMEA0183. This is a "design feature" of all Garmin receivers.
  • Delete All. Be careful. If you know you have saved the routes on your computer and are able to import the again, this is a simple way to clear the screen from routes. Better be safe than sorry, so save before deleting, if you want to be able to use the routes again.
  • Import. Import one or more previously saved Routes, or Routes from other gpx compatible applications. It is possible to select and import multiple routes. The default waypoint icon bitmap is a circle. This kicks in if the icon in the imported gpx-file is not recognized.
  • Export All, now called "Export All Visible..." Saves all visible routes, waypoints and layers, in one gpx file. This is done through a normal file saving dialog.
  • If a Tidal Height Curve Dialog, for an individual tidal station is shown on the screen, the tidal situation for this station will be tabulated along all route points in the route properties dialog. It is essential to enter a departure time and a planned speed. Once "Enter" is pressed the tidal column will show the nearest High or Low water considering the ETA at each waypoint.

  • If no tide dialog for any station is open and a waypoints name contains the string @~~<name>, for example "@~~York Spit Light", then the tide report for the closest station with matching name is shown in the tide column for this waypoint. The most appropriate tidal station for each waypoint can thus be selected.
  • When entering a departure time the ETA, Expected Time of Arrival will be shown, instead of ETE, Expected Time En-route.
  • The individual waypoints "Description" field can contain the setting of planned speed specific just to the next route leg (e.g. "VMG=4.5;") and/or the specification of Estimated Time of Departure from this waypoint (e.g. " ETD=2/14/2011 12:00;"), allowing for planning extended stopovers. Time can be specified as UT, LMT or local zone time at the PC (default).


  • Make sure that you have read all about Automatic Daily tracks and track Highlighting in the Documentation on the Own Ship
  • The visibility of tracks is controlled by clicking the "eye" on each line. Tracks can be sorted by clicking the column headers.
  • Tracks are extended backward, based on the time-stamp sequence, a track is selected, which ends as the latest one before the start of current track. Tracks are extended as a single segment if they share the extending point. If they ha no common point a new "empty" segment, with no visible track, is added. Joining two tracks (i.e. extending a track) results in just track one remaining. It may look like two tracks but the Route Manager treats it as a single track.
  • "Merge Selected Tracks" is an alternative to "Extend Track", where tracks are joined. The difference is that Merged tracks are visibly joined by straight track-lines. Read on for instructions on merging tracks.
  • If you have ever hit the Track icon by mistake, or closed down OpenCPN in the middle of a passage, you know that it's very frustrating it is, to have a voyage split up in a number of different tracks that does not come together.
  • This can be fixed. Just select any number of tracks in the Track tab of the Route Manager window, right click the mouse to bring up the context menu, and choose to Merge Selected Tracks. The selected tracks will be merged in chronological order, with the track properties (name, color etc) of the resulting track keeping those of the earliest track in the selection.

  • "Copy as text" copies the track name, unless it's the default time stamp, and the track distance.

  • The result of clicking the merge button.

Reduce Track Data

  • Do you have have massive amounts of tracks and finds them bogging down OpenCPN? This feature is for you!
  • It is available from the context menu in the Track Manager. Right click on an existing track, and then click "Reduce Data..." .
  • Pick one of the options, it reduces the amount of points in an existing track while maintaining the specified maximum error between the original track and the reduced track. Testing on an old OpenCPN track or an imported track, with an error setting of 10 or 20 meters tracks, will, in many cases, reduce the size to less than half and one can't really see the difference.
  • Tracks made with the new intelligent dynamic tracking available in OpenCPN will not reduce much, unless a large error is tolerated.

Track Properties

The track properties dialog is similar to the route properties dialog above. There are some obvious differences as a track describes something that took place in the past and a route is planning for the future. Track properties also has an Advanced tab that works similar to the Extended Marks dialog.


  • Control the visibility of each waypoint by clicking the waypoint icon to the left on each line. Sort the waypoints by clicking the column headers.
  • New. Create a new waypoint. This brings up the waypoints properties dialog. The default position is set to the current position of "Own Ship".
  • Properties. All about the dialog in Extended Marks
  • Zoom to centers the chart display on the waypoint.
  • Go To. Makes an instant route from present position to the mark and activates the route. A similar instant route is created by right clicking and selecting "Go To Here" without first creating a mark. This instant route will be listed in the Route Tab.
  • Export Wpt and Send to GPS buttons behaves similar to corresponding buttons for Routes.
  • Delete All, does not delete any Man Over Board marks. All other marks are deleted.
  • Use the Shift key to mark multiple waypoints for deletion. This also work in the other Route manager tabs.

Go to Table Of Contents

Using Routes

To include existing waypoints in a route

How to use split and extend - an example.

Hm...a bit of a miss in the planning. An islet with a shallow bank extending southward on our route. We put two marks north of the obstruction and would like to include these in our route.

The waypoint west of the islet is #2. We mark this in "Route Properties", from the right-click menu. The Button "Split Route" is highlighted, meaning it is available to use. This is exactly what we want to do, so we click the button and split the route at wpt #2.

Right click at #2 and choose "Append Waypoint",

Move the cursor to the first triangle, and answer yes to "Use nearby waypoint?".
Then move the cursor to the second triangle , and answer yes to "Use nearby waypoint?".
Same thing for the original wpt to the east of the islet.

Click "Activate Route" to see that this extension worked.

Once again mark "Route Properties" in the right-click dialog. #3 is the last wpt in our "new" temporary route. The "Extend Route" button is highlighted, so we click it.

Open the Route Manager to view the result. Notice the naming of the routes. _B_plus is active. What remains is to delete route _B and to rename _B_plus to a suitable name, for example the name of your original route.

Deleting route _B.

And here is the finally adjusted route.

This was just an real life, it would be easier to just move the existing waypoints in the route, to avoid the Islet.

Go to Table Of Contents


  • Layers are one or more routes, tracks or waypoints that have been saved together in a gpx file. A layer is represented as a single gpx file. A layer is persistent and protected from changes. A waypoint in a gpx file for example, can be imported either as a "waypoint" or as a layer. The difference is that when imported as a layer it cannot be changed or deleted.

The Route Managers Layer Tab

  • Layers are useful for many things. It can for example be used to update charts with new navigation marks and dangers as per Notices to Mariners, and to add Radio Call-In Points or to build a database of lights and locations, that will be visible on chart regardless of current scale. See the first picture above, where French and UK forecast areas are good examples of Layers. In the second picture, a very good celestial fix, plotted with a gpx script has been saved as a layer.
  • More advanced uses could for example be an interactive cruising guide, using the possibility to embed links in waypoint descriptions.

When is a feature a part of a Layer?

  • Layers are immutable, nothing can be changed. This could make them confusing, unless you are aware of the fact that they are .... layers!
  • To see if a waypoint, route or track, is a part of a layer, right-click the object. If it is part of a layer, the context sensitive menu will say so. Alternatively, open properties and check the top of the dialog, if part of a layer, the layers name is printed. As always,double clicking on a object, directly brings up the properties dialog,

  • A route belonging to a layer is also identified as such, by just hovering with the cursor above the route.
  • A Route belonging to a layer also has the option "Activate". It can thus be used, but still, no changes can be made. A much more flexible option, would be to import the route layer file as a normal gpx file.

Handling Layers.

  • Layers can be created in OpenCPN, and saved as a gpx file, or be created offline, manually or by scripts, for example.
  • Layers that are saved in a directory called "layers", in the same place that holds your opencpn.ini(config) file, are automatically loaded on start of OpenCPN. These layers will be listed in the Route Managers Layers Tab on start up. The first time they will all be visible. Adjust visibility by clicking on the "eye" in the first column. This setting will be remembered. Have a look at the first picture on this page!
  • The easiest way to find this directory is to go to the - button in the ToolBar and look all the way down in the first tab (About).
    In Linux create the directory: /home/$USER/.opencpn/layers.
  • On Mac OS X, the location is "/Users/"user name"/Library/Preferences/Layers". Note that "library" is a hidden directory in "Lion".
  • Any subdirectories in the layers directory, are also loaded.
  • Layers worth keeping, could be kept in the mentioned "layers" directory and visibility during a session can be handled through "Hide from Chart" or "Show on Chart" buttons. New layers, gpx files, can easily be added in a subdirectory of it's own.
  • A few restrictions apply to layer marks. A layer mark cannot be used to set anchor-watch on. If right-click-selecting co-located objects, priority is given to non-layer objects.

The Route Managers Layer Tab.

  • Temporary layer: Any gpx file can be imported as a layer. This can be used for developing layers, or for import from a user defined directory with predefined layers, as necessary. Layers imported this way will be saved when closing down the computer, they are persistent. More permanent layers should be kept in the "layers" directory, as described above.
  • Delete: Unloads the layer, but doesn't of course touch the originally imported gpx file. A progress bar will appear when deleting large layers. It is not possible to stop the deletion, once started. For size restrictions, see below.
  • Hide from Chart or Show on Chart Controls if the marked layer is visible. The same thing can be achieved by clicking the "eye" to the left of the layers name. A red X across the eye marks a hidden layer. See picture above. These settings are persistent, they will be remembered after a restart.
  • Hide WPT Names Shows a visible layer without waypoint names. This helps to un-clutter layers, when zoomed out.
  • List contents or Delist Contents Listing is this context means showing the individual points in the layer as waypoints in the "Waypoints Tab"
  • Import GPX.. and Export All.. Warning these buttons has nothing to do with Layers. They work as if you are in an other tab. For import use "Import New Layers". For export, create layers as described above.
  • Export All Visible.. exports all visible layers, routes and waypoints to a gpx file. Use this button to create new layers, for example. Just save the gpxfile in the right place, described above. Note that "visible" in this context is the opposite to a layer, route or waypoint being "hidden". This means that objects not visible on the screen, may be included.
  • A progress bar will appear when exporting large layers. It is not possible to stop the deletion, once started. For size restrictions, see below.
  • If a layer includes extended marks, linked to pictures, for example, the pictures will not be exported, only the links to the pictures. To "export" the whole layer to another computer, copy all the pictures separately. Adjust all the links in the gpx file, to the new computer, by doing a "search and replace" in a text editor on the new computer.

Size Limits for the Layer feature.

  • OpenCPN is not suited to handle very large permanent layer files. Exporting and deleting such layers bogs down the program. With older hardware or limited available memory, even these recommendations may be to optimistic.
  • OpenCPN 4.0 has refined the track and layer logic to improve performance with large tracks. See next paragraph.
  • Newly developed static layers by shows that OpenCPN has problems with very large layers consisting of waypoints named after the depth at the position. With 10,000 + posistions it's necessary to consider some rules when using OpenCPN. If you disregard these rules, expect bad performance.
  • Deactivating OpenGL may improve the performance somewhat.
  • Always load the files as a temporary layer, zoomed in on your local area. Never load when zoomed out. Why? Zoomed out OpenCPN has to handle all wpts at the same time when zooming/panning. Zoomed in it just a handful of wpts at the same time.
  • An alternative is to load a file when zoomed in on an other area. This goes quick. Then promptly make the layer invisible. Only make the layer visible when zoomed in on the actual area.
  • Never zoom out with these files loaded, unless you make the layer invisible first. There is no point in this anyway as all you will see is a lot of black "smear".

More on creating layers and saving data.

Where to find ready made Layers?

Go to Table Of Contents

Great-circle Sailing

Very few cruising boats needs to use Great-circles, but it's certainly an important consideration for commercial vessels across the North Atlantic and North Pacific.
The advantage of a great circle is obvious, the shorter distance. The disadvantages, depending on latitude, could be quite a few. Colder weather, stronger winds, higher seas and perhaps even icebergs. The great circle is just one factor in the decision making, when planning a route, the weather is likely to be the deciding factor in most cases.

OpenCPN has a builtin Great-circle tool as well as a Great-circle plugin.

The built in Great-circle tool.
The "Measure" tool in the right-click menu and the "Create Route" button on the ToolBar switches seamlessly to a great circle mode when asked to do long distance tasks. This mainly happens when using these tools in some east-west direction and far away from the equator. The mode kicks in when the difference between the normal, rhumb line and the great circle becomes larger than two nautical miles. This will be some 0.2% to 0.5% of the total distance, depending on latitude and direction. When this happens a clear curve towards the pole will appear.

The Measure Tool

Testing the measure tool for Manila to San Francisco (approximately). For a good illustration to Great-circles, find a second point that is opposite the first, on the other side of the globe, and just move around slightly.

Once the first leg in measuring is done, it's plotted as a rhumb-line, to keep things simple. The active leg is still displayed as a Great-circle, if long enough. The distance displayed is the combined Great-circle distances.

The "Create Route" Tool

If you answer no to the above question, OpenCPN will use a traditional rhumb line for the leg. Answering yes, will kick the Great-circle option into action and a number of intermediary waypoint points will be created. There will be at least 3 waypoints. The exact number of waypoints is calculated by OpenCPN and is appropriate for most cases.

The created route is now available in the RouteManager dialog, as a normal route.

As a real example let us looka at a route from Mossel Baai South Africa, to the western entrance to Investigator Strait South Australia. The Rhumbline is 5660 mautilcal miles, and the Great-circle, as approximated by the created route is 5249 miles. The "real" Great-circle is som 15 miles shorter.

Composite Saling

Composite sailing is a Great-circle sailing with a maximum allowed latitude. OpenCPN has no such built option, but it's easy to create.
Above is the same route as before designed for composite sailing, not going further south than 45° S latitude. Start a route at Mossel Baai extend it until 45° S becomes a tangent to the visible Great-circle. End the route.

Do the same thing, starting with the destination and going backwards. Create a rhumbline route, using the two point along 45
° S. The three routes together is the composite route. The total distance of the composite route is 5293 Nautical Miles.

Route Plugin

"Salty Paws" route plugin handles much more than Great circles, introduced here.

The plugin has a few features not present in the built-in tool. It can calculate a composite route, and the distance between the waypoints can be set by the user. The end result, however, is a "gpx" file that is exported, and then imported into OpenCPN via the Route Manager.

A Great-circle from Cook Strait to Cape Horn limited by 60° S

Go to Table Of Contents


Users have the choice between using qtVlm or the Weather Routing Plugin.

It is recommended that you use the weather routing plugin as it is now stable and qtVlm is no longer free software (source code is not available)

Routing with an older version of qtVlm is described here.

OpenCPN can import optimized routes from the Free and OpenSource QtVlm program. Make yourself familiar with QtVlm if you intend to use it, as many things are done differently from OpenCPN.

QtVlm Documentation and Installation
QtVlm Thread on OpenCpn Cruiser's Forum
OpenCPN and QtVlm Summary of Route Transfer, see below

Before going any further, make sure you really understand grib files, what they are and their limitations. A good place to start is Franks Singletons pages.

Let's look at an example of importing an optimized route from QtVlm. It's a situation most of us try to avoid. Going across the Bay of Biscay with an active Atlantic Low just west of the British Isles.
The busy, time constrained, delivery skipper intend to find the best route from Lizard Point to Cape Finisterre. He has entered into QtVlm, the constraint, to route away from more than 30 kts headwinds. Below is the QtVlm optimized route based on the latest available grib file. Note that QtVlm doesn't know anything about tidal streams, currents local squalls nor about the state of the crew etc. These are more reasons why the final route always is the responsibility of the skipper.

Right-click on the route and export in the kml format.

Open OpenCPN. Right-click and "Paste Route"

This looks a bit ugly, and both the route and all waypoint have been exported.
We want something better!

One alternative is to let QtVlm (Edit Route) "Simplify" the route before copying.

Another alternative is to first use the "Paste Track" option.

*Note that this is no true track, it's just another way of exporting a route, possible due to the KML format. A track describes where we have been in the past, while routing is planning for the future. Importing the track gives a "light-weight" overview of the suggested route. Read more about the Grib Weather Plugin.

Next open OpenCPNs Route Manager Track Tab and press "Route from Track".

Much better. We now have a track with a route on top. Right-click and delete the track.
Next, it is smart to display the same gribfile, used by QtVlm, in OpenCPN, using the Grib Plugin.

All this looks impressive, but it's still based on a grib file. So it's still based on a computer prognosis, with no human input. All other reservations connected with gribs, still applies. An on board calibrated barometer is a good way to check what confidence can put on a grib forecast. Read more about the Grib Weather Plugin.
A reasonable polar diagram is essential as well. Producing one is standard procedure on racing boats, but not that common on cruising boats. Cruising specific factors, such as "comfort" also plays a part in a cruisers true performance capabilities.

Summary of Route transfer process.

Using OpenCPN and qtVlm in "Real Boat Mode"
QtVlm English Documentation and Download is here .

Copy Routes

OpenCPN to QtVlm

  • OpenCPN Right click on the route, pick "Copy as KML", Pick "KML with extended waypoint data (qtVlm)"
  • QtVlm Right click on the Ocean, pick "Paste a Route" or Hit "CTRL-V"

QtVlm to OpenCPN

  • QtVlm Right click on the route, pick "Copy Route xxx"
  • OpenCPN Right click on the Ocean, pick "Paste Route"

Copy Tracks

OpenCPN to QtVlm

  • OpenCPN Right click on the Track, pick "Copy as KML" Open Text Editor, Paste into new txt, save as .KML .
  • QtVlm Pick "Routes- Imports Routes - In Ortho mode - browse to the directory, Pick the *.kml file.
  • Note If all of the Track (now route) does not show up, current Grib data is not long enough.
  • Note: Route Manager "Route from Track" selection, then simply copy the route.
  • Note: Route Manager also provides Export Track as Gpx, however qtVlm does not support *.gpx format.

QtVlm to O

  • QtVlm There are no tracks in qtVlm, just copy the route.

Using GPS in OpenCPN and qtVLM at the same time

Linux only:
Connect to your Gps using GPSD in OpenCPN.
Then issue this command:
$gpspipe -r | socat - PTY,link=/tmp/gpsout,raw
Now use "/tmp/gpsout" as the serial port name in QtVlm.

Go to Table Of Contents

Planning Data

The examples shown on this page are all suitable for import as layers, as that will prevent any waypoint from being moved by mistake.

Need to see some offshore weather observations?

NOAAs NDBC site gives access to a lot of offshore observations from buoys and ships worldwide.
To easy visualize all this data the "ShipWxRep" script transform a limited set of all the available data into gpx waypoints. The format, as seen above is "wind direction, wind speed, time for observation, and air pressure". This can be helpful when evaluating the accuracy of grib files, even though the best tool in this respect probably is a calibrated digital barometer.

Plotting Miami Tropical Forecast Advisories.

If you only have access to low bandwidth Internet, this script is a way to quickly plot the contents of, for example an email, containing the forecast advisory. In any case, it is a good idea to have the forecast track of a tropical system available where you normally do your navigation and planning.

Download the gpx scripts here. The old great-circle script is included. For some help run each script without arguments.

Go to Table Of Contents

Ship Track

Toggling the track icon turns tracking on and off. When tracking is on, the button becomes slightly larger and darker (shown here). Tracking means that a record is kept of the vessels position as it proceeds. A trail is left behind the vessel.
Tracking is persistent. If you shut down OpenCPN with tracking active, tracking will be activated automatically next time you start. Note however that tracking on start up is delayed until a GPS position is available. This action avoids large nonsense jumps in the beginning of the new track.
The way the track is recorded can be set in Options -> Ships -> Ownship.
A full explanation is available in Own Ship

Recorded tracks can be imported, exported and managed using the Route & Mark Manager .
When right clicking on a track you can select Track Properties from the context menu, and a new dialog pops up. Normally it looks like this:

But if the track is a layer or part of a layer, you will see this instead:

A layer cannot be changed easily, and a lot of what follows does not apply to Layer Tracks. Read more about Layers.

The properties dialog can also be reached through the Route Manager. A record of all the track point will be listed. On the screen dump below the tracking precision is set to "Medium". The Waypoints, track points really, appears at irregular times, due to the smart tracking. Only trackpoints that contributes to the track are recorded. In other words, a change in the track occurs at every recorded trackpoint.
Click anywhere on a line in the list of track points, to mark the line and a blue square will mark the position on the track.

From the right click menu the Delete track option is available as well. To prevent mistakes a confirmation dialog pops up.
For more about Tracks read about the Route Managers Track Tab in Route & Mark Manager .

There ar many options for how a track will be shown and what time to use.
The Advanced tab, were you can document the track and include links, works similar to Extended Marks.

As a backup, a logbook entry is made every half hour in the OpenCPN log file. The format is similar to this:

14:30:00 CEST: LOGBOOK: 2011-06-28 12:30:00 UTC DR Lat 44.43657 Lon -65.17280

Go to Table Of Contents


Please Jump to the Getting Started page where Help is located.

About OpenCPN
Help with search
How can I find the OpenCPN.Log File ?
How can I find the Opencpn.ini File

Click on the link above.
Please do not put any content on this page. Put it on Getting Started

Man OverBoard

Man Over Board, MOB, can be handled manually, by pressing a button on the screen, or hit a shortcut key sequence.
Mob can also be handled automatically, or semi-automatically, provided that the crew is equipped with the right gear.

In any case ...receiving a signal from an AIS SART or PLB will always generate an on screen alert, and sound a warning if this is set up. Read more about AIS SART .

MOB activated manually.

Drop a Man Over Board Marker at your present position by pressing
* Man Over Board Button on the ToolBar. This button will always be furthest to the right among the buttons, for ease of finding.
or hit the Keys
*Ctrl + Space bar.

A mark, looking like the button is instantly created - the MOB mark.
The MOB mark will be called "MAN OVERBOARD at + time-stamp"

A temporary route, from a point 1 mile ahead on the current COG, and to the MOB mark is created and activated. On the screen, a course and bearing to the MOB mark will be displayed. This temporary triangular mark is labeled "1.0 NM along COG".

If COG, course over ground, is not available, no route is created but the MOB position is marked. This can happen if no GPS is connected, if the GPS signal is (temporary) unavailable or if the speed is so low that the GPS doesn't calculate COG.

The MOB mark is persistent
If OpenCPN is shut down OpenCPN by misstake, and you have to restart, the MOB mark will still be there.

To delete a MOB
The temporary route can be deleted, through the right-click menu, but no action of the user with the mouse or keyboard will move or delete the MOB mark, except for a right click -> Mark/Wpt Properties and select a different icon, and then delete the mark (ex mob mark) from the right click menu, or through the Route Manager. A MOB mark is not included in "Delete All" in the Toute Manager, to avoid mistakes. The mark has to be selected alone and then "Deleted".

Multiple MOB marks can be deployed, and multiple temporary routes will be created. The active route will always be associated with the last dropped MOB mark.

Be very careful when using this capability in waters with strong tide or current.
The person overboard will not be at the position of the MOB mark for long. Both Own Boat and the person in the water will move with the current, but OpenCPN knows nothing about this.

The MOB mark has just been dropped

Own Boat has moved on and the MOB mark is 0.22 miles in bearing 306 degrees.
One option in this situation is to drag the triangle to the Own Boats position.

A second MOB mark is dropped.

MOB activated automatically.

This works if each person onboard has a personal "AIS-SART" or "PLB(AIS)" and carry them at all times.
The transponder must also be activated, either manually by the MOB or automatically.
OpenCPN should be set to treat the MMSI of the crew devices as MOB events.
Do this by going to Options->Ships->MMSI Properties->New and enter the MMSI number of a device.

Mark "Always track" and "Handle this MMSI as SART/PLB(AIS) MOB", and press OK. Do the same thing for each AIS emergency device on board. They should now all appear in the list at the "MMSI Properties" tab.

Next set up Options->Ships->Ais Targets->"Play Sound on CPA/TCPA and DSC/SART emergencies" including "Select Alert Sound".

With this setup a MOB will generate an alarm and OpenCPN will start a MOB event as described above under "MOB activated manually".


An active SART or PLB(AIS) will generate an emergency alarm (if this is set up) and an on screen alert, even if the MMSI is not entered into OpenCPN as above. Read more about AIS SART .

Go to Table Of Contents

Night Navigation

Use the F6 key for dimming and SHIFT + F6 to reverse the dimming.
This is not connected to a chart feature, and dims the whole display, not just OpenCPN.
"CTRL + G" cycles through (monochromatic) green, red and normal screen. The color change applies to the whole screen as well.
"Ctrl + G" may not work on some Windows systems, depending upon the graphics driver implemented.

When pressing F6 the word "MAX" appears on the screen in the NW part. Press again and the screen gets a bit dimmer and "MAX" is replaced by a "9" and so on.

"Print Screen" refuses to catch the dimming!!

Mac OS X users can easily adjust the screen brightness with the F1 and F2 keys.

Change Color Scheme

This Button has 4 levels corresponding to standard US raster charts built in levels. You can cycle through the levels also by pressing the F5 key.
These represents the Default level, the Daylight level, the Dawn or Dusk level and finally the Night level. Often there is no difference between the Default level and the Daylight level.

The way this button works differs between different category of charts.

S57 Vector Charts and the CM93 ver2 charts.
All charts display the Dawn/Dusk and Night levels. This means that there is no change when the button is first pressed, but further pressing brings up a Dusk and then a Night palette.
US Raster Charts
These are generally coded with all the levels. The Daylight level has slightly sharper colors for better daylight viewing.
Other Raster Charts
Most other raster charts just contains a standard palette, and pressing the Button has no effect other than dimming part of OpenCPN, except for the chart display.
The Brazilian Raster Charts includes a dusk and night palette, but the colors displayed is not what one would expect.
Charts converted with the help of tiff2bsb or imgkap, normally only contains the default color scheme.

Go to Table Of Contents


Please select one of the followng Pages:

Install and Enable Plugins General Information about plugins.
Included Plugins in OpenCPN
Download Page to see ALL plugins that are regarded as stable.
Plugin Messaging between ODraw , Watchdog and Weather_routing.

Please do not put any content on this page (Other than the Authors).

Plugin Authors Credit

The diversity and range of the OpenCPN Plugins is quite remarkable. Users should appreciate the time these authors spent to create this resource. Plugins have been developed for some time now. There is a very healthy collaboration, so that at times it is truely impossible to determine "who's" plugin it is, and since this is one of the major strengths of Open Source we willl not attribute. However it should be noted that there are a number of authors who are quite prolific. As the authors come to mind they will be noted below. If you are one of the authors and your name does not appear, please advise.

Sean Depagnier, Dave Register, Jean Pierre Pitzef, Dave Cowell, Dirk Smits, Jon Gough, Mike Rossiter, Salty Paws, Transmitter Dan, Peter Tulp, Konni, Hakan, Wally Schulpen, Kees Verruijt, Douwe Fokkema, Deave Dellear
and there are more.

Many thanks to those who have helped the authors of these plugins.

Install and Enable

The core OpenCPN tries to keep features to a minimum so that it is lean, mean and easy to use. Features can still be added through the plugin infrastructure.

The release of OpenCPN 4.2 upgrades the user framework for Plugins to a newer version, which means it is not binary compatible with the previous releases and all Plugins for Windows and Linux must be rebuilt for compatibility.

These newly rebuilt plugins will not work with older versions of OpenCPN.

OpenCPN has four default plugins pre-installed:

Download Plugins

Many more plugins are available. See below.
Go to the dedicated page for downloading plugins: PlugIns
Currently there are about 20 different plugins available for download.
For a complete list of plugins read the recent posts in this forum thread

Plugin Versions

The release of OpenCPN 4.2 upgrades the user frameworks for Plugins to a newer version, which means it is not binary compatible with the previous releases and all Plugins for Windows and Linux must be rebuilt for compatibility. It is expected that this Plugin interface will remain stable for some time so Plugins will work across different (future) versions of OpenCPN.

Blacklisted Plugins

Plugins or versions of plugins known to be problematic can be Blacklisted.

A dialog pops up for 5 seconds when starting OpenCPN, if a blacklisted plugin is detected. This will happen even if the plugin is not enabled. A number of plugins are blacklisted. They are, mainly, old problematic versions of plugins. There is always a newer version of a blacklisted plugin, or, in worst case scenario, one will soon be released.

Installing a Plugin

For Linux, place the downloaded "" in {prefix}/lib/opencpn, which means /usr/lib/opencpn for a standard installation, using the provided packages. If you are compiling yourself {prefix} may be "/usr/local" instead of "/usr". Check "opencpn.log" if necessary.
For Windows the downloaded file is usually an executable ".exe" installation file. Click on the file and follow the instructions. If the file is a "_.dll" place the downloaded "pluginxx.dll" in a "plugins" sub folder of your OpenCPN installation folder. A common location is C:\Program Files\OpenCPN\plugins.
Once the plugin is in the right directory, restart OpenCPN and proceed to enabling the plugin.
For Mac the plugin will come as a pkg file. Double-click the pkg file and follow the install instructions.
This will place the plugin files in the proper locations.

Enabling a Plugin

Plugins are made available by clicking on the plugin in the Options->Plugins Tab. Once this is done, an "Enable" button appears. Pressing this button activates the plugin icon in the ToolBar and changes the the default "grayed out" text to black in the list. Not all plugins have an icon when active. For most plugins there is a "Preferences" Button for configuration.
When a plugin is disabled in the Options->Plugin tab, the plugin Icon disappears from the ToolBar.
The Plugin Icon works as a toggle switch for the plugin. Pressing the Grib Icon, for example, activates the Grib plugin. Pressing one more time, kills it.
The WMM Icon uses a new feature, by displaying the magnetic variation, at the position of OwnShip in the button itself.

Re-Enable a Plugin after a Plugin Update

Version 4.2 has implemented automatic reload of updated PlugIns by visiting the Options > Plugins screen.
Presumably the plugins are rescanned and loaded.
Previously, after a plugin was Disabled, the program had to be shut down and reopened for the full change of Opencpn status to occur. This is no longer necessary, simply go to the Option>Plugiins screen and all plugins will be reloaded.

Problems with Plugins

If you run into problems with plugins, first check what the opencpn.log file say.
For each plugin you will find lines similar to:

08:59:25 CEST: PlugInManager searching for PlugIns in location /usr/lib/opencpn
08:59:25 CEST: PlugInManager: Loading PlugIn: /usr/lib/opencpn/
08:59:25 CEST: /usr/lib/opencpn/
API Version detected: 110
PlugIn Version detected: 101

This example is from Linux.

On Windows systems the location of the log file will be displayed when you click "Help" (the ? mark icon) on the toolbar. Alternatively, to find the "opencpn.log" on your system read

OpenCPN Installation

Go to Table Of Contents

Install Linux Plugins

After releasing OpenCPN 4.0, the plugins are being migrated to the official OpenCPN PPA repository.

Ubuntu / Debian

To configure the your system to use the official repository, follow the instructions at Ubuntu PPA

After adding the repository, you can use the Software Center to install the OpenCPN plugins as any other software package or use the command line tools
sudo apt-get update
sudo apt-get install opencpn-plugin-<PLUGIN_NAME>

where <PLUGIN_NAME> is the name of the plugin, for example to install the WMM plugin, the complete commad will be:
sudo apt-get install opencpn-plugin-wmm

Note for the users who previously installed the plugin packages manually

Unfortunately, the new packages conflict with the plugins downloaded originally from To resolve the conflict, either uninstall the plugin before using the version from the PPA or open the Terminal and use the following command to install a plugin:

sudo apt-get -o Dpkg::Options::="--force-overwrite" install opencpn-plugin-<PLUGIN_NAME>

where <PLUGIN_NAME> is the name of the plugin, for example to install the WMM plugin, the complete commad will be:

sudo apt-get -o Dpkg::Options::="--force-overwrite" install www-plugin-wmm

Fedora / CentOS

yum install opencpn-plugin-<PLUGIN_NAME>

Plugin Messaging

Between ODraw, Watchdog and Weather_routing.

OpenCPn Draw and Watchdog

User aspects

First of all, we should see OD and WD as separate plugins. In OD you can draw geo-referenced objects (lines, points, straight lined areas and circles). WD knows when and how to sound alarms.

In OD, a graphical indication (crosshatching or shading) may be added to areas, to indicate whether these are intended to avoid (crosshatched inside) or to stay within (crosshatched outside), or whatever other meaning you want to give to those graphical indications.

In WD you can select whether (certain types of) alarms should react only for areas that are flagged (in OD) as to avoid or to stay within, or for all areas. On top of that, in WD you can indicate whether this should be done only for areas labeled in OD as active, or inactive, or both.

The WD Boundary Alarm has 4 different types:
  1. Alarm when approaching an area from outside (based on distance);
  2. Alarm when approaching an area from outside (based on time);
  3. Alarm to indicate whether your boat is inside or outside an area (Inclusion Alarm, another type of anchor alarm);
  4. Alarm to indicate whether AIS objects are present in an area.
For the first two alarms the WD uses the same terms for the boundary that OD does as well as allowing a check for the state of the boundary. The third alarm only looks at a specific boundary which is identified by the boundaries GUID. The fourth alarm specifies a boundary to check if an AIS target is inside it.

Beside the 4 types of Boundary Alarms mentioned above, WD has the following alarm functionality:
  1. Alarm when approaching coastlines (Landfall Alarm; 2 types: time and distance)
  2. Alarm when NMEA-data stream stops (NMEA Alarm)
  3. Deadman Alarm
  4. Alarm when distance to reference position exceeds a set value (Anchor Alarm)
  5. Alarm when course over ground deviates more than set (Course Alarm; 3 types: only port deviation, only starboard deviation or a general deviation);
  6. Alarms when speed deviates more then set (Speed Alarm; two types: overspeed for more than set maximum, and underspeed for less than set minimum).
In total there are 14 different types of alarms.

Technical aspects

WD and OD are independent plugins. OD knows about drawing geo-referenced objects, WD knows how to sound alarms. Now the two can work together by passing and receiving messages, in this case JSON messages (basically a text string of elements and values).

For the alarms, when WD needs boundary information, WD asks OD, via a message, whether a Lat/Lon is inside a boundary. WD can add further requirements asking for boundaries in a particular state and a particular type. Both the state and type are the same as what OD uses, i.e. Active/Inactive and Exclusion/Inclusion/Neither, or the inclusive 'Any' (meaning any type and/or any state, not being as selective).

In OD the boundaries checked are both an OD Boundary and an OD Boundary Point with range rings showing. Boundaries and Boundary Point Range Rings are both considered boundaries. The type of boundary applies to both, but the state (active/inactive) currently only applies to Boundaries, not Boundary Points. This is because there is currently no state for a Boundary Point. This may change in future updates to the plugins for consistency.

When OD completes its check of Lat/Lon inside boundaries it replies with a single message containing the first boundary that the Lat/Lon is inside AND which matches the type and state requested. The response message contains the Name, Description, GUID, Type and State of the boundary found.

WD uses the returned message to decide whether to sound the alarm and uses some of the information in the messages that are then displayed to the user, i.e. a change in text in the watchdog window and a message box, if requested.

Messaging in OCPN is synchronous, broadcast such that every plugin that registers for messages and the main program, OpenCPN, will receive every message sent. All processing of messages is synchronous, i.e. each plugin has to process each message completely and return to OCPN (the controller) before the next plugin can process the message. For the WD/OD message stream WD sends a message to OD, OD processes the message and sends a response message to WD, WD mainline processes the response message and stores the information, then returns control to OD which then returns control to WD at the point that WD created the first message. Now WD can process the saved information from OD, and the controller, OpenCPN can process the next message.

OD messages can be used by any plugin and OCPN itself to obtain information. For the OD messaging there is a “structure” for the content of the message, specifying the source requester, the type of message (Request/Response), the message i.e. FindPointInAnyBoundary, the message id (may contain an identifier for the source requester) and then the message contents, i.e. Lat, Lon, Type, etc.

So a request looks like:

  • Source: "WATCHDOG_PI"
    Type: "Request"
    Msg: "FindPointInAnyBoundary"
    MsgId: "distance"
    lat: 54.0001
    lon: -30.1001
    BoundaryType: "Exclusion"
    BoundaryState: "Active"
This message is then given a 'destination', in this case "OCPN_DRAW_PI", when the call to the OCPN messaging process is made.

The response will look like:

  • Source: "OCPN_DRAW_PI"
    Type: "Response"
    Msg: "FindPointInAnyBoundary"
    MsgId: "distance"
    GUID: "62ec7520-b58f-4087-b077-ae1c581dfec1"
    lat: 54.0001
    lon: -30.1001
    Name: "Rocks"
    Description: "Good fishing"
    Found: false
    BoundaryObjectType: "Boundary"
    BoundaryType: "Exclusion"

This message is then given a “destination'” of the originator, in the case above "WATCHDOG_PI", when the call to the OCPN messaging process is made.
The “destination” is used so that each recipient of the broadcast message can easily check if the message is meant for it. There is no filtering provided by OCPN messaging on this value.

Using this construct there are validation checks to make sure messages are valid to process. If they are not valid there will be error messages entered into the opencpn.log file with relevant information.

Currently this message construct is used by OD, WD, WR and the AIS processing in OCPN when it broadcasts AIS information to OCPN and the plugins. In some cases there is no response message expected, i.e. AIS just sends messages, but in others the response is important.

OD is not concerned where the message came from or why, it will just respond to message requests with what is found from inspection of OD objects. WD just wants to know if it should sound an alarm or not, so it sends message requests to OD to determine certain conditions. WR just wants to know if the current Lat/Lon is valid for further processing or not, so it sends message requests to OD to determine certain conditions. AIS just provides information on each target it is dealing with.

Now the check frequency in the WD alarm screen determines how often to check for a Lat/Lon being in a boundary. One other item which should be mentioned, is that for each boundary check based on time there are up to 11 Lat/Lon messages sent to OD, for each distance check there are up to 163 Lat/Lon messages to OD. Therefore the amount of this message traffic is something to watch.
Please note that a JSON message does not have a “structure” per se, the message consists of element/value pairs written as delimited strings. The elements can occur in any order. So “structure” in the sense used in this document really refers to required elements.

Included Plugins

These are the Plugins included with the standard download.

Install and Enable Plugins
General Information about plugins.

Plugins included in OpenCPN

Dashboard Plugin
Plugin to display navigation data. Included in the OpenCPN installation.

Grib Weather Plugin.
Plugin to display Grib weather data files. Included in the OpenCPN installation.

WMM Plugin
A plugin to display the magnetic variation, based on the World Magnetic Model.

Chart Downloader
Manager for chart downloads.


The Dashboard plugin is able to show quite a few instruments.
The Dashboard plugin is always distributed with OpenCPN, no separate download is required.

If the data is available to OpenCPN in the NMEA0183 data stream the different instruments will display relevant data; but the plugin don't tell what is available. It is assumed that the user know what is connected. It is of course possible to activate all instruments and see what works.

The Dashboard in action, two Dashboards, one vertical and one horizontal.
Grab the top Caption bar with the cursor and drag the Dashboard as far as possible to the right or left. Let go the cursor, and the Dashboard will dock, the chart display will adjust, no part of the chart will be hidden. Horizontal Dashboards can in a similar way be docked top or bottom.
This process is reversible. Just grab the Dashboard dialog bar with the cursor, an pull towards the middle of the screen, and the Dashboard will become floating.

The same Dashboards docked left and bottom.

There is a grab handle in the SE corner of each Dashboard. Use it to resize each dialog.
The graphics will change size, but not the text, which is handled separately. See further down.

The Dashboard Tab

Once the Dashboard plugin is activated in the plugin tab, the Dashboard Icon will be available in the ToolBar and will work as an on/off toggle. The Preference button works exactly the same as described under "Dashboard Settings" below.

The "Enable" Button activates the plugin and shows the icon in the ToolBar.
Once enabled, the "Disable" Button is displayed, as show above.
If you press the "Preference" Button the Dashboard preferences dialog becomes available.

Dashboard settings

Right click anywhere in a Dashboard and a few options are displayed, in a small dialog.
Above we have clicked on the vertical Dashboard. Make this Dashboard horizontal by clicking the "Horizontal" radio button. Stop displaying it by un-ticking the box in front of the first "Dashboard" line. Get it back by right clicking on the other Dashboard and tick the same box again.


The Dashboard Tab

The Icons in the narrow pane to the left, represents the available instances. Click on an instance and the configured instruments shows in the "Instruments" pane.

"+" and "-" Add or delete a Dashboard instance. Note, that an active Dashboard can not be deleted as the "-" will be grayed out. Configure a new instance by "Add"-ing instruments in the "Instrument" pane.

Show this Dashboard If ticked just that Dashboard is shown. Toggling the icon displays all Dashboards.

Caption changes the name of the DashBoard from the default "Dashboard" to the Caption value.
Due to a wxWidgets bug, this change is not instant, and requires docking the Dashboard or restarting OpenCPN, to work.

Orientation A dash board can be either Vertical or Horizontal.
Vertical can be docked left or right, Horizontal can be docked top or bottom.

The "Instruments" pane. Shows the Instruments that are "active", that will show up in that particular Dashboard .The instruments are selected with the buttons to the right.

Add. This button brings up the "Add Instrument" dialog where the available instruments can be highlighted and added to the Instruments Window.

The available 40 instruments are:

Position (text)
SOG (text) -Speed Over Ground
Speedometer (dial)
COG(text) - Course Over Ground
GPS Compass(dial)
STW(text) Speed Through Water
True HDG(text) Heading
Apparent WindAngle & Speed(dial)
App. Wind speed(text)
App. Wind speed(dial)
True Wind Angle & Speed(dial)
Water Temp(text)
VMG(text)- Velocity Made Good to a waypoint.
Rudder Angle(text)
Rudder Angle(dial)
GPS in view(text)- the number of satellites detected*
GPS status(dial)**
Cursor, shows the position of the cursor.
Clock, showing UTC from the NMEA stream, in most cases this is the gps time.
Moon phase
Air Temp
App. Wind angle
True Wind angle
True Wind direction
True Wind Speed
True Wind Direction and speed
Magnetic Hdg
True Compass
Wind History
Trip Log
Sum Log
Barometric Pressure (dial)
Barometric Pressure (text)
Barometric History
From Ownship. Shows the vector from Ownship to the cursor.
Magnetic COG

*The DPT sentence is used, and transducer offset will be added to depth value, if available.
**Linux note: GPS satellite info is not available if using gpsd.
The same informations is however available through the "xgps" command.
Delete. Highlight an entry in the Instrument Window to delete it.

Up / Down. Highlight an entry in the Instrument Window and change the order between the selected instruments.
This order will also be the order between the instruments in the Dashboard dialog.

The Appearance Tab

Dashboard Preferences Appearances

Use this tab to set fonts.

Dampen SOG and COG (IR Filter)
There are 2 parameters in the Dashboard-> Preferences-> Appearance dialog for damping of SOG and COG.
A value of 1 means no filtering. Higher values mean ever slower response of the instrument.
The max filter value is 100 which is pretty slow. This filter works almost exactly like a mechanical filter that uses an oil damped indicator dial. It will respond gradually to a change in course or speed. A typical filter value of 10 seems to work pretty well.

Units Selection
Select these parameters as suits your use. These controls together enables the user to adjust the view of the dashboard to suit individual needs.

Units Ranges and Formats
Set the units to use, and the range of the speed dial.

Wind History

The Wind History Instrument needs some further explanations.

The "wind history" instrument is meant to be run as a standalone (vertical) instrument.
Just define a separate dashboard and add it as the only instrument.

You can resize the Instrument it with the mouse.

In real conditions, it monitors around 40 min of wind direction (red), as well as wind speed (blue), showing a vertical time line every 5 min (the example screen shot is a full-speed VDR replay).

The text on the top shows the current values, as it is displayed in the standard instruments (blue = wind speed data, TWS=True Wind Speed, red = direction, TWD = True Wind Direction).

Here is an explanation of the text line, left side (see screen shot):
TWS 7.5 : true Wind Speed currently 7.5 kts
Max 22.3 kts since 18:50 : this is the max Wind speed in the visible graphs, i.e. the last ~40 mins
Overall 22.3 : the max wind speed since OpenCPN was started.

Right side above :
TWD 357° : True wind direction currently 357°

The thin red/blue curves are the real direction/speed values, the thicker curves are smoothed values. Makes it easier to see trends.

There is some logic included :
The instruments re-zoomes automatically as much as possible, always trying to show the whole visible curve;
Wind speed curve:
if your max (visible) wind speed is 10 kts, then your scale is from 0...11 kts (rounded upwards to the next full knot).
In the screen shot we had a mx of 22.3kts --> scale is 0...23 kts.
Wind direction :
The instrument scale shows +/- 90° of the currently visible data values, but is limited to a total of 360°.
If the wind is shifting through North (from 350, 355, 359, 002, 010, ...) we're shifting the curve as well, meaning that there is NO vertical jump in the data from 360° --> 0°, and we do NOT loose all the continuity in the smoothed curves !

If you should happen to have more than a full 360° cycle of wind direction in the recorded data (if you sail through a couple of dust devils ), I limited the max scale to 360°, meaning that the curve will run out of the visible area on bottom or on top of the instrument.

Please note that you don't have to have the instrument "open" all the time.
Once activated as initially described, you can close it, and simply reopen it on demand. You don't loose the curves, the instrument continues to collect the data.
To make it visible again simply right click on an existing standard-dashboard, and click the "Wind History" Dashboard.

Night time Mode

In Windows, Night, F5, mode. The title bar on the floating dashboard window is a bit glaring (this mode is controled by windows by way of a theme and is not possible to change from an application) . Dock the Dashboard into "docked mode" it will be less glaring. The best solution is to simply "dock" the dashboard window at night, either left or right. This brings the window decorations back under OCPN control, and we recently added logic to dim it in this mode.

Go to Table Of Contents


The "World Magnetic Model PlugIn for OpenCPN" implements the NOAA World Magnetic Model.
More information:

The bundled WMM2010 model expires on December 31, 2014.
After then, if a new version of the plugin is not released in time, you will have to get a new WMM.COF from NOAA and place it in the location you can find in the OpenCPN logfile.

A Quick-Start Guide.

This plugin is all about the value of the magnetic variation. The value at your boat position, at the position of the cursor, and the rest of the world.

Download and install the plugin. Go to Options-->Plugins. Press the "Enable" button.

Then press the Preference button, and copy the settings below.

Press OK twice.
The WMM icon will now be found in your ToolBar. The numbers in the button is the variation at your position.

Press the Toolbar Button and the small dialog below will appear on the screen.
The first value is the same as in the button, the variation at your boat (gps) position.
The second value is the variation at the position of the cursor.

That is all you need to know to get started, and for most of your daily use.
Need more details? Read on!

The Details

World Magnetic Model Plotting allows users to cross reference the magnetic deviation values printed on many raster charts.
Variation is the angle between true and magnetic north.
Inclination is the vertical angle of the magnetic field.
A compass is adjusted for the inclination in the intended sales region.
If you buy a compass in Europe; it will not be level in Australia, for example.
Field Strength is the magnetic field in nano tesla from 20000 to 66000.
Currently the total field strength is shown, with no immediate practical use. Hopefully this will change to show the horizontal component in the future, that has an impact on whether the compass works or not, near the magnetical poles.

The plotted lines are similar to a topographic map. The space between them can be adjusted; more space takes less time to calculate.

The Step size and Pole accuracy sliders allow a trade off for speed vs computation time.

With the extended Radio-button, this dialog will show on the screen

F - Total Intensity of the geomagnetic field
H - Horizontal Intensity of the geomagnetic field
X - North Component of the geomagnetic field
Y - East Component of the geomagnetic field
Z - Vertical Component of the geomagnetic field
I (DIP) - Geomagnetic Inclination
D (DEC) - Geomagnetic Declination (Magnetic Variation)
Click "Settings" and adjust the display of the graphical plot.

Show variation only.

Or all options together.


Grib Weather

OpenCPN has a grib weather file viewer plugin, aimed at being useful while under way.
The grib plugin is always distributed with OpenCPN, no separate download is required.

What is a grib file?

  • If you are not familiar with grib weather files, make sure you understand the basics, before you start to use them. It is essential to understand the limitations of weather forecasts that are distributed in the grib format. It is also worth pointing out that gribs are not reliable near tropical systems. Send a blank mail to Read the mail you get back carefully.
  • To get started with gribs and to find sources for downloads, check Franks-Weather.
  • A very good, up to date book, is "Modern Marine Weather, second edition" by David Burch, with a thorough treatment of the subject.
  • A few files including lectures on tropical weather and gribs are available here.

Get started

  • To display grib files as an overlay on your normal charts you have to first activate the grib icon
  • Go to find the plugin tab. Click on the Grib plugin, then the "Enable" button. The "Preferences" Button brings up a small dialog. The settings in this dialog rarely needs changing after the initial setup.

Grib Preference

  • Use High Definition Graphics. The setting only concerns the barbed wind arrows.Tick the "Use High Definition Graphics" box, unless you are on old hardware. Not ticking the "High Definition Graphics" box can help to speed up the grib display, in such cases.
  • Use Gradual Colors. This setting applies to all colored overlay maps. On many installations the difference in rendering is very small. The overlay maps built in color variation plays a part.
  • Copy First Cumulative Missing Record. This is about rainfall and cloud cover records .
As these records are "cumulative" , the first one does not exist in files from zyGrib and Saildocs. With this parameter unchecked, there will be neither rainfall and nor cloud cover displayed for the first date/time of the file. Ticking the box fixes the problem.
  • Copy Missing Wave Records. This only concerns wave records from zyGrib delivers files from two models ; FNMOC (WW3-...) for waves and GFS for all other parameters. These two forecast models does not have the same time spacing. For some dates/times, the wave data do not exist.This parameter allows this missing data to be reconstructed and avoiding the overlay (if set) to flicker.

Load File Options

  • Load the More Recent File in Directory. Loads the newest file in the grib directory on start.
  • Load the Last Open File. Loads the grib file used last time.

Start options

  • Start at the first forecast in GRIB file
  • Start at the nearest forecast to current time
  • Authorize interpolation to start at current time.

Time Options

  • Local Time
  • UTC

The Grib Display Controls

The Standard Display Control

To start the Grib plugin press the button in the tool-bar. The "GRIB Display Control" then pops up.

Hide Data at Cursor

This is a smart and compact dialog. For a quick start press the "Open File" button and navigate to your grib file directory and press the file to be displayed.
  • Previous/Next Go to the previous or the next record in the gribfile. This corresponds to the time "interval" chosen when the grib file was downloaded.
  • Data valid at The time of validity for all grib data on screen.
  • Open Grib file The name of the grib file in use.
  • Now Displays the record, nearest in time to "now" according to the Start option you have selected: ("Start at the nearest forecast to current time" or "Authorize interpolation to start at current time").
  • Select Geopotential Height If grib data for geopotential height is available, selection will be between Std, 500.
  • Zoom to Center This button will home in on the loaded area that the loaded grib file covers.
  • Play Goes through all records in turn, with the animation speed controlled in the "Grib Settings" dialog.
  • Hide Cursor Data Hides Grib which normally appears in the data windows. Data windows are hidden.
  • Progress Slider Just to the right of the "Play" button is a slider that is just another way of going through the grip records.
  • Open File Activates the operating systems standard file selector dialog to select a grib file. The plugin remembers the directory of this grib. This is used next time you start OpenCPN and activates the Grib plugin. See settings in the "Grib Preferences" dialog above.
  • Settings is where to control how the different grib data will be displayed. See more below.
  • Request Download grib files via email. More below.
  • GRIB Data at Cursor. This is where the "smart" part kicks in. Only entries for the data contained in the active grib file will be displayed. For example, if there is no wave data in the current grib file, there will be no signs of wave data at all. In the case above, where the the wave data is N/A, the grib file includes wave data, but not for the area where the cursor is. Compare with the picture below, where the grib only contains current data. The tick boxes next to each data entry, are used to activate the data-display on the screen. Exactly what will be shown is controlled in the "Grib Settings" dialog, which is reached by pressing the "Settings" button. Don't activate to many display features at the same time. The display quickly becomes very cluttered.

The "GRIB Display Control" loaded with a grib file only containing current data.
  • Advanced GRIB Data at Cursor. The display options for all the data shown, can be reached by right.clicking on the little squares where the "ticks" are shown. For the meaning of all these options, read on.

Right-clicking the "Air Temp" option square.

The Advanced Display Control

The plugin has an advanced mode were altitude data can be displayed. This mode requires some more knowledge than plain gribs. A good start is to read "Mariner’s Guide to the 500 – Millibar Chart".
If a grib file includes altitude data, the control will automatically include more options. See below.

If the dialog looks normal except for an extra selection box under "GRIB Data at Cursor", like this,

then the grib file contains altitude data. Selecting one of the altitudes, for example 500, changes the dialog to what you see above. The advanced data are displayed against a yellow background.
Wind. These are the wind data valid for the selected altitude level.
Grib Data at 500 hPa. The values at the selected level.

Weather Tables

Once a grib file is loaded in the current session, the "Weather table" appears in the right click menu.

Click the entry, and a Weather Table, valid at the cursor point, pops up. All available data in the current grib file, for the whole time span, are shown.


...controls how the grib files are displayed on the screen, and units used in the Grib Display control. Thing like Overlay colors, animation time interval and speed and much more.
The basic dialog looks like this.

Typical DATA TAB

Note the Fixed or Minimum Spacing (pixels) selection. This is a typical setting.

Typical GUI TAB



The Loop Mode controls what happens when "Play" is pressed in the Grib Display Control.
  • Loop Mode. Sets the "Play" function into a loop mode. Otherwise, playback will stop when reaching the end of the file.
  • Loop Start. Were to start the loop. The option "Current time forecast" makes sure that only data now or in the future are shown
  • Updates per Second. Controls the speed of "play".
  • Loop Start. The loop can start either at the start of the grib file or from the current time forecast.
  • Interpolate between gribs. If you select this option, you will be able to choose your own time interval, but you have to consider that it can decrease data accuracy. To remind you, this info will pop up.
  • Time Interval. This is the time interval used for interpolation. The entry is only visible if "Interpolate between gribs" is ticked. This is connected tho the chosen time interval when requesting a grib file.


The lower part of the Grib Settings Dialog, under the Display heading is really 10 different controls. The controls are activated by the choosing one of the items in the selection menu below.

Many of the entries are repeated, so let's first have a closer look at the the most important one, the Wind. Entries on the same line are connected.

  • Units refers to the choice of units for the selected record.
For wind speed the choices are.

  • Barbed Arrows. Display the traditional barbed arrows, showing wind direction and wind speed. Range refers to the distance between displayed arrows ( not working 3.3.1117). Default Color / Controlled Colors Default is dark brown while "Controled" varies from blue for very light winds to red for very strong winds
  • Always visible This option only exists for "Wind" and "Pressure". When ticked the object is shown regardless of what is ticked in the "Settings Control". The idea is to be able to Show wind and/or pressure at the same time as other options. Use with Rainfall, for example, to help identifying fronts.
  • Display Isotachs shows contour lines connecting points with the same wind speed. Spacing controls which wind speed Isotachs will be shown. Use knots for units and 10 for spacing and isotach contours will be shown at 10 kts, 20kts and so on.
  • OverlayMap Depending on your system capability,if you use "Accelerated Graphics (OpenGL)" (see General Options/Display/Advanced ), the overlay will be visible at all scales. But if you don't, the overlay will only be visible at small scales. A small yellow pop up at the bottom left of the screen will inform you. Zoom out to a scale of 1:13 millions, or smaller to see them.
  • Colors is another selection menu containing pre-set color schemes. The idea is to use the scheme with the same name as the control, but this is just a hint, nothing more.

  • Numbers shows the wind speed in small square boxes. Minimum Spacing refers to the spacing between these boxes.
  • Particle Map is a kind of animation of the wind field. It is created by letting "particles", or dots, move in the wind direction and leave a trail. The trail is colored after the wind strength, and each particle has a limited "life span". The Density slider creates particle trails that are shorter but closer together with increased value, which is the same as further to the right. The particle Map below clearly shows a convergence zone with stronger winds (red). This is probably a cold front. Performance Warning: Note that high density Particle Maps on Low Powered Machines and Large Files may slow your machine to a crawl. First test on small files.

  • Overlay Transparency works as expected.

All the controls for Wind Gust, Rainfall and Cloud Cover, have similar entries; only the units differs.

The pressure display has no overlays, only the options of isobars and numbers.
Overlay Transparency is redundant.

Waves and Current have a more or less similar display. A Particle Map is available for currents. See the ddescripion above for wind Particle Maps. Once again different units.
There is a choice between three different display arrows shown in two sizes.
If wave height, direction and wave period is present in the grib file it will be displayed in the Display Control like this:

Air Temperature and Sea Temperature looks the same.

Convective Available Potential Energy (CAPE) has these settings

Altitude and Relative Humidity have a simple one choice entry.

The new Grib-file Request Button

  • Grib files can be requested directly from the plugin. The request is in the form of an email to SailDocs or ZyGrib. The requested grib file is also delivered via email.
  • The area for which data is requested defaults to the area visible on the screen, but the request area can be selected by other means as well. More below.
  • It's possible to request gribs from 4 different Grib prediction models when using Saildocs GFS, COAMPS, RTOFS and indirectly WW3. When you request "Waves" in GFS, Saildocs merge wavedata from WW3 into the delivered grib.
  • The ZyGrib option can only deliver GFS gribs, which is the "standard" model for gribs.
  • RTOFS gribs only contains current and water temperature data.
  • COAMPS delivers wind and pressure with a higher resolution than GFS
  • The minimum time between grib records are 3h for GFS and 6h for COAMPS & RTOFS.
  • GFS can be requested for 8 days ahead. An extended GFS request up to 16 days ahead is possible. This warning will pop up.

  • The same value for COAMPS is 3 days and RTOFS 6 days.

There are two layouts of this dialog, depending on wether it is a request to SaiDocs or to ZyGrib. Some alternatives are only available from SailDocs, and some are only available from zyGrib. Alternatives not available are grayed out.

The SailDoc Request looks like this.

Compose the request by picking parameters and data. Not all data are available for all choices of parameters. For example, in the picture above "Wind Gusts" and "Current" are grayed out, as the are not available with GFS from SailDocs.

When selecting "Moving Grib" the dialog expands and makes i possible to choose a speed and course. The selected grib forecast area will move, using these values, for each grib interval. The idea behind this is to minimize the download while still covering a longer passage.
Moving grib files are incompatible with interpolation, so if a "moving file" is detected a warning is displayed. Interpolation, if set is deactivated, but only for moving file, the settings as such, are not modified.

Resolution The choices are 0.5, 1.0 or 2.0. A recent upgrade to gribs makes it possible to download even 0.25° resolution. This is not yet an alternative in the plugin and requires editing the email manually before sending. In the picture above ...|0.5,0.5|... should instead look like ...|0.25,0.25|...

The default geographical coverage of the requested grib file is the area you can see on the screen. A manual Selection Mode is also available.
When the Area Selection -> Manual Selection box is ticked the dialog expands

Choose the limiting Latitude and Longitude for the grib-file manually or press "Start graphic Sel." button.

Press the left mouse-button and draw a rectangle around the required area.

When selecting "Pressure Altitude" and the GFS forecast model, the dialog expands and makes i possible to choose forecasts for different altitude levels. The SailDocs dialog only supports the 500 mb altitude, while zyGrib suports all options.
When you are ready press "Send".
This message will show in the "Mail" window instead of the "send" request:
Your request is ready. An email is prepared in your email environment.
You have just to verify and send it...
Save or Cancel to finish...or Continue...
As stated, a mail is composed for you and ready to send with your normal mailing program.
This is the standard way of getting a new grib in Windows and Linux. (Mac ??)

There is an advanced alternative for Mac OSX, Linux (and BSD). Install and configure a mail server. Instructions on the Mail Servers page. This will enable automatic transmission of a grib request to SailDocs.
After installing and configuring a mail server, there is one more step.
Open "opencpn.conf" and ad the line below. As always, do not run OpenCPN when editing opencpn.conf.
Setting "SendMailMethod" to "0" restores the default.
To get a grib, just press "send", and wait for a return mail.

The zyGrib Request looks like this.

Load two Grib Files Concurrently: Combine Saildocs wind + Current file

(Note: Only applies to OpenCPN v4.2.x and forward)
Using Windows, Click on the 'Open a File' to browse grib file. Highlight two grib files (Ctrl and pick the two files with a mouse left click.) The pick Open and the two grib files will be opened. Both grib files will be used by Weather_routing.

More to know

  • ZyGrib is a free and open-source software (FOSS) dedicated grib viewer. Grib files can be downloaded by ZyGrib and then opened in OpenCPN.
  • QtVlm a FOSS weather routing program, combines a grib file with boat polar data, and produces an optimized route. More here Weather-Routing or the Weather Routing Plugin. These are very good tools to use in routing decisions, but has the same limitations as all grib-data.
Go to Table Of Contents

Mail Servers


This is an Advanced subject, that is not necessary for running the grib plugin.
Do not try these setups unless you are familiar with your operating system, comfortable with handling the command line interface and editing configuration files.
Do not expect these instructions to work without some customization.

This page contains detailed instructions on how to set up mailservers to automatically send grib request mails to Sail Docs.
"Ptizef" has compiled the instructions for Windows (XP or XP)/Thunderbird
"Ptizef" has compiled the instructions for Linux/SSMTP.
"Cagney" has compiled the instructions for Linux/Exim4.
"CarCode" has compiled the instructions for Mac OS X/PostFix .


1) Windows(Vista or XP and Thunderbird)

- Outside OpenCPN there is nothing more to do except to ensure that there is a mail system (mine is thunderbird) correctly configured and set as "main" on the device.
also verify if the mapi32.dll is present in c:/windows/system32 (or equivalent for 64b) (otherwise an error message will be the result).

- Inside OpenCPN, there is nothing to do; the sender mail address can be entered, but will not be used. Just don't forget to enter the zyGRIB login and password.

When clicking on "send" button :
if the "main" mail system is not open, OpenCPN opens it and the waiting messages are received.
remark : if there are many waiting messages, it could take a while. That is why it would be better to create a specific address for this purpose.
Then a new mail page is opened with all mail elements already written thus ready to be sent.



How to install and configure sSMTP:

- 1) Install the ssmtp package.
If another MTA is already installed, it could be requested to uninstall it before installing ssmtp

once it's done you could test by typing this command:
"whereis sendmail"

the answer should be something like that :"/usr/sbin/sendmail"

use this answer in the next command:
"ls -la /usr/sbin/sendmail"

If everything's OK you should get this answer: "/usr/sbin/sendmail → ssmtp" showing that Sendmail function is now connected to ssmtp

- 2) Now there are two files to set:

the first file : /etc/ssmtp/ssmtp.conf ( with root rights )

The typical setting should be:
AuthUser=yourlogin to your ISP access
AuthPass=yourpasseword to your ISP access
mailhub=yourISPserveurname.yourdomain (for example
hostname= the full host-name ( normally automatically entered, but if not you can type the command : "hostname" to get it)

For ISP requiring a TLS connection , it could be necessary to add the line UseTLS=YES or UseSTARTTLS=YES

the second file : /etc/ssmtp/revaliases (with root rights)

Enter this line.
root:yourlogin@yourdomain:yourISPserveurname.yourd omainort

the default port was 25 but now many ISP refuse it and use 587. If you have a mail system, you will find the right value in it.sudo dpkg-reconfigure exim4-config
Sendmail/Postfix install for Mac
- Inside OpenCPN :You must enter the sender address : your entire mail address, the one you will use to send mails and receive answers

When you click on the "send" button, the mail is directly sent. You can find the log here : /var/log/mail.log

Using Exim4

First install Exim4
$sudo apt-get install exim4
then configure it (again).
$sudo dpkg-reconfigure exim4-config
This is a very simple setup where exim is just used to forward mail to the ISP:s smtp server. Local system mail is also available.

It's important to use the choice above.

I just use "localhost".

We have no incoming connections.

We are not using this.

We are not using this.

This is important. It must point to your Internet Service Providers SMTP server.

Your choice!

RTFM and make up your mind. Not a big deal for this simple setup.


Your Choice, but no point in splitting this simple setup.

Edit /etc/exim4/passwd.client so it contains your username and password to your ISP:s mail server.
# password file used when the local exim is authenticating to a remote
# host as a client.
# see exim4_passwd_client(5) for more documentation
# Example:
### target.mail.server.example:login:password
# for OpenCPN you can use *:login:password
(Re)start Exim4
$ /etc/init.d/exim4 {start|stop|restart|reload|status|what|force-stop}
Start testing

Mac OS X

Using Sendmail/Postfix

It is not so easy to install this on a Mac since you will need some experience with terminal using. The example below uses an googlemail account and nano as editor:

Step 1
Type in terminal these 6 lines one after another with return:
sudo mkdir -p /Library/Server/Mail/Data/spool

sudo gzip /usr/share/man/man1/{postalias.1,postcat.1,postconf.1,postdrop.1,postf ix.1,postkick.1,postlock.1,postlog.1,postmap.1,pos tmulti.1,postqueue.1,postsuper.1,sendmail.1}

sudo gzip /usr/share/man/man5/{access.5,aliases.5,bounce.5,canonical.5,cidr_tabl e.5,generic.5,header_checks.5,ldap_table.5,master. 5,mysql_table.5,nisplus_table.5,pcre_table.5,pgsql _table.5,postconf.5,postfix-wrapper.5,regexp_table.5,relocated.5,tcp_table.5,t ransport.5,virtual.5}

sudo gzip /usr/share/man/man8/{anvil.8,bounce.8,cleanup.8,discard.8,error.8,flus h.8,local.8,master.8,oqmgr.8,pickup.8,pipe.8,proxy map.8,qmgr.8,qmqpd.8,scache.8,showq.8,smtp.8,smtpd .8,spawn.8,tlsmgr.8,trivial-rewrite.8,verify.8,virtual.8}

sudo /usr/sbin/postfix set-permissions

sudo chmod 700 /Library/Server/Mail/Data/mta

Step 2
Type in terminal another command to start the nano editor with this file:
sudo nano /etc/postfix/sasl_passwd

Type into the nano editor:

Substitute YourAccountname and YourPassword with your data.
Save the file in nano with Ctrl-O and exit with Ctrl-X.

Step 3
Publicate the new file in terminal with this command:
sudo postmap /etc/postfix/sasl_passwd

Step 4
You have to edit the main config file and add at the end the following lines with
this command in Terminal:
sudo nano /etc/postfix/

This to add:
# Minimum Postfix-specific configurations.
mydomain_fallback = localhost
mail_owner = _postfix
setgid_group = _postdrop

# Enable SASL authentication in the Postfix SMTP client.

# Enable Transport Layer Security (TLS), i.e. SSL.

Save the file and exit nano as in step 2.

Step 5
Now you can start postfix in terminal with:
sudo postfix start

If an error occurs correct and start again with:
sudo postfix reload

Step 6
Now you can test your work in terminal with:
date | mail -s test

If you want to have started sendmail/postfix each time you start you start
your machine you can add these lines to the launch daemon:

Do this with this command in terminal:
sudo nano /System/Library/LaunchDaemons/org.postfix.master.plist

After that this file should look like this:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "">
<plist version="1.0">

Instead of googlemail in this example you may use any other mail server.

Go to Table Of Contents

Chart Downloader

Please go to the Chart Downloader documentation on this page:
Click on the link above.
Please do not put any content on this page. Put it on Toolbar_Plugin page

Cruise Destinations

Generally available information and "crowd sourcing" to present navigational and other information to Cruisers.
Display thousands of great sailing destinations worldwide right on your chart.
  • sQuiddio
    Global user-sourced and user-maintained repository of sailing destinations (marinas, anchorages, yacht clubs, docks, fuel stations etc.) available as waypoints in OpenCPN through a plugin.


Find thousands of destinations right in your Opencpn chart

Opencpn makes its global user-sourced and user-maintained repository of sailing destinations (marinas, anchorages, yacht clubs, docks, fuel stations etc.) available as waypoints in OpenCPN* through a plugin.

The waypoint Properties box shows basic information about the Destination, such as the Destination's average user rating, address and phone number (where available) and a link to the Destination's page on sQuddio.

* OpenCPN version 3.3 or greater required

Share your seafaring knowledge with others


By following the link in the waypoint, registered users can post comments about the Destination, as well as rate the Destination on attributes such as beauty, service and quality of wi-fi access (where applicable).

Can't find your favorite anchorage or marina? Report new destinations not yet available in the database.

Follow your cruising friends on your OpenCPN Chart

(version 0.4 or greater)


Share your position, SOG and COG with boats in your sQuiddio follow list , and display their current position and heading on your OpenCPN charts

(version 0.5 or greater)


Plan your cruise ahead by locating AIS ATONs along your itinerary, before they come into your AIS range.

Use of the plugin is free of charge. (Free registration is required for certain functions).

Installing the plugin

  • Look for the icon in the Plugins for OpenCPN 3.3 and later section of the plugins download page.
  • Select the architecture and platform of your choice, download and install the relevant installation package.
  • After successful installation, the plug in should be available in the Plugins tab of your OpenCpn Options dialog box.

Using the plugin:

  • In OpenCPN, go to the Options -> Plugins and enable the sQuiddio plugin (no settings are required).
  • To view destinations in an area:
    • Right-click on the area of the chart for which you want to view available Destinations.
    • Select Download local sQuiddio destinations from the contextual menu.
  • To view additional information about the Destination, and a link to the sQuiddio Destination page, right click on Destination's waypoint, and select Properties.
  • The waypoint dialog box includes a link to the Destination page on If you have an Internet connection, click the link and your browser should soon display the Destination's page on

  • You can hide all Destinations for an area from the charts by right-clicking on the chart and selecting Hide local sQuiddio Destinations from the contextual menu. You can make the destinations visible again (without downloading them anew) by selecting the Show sQiddio destinations.
  • To submit a new destination, position your cursor on the new Destination's exact location in the OpenCPN chart, right-click and select Report a Destination at this location from the contextual menu. (Note: you must have a free user account to report new Destinations.)

About is a service designed and developed by boaters for boaters.

We love the sea and believe that the best way to enjoy and protect this wonderful gift of Mother Nature is to facilitate the sharing of information among boaters. This is why most of the content you find on our site is generated by other users. We encourage you to contribute your seafaring knowledge to by creating destinations, rating your favorite ones and by providing information and feedback. Thanks to users like you, is quickly becoming the most complete, comprehensive and up-to date source of cruising information in the world.


Chart Downloader (Plugin Included in Program download)
Download, install and keep up to date the navigational charts provided by various free governmental sources worldwide directly from within OpenCPN's Toolbox. Supports both the raster and vector charts for the US waters provided by the NOAA, official raster navigational charts published by Argentina, Brasil and New Zealand (covering also huge areas of the Pacific ocean) as well as electronic charts of the inland waterways of the USA and more than a dozen European Union countries.

S63 Vector Charts (O Charts)
A plugin that makes it possible to display standard commercial charts.
This plugin has a totally different display format and is integrated in the main program.
See O-Charts S-63 Vector charts for OpenCPN which has a link to VAR Chartworld for ENC charts.

The NVC charts are purchased only from the German publisher NV Verlag This plugin runs NVC Charts.

BSB4 Charts
A plugin which makes it possible to use MAPTEC encrypted BSB4 charts for which encryption certificates have been purchased and registered on the computer running OpenCPN.

Has charts for UK, Ireland, Near Contenant, Iberia. VisitmyHarbor

Other Sources
See OpenCPN User Manual for other Chart Sources.

S63 Vector Charts

Chart showing Part of Jamaica, from the IHO S63 test suit.

This Plugin supports use of S63 encrypted Charts and dramatically expands OpenCPN's range of charts available.
These charts are quite reasonably priced....S-63 is the encrypted distribution format for S-57 vector charts. Today, hydrographical offices all over the world are producing their official vector charts in the S-57 format. Distribution is done under the S-63 standard.

To use the encrypted charts, you must get a license for your particular machine (called Permit), make sure to visit for more information and to get the permits.

S63 is an encrypted version of S57 vector charts, and is the standard format for almost all, officially published, vector charts in today’s world. As a matter of fact, only NOAA and the East Asia Hydrographic Commission (EAHC), publishes free unencrypted S57 charts nowadays.

These, S57 and S63 charts, are the current state of the art charts. The quality of the charts are the best vector charts available. They are always kept up to date. No other vector chart are in the same league.
There are, however also some drawbacks. Many popular cruising areas are very poorly covered as the focus is on the needs for commercial shipping. One example is he Bahamas area. Another problem is the relatively high price. When licensing consider the licensing period. Your charts will be available still after expiring just without weekly updates.

OpenCPN handles these commercial, non free, charts through an open source plugin, that in the background connects to a "black box" helper application. An external entity,, handles the encrypted and commercial aspects of the S-63 plug-ins for OpenCPN.

Get Started

  • Download the plugin for your operating system the official OpenCPN download page.
  • Also download and read the informative Documentation from Really!!
  • Install the plugin the way you normally install programs on your operating system. The S-63 plug-in gets enabled at installation.
  • Check that your Options->Charts shows a new "S 63 Charts" tab, as in the pictures below.
  • At the S-63 Keys/Permit tab you can create a system identifier file which "fingerprints" your individual system - a file you will need for the InstallPermit. Try this on your system before licensing charts to ensure that a fingerprint can be created for you.
  • Now go to the O-charts shop to get your "User Permit" and "Install Permit". Use these to license your chart selection.
  • Detailed instructions are available on

Loading the Charts

The Keys/Permits tab.

  • Certificate Name This should already be present after a sucessfull plugin installation.
  • If it's missing press the "Import Certificate..." button and import the file IHO.PUB. To find the location of this, file press the button in the toolbar. Find the " Config file location" at the bottom of the "About" tab. Go to the same directory as the config file, and then s63->s63_certificates directory, where you will find IHO.PUB.
  • UserPermit
  • Enter your new Userpermit from O-charts and test it. The permit above is from IHO's test suit and is not valid in real life.
  • New InstallPermit
  • Enter your new Installpermit from O-charts and test it.
  • OpenCPN is now setup for S63 charts. Lincense your charts or use the test set. See instructions below.
  • Download and uncompress your files.
  • Install Cell Permits by using the button "Import Cell Permits..." to find the file PERMIT.TXT.
  • Import the downloaded charts by pressing "Import Charts/Updates.." and find the folder "ENC_ROOT"

  • This dialog will pop up. I you answer "No", the SENC creation will happen when you first try to use the chart.



You may exercise the S64 Test set using the following special permits:
User Permit: 66B5CBFDF7E4139D5B6086C23130
Install Permit: 38F99B50

Perhaps the best to start with is:
IHO S-64 [S-63 TDS v1.2]/8 Data Exchange Media/Test 8b/PERMIT.TXT

NV Charts

  • On your PC, the download and installation plugin can be made ​​before or after the installation of the charts.

Get charts from NV-Verlag:

The NVC charts are purchased only from the German publisher NV Verlag.
  • On this website: NV_Verlag ----->
    • This website is multilingual. See, top right on the homepage of the site, the icons to change the language.
  • The charts in this editor ribs cover the following:

For Europe area : Other areas:
the North Sea, Caraïbe
the Baltic Sea East USA cost
the English Channel,
Attantique the coast
Balearic Islands
  • Editor's note:
    • In case of malfunction, particularly on Windows 8.1 and Windows 10, do not hesitate to contact NV-Verlag, using their website contact form. Experience shows that this chart editor is responsive and helps resolve many problems.
  • The installation procedure of the charts is independent of OpenCPN
  • It is possible to install the charts on two different computers,
  • Free software charts display comes with charts. But it is "light" a product.
  • Nautical charts are automatically installed in a specific folder proposed by the installer.
    • But it is possible to choose the installation folder of charts as you wish.
    • Other data, OpenCPN does not support, will install automatically in a prescribed folder.
  • You can buy a "dongle" on which a facility is possible.
    • In this case, by moving the dongle, it is possible to use the charts on other computers.

Installation charts procedure:

  • For installation you must:
    • or a CD-ROM, provided by the publisher, which contains:
      • the installation software
      • charts.
    • or having proceeded to download:
      • the installation software,
      • charts.
  • If you have a dongle, install the dongle into a USB port on your PC
  • Note Well:
    • This dongle does not appear in the list of equipment on the PC when using the Windows Explorer.
    • Since the dongle can be used on another PC, the location of the charts in your PC is not listed on the dongle. Therefore, the name of the folder where the charts are placed does not matter.
    • The charts will not be installed on the dongle.
    • One of the two work permits nautical charts will be listed on the dongle.
  • If you do not have a dongle, one of two installation permissions will be written on your PC.
  • In any case, it is best to have a good internet connection to complete the installation.
  • In the absence of internet access, there is a special procedure for installing.
  • Run the installation software,
  • Follow the instructions that appear on the screen knowing that sometimes to be patient.

Download and install the plugin:

The latest version is available here:
  • Save the file to your PC.
    • Uploading
  • This plug-in only works with windows
    • XP SP3/Vista/7/8.1/10
  • After downloading the file, depending on the settings selected on your PC, click or double click it.
  • For installation steps. Allow the installation to do.
Install plugin 1
Install plugin 2
Install plugin 3
Install plugin 4

The installation will be done automatically in the "plugins" folder of the installation OpenCPN.
  • Nota Bene :
    • Once the installation done, the executable file which was used to carry, can be deleted from the PC.

Activation / De-activation of the plugin:

  • After installing OpenCPN the icon bar at the top of the screen, has no additional icon.
    • No visual information makes it impossible to know whether the plug-in "NVC-Chart" is on.
Activation :
  • Commissioning Tool "NVC-Chart":
    • Go to the "Toolbox", "Plugins" tab,
    • Click the "NVC-Chart" icon,
    • Click the "Activate" button,
    • Confirm with "Ok" or "Apply".
Deactivate :
Unactivate plugin
Go to the "Toolbox", "PluginsIns" tab,
  • Click the "NVC-Chart" icon,
  • Click the "De-activate" button,
  • Confirm with "Ok" or "Apply".

Manual :

  • Cases where the charts were installed directly on the computer with the access code.
    • OpenCPN automatically recognizes their presence
    • The operating procedure is the same as with other charts. Just declare the directory charts in the "Maps" tab of the "Toolbox"
  • Cases where the charts were installed on the computer and where the access code is on a dongle.
    • You must insert the dongle into a USB port on the computer before launching OpenCPN.
    • After that, the operating procedure is similar to that of other charts. Just declare the directory charts in the "Charts" tab of the "Options".
    • Each access to the charts, the dongle is red illuminated during the update of the database. (see pictures below)
  • If you use a dongle and if the dongle is removed, access to nautical charts is stoped.
      • It is useless to put the dongle to try to regain access to nautical charts.
      • We must restart the access procedure:
        • closing OpenCPN,
        • by returning the dongle,
        • OpenCPN restarting again.

Retrieve Charts Previously Purchased.

To retrieve the charts I purchased earlier NVcharts and directed me to this website: NV-Chart Download

Then you can find the charts you purchased and you want to download by year of release.
I found the Windward Islands kit but couldn't find the Leeward Islands kit.

Enter the charts you need to download and click on the download button. The charts will be downloaded as an exe file. Run the exe file and enter your serial numbers, name and email and then it will install the charts. They recommend saving them in C:Chartkit/BSB. That's where I installed and then pointed Opencpn to that subdirectory and everything works well.

Utilisation du dongle

Ingestion charts

Chart, Large area. Isle of Guernsey and JerseyChannel Islands

Chart, medium Scale, Mount St Michel bay, English Channel

Chart, for zoom, St Helier, Jersey, English Channel.

Chart, Big big zoom, St helier, Jersey, English Channel.

BSB4 Charts

Provides support of BSB Version 4 Raster charts, a format used by many hydrographic authorities throughout the world. BSB4 charts are raster charts, manufactured according to a standard developed by MAPTEC. The BSB4 plug-in enables OpenCPN to open and read the encrypted charts correctly provided that the charts have been purchased, registered and the plugin is installed properly. Supported charts must have been installed with appropriate encryption certificates in place. This plug-in only works with Windows.

There are several sources of charts:
The chart installation procedure is independent of OpenCPN. At the time this plugin was first published the creator of the plugin posted on www.cruisersforum as follows:
  • This plugin supports Windows only.
  • The BSB4 charts will be available only on the computer where they were successfully first installed and registered by the original end user.
  • The plug-in makes no attempt to understand or "crack" the encryption algorithms. The DLL interface is treated as an opaque portal to read the decrypted files. The plug-in acts as a "wrapper" to make the charts visible.
  • The BSB4 PlugIn won't be distributed as open source. It will be a binary-only DLL, looking just like all other PlugIns at run-time.
  • Please take careful notes of the 2nd point above. If a user somehow "acquires" a copy of an encrypted BSB4 chart folio, it won't be useable with this plugin.
In summary, the plug-in will only work for registered charts on the computer where they were first installed and registered. The plug-in is NOT a means to obtain free charts.

The downloaded file is an installer which will place a DLL in the "plugins" folder of the OpenCPN installation. The installer will attempt to place it in the correct location but if your directory structure is "non-standard" the plug-in may not end up in the correct location. On a standard installation the plug-in folder will be C:\Program Files (x86)\OpenCPN\plugins\ If you have a non-standard installation then it will be up to you to ensure that the BSB4 plug-in (bsb4_pi.dll) appears in the correct folder - just copy it into the right location if it doesn't get there by itself.

Once the plug-in DLL is in the correct plug-ins folder it will appear in the options/plugins menu when you start OpenCPN. You will need to navigate to Options (the wrench menu item), select the plug-ins tab, find the BSB4 plug-in and click "enable" in order to use the plug-in.

With the plug-in successfully installed in the OpenCPN plug-ins directory and enabled there is one further step necessary to view your encrypted charts.

From the Options menu, select the Charts tab. Then add the appropriate directory(ies) where your encryption certificates are located, followed by the directory(ies) where the encrypted charts are located. The screenshot above is from a successful installation. Your directory structure will no doubt be completely different but the same principles apply. In the example above, the non-encrypted charts are located on Dropbox. Then there are two separate encryption directories followed by the directory which contains the encrypted charts.

To recap the process, the following are the steps necessary to install and use the BSB4 plug-in:
  1. Purchase and install encrypted BSB4 charts on the same computer that will run OpenCPN with the BSB4 plug-in
  2. Download and run the BSB4 plug-in installer
  3. Ensure that the plug-in DLL has in fact been created in the appropriate plug-in folder. If not, copy the DLL to the required location.
  4. Start the OpenCPN software and enable the BSB4 plug-in
  5. Add the appropriate encryption and chart directories to the OpenCPN chart locator.

Typically if you follow all the steps the charts will immediately be visible at this point. On occasion however they will not immediately appear and you may need to exit the OpenCPN software, closing it completely and then reopening it. At that point the encrypted charts should be visible.

Radar Overlay / AIS

Radar Overlay Plugins:

Overlay the Radar picture of Garmin or Navico on OpenCPN

Garmin Radar
The GRadar plugin works with modern Garmin (Ethernet capable) radar scanners only.

Navico Broadband Radar
The Navico broadband plugin will work with a Simrad, Lowrance or B&G broadband scanner. All three models -- BR24, 3G and 4G -- are supported.

Navico Broadband Debugging
Assistance in debugging connections.

AIS Plugins

AIS Radar
Implements a radar-like display for AIS targets. See Other Plugins. Simple plugin no documentation.

RtlSdr AIS

Use a low-cost USB DVB-T (digital TV) receiver to receive AIS messages from ships.

BR24 Radar

(BR24, 3G, 4G models)

by Kees Verruijt

Binary releases are available at:
Source code available here:
Wiki (up to date)

BR24radar_pi is a plugin for OpenCPN that allows full integration of Navico broadband radars. It supports all broadband radomes -- BR24, 3G and 4G. It will probably also support the new Halo models, but this has not been tested.

The plugin can be operated as the only control station for your scanner, as it allows access to all setup operations such as antenna direction correction and antenna height, as well as cooperate in a multi-station setup -- whether multiple OpenCPN installations or one or more Navico MFDs/plotters. In fact using a mixed setup is what 2 out of 3 developers use, and recommend (our laptops and tablets don't work nearly as well outside as the dedicated plotters.)

With the 4G model it supports dual range ("two radar") mode, where both radars can be operated individually (transmit state, gain & other settings, guard zones, etc.) Compared to the plotters the only functionality missing is MARPA but it has better _target trails_ support than the plotters and comparable _guard zone_ support. It supports two guard zones per radar as well as two _Electronic Bearing Lines_ (EBL) and Variable Range Markers (VRM) per radar.
  1. Hardware installation
  2. Software installation
  3. Basic operation
  4. Target trails
  5. Cursor, EBL and VRM
  6. Guard zones
  7. Timed transmit


The plugin was initially developed by Dave Cowell who took Dave Register's Garmin plugin and modified it to work with the BR24. Over the years code was contributed by @Hakansv, @douwefokkema, @seandepagnier, @nohal, @chucksk
and @canboat.


The toolbar button

The toolbar button shows the state of the radar:
Radar not detected = Radar not detected Radar standby = Radar standby Radar transmit = Radar transmitting Radar hidden = Radar windows hidden

The action taken when clicking the icon depends on the current state: * When radar overlay is enabled but the control menu is not shown it shows the control menu. * Otherwise it toggles the radar windows and overlay off (hidden) or on (shown).

Hiding all radar windows and overlay is useful if you are sailing into a highly complex situation where you want full view of the chart display and not have the distraction of radar windows and paints over your charts. The radar keeps its current settings (it keeps transmitting if this was on) until you un-hide (show) it again.

There are also two entries in the control menu for the radar plugin. The context menu is usually accessed by clicking the right mouse button on the chart window.
Radar context menu
These are:
  • Hide radar
  • Show radar
  • Radar control
... Hide or Show radar should be self-explanatory. If chart overlay is enabled the *Radar control...* button will show the control menu for that radar only. If chart overlay is disabled it will show the control menu(s) for one or two radars.

The PPI window(s)

Radar PPI window

Either one or two classic radar displays, known as Position Plot Indicators (PPI) by professionals, can be shown. You can hide these if so desired (which makes sense only if you enabled the overlay over the chart). You can resize, move or dock them into the chart display. To close them you use the default OS button on the top of the window. To dock them, drag them to the side or bottom of the chart window and wait for a colored rectangle to be drawn over the chart.

The author likes to use two radar ranges with the windows docked on the right side of the display, one above the other. But just try it out to see what you like best. Radar PPI windows docked
The PPI window has a *Menu* button that accesses the control menu. If you moved the PPI window since the last time you accessed the control menu the menu will come up immediately above the Menu button on the PPI window.

Every radar (again, in the case of a 4G you can have two) has its own *control menu*. If radar overlay is enabled and you have hidden the control menu of the radar assigned to radar overlay, press the toolbar icon to access the control menu. If all else fails you can access this using the context menu on the chart display (_Right mouse button > Radar control ..._) The control menu only shows those options which are functional for the particular state of the radar, and has various sub-menus.
When the radar is not transmitting the menu looks like this:
Radar menu (standby)

Button Possible Values Purpose
Standby/Transmit/Standby Standby, Transmit Toggle radar Transmit state
Show/Hide Window Show window(s), Hide window(s), Show other window Show or hide the PPI windows
Overlay Off, On, Radar A, Radar B Toggles radar overlay over chart
Timed Transmit Off, mins Chooses time that radar is in standby and then automatically transmits again
Info Show information dialog


The Navico radars are very easy to use with OpenCPN. All you need is a wired Ethernet connection.

You can add as many computers as desired, the system will allow operation from all connected MFDs (plotters) and computers.


In all installation packages (except Lowrance 3G USA) the scanner also ships with a small black box -- either a RI10 with NMEA 2000 input or a RI11 with NMEA 0183. It uses the data from the heading sensor on the NMEA network to add this to the radar data.
  • The Navico plotters require heading input to the RI-10/11 for MARPA operation.
  • The plugin uses this heading as the "best" source of heading for radar overlay.
This box also helps isolating the system electrically, and will improve protection of the computer from damage in case of electrical storms (lightning.)

If you already have a Navico MFD installed the installation consists of:
  • Installing an Ethernet switch, or a WiFi router with a built in Ethernet switch. You need a wired port for each device -- the radar, the MFD(s) and the computer running OpenCPN.
  • Connect all devices to the switch.
In all cases you will need at least one RJ45 to Navico radar connector cable. The cheapest solution is to cut Navico Ethernet cables with two yellow connectors at both ends, and crimp a RJ45 connector onto both halves. Follow the instructions here to fabricate these: . So for the most common case where you have a single MFD connected to a radar scanner:
  • Cut the ethernet cable between MFD and scanner.
  • Crimp on two RJ45 connectors.
  • Insert these into a switch.
  • Connect the computer to the switch as well.

Installation with only a scanner.

If your scanner came with a RI10:
  • Cut the supplied Navico ethernet cable in half.
  • Crimp on a RJ45 connector.
  • Insert the RJ45 connector into the computer's Ethernet port or a standard Ethernet switch and the other side into the RI10.
Install the scanner as detailed in the Navico installation instructions.

If you bought a USA Lowrance 3G scanner:
  • Insert the RJ45 connector from the radar scanner into a standard 100 Mbit switch. _or_
  • Cut the supplied Navico conversion cable that has a RJ45 female connector and a yellow Navico connector in half, and replace the yellow connector with a RJ45 connector.
We recommend always using a 100 Mbit switch in this setup to provide some electrical isolation between the scanner and the computer. We don't know whether the connection between the radar and the RI10 uses the four other wires for some non-Ethernet purposes, so some damage may occur if you insert the radar cable directly into your computer.

Choosing an Ethernet switch

If you are going to use a switch you may as well use a Gigabit switch. The scanner has a 100 Mbit interface, but a Gigabit switch will use slightly less power than a 100 MBit switch. You should probably also use one that has a 12V input which can be powered directly from the 12V house battery (or a DC/DC converter if you have a 24 V house battery bank.)

The author uses a 5 port Netgear GS105 which according to Netgear: _Both GS105 and GS108 support the latest Energy E cient Ethernet (IEEE 802.3az) standard, which reduces energy consumption when there is light traffic on an active port or when there is no link or no activity detected. It can further save energy when a short cable (<100m) is used. Energy savings lead directly to cost savings in operation._

Note: make sure you get the _metal cased_ GS105/GS108 that uses 12 V input. There are now also other models with a plastic case that have a 5 V input, which requires an extra DC/DC converter.


The _multicast_ transmission system used by the scanner means that transmission over WiFi must happen at the lowest rate that any device connected to the WiFi network is capable of. For 802.11b and g this rate is 1 Mbit/s. Since the radar data is ~ 1 Mbit/s as well this means it _does not work well at all_. The solution is to either:
* Modify the base rate to be higher. This reduces the maximum range of your WiFi network for all devices.
* Get a faster WiFi network, for example 802.11a or 802.1ac (5 GHz). This has a much faster base rate (6 Mbit/s). Unfortunately, most WiFi routers do not allow you to change the base rate. If yours is Linux based and uses `hostapd` you can edit the following section in `hostapd.conf`. The example disables basic rates 10 and 20 (= 1 and 2 Mbit/s):

# Basic rate set configuration
# List of rates (in 100 kbps) that are included in the basic rate set.
# If this item is not included, usually reasonable default set is used.
#basic_rates=10 20 #basic_rates=10 20 55 110
basic_rates=55 110
#basic_rates=60 120 240


The plugin requires the following software requirements:
  • OpenCPN 4.2 or higher installed. Generally the latest production release is recommended, at the time of writing this is OpenCPN 4.4.
  • Firewall disabled or with exceptions enabled for opencpn.exe.
  • OpenGL mode enabled in OpenCPN. The frequent screen updates produced by a radar make traditional window calls impractical.

Network setup

The scanner and the displays communicate using a system called _multicast_. This has the advantage that the data only needs to be sent once, and is received by all displays. Uniquely, it also means that there is no issue with Ethernet addresses. _Any ethernet address is acceptable._ A disadvantage is that it can be hard to setup a firewall rule as you don't just "open" a particular port. The simplest solution is to allow `opencpn.exe` full access to the network for both receive and transmit.

Installing the plugin

Download the latest production version and run the installation package.

Enabling the plugin

  • Start OpenCPN
  • Go to Options > Plugins > BR24radar. Click **Enable**.
  • Close the options dialog. You now have a new icon in the toolbar.
If the radar has not been detected yet it will show as:
Radar not detected
and if the radar has been detected it will show:
Radar standby
There is also an information window that shows whether the scanner has been detected, and whether there is a valid heading input:

Radar Info

If a condition is not satisfied this dialog will open automatically. You can also open it using the control menu (see next page.) As you can see the Info dialog shows whether you have OpenGL mode enabled.

It also shows whether radar presence has been detected, and its IP address. Until it has it will cycle through all Ethernet cards at the rate of one card every two seconds. In the image above the scanner has not been seen yet and it is listening on the card with IP address

Radar Info Type

In the above image the radar type and firmware release date are shown, this shows that the radar has been detected successfully.

For North Up display and radar overlay you must have a heading sensor attached, either via the RI10/11 (preferred) or via NMEA0183 input to OpenCPN directly. If you use a magnetic sensor the variation is also required, but that is easy to do by enabling the WMM plugin.

For radar overlay you must have a boat position via GNSS input to OpenCPN. The most common is a GPS sensor sending NMEA0183 data.

By customer demand it has been made possible to use Course Over Ground as the heading input, but we think this is such a bad idea that we have not enabled it by default. Go to the _Options > Plugins > BR24radar > Preferences_ page to enable it. Please don't enable it and then complain that the overlay is out when you are going slowly or are docked.

Garmin Radar

The GRadar plugin works with modern Garmin (Ethernet capable) radar scanners only.

The chart plotter is a combination of a Gps and electronic charts. If Gps works as expected and, a bigger if, the chart is correct, then everything is fine. Add a radar to the mix, with an independent picture of targets, including land, buoys and other vessels, and compare the two. That is what this plugin does. It overlays the radar-picture on the chart plotter. If both agrees, the navigator can be more confident that his navigation is correct. On the other hand, if the pictures disagrees, there is one more thing to sort out.

To use this plugin the user must be familiar with both OpenCPN and radars. Without a sound knowledge in radar picture interpretation, the plugin will seem a bit confusing.

Garmin Radar plugin


The Garmin Radar PlugIn for OpenCPN requires a specific hardware interface in order to allow the OpenCPN application to access the Ethernet data captured and broadcast by the radar scanner.

There are three interconnect scenarios possible, depending upon whether the installation includes an existing Garmin chartplotter, and the operational mode desired.
Interface Type 0: OpenCPN Slave Mode, using existing Garmin chartplotter.
Interface Type 1: OpenCPN Master Mode, using existing Garmin chartplotter.
Interface Type 2: OpenCPN Master Mode, no chartplotter.
Download and read the complete installation instructions: GRadarDoc.pdf

Installing the plugin

Follow the instructions on the Install and Enable page.

Enable GRadar plugin

Once installed enable the plugin in Options->Plugins. The Preference button does not work. For GRadar Settings, read on.

When enabled the GRadar icon appears in the toolbar. The icon is an on/off switch and has two states indicting if the the plugin is working or not:

Off On

As soon as the plugin is enabled there will also be a separate log window. This is how it looks when no radar is connected.

Using GRadar

Rightclick to get to the GRadar Settings.

Operational Controll

Describe all the options.

Range Control

Describe all the options.

Noise Control

Describe all the options.

Dome Control

Describe all the options.

More ......

NMEA ARPA Radar Targets

Certain radars transmits targets in NMEA sentences. OpenCPN can display these targets in a similar fashion as normal AIS targets. Read more: Radar Targets
Is this a good thing combined with GRadar or does it just clutter the display......??

Navico Broadband Radar (old version)

NOTE: The documentation below is for Opencpn 4.0 & 4.2 version of the plugin.

The Navico broadband plugin will work with a Simrad, Lowrance or B&G broadband scanner. All three models -- BR24, 3G and 4G -- are supported.

The latest version available is 2.1 which requires Opencpn 4.5.0
OpenCPN 4.2.0 requires the v1.3.1 plugin requires API 1.10, released March 9, 2016.
OpenCPN 4.0.0 requires the v1.2 plugin.

Binary releases are available at:
Source code available here:


The v2.1 plugin requires OpenCPN 4.5.0

The plugin requires OpenGL mode. It does not work without OpenGL, and never will. This means that a computer with good and fast OpenGL drivers is recommended.


The plugin supports all basic radar functionality, overlayed over the chart display.
  • All radar tuning options such as gain, sea state, etc. can be set. The settings in the controls will reflect what the radar says it uses, so if you use two or more radar displays (either multiple OpenCPN installations or one or more Navico MFDs) the settings will reflect the actual radar operation.
  • The same installation settings as on a MFD can be set: bearing alignment, antenna height, local interference rejection and side lobe suppression.
  • Two guard zones.
  • Support for using either Radar A or Radar B when a 4G radar is used.
  • When no GPS or heading is received a "radar only" display is allowed.

Not supported are:
  • Range rings (use a different plugin to supply this)
  • Separate radar display (not overlayed on chart) -- the current method allows either a chart display or a radar display.

The latter two functions are under development.

Hardware installation

The Navico radars communicate with the chartplotters using UDP multicast. This means that they do not require any particular IP address, as long as they have one. There is no need for a DNS or DHCP server with multicast.

As long as there is a wired Ethernet path between the radar and the computer running OpenCPN, and the ethernet device in the computer has any IPv4 address (even a self-assigned one) it will work.


With most (older) WiFi routers the plugin will not work at all or very unreliably. The reason for this is that the bandwidth used by the radar is slightly more than one megabit per second, and according the specification the router must send broadcast data and multicast data at the lowest speed that any client can possibly be receiving on. When this lowest speed happens to be one megabit per second then you're in trouble, as now there is more data than can be transmitted, and the wireless channel is continuously full (overloaded even).

To fix this you can use a router that doesn't allow the rate to drop to 1 Mb/s. In other words, disable 802.11b and 802.11g. 802.11n, 802.11a (5 GHz) and 802.11ac are OK as they all have minimum transmit rates of about 6 Mb/s and up.

Some routers don't support multicast at all. Replace the WiFi router with something else.

Some routers don't drop down to 1 Mb/s for multicast over 802.11b/g. They are either being clever (seeing there are no 802.11b/g clients on the network), or they actually monitor multicast group subscriptions (perform network assistance,) or they have a bug in not dropping down to this unusual slow rate.

Even if you do have a router that works when testing, make sure it also works when you have additional devices that may be on your network at other times, such as smartphones or tablets.

The best advice seems to be to either not use wireless at all, or to use a separate 5 GHz (802.11a) network for the radar clients.

Software installation

There are installation packages that can be run using the installation tool for your platform.

Once you have installed and restarted OpenCPN it should be available in the "Plugins" list in the configuration dialog.

Click the enable button, then close the options dialog. Unless you want to switch to kilometers or want to rotate the radar image there should be no need to access the preferences.

Once you have enabled the plugin a new button appears on the button bar, looking like this:

The light will be red, yellow or green. Red means that the radar is not transmitting and that it has not been detected. Yellow means that radar hardware has been detected but it is not transmitting. Green means that data has been received from the radar.

Click on the button to open the radar control dialog and start the radar.

The radar controls dialog is intended to be a small dialog that can be kept on-screen at all times. If you have a small screen you can close the dialog and open it again either by pressing the radar button twice (switch off, switch on) or by using the context menu (right mouse click -> Radar control.)

If not all conditions are met to show an overlay it will show the following:

The OpenGL mode must be enabled. Go to Options > Display > Advanced > Graphics to enable this.

As you can see the overlay requires boat position (normally via GPS) and heading (via a compass). Heading via COG (when moving) is not recommended. You must set up NMEA connections either via a serial connection or a TCP or UDP or GPSD server.

The radar will be searched automatically on all ethernet devices in turn. In the image above you see that the plugin is attempting to find it on a device with IP address It will keep scanning at a rate of one per 2 seconds until it finds it. When it does it will update the control to show the radar IP address.

Once the conditions are met and the radar is transmitting the radar control dialog allows you to change the settings of the radar (as shown on Windows XP):

You can access settings that should be needed less often by clicking Advanced (as shown on OS X with a BR24 or 3G):

Controlling the radar picture

Whereas an AIS requires little help, a radar may need some tweaking to get the best picture. Not only that, the radar plugin can also be finetuned for specific circumstances.
  1. Range. Starts off as "Auto", which means that it shrinks and grows with chart scale. You can go from 50m to 48km or 1/20 NM to 36 NM with a 4G radar and one step less with a BR24 or 3G.
  2. Gain. How much the return is amplified. Auto works quite well.
  3. Sea. Change this in a rough sea if the Auto setting shows too much noise.
  4. Rain. Change this in order to "see through" rain or to have dense rain show up.
  5. Advanced. See the next section.
  6. Guard zones. See the next chapter.

Advanced controls

  1. Transparency. Use this to change how much of the underlying chart is visible through the radar image on overlay. It is not possible to change the 'z order' of the image with vector charts, so AIS images are always on top, then the radar, followed by the chart.
  2. Interference rejection. Increase this if you see spurious hard 'spokes' of radar data in the direction of another ship that has a radar that 'jams' the picture. Keep low or off otherwise.
  3. Target boost. Increase to have small returns show up more prominently.
  4. Noise rejection (4G only). Controls the amount of noise filtering applied by the radar. Target sensitivity is increased at longer ranges when this control is set to Low or High, but does cause some loss of target discrimination. To get maximum range performance from 4G, set Noise rejection to High. You may need to lower noise rejection in areas of high interference.
  5. Target separation (4G only). Advanced technology in the radar enhances the definition of returns, especially at mid range. Suggested value: high.
  6. Scan speed (4G only). Increases the speed at which the radar turns to 36 rpm. If Noise rejection is set to Low or High, for ranges 1nm or higher, speed is limited to 24 rpm.
  7. Downsample. Generating the radar image may cause a lot of CPU if you have a weak OpenGL graphics card as every rotation contains 2048 lines of radar data. By downsampling (ignoring a part of the data) fewer blobs are created, but the image becomes blockier. Suggested values are 1 to 4. 5 to 8 are there for tests.
  8. Scan age. If you have very weak hardware you may need to keep radar data onscreen for longer than the normal period. Increase beyond the default value of 4 if you have missing data and don't mind seeing older returns.

Guard zones

You can enable two guard zones. Enter values in the Guard Zone dialog to configure the distance and angle from the bow that you want scanned for 'bogeys'. Once an echo is detected the alarm will sound every ten seconds until you press the Confirm button. Once you do the alarm will be silent until the guard zone is empty and a new echo arrives in the guard zone. As of 1.1 you can set up which alarm sound you want to use in the preferences dialog (Options > Plugin > BR24radar > Preferences).

What to do if it it does not work

See the next page in this manual, Debugging, for more information.


Of course you updated to the newest version first?
Recent versions show this message dialog if not all conditions to show a radar image are met:

No boat position

Check your GPS interface and/or NMEA inputs.

No heading

No compass data found. Check the NMEA inputs for HDT, HDM or HDG sentences. HDT is preferred. If none are available COG is used if the boat is travelling, but this is very bad for the overlay. Get a compass!

No radar present

Is the system connected to the radar, either directly or via switch? Does the IP address of the network device show up in the "ZeroConf" line?

If the radar does not transmit radar data but it is detected then the "Radar present" line will get a checkmark and the text will change to "Radar IP <ip-addr>". Check that this is the correct IP address. If the system does not show the IP address of the ethernet device that is on the same network as your radar, check your ethernet configuration.

If the radar transmits data the dialog will change to the controls dialog, but the log file will still show the information such as IP address.

Everything looks OK but still no picture

If you get the normal radar control dialog and the little 'light' in the radar button shows green, but you still do not get a picture, you can use the radar emulator.

The emulator was created for debugging during development, but it can be used to check that your OpenGL driver is compatible and whether your system performs well enough. It uses (almost) the same code path as the normal UDP reception of radar data, but 'invents' an artificial radar image in 'standalone' mode.

In the preferences dialog (Options > Plugins > BR24Radar > Preferences) choose Display Option for Radar display as Emulator and close the preferences and options dialogs. You should now see a picture like this, even if you have fulfilled none of the overlay requirements:


Most issues so far that we have been asked to look in to were related to a firewall preventing the plugin to access the network at will, especially for Microsoft Windows users. Please try again with your firewall switched off completely. If it works without the firewall, just add a rule in the firewall that allows opencpn.exe full access. Most consumer grade firewalls do not allow sufficient control over multicast settings.

Multiple ethernet devices

The Navico radar continuously sends out its status, and it tries to locate such a message. Since the plugin doesn't know which ethernet device it should use it loops over the list of active devices until it receives such a status message, and then uses that device until it looses the connection, at which point it starts searching again.

This algorithm has been developed for the situation where a radar may be on one ethernet device (a USB Ethernet dongle) one moment and a different ethernet device (a Thunderbolt Ethernet converter attached to a docking station) the next moment. This is useful as it allows you to keep OpenCPN running for days at a time without restarting, and it will still be able to use the radar when the tablet is docked or wired to the network, without stopping OpenCPN when using the tablet in a wireless fashion.

Although the software tries to detect automatically which ethernet device the radar is using there are still situations where this breaks. In particular this will matter most when the OS requires the plugin to set the proper IP address on the multicast output data and the plugin chooses the wrong IP address. This will surface as a situation where the radar is detected but it cannot be turned on.

The following situations are examples of such setups:

  • When you have a bridged network over two devices and it accidentally binds to one of the underlying devices (which, because of Murphy, will be the wrong one). This should only occur when the underlying device has an IPv4 address which (because it is bridged) it should not have. The plugin should use the bridge device only.
  • When you have a virtual ethernet device that passes the multicast data from the radar on to the plugin but does not pass multicast send data from the plugin to the radar.
  • When you have both a wired and a wireless network connected to the radar network.

To see if this is the case please check the list of ethernet devices using ipconfig / ifconfig (command line) or GUI control panel (MS Win), network manager (Linux) / System preferences (OS X). Disable all devices except for the one that the radar is connected to. If it works now, enable the other devices one by one and restart OpenCPN after each attempt. Once you locate the network that is interfering, determine whether it has a correct IPv4 address. It should be on a different network as that of the ethernet device where the radar is connected to.

Note that devices that have no IPv4 address (not even a self-assigned one) or have a loopback address (starts with 127) will never interfere and do not need to be disabled.

Verbose logging to file

Use the following to increase the amount of logging to the opencpn.log file:
  1. Click on the question mark in the button bar and note where the ini file (and log file) are kept.
  2. Stop OpenCPN.
  3. Edit the ini file and change the VerboseLog in the [Plugins/BR24radar] section to a number higher than 0. Values from 1 to 4 are different. At level 4 your file will grow very quickly!
  4. Start OpenCPN.
  5. Start the radar (or attempt to do so.)
  6. Stop OpenCPN.
  7. Check the content of the logfile. You may also be asked to upload this file to a location that it can be examined.

AIS Radar Display

What's the point :

This plugin to display AIS targets in the way things are displayed on a radar screen.

Download, install, activate, setting preferences:

Download and install:
Under windows, the plugin can be downloaded here:
  • Once downloaded, run the ".exe" file.
  • Let them. The plugin is automatically installed.
  • Nota Bene :
    • Do not confuse this with the additional supplements that overlap the Ship's radar screen on the OpenCPN screen.
  • After installing the add-in, the icon bar at the top of the screen does not have the icon of this plugin
  • The tool "Radar-AIS View" is not in service. ------> Above all, it must be put into service
  • Go to the "Options / plugins"
  • select the ad hoc line,
  • Click "Enable"
  • At this stage, the tool is activated and the icon is displayed.
Settings preferences:
  • The list of preferences is simple:
  • Show icon
    • This box displays the icon or not complement OpenCPN in the icon bar.
  • Using AIS as an information source.


  • Two operating mode are possible:
    • North-up,
    • COG up, or "Course Up".

Mode "North up":

General principle:
  • Check the "North Up"
  • The next screenshot, shows the center an AIS target. This is the boat of the user.
    • This can only take place if the user's boat itself is equipped with a transmitter, class A or B.
    • Finally, this presence can be avoided by using the best opportunities "Options / Boats / MMSI" of OpenCPN.
  • But in any case, imagine that the boat the user will always be the center of the screen "radar".
  • In this example, the presence of the target user of the boat, we understand that it is the navigation direction of the boat user.
    • Note: On the map area, imagine that user's boat moves by practicing with it the circles that appear on the screen.
  • All vessels with an AIS transmitter, Class A or B, within the chosen distance, is displayed on the screen and move it.
  • Any target that:
    • approaches the center of the screen is a boat that can "potentially", collide with the boat of the user.
    • away from the center of the screen, is a boat which presents no risk of collision with the boat of the user.
The EBL Line :
  • Click randomly in addition to the window ...
  • A line appears. So precise adjustment is very difficult.
  • She will not move ....
  • One possible use:
    • Want to know which angle you see a target that is near you.
  • Click the center of the target.
  • Two informations are displayed:
    • The line EBL,
    • The transcript of that target.

Mode "Course Up" ("COG up")

General principle:
  • Do not check the "North Up".
  • The next screenshot is similar that of fashion "North up" but, note that the numerical value displayed at the top of the vertical axis gives the COG boat user.
  • Theoretically, the target pointing user's boat should be permanently oriented towards the top of the screen.
  • BUT, also note that with each variation of COG boat from the user, the entire screen rotates either in one direction or the other. It's movements are non-existent if the user follows a boat absolutely constant heading.
  • All vessels with an AIS transmitter, Class A or B, within the chosen distance, is displayed on the screen and move it. These are the AIS targets
  • Any target that:
    • approaches the center of the screen is a boat that can "potentially", collide with the boat of the user.
    • away from the center of the screen, is a boat which presents no risk of collision with the boat of the user.
The EBL line:
  • Click randomly in addition to the window ...
  • A line appears. So precise adjustment is very difficult.
  • She will not move ....
  • The display angle changes so that the difference between the angle that appears at the top and the angle that appears next to the ligneEBL is equal to the angle that must run a line from the vertical axis to the line EBL. One possible use:
    • Want to know which angle you see a target that is near you.
  • Click the center of the target.
  • Two information is displayed:
    • The line EBL,
    • The transcript of that target.

Rtlsdr USB

Rtlsdr USB Plugin

Use a low cost USB DVB-T (Digital TV) receiver for AIS messages from Ships

Various dongles are supported, the r820-t works the best and is also the cheapest (typically $8 USD)

Hardware Setup:

You must use a proper vhf antenna, not the one included with the dongle. I cut the antenna coax included with the dongle, and spliced it to the vhf coax. You must solder both inner and outer (shield) connections.

Software Setup:

You must now compile rtl-sdr from source:

git clone git://
mkdir build
cd build
cmake ..
sudo make install

Next, you must have either aisdecoder, or gnuradio (with gr-ais).

For aisdecoder:
tar zxvf aisdecoder.tar.gz
cd aisdecoder
mkdir build
cd build
cmake ..
sudo make install

For gnuradio with gr-ais:
<not completed>

You must run the program zadig to install the driver available here The default settings should be fine.

The receiver program (rtl_fm) and decoder (aisdecoder) are included as pre-built binaries, so from here, install the plugin setup package. So far I have no pre-built packages for gnuradio on windows, but this would be useful if provided. If there are issues it may be helpful to install the sdrsharp program to determine if the dongle is receiving data at all.

All Platforms

It should be possible (from the preferences dialog) to calibrate the dongle with the Auto Calibrate button:

From what I can tell so far, the error correction range is +- 128 (my two dongles use values of 35 and 50) and must be within 5 for aisdecoder and 15-20 for gnuradio. When the value is more accurate, more ais messages are received as well.

From here, install the plugin package, or build from source and install. This works best in an area with a lot of ais traffic. Once calibrated, ships should appear on the chart.

Log, Data & Translate

Plugin for creating and maintaining many types of logs for your boat.

A stowage Manager

VDR Voyage Data Recorder.
Plugin to record and play NMEA data files. Allows simulation of AIS.

NMEA Converter
Useful plugin to convert incoming NMEA Sentences

Shows plugin API messages. For developers to help troubleshoot problems with NMEA data streams.

Uses GPSBabel to transfer waypoints and routes to a Garmin chartplotter


The Logbook plugin is useful for creating and maintaining many types of logs for your boat.
The Logbook Konni plugin can be downloaded from the Download tab.
The wiki is a part of the download and is accessible from the plugin.

The plugin is now maintained by Del, Konnibe has been unable to continue development due to ill health.


See Install and Enable page for installing this plugin.

An additional Layouts zip file is needed for the first install and should be downloaded through the official download page.

After downloading and installing the plugin, you can install the initial layouts.
  • Start OpenCPN
  • Select Options from the toolbar (spanner icon) and go to the Plugins tab.
  • Select the Logbook plugin
  • Click the Preferences button
  • In the dialog click "Install" below the label "Install Layouts"
  • In the file dialog select the file ''

Note that the layouts are customisable by the user and can be distributed to and shared with other OpenCPN logbook users. If you have developed a useful custom layout for your logbook then please feel free to send us details.

The logbook plugin contains a extensive help file which can be accessed by clicking on the little blue book when the logbook plugin is started.


Setting preferences for the logbook is done in the Logbook Preferences dialog. You can get to this from the main OpenCPN Options window, go to the Plugins tab, select the Logbook plugin and click "Preferences"

Logging, Date and Time Behaviour

This is on the Behavior tab. Here you can adjust the following items:
  • Date format for logging -- either local format (may not work on all platforms), or select a format such as Day/Month/Year.
  • Time format -- 12 or 24 hour format with or without seconds.
  • Time zone -- either log in UTC timezone or choose the local timezone. It's also possible to log in "GPS Auto" time zone where the time zone is determined from the current longitude.


1. What and Why

This Plugin is a stowage manager.

The plugin can work alone or in conjunction with the LogbookKonni plugin.
If the LogbookKonni plugin is present and enabled and the Buy it button is pressed the items in the Material or Provisions page marked Buy will be transferred to the LogbookKonni page Maintenance/BuyParts.

2. Install

See Install and Enable page for installing this plugin.

3. Standard actions

First you have to define the Units.
E.g. Bottle, Can, Tin, Box etc.

Then you have to create the possible locations in the boat.
These Locations are user definable and depend on the possible locations on board.
The locations below are just for demo purposes.

Now you can create Material or Provisions with the units and locations defined previously.

If the Actual count will be below the Quota, the Balance will be positive and the Buy indicator will be set to Yes.
Clicking on the Buy it button will transfer the Yes marked lines to the LogbookKonni plugin in the Maintenance/BuyParts section. Depending on the Priority it will be marked in different colors.

4. Options


Voyage Data Recorder

Use Voyage Data Recorder to record and play NMEA files.

  • Use VDR for AIS Simulation - Run VDR to play AIS NMEA files. Or... use the VDR plugin to record your passages and replay them later! The VDR is also great for testing NMEA sentences, the Dashboard and new OpenCPN features. These are just a few examples, of how to use this versatile plugin.
  • When VDR is activated in ToolBar -> Options -> Plugins -> VDR, two Buttons appears in the ToolBar

  • The left button is for recording, and leads to a "Choose file" dialog to select the file to record to. A file with a .txt file extension works well.
  • The right button is for playing an existing file, and also leads to a dialog where the file must be selected. Once selected VDR starts to play the file, the small dialog below shows on the screen.
  • You can control the speed with the upper slide. Far left is slow, natural speed, while moving the slide to the far right equals fast forwarding.
  • The lower part of the dialog shows the progress.
  • When recording, the VDR plugin includes all NMEA data available on the internal bus in OpenCPN. Even data not recognized or used by OpenCPN will be recorded. Everything (almost) in the ToolBar -> Connections -> "NMEA debug window" will be included.
  • In other words. The VDR records everything from all ports and does not participate in the downstream multiplexer filter or priority scheme. That way, a VDR recording may be played back, experimenting with various filters and priorities if desired.
  • If you are playing a file with the VDR at the same time, even that data will be included. So it is possible to play and record at the same time!

Want to play ?

  • To get started, download this file. Un - 7-zip the file and change the .pdf extension to .txt. The file is now ready to play.
  • If you can't find the boat, have a look in the Adriatic or just press the "Auto Follow", or press F2. The view will now center on the action.
  • The VDR shows up as "PlugIn Virtual" in the NMEA Debug Window.

NMEA Converter

NMEA Converter can convert incoming NMEA Sentences.

Be aware you need at least some knowledge of NMEA Sentences .

Install the plugin in accord with the Install and Enable Instructions.

Then open the Preference Dialog to set your conversions.

If you see something like above please enlarge the nmeaSendDlg window so it will show some buttons.
Lets make a first test.
This is a completely useless sentence that is send every second to OpenCPN. Check also the nmeadebug window in the picture above, and note that a checksum is added to the sentence.
It is easy to change this one into something like:
That will fake a GPS position into OpenCPN, but still not very usefull.

Use incoming data to send a different NMEA sentence.

The real power of this plugin is that you can change the data of the send sentence by cherrypicking from incoming sentences.
The reason I did write this plugin was I wanted dashboard to show the airtemperature. To get the data, dashboard needs a $xxMTA sentence, however I had a Airmar PB200 unit that is sending $xxMDA sentences.
An example: We have from the windset,
and want:
Note that the data needed in in fields 5 and 6 of the MDA sentence. (11.3 degrees Celcius)
Setting the format to,
will give an output sentence: $XXMTA, 11.3, C*26
Where $WIMDA5 is replaced by the 5th field of the $WIMDA sentence. etc.

As seen above, the $XXMTA sentece is send each time a $WIMDA sentence is received, an read by dashboard.

Do math - Convert units. EG: Centigrade to Fahrenheit

But what if I was living in the US and prefered the reading to be in degrees Fahrenheit??
Just change the format to:
$XXMTA, 5 / 9 * $WIMDA5 + 32, F

As you see the value is recalculated and now displayed as degrees Fahrenheit.

Force True Heading to COG

In NMEAconverter create a HDG (compass) sentence from your COG.
Possible use when the autopilot is old and does not recieve heading (true or magnetic).

Note: Since computation of the drift and surface current requires HDG, it is understood that while using Tactics_pi value for Current speed and direction will not be useful. All you will see is the speed difference between SOG and STW, which would force Current to be the vector component normal to the keel. That means the "current" display will always be directly from bow or stern, in other words the component of the current along the centerline of the boat, assuming your STW(speed through water) is calibrated correctly.
See Tactics_pi thread in Cruiser Forum

Tactics_pi and NMEAconverter_pi shown with $XXHDT,$IIVTG1,$IIVTG2

Remember that setting HDT to COG will give you no drift angle at all (except maybe a small portion via the manual heel input), so you will not see any real current display.
The only thing that remains is the speed difference between STW and SOG, which means that you will get only the vector of current along the keel line of your boat.

I suggest to set a fixed heel angle to 0 (see screenshot above), to avoid side effects with manual heel input at very low speeds and small speed differences between SOG and STW

Calculate True Wind from Apparent Wind

Boat Speed ground (kts) = SOG
Apparent wind speed (degrees) = AWS
Apparent wind angle (degrees) = AWA

MWV - Wind Speed and Angle - Input

Field Number:
  1. Wind Angle, 0 to 360 degrees
  2. Reference, R = Relative, T = True
  3. Wind Speed
  4. Wind Speed Units, K/M/N
  5. Status, A = Data Valid
  6. Checksum
Field Number:
  1. Blink Warning
  2. Latitude
  3. N or S
  4. Longitude
  5. E or W
  6. Time Difference A, uS
  7. Time Difference B, uS
  8. Speed Over Ground, Knots
  9. Track Made Good, degrees true
  10. Magnetic Variation, degrees
  11. E or W
  12. Checksum

MWV - Wind Speed and Angle - Output TW in Knots

Field Number:
  1. Wind Angle, 0 to 360 degrees
  2. Reference, R = Relative, T = True
  3. Wind Speed
  4. Wind Speed Units, K/M/N
  5. Status, A = Data Valid
  6. Checksum
Nmea0183 from

Calculations Needed:
x =AWS*sin(AWA*3.14159265/180)
y =(x/tan(AWA*3.14159265/180)) - SOG
TWS (True Wind Speed) =x/sin(TWA*3.14159265/180)
TWA (True Wind Angle) =atan(x/y)*180/3.14159265
*Formula from

The formula now needs to be completed:

Contribute your Formulas & Conversions

If you have an usefull format formula pls. feel free to add it here .

Another future possibility is to do a comparison lookup of a boat''s Polar data and send a special NMEA sentence of the comparative result to the Dashboard using a special dedicated performance instrument, for example.

Calculations Supported

For calculations the following functions are suported:

Normal functions

abs : the absolute value, it removes the sign
ceil : the smallest integer greater than or equal to x
cub : x^3, safe way to compute such an exponent
deg : converts from radian to degree
exp : the exponential value
hvi : Heaviside's function, =0 if x<0, =1 if x>=0
int : the largest integer less than or equal to x
inv : inverts, 1/x
floor : not supported, see int
ln : the neperian logarithm
lnep : see ln
log : the logarithm base 10
rad : converts from degree to radian
sgn : the sign, -1 or +1. Zero returns +1.
sqr : x^2, safe way to compute such an exponent
sqrt : the root square

Trigonometric functions

acos : the secant (inverse of cosine)
acsh : the inverse of the hyperbolic cosine
asin : the cosecant (inverse of sine)
asnh : the inverse of the hyperbolic sine
atan : the cotangent (inverse of tangent)
atnh : the inverse of the hyperbolic tangent
cos : the cosine
cosh : the hyperbolic cosine
sin : the sine
sinc : the cardinal sine (radian)
sinh : the hyperbolic sine
tan : the tangent
tanh : the hyperbolic tangent

This makes it possible to do spreadsheel like calculations. And as in a spreadsheet the trigonometric functions are using radians.


1. What and Why

OpenCPN is a fantastic program for planning routes but sometimes these routes need to be transferred to chartplotters from Garmin, Raymarine etc.

The oBabel plugin is intended to make the transfer of routes and waypoints from OpenCPN to (Initially) Garmin Chartplotters easier. These instructions are for using oBabel with MS Windows. It has not been tested with other OS.

At present the transfer of waypoints directly from OpenCPN via NMEA0183 is possible, but not the routes they are part of. Using the program GPSBabel as part of the plugin allows the transfer of routes via the Garmin protocol, if a Garmin plotter is being used.

2. Install

Download the oBabel_pi.dll plugin file and place this file in the plugins folder of OpenCPN.

The OpenSource GPSBabel program needs to be installed on your computer. A copy can be downloaded from here:

3. Standard actions

Connect your chartplotter to the OpenCPN computer using a serial cable.

Enable the plugin by using Tools/Options and pressing the Enable button.

The main page of the plugin appears:

The plugin should detect the comport (COM2 in this case) that is being used for the connection to the plotter. If you have been using this serial comport already as one of the connections in OpenCPN you will need to delete the connection using Tools/Connections in OpenCPN. oBabel and OpenCPN cannot use the same comport.

The Garmin plotter communication configuration must be set to 'Garmin'.

The plugin uses the OpenSource GPSBabel program. Find the 'gpsbabel.exe' program file by pressing 'Locate GPSBabel'. The path to the file appears in the textbox on the left.

In this first runthrough we will transfer a route using KML and the clipboard.

In OpenCPN display the route you wish to transfer. 'Right-Click' anywhere on the route and choose the option 'KML Standard'.

Right-Click again in the Clipboard area of the plugin and the KML text will appear.

Use the checkboxes to select what you want to transfer. Finally press 'Clipboard->GPSBabel'. A box will appear showing the options you have chosen.

Pressing 'OK' starts the transfer. You will see some screen activity as GPSBabel is started and does the work. Using a Garmin plotter you will hear a 'beep' as each transfer is completed.

4. Options

Transfer saved route from OpenCPN

It is possible to transfer a route that has been saved on your computer. If it is a route exported from OpenCPN use the dropdown 'KML/oGPX/GPX' and select 'oGPX'.

Press 'File->GPSBabel' and the 'Proceed' page appears. Using 'Ok' starts the transfer.

Transfer a saved Route GPX from other programs

For routes from EasyGPS and other sources choose 'GPX' from the dropdown 'KML/oGPX/GPX'.

Transfer a single waypoint from OpenCPN via KML

Use the same technique as shown above for copying a route to the clipboard. In this case 'Right-Click' on the waypoint you wish to transfer.

5. FAQ


World Magnetic Model (Included Plugin)
A plugin to display the magnetic variation, based on the World Magnetic Model.
Celestial Navigation
Plugin to record Sextant Sights and show Circles of Position to obtain a Fix
Route Great Circle
A short introduction to to the Great circle part of the Route Plugin. Route Plotting, Great Circle routes, Limited Circle Routes and Rhumb lines.

DR Dead Reckoning
Add DR positions to a GPX file exported from OpenCPN
Global user-sourced and user-maintained repository of sailing destinations (marinas, anchorages, yacht clubs, docks, fuel stations etc.) available as waypoints in OpenCPN through a plugin.

Google Earth
Gecomapi - Google Earth Plugin Turn Google earth into chart overlays

GE2KAP (a companion piece of software, not a plugin)
Use GoggleEarth(GE)2Kap to create Kap files which can be overlaid on Charts
Drawing tools, Boundaries, EBL & VRM, link to Watchdog for keep in & out alarms.

Display tidal current arrows for times other than the present

Celestial Navigation

Plugin to record Sextant Sights and show Circles of Position to obtain a Fix

Celestial navigation support makes it possible to establish your position when other means are not available. Also, users may find this plugin, which is still under development, useful for cross checking their position fixes obtained in other ways, or to to better visualize a celestial fix. You find the forum thread here: Cruisersforum thread: celestial navigation plugin

Four Circles of position

Types of Observations

Currently 3 types of observations are, more or less, supported:
  1. Altitude (sextant measurement) -- Measure the angle between the horizon and a heavenly body, and enter the required data in the plugin. Each measurement results in a Circle of Position on the sphere (COP, or Circle of Equal Altitude). Two or more observations result in intersecting COP's from which a position fix can be obtained.
  2. Azimuth (compass measurement) -- Measure the azimuth (bearing) of a heavenly body. This method is hopelessly inaccurate, especially on a small boat in high seas. However, it is interesting for demonstration purposes, and possibly - with accurate digital compasses - it may be a viable navigation method in the future.
  3. Lunar distance (sextant measurement) -- Measure the angle between two heavenly bodies. The computer then attempts to determine clock error from this measurement, and the system time may be corrected.


1. Obtaining Sights with Sextant

Standard practice in navy and merchant navy with regard to celestial positioning is as follows (assuming no artificial horizon is available on the sextant):
  1. During morning nautical twilight (about 15 minutes): if possible take 6 star/planet observations.
  2. In the morning at about 09:00LT: take a Sun's observation (later to be shifted to noon-time).
  3. At local noon: take a Sun's observation (traditionally only direct latitude calculation from sun at meridian passage). Construct a fix for noon from both sun observations.
  4. During evening nautical twilight (about 15 minutes): if possible take 6 star/planet observations.
  5. Use the Moon for an observation in above practice when situation permits.
Many books have been written about the art and science of celestial positioning (see below).

This is the document containing the test data used for the example below: Example worksheet (4 star observations).

2. Sight Properties - Sight Tab - Enter Star Data

Enter Type (Altitiude, Azimuth, Lunar), Celestial Body, Limb, Measurement and Degrees of Certainty. Degrees of Certainty is the accuracy the navigator assumes for the observation. A larger value results in a larger line width for the Circle of Position on the chart.

Sight 1  Degrees Minutes Degrees Uncertainty

3. Sight Properties - Date and Time Tab

Enter Date, Time, Certainty and Shift. Note that entering a shift removes the calculated numerical fix. This is due to the computation method used, which presently does not allow to shift COP's. However, a position fix can be established by visualy observing the COP's (which are graphically shifted) on the chart.

Sight 2 - Data Time and Certainty

4. Sight Properties - Config Tab - Display Characteristics

Enter Transparency and Color you wish to use for the COP.

Sight 3 - Configuration

5. Sight Properties - Parameters Tab

Enter Eye Height, Temperature, Pressure and Index Error.

Sight 4 Parameters

6. Sight Properties - Calculations Tab

Showing the input figures and some calculated results for the observation. Together with the calculated numerical position fix showed in the main window of the plugin, this can be used for comparison with results that are obtained by other calculation methods (traditional manual method using logarithms, traditional or direct compution methods as mentioned in Nautical Almanac, shortened methods using e.g. US Pub. 229 or US Pub. 249, other computer applications).

Sights 5 Calculations A Circle of Position (COP) indicates all the positions on earth where a navigator may observe the same altitude of a heavenly body at a certain time. Using traditional methods, only the part of a COP the navigator is interested in is used, and replaced by a tangent line (LOP).

Four Circles of Position

8. Four Circles of Position (showing DR position as MOB and fix as Waypoint)

The MOB icon shows the initial DR position entered. The red circle indicates the intersection of the crossing red lines, the calculated position fix. Hover cursor over the crossing, right click and place a mark. If required, visually adjust this to get best latitude and longitude of the fix. In Sight Properties - Sight Tab, Degrees Certainty was set to 0.05.

Four Circles of Position Entered


General Traditional Theory

A general, but very clear text on celestial positioning is available in the PDF file on the web site of Henning Umland: Many thanks to Henning Umland for this concise text. Naturally, also the information provided by the Nautical Almanac and Bowditch is of interest (see 'Links').

Plugin Computation Methods

The plugin is still under development and the computation methods used are innovative and based on vector, matrix and least squares methods. The author, Sean d'Epagnier, uses this innovative method to directly calculate a fix position. Only he knows the background and details.

General information on direct computation methods can be found on pages 277 to 285 of the Nautical Almanac 1994 (see 'Links') and in the following articles: Presently, the plugin is not capable of advancing COP's to a common time. When a shift is entered, the calculated numerical position on the main window disappears. In this case, the fix can only be established by visual examination of the graphics on the screen (see also 3. Sight Properties - Date and Time Tab, and 8. Four Circles of Position) and a fix time cannot be established.

Accuracy of Data

Comparision of Plugin Astronomical Data and Nautical Almanac Data

The data and formulae contained in the Nautical Almanac form a standard in itself. The plugin utilises astronomical data from VOP87d (for the planets and indirectly for the sun), ELP2000/82 (for the moon) and contains Right Ascension (RA; star's SHA = 360° - star's RA) and Declination (Dec) data for the selected stars.

During development of the plugin, the calculated (intermediate) correction values for dip, refraction, horizontal parallax, parallax in altitude and semi diameter, as well as the calculated position fix, should be compared to values that result from other computation methods.

The astronomical data used in the plugin is more accurate than data taken from the Nautical Almanac. However, for navigation purposes the differences are generally not important. With regard to altitude reductions, so far test data indicates that the differences found in calculated observed altitude (Ho) are small. Measurement and reading errors made by the navigator will be larger. Using the present version, calculated fix positions can still differ from those calculated with traditional methods.

Accuracy of Plugin Astronomical Data

The plugin astronomical data are from Jean Meeus' Astronomical Algorithms.
  • Planetary positions are based upon a truncated version of Bretagnon and Francou's VSOP87 theory. The estimated maximum error in the heliocentric longitude is several arc-seconds. Geocentric positions are accurate to within a few arc-seconds.
  • Lunar positions are calculated using a truncated version of the lunar theory ELP-2000/82 of Chapront-Touzé and Chapront. The estimated maximum error in the geocentric longitude is about 10 arc-seconds.

Accuracy of Data in the Printed Nautical Almanac

The largest error that can occur in GHA and declination of any body other than the Sun or Moon is less than 0.2'; it may reach 0.25' for the Sun and 0.3' for that of the Moon. In practice it may be expected that only one third of the values of GHA and declination will have errors larger than 0.05', and less than one tenth will have errors larger than 0.1'.

The errors in the altitude corrections are nominally in the same order (but the actual values of dip and refraction at low altitudes may differ considerably in extreme atmospheric conditions).

Depending on the type of sextant, the reading accuracy of the sextant can be 0.2', 0.1' or 10". Measurement and reading errors made by the navigator will be larger.


Some abbreviations of terms are given in the list hereunder. Not all of these abbreviations conform to a standard.
DR Dead Reckoning Position
AP Assumed Position
MPP Most Probable Position
COP Circle of Position (Circle of Equal Altitude)
LOP Line of Position
HA Hour Angle
GHA Greenwich Hour Angle
LHA Local Hour Angle
SHA Siderial Hour Angle
RA Right Ascension (star's SHA = 360o - star's RA)
Dec Declination
GP Geographical Position (of heavenly body; Lat = Dec, W_Lon = GHA or E_Lon = 360° - GHA)
ic Index Correction (= - Index Error of sextant)
Dip Dip of the Horizon (function of eye height)
R Refraction (function of Ha, temperature and pressure)
HP Horizontal Parallax
PA Parallax in Altitude (function of HP and Ha)
SD Semi Diameter
Hs Sextant Altitude
Ha Apparent Altitude
Ho Observed Altitude
Hc Computed Altitude
Z Azimuth
Int Intercept (= Ho - Hc)


by Ming-Cheng Tsou, Ph.D., National Kaohsiung Marine University, Taiwan
POLISH MARITIME RESEARCH 3(75) 2012 Vol 19; pp. 53-59 10.2478/v10012-012-0031-5 ABSTRACT
In this work, we employ a genetic algorithm, from the field of artificial intelligence, due to its superior search ability that mimics the natural process of biological evolution. Unique encodings and genetic operators designed in this study, in combination with the fix principle of celestial circles of equal altitude in celestial navigation, allow the rapid and direct attainment of accurate optimum vessel position. Test results indicate that this method has more flexibility, and avoids tedious and complicated computation and graphical procedures.

Article: The Direct Fix of Latitude and Longitude from Two Observed Altitudes

by Stanley W. Gery
Neptune Power Squadron, Huntington, New York, Received April 1996, Revised December 1996 ABSTRACT
This work presents a direct method for obtaining the latitude and longitude of an observer from the observed altitudes of two celestial bodies. No assumed position or dead-reckoned position or plotting is required. Starting with the Greenwich hour angles, declinations, and observed altitudes of each pair, the latitude and longitude of the two points from which the observations must have been made are directly computed. The algorithm is presented in the paper, along with its derivation. Two different, inexpensive, programmable pocket electronic calculators were programmed to execute the algorithm, and they do it in under 30 s. The algorithm was also programmed to run on a personal computer to examine the effect of the precision of the calculations on the error in the results. The findings show that the use of eight decimal places in the trigonometric computations provides acceptable results.

Article: New Computational Methods for Solving Problems of the Astronomical Vessel Position

by Tien-Pen Hsu (1), Chih-Li Chen (2) and Jiang-Ren Chang (3)
(1) Institute of Civil Engineering, National Taiwan University
(2) Institute of Merchant Marine, National Taiwan Ocean University
(3) Institute of Systems Engineering and Naval Architecture, National Taiwan Ocean University; E-mail:
THE JOURNAL OF NAVIGATION (2005), 58, 315–335. The Royal Institute of Navigation, doi: 10.1017/S0373463305003188, Printed in the United Kingdom ABSTRACT
In this paper, a simplified and direct computation method formulated by the fixed coordinate system and relative meridian concept in conjunction with vector algebra is developed to deal with the classical problems of celestial navigation. It is found that the proposed approach, the Simultaneous Equal-altitude Equation Method (SEEM), can directly calculate the Astronomical Vessel Position (AVP) without an additional graphical procedure. The SEEM is not only simpler than the matrix method but is also more straightforward than the Spherical Triangle Method (STM). Due to tedious computation procedures existing in the commonly used methods for determining the AVP, a set of optimal computation procedures for the STM is also suggested. In addition, aimed at drawbacks of the intercept method, an improved approach with a new computation procedure is also presented to plot the celestial line of position without the intercept. The improved approach with iteration scheme is used to solve the AVP and validate the SEEM successfully. Methods of solving AVP problems are also discussed in detail. Finally, a benchmark example is included to demonstrate these proposed methods.

Article: Use of Rotation Matrices to Plot a Circle of Equal Altitude

by A. Ruiz
Industrial engineer, Navigational Algorithms
Journal of Maritime Research, Vol. VIII. No. 3, pp.51-58, 2011 ABSTRACT
A direct method for obtaining the points of a circle of equal altitude using the vector analysis as an alternative to the spherical trigonometry is presented, and a solution where celestial navigation and Global Navigation Satellite Systems are complementary and coexist is proposed.

Article: Determining the Position and Motion of a Vessel from Celestial Observations

by George H. Kaplan
U.S. Naval Observatory ABSTRACT
Although many mathematical approaches to the celestial fix problem have been published, all of them fundamentally assume a stationary observer. Since this situation seldom occurs in practice, methods have been developed that effectively remove the observer's motion from the problem before a fix is determined. As an alternative, this paper presents a development of celestial navigation that incorporates a moving observer as part of its basic construction. This development allows recovery of the information on the vessel's course and speed contained in the observations. Thus, it provides the means for determining, from a suitable ensemble of celestial observations, the values of all four parameters describing a vessel's rhumb-line track across the earth: latitude and longitude at a specified time, course, and speed. In many cases, this technique will result in better fixes than traditional methods.
Copyright © 1997-2011 Henning Umland; PDF file can be found on this page on his web site: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".
Revised October 1st, 2011, First Published May 20th, 1997

Book: The Sextant Handbook

Copyright © 1986, 1992 Bruce A. Bauer
International Marine
ISBN 0-07-005219-0 The Sextant Handbook is dedicated to the premise that electronic navigation devices, while too convenient to disregard, are too vulnerable to rely on exclusively. The book is designed to make beginner and expert alike conversant with this most beautiful and and functional of the navigator's tools.

Examples of Test Data

  • Example worksheet (observation of 4 stars for fix calculation)
  • Alternative worksheet (observation of Sun, Moon, Venus and Polaris for altitude reduction only)
We should thank Sean who has advanced the work of others admirably, and NAV for his technical review of the plugin, his knowledge, and his generous assistance in preparing this documentation. Rick.

Route Great Circle

Route Plugin

"Salty Paws" route plugin handles much more than Great circles, introduced here.

The plugin have a few features not present in the built-in tool. It can calculate a composite route, and the distance between the waypoints can be set by the user. The end result, however, is a "gpx" file that is exported, and then imported into OpenCPN via the Route Manager.

A Great-circle from Cook Strait to Cape Horn limited by 60° S

Go to Table Of Contents

DR Dead Reckoning

Add DR positions to a route by means of editing a gpx file, which has been exported from 'Route Manager'.


In navigation, dead reckoning or dead-reckoning (also ded for deduced reckoning or DR) is the process of calculating one's current position by using a previously determined position, or fix, and advancing that position based upon known or estimated speeds over elapsed time and course.

1. What and Why

The DR plugin is a means of adding DR positions to a route. Because the plugin cannot access 'Route Manager' directly it works by editing a gpx file, which has been exported from 'Route Manager'.

DR speed and the time between the DR positions can be changed before the DR gpx is finally created.

This plugin is a temporary solution to the problem of creating DR positions. The Draw plugin now allows the creation of DR positions for course legs.

2. Install

Copy 'DR_pi.dll' to the plugins folder. Start OpenCPN. Tools/Options and select 'Enable' for the DR entry.

3. Standard actions

Save the route which you want to add DR positions to by using 'Route Manager'. Make a note of the folder where this original route file can be found.

Start DR:

The main page of the plugin appears:

The DR speed and interval between DR positions have been added. The DR route name is entered in the bottom box.

The process of creating the DR route is started by pressing 'Generate GPX'. A file dialog box appears.

Select the route GPX file where DR positions will be added.

Immediately after selecting this file a new file dialog box appears.

After pressing 'Save' the route_dr gpx file is created in the folder you have chosen. If the original file is not needed you can use the same file name and the original file will be over-written.

The plugin can now be closed.

Using 'Route Manager' import the DR gpx:

The DR route is now available. To avoid confusion the original route can be hidden by using the 'Eye' symbol.



The Ocpn_Draw Plugin (OD) is designed to allow users to place objects/items on the OpenCPN interface and have these georeferenced. This allows the objects/items to move with the chart and have a definined Latitude and Longitude. There are two basic types of object/item that can be used:
  • Points
  • Paths
Points are very similar to Waypoints and mark locations on the chart. Paths joine two or more points together and draw a line between them. Currently these Points exist:
  • Boundary Point
  • Text Point
  • Electronic Brearing Line (EBL) Point
  • Dead Reckoning (DR) Point
  • Guard Zone (GZ) Point
These Points are used to construct special types of Paths:
  • Boundary
  • Electronic Bearing Line (EBL)
  • Dead Reckoning (DR)
  • Guard Zone (GZ)
The example screen shot below shows an example of each type of Point and Path.

WatchDog Alarms

Ocpn_Draw_pi (OD) provides a graphics companion to Watchdog_pi (WD) Alarms.
OD is used as a graphics tool to create Boundary Graphics and Boundary Point Graphics.
WD will then create "Boundary Alarms" using the Boundary Graphics created by OD.
The alarms that WD can create are (GPS proximity, GPS course & time, Anchor, AIS) depending on the alarm type WD may require a particular Boundary GUID or the alarm may apply to all boundaries that are displayed.
The WD alarm types are separate and distinct from the OD graphics types (inclusive, exclusive, neither).
OD knows nothing about the WD plugin, it just responds with information about specific Lat/Lon combinations. WD can use the graphic type that OD has to help filter which boundaries to look for. So if you have a large number of boundaries of mixed 'types' it would probably help if you selected the type of boundary to look for rather than use the default 'Any'.

ODraw and WatchDog interactions

See Plugin Messaging between ODraw , Watchdog and Weather_routing.
A simple way to visualise the interactions between ODraw Boundaries and WatchDog boundaries alarms is layed out in this chart.

The chart shows which OD Boundary objects will cause a WD alarm to ring. If the WD alarm is set to Exclusion, the alarm will ring, go off, if an Exclusion boundary is found within the alarm area, i.e. time or distance. However, no other type of boundary will cause the alarm to go off. So when you setup the alarms you need to check the above matrix to ensure you will get the alarm when you want it.


This plugin requires the most current version of Opencpn
Download the plugiin from the Plugin Downloads secton of


Settings > Plugin > Ocpn_Draw > Preferences

Under Preferences the Tabs are General, Boundary, Boundary Point, Text Point, Path, EBL, DR, DR Point and About where various settings are selected. Generally the defaults should give a reasonable starting point. However, all the defaults that are used can be changed from here.


Confirm Delete
This setting determines whether a dialog box will be shown asking for conformation about deleting any objects. With it checked you will be asked to confirm all deletes, with it unchecked you will be able to delete any object without being asked for confirmation.
If you do delete an object by mistake and you have 'Nav Object Backups' set to more than 0, you will be able to use one of these backups to restore your objects.
Show Magnetic Bearings
If this is checked and there is a magnetic variation available then this will be applied to all angles that are used within the plugin. If it is checked and there is no magnetic variation available it will assume a '0' variationi. This setting determines how many backups to keep of the navigation objects file. The location of the files can be found in the opencpn.log file. Each time OpenCPN stops a new copy of the navigation obj file will be created. The latest file is called 'ODnavobj.xml'.
Edge Panning Sensitivity
This is the percentage of the screen size distance from the edge that will cause the screen to pan when using the drawing tools. The bigger this number the further from the edge of the screen your pointer will be when the screen starts panning.
Initial Edge Panning Sensitivity
This is the same as above, but is used after a drawing tool is picked but before the first object is created. This is supplied so that the screen does not start panning if you move your pointer off of the toll bar near the edge of the screen.
Display Toolbar
The plugin allows you to use two graphical methods of selecting the tool you wish to draw with:
  1. The main Toolbar and the right mouse click
  2. The Draw Toolbar
This setting determines if the tool bar is display and has three settings
  1. Never - the toolbar is not displayed
  2. Whilst Drawing - the toolbar is displayed whilst a drawing tool is active
  3. Always - the toolbar will display all the time irrerspective of whether you are using the plugin.


Active Line Colour
This is the colour of an active Boundary Line
Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Active Fill Colour
This is the default colour to use for any active Boundary fill hash. When selected a standard, platform dependant, colour picker will be presented. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Inactive Line Colour
This is the colour of an inactive Boundary Line.
Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Inactive Fill Colour
This is the default colour to use for any inactive Boundary fill hash. When selected a standard, platform dependant, colour picker will be presented. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Line Width
This is the width of the Boundary Line in pixels. It can be a value between 1 and 10 pixels.
Line Style
This defines how the Boundary Line is drawn. It can be one of the following:
  • Solid
  • Dot
  • Long Dash
  • Short Dash
  • Dot Dash
Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800x1900 the difference between the line types may be difficult to see.
Fill Density
This allows the setting of how transparent the fill hash is. A value of 0 means that it is fully transparent and a value of 255 is that it is fully opaque. The term density is used as it seemed clearer, i.e. low density - you can see through it, high density - you cannot see through it.
Boundary Inclusion Size
This defines, in pixels, how wide the hash is around the outside Boundary Line when the Boundary is of type 'Inclusion'.
Boundary Type
This radio button selection sets the default type for all Boundary. Points.
  • Exclusion - fill the inside of the Boundary with a hash.
  • Inclusion - surround the Boundary with a nominated size hash
  • Neither - just draw the Boundary Line with no hash

Boundary Point

Arrival Radius
This is not really relevant to a Boundary Point at the moment, but may become useful if other items/capabilities are added
Show Name
This is the default setting for showing the Boundary Point name. Currently Boundary Points are created with the name empty/blank so nothing displays.
This is the default icon to use for all Boundary Points. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual
Show Range Rings
Boundary Points can have range rings associated with them. To show the rings by default this setting needs to be checked.
Boundary Point Type
This radio button selection sets the default type for all Boundary Points.
  • Exclusion - fill the inside range rings with a hash.
  • Inclusion - surround the largest range ring with a nominated size hash
  • Neither - just draw the range rings but there is no hash
Fill Density
This allows the setting of how transparent the fill hash is. A value of 0 means that it is fully transparent and a value of 255 is that it is fully opaque. The term density is used as it seemed clearer, i.e. low density - you can see through it, high density - you cannot see through it.
Boundary Point Inclusion Size
This defines, in pixels, how wide the hash is around the outside Boundary Point Range Ring when the Boundary Point is of type 'Inclusion'.
Number of Range Rings
This defines the number of range rings to show if they are selected to be shown. If Zero is selected, then there will be no range ring shown.
Distance Between Range Rings
This is the gap between sucessive range rings. The measurement this is using is defined in the Distance Unit' setting
Distance Unit
The unit of measurement to use for the range rings gap. It can be:
  • Nautical Miles
  • Kilometers
Range Ring Colours
This is the default colour to use for any Boundary Point Range Ring. When selected a standard, platform dependant, colour picker will be presented. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Range Ring Line Width
This is the width of the range rings when drawn in pixels. It can be a value between 1 and 10 pixels.
Range Ring Line Style
This defines how the Range Rings are drawn. It can be one of the following:
  • Solid
  • Dot
  • Long Dash
  • Short Dash
  • Dot Dash
Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800x1900 the difference between the line types may be difficult to see.

Text Point

Text Point Icon
This is the default icon to use for all Text Points. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.
Text Position
This selects where the text is positioned relative to the location of the Text Point. If you show an Icon it will be easer to see and interact with the text on the screen. If you do not use an Icon it may be easier to use the Path Manager to get to the Text Point.
There are 7 differnet locations:
  • Top
  • Top Centre
  • Bottom
  • Bottom Centre
  • Centre
  • Right
  • Left
Text Colour
This is the colour that the default Display Text will have. Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Background Colour
When a Text Point displays text it will have a coloured background to help it stand out from the underlying chart. This is the default colour of the background box. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Background Density
This allows the setting of how transparent the background colour. A value of 0 means that it is fully transparent and a value of 255 is that it is fully opaque. The term density is used as it seemed clearer, i.e. low density - you can see through it, high density - you cannot see through it.
The default density is 100.
Text Font
This is the default font to be used for the 'Display Text'. The 'Fonts' button will allow picking of any font that is installed on the system. You can pick the Family, Style and Size of the font. This is presented by a platform specific font picker.
The current font that will be used is shown by the work 'Example' which will be drawn using the font selected.
Show Display Text
This is the default for when the Display Text of a Text Point is shown.
  • Always - Display text is always shown
  • On Rollover Only - The text will be displayed when the mouse pointer rolls over the Text Point. This is to try and help declutter the screen if there are many objects being concurrently displayed.
  • Never - The display text is not displayed


Active Line Colour
This is the colour of an active generic Path if there is no specific type. Currently this is not used as there are no unspecified Path types in use.
Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Inactive Line Colour
This is the colour of an inactive generic Path if there is no specific type. Currently this is not used as there are no unspecified Path types in use.
Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Line Width
This is the width of the Path Line in pixels. It can be a value between 1 and 10 pixels.
Line Style
This defines how the Path Line is drawn. It can be one of the following:
  • Solid
  • Dot
  • Long Dash
  • Short Dash
  • Dot Dash
Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800x1900 the difference between the line types may be difficult to see.

Electronic Bearing Line (EBL)

Start Point Icon
This is the default icon to use for the start point of an EBL. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.
End Point Icon
This is the default icon to use for the end point of an EBL. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.
Active EBL Line Colour
This is the colour of an active EBL.
Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Inactive EBL Line Colour
This is the colour of an inactive EBL.
Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Line Width
This is the width of the EBL in pixels. It can be a value between 1 and 10 pixels.
Line Style
This defines how the EBL is drawn. It can be one of the following:
  • Solid
  • Dot
  • Long Dash
  • Short Dash
  • Dot Dash
EBL Fixed End Position
This the default for all EBL's. This fixes the End Point of an EBL such that when the boat moves the end point does not. If this is left uncheck the end point of the EBL will move with the boat so the EBL always has the same length and bearing.
Show EBL Direction Arrow
This is the default for all EBL's. If checked a direction arrow will be displayed on the EBL at or near the end point. This helps show the direction of the EBL.
EBL Persistence
The EBL's that are created can be:
  • Persistent - will presist over a restart of OpenCPN
  • Persistent over Crash - will not be persistent over a normal restart of OpenCPN, but will be persistent over a crash of OpenCPN
  • Never - the EBL will only be temporary and will not be displayed again when OpenCPN is restarted.
Show VRM
This draws a Variable Range Marker (Ring) centred on the start point and sized to go through the end point.

Dead Reckoning (DR)

DR Point Icon
This is the default icon to use for the all points of a Dead Reckoning line. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.
Active DR Line Colour
This is the colour of an active DR Line
Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Inactive DR Line Colour
This is the colour of an inactive DR Line.
Selection is by a platform specific colour picker. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Line Width
This is the width of the DR line in pixels. It can be a value between 1 and 10 pixels.
Line Style
This defines how the DR line is drawn. It can be one of the following:
  • Solid
  • Dot
  • Long Dash
  • Short Dash
  • Dot Dash
Speed over Ground
This is the default speed over the ground to use when calculating the DR line.
Course over Ground
This is the default course over ground to use. The type, True or Magnetic, is determined by the setting in the General tab.
DR Path Length
This is the default length of the DR line.
DR Point Interval
This is the default interval to place points along the DR path.
Length Type
This is the default length type to be used, either Time or Distance.
Interval Type
This is the default interval between placing points, either Time or Distance.
Distance Units
This is the default distance units to use, either Kilometres or Nautical Miles
Time Units
This is the default time units to use, one of Minutes, Hours or Days
DR Persistence
The DR lines that are created can be:
  • Persistent - will presist over a restart of OpenCPN
  • Persistent over Crash - will not be persistent over a normal restart of OpenCPN, but will be persistent over a crash of OpenCPN
  • Never - the DR line will only be temporary and will not be displayed again when OpenCPN is restarted.

Dead Reckoning Point (DR Point)

Show Range Rings
Boundary Points can have range rings associated with them. To show the rings by default this setting needs to be checked.
Number of Range Rings
This defines the number of range rings to show if they are selected to be shown. If Zero is selected, then there will be no range ring shown.
Distance Between Range Rings
This is the gap between sucessive range rings. The measurement this is using is defined in the Distance Unit' setting
Distance Unit
The unit of measurement to use for the range rings gap. It can be:
  • Nautical Miles
  • Kilometers
Range Ring Colours
This is the default colour to use for any DR Point Range Ring. When selected a standard, platform dependant, colour picker will be presented. This will allow the colour to be any RGB (Red, Green, Blue) colour that is supported by the platform.
Range Ring Line Width
This is the width of the range rings when drawn in pixels. It can be a value between 1 and 10 pixels.
Range Ring Line Style
This defines how the Range Rings are drawn. It can be one of the following:
  • Solid
  • Dot
  • Long Dash
  • Short Dash
  • Dot Dash

Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800x1900 the difference between the line types may be difficult to see.


This page provides useful information in the event you have problems with the Plug In. Please provide the version number and the patch number with any reported incident. You should also provide the version number of OpenCPN as this will help identify where the issue may be.

Interface at the Icon Toolbar

Draw Icons

Draw Create (right icon)

The plugin has an interesting interface with two icons as shown above for Draw Manager and Draw Create.
The right icon Draw Create is dynamic and will show a different icon dependent on which drawing object type has been selected. Cllick on the right icon and a floating Draw Toolbar appears containing Draw Tools, with the last one used selected as default (appears depressed). Select the Drawing Tool needed.

The above Draw Tools are for Boundary, then Boundary Points, Text points, EBL and DR in that order.
The Drawing Objects that are available are as follows:
  • Boundary
  • Boundary points
  • Text points
  • Electronic Bearing Lines (EBL) & Variable Range Marker (VRM)
  • Dead Reckoning
Try drawing several of each type to learn how they work and what they create.

You can select the next tool in sequence by right clicking the mouse prior to starting to draw. Once a left mouse click has been done the right click will terminate the 'create' drawing. You can also stop the 'create' mode by hitting 'Esc', left mouse clicking the selected tool in the main toolbar or by left mouse clicking on the close icon in the 'Draw Toolbar'. It sounds complicated, but you will find one of the methods should meet your normal usage requirements.

Each tool has a cursor icon:
  • Boundary: Pencil
  • Boundary Point: Red Cross
  • Text Point: 'I' icon
  • EBL: Red Cross and a line joining the cursor to the boat
  • DR: Red Cross
The DR tool does not draw based on the current cursor position, it brings up a dialog box that allows you to enter the DR information.

When you left mouse click 'OK' the DR line will be drawn based on the information you have entred. The information that is first displayed is the default information entered into the properties panel or the current information available to OpenCPN, i.e. SOG and COG.

Draw Icons

Draw Manager (left icon)

The left Icon is for the Draw Manager which gives the user control over each of the Drawing objects that have been created from the Draw Toolbar. From the Drawing Manager menu Path & Point Manager Tabs for Paths, Ocpn Points, Layers become available, and selected Drawing Objects can be Shown, Hidden, Deactivated, Centered, Deleted, Exported, Delete All, and Export All. Additionally a drawing object's Properties can be accessed and changed.

First select one or more Drawing Objects under a given Tab. Then select the desired Action on the right.
For example: Select all Drawing Objects under Paths Tab, then select Delete. This will remove all of the Drawing Objects under Path Tab. Of course the quick alternative is to select Delete All.
Properties, Deactivate and Center View are greyed out when more than one object is selected.

Drawing Manager > Layers
Drawing Objects imported into Layers are static and non editable. Use Layers in the same way as the Route and Waypoint manager does, i.e. Temporary Layers. It will bring in boundaries and points and show or hide them as required. You can load more than one layer file into the same layer, just select more than one file in the file manager popup and they will load into the same layer. To use Layers and move Drawing Objects into a temporary user created Layer, select them, Export Selected and then from the Layer Tab Import.

Edit Mode for Draw Objects
First, to get out of the creative draw mode, click on the Draw Button and hit escape.
Then in the drawing hover over the object you wish to modify until a square yellow descriptor appears, then right click. The popup menu's first line will identify the type of drawing object you have selected. Then there will be a action pick list, dependent on the object, such as Properties, Move.., Insert.. Deactivate.. Delete. Some drawing objects are made of several parts, (Boundary, Boundary Points, EBL & VRM) so it makes a difference where you hoover and the condition of the object.
1. To select a Boundary, hoover over the edges. To select a boundary point hover over it.
2. To select an EBL hover over the ends or the shaft, depending on whether the EBL is centered on a boat or lat/long the right click actions will be different. The popup menu list selections should be self explanatory.
When you have right clicked and selected an action, for example to move a boundary, text point or boundary point, the point willl be highlighted with a yellow dot. Complete the move by dragging and releasing.
For editing any characteristics such as color, line thickness, font, etc, use 'Properties', but if you just want to move a point select 'Move'. To move a point you will need to right click and select move.
Having selected move you will then need to put the cursor over the selected object, push and hold the left mouse button and drag the object to where you want it. When you let go of the left mouse button the cursor (what ever it was showing before) should revert to the standard pointer and the 'move' process is terminated. If you want to move the object again, you will have to right click again to get the popup and repeat the process.

Edit Mode for Draw Object Properties
There are multiple ways to access an object's Properties.
  • In Path & Point Manager double click on a Drawing Object, Properties will appear.
  • In the Drawing hover over the Drawing Object, right click and pick Properties.
  • In the Drawing hover over the Drawing Object, double left click, Properties will appear.
It is also possible to drill down into an object if it is multi-part, i.e. get a Boundary properties dialog displayed then right click or double click any line showing a Boundary point and the properties for that point will be displayed.

Available Drawing tools

This section will describe in more detail the drawing tools that are available with this Plug In.


This allows drawing of a closed path joining all points that of the path. The smallest Boundary has two points, but normal Boundaries will have three (triangle) or more points. There is no limit to the number of points, or the size of the Boundary. When drawing points that have already been placed will be connected togther with the path line. A rubber band line will be drawn that follows the cursor. The boundary fill may appear incomplete or strange at this point. However, when the final point is place and the create process is finished it will correct itself and display the boundary fill correctly.

If a point is placed in the wrong location carry on laying the other points. When you have finished the create process you can then edit the boundary and 'Move', 'Delete' or 'Add' more points to the boundary. If the whole boundary is in the wrong location it can be moved as a whole from the right mouse click menu.

The types of boundary you can draw, which can be easily changed after creation if it is wrong, are:
  • Exclusion - The interior of the boundary will have a cross hatch pattern of the selected colour. The type of boundary reported to other plugins, such as Watchdog, will be of type 'Exclusion'.
  • Inclusion - A user defined width cross hatch pattern will be drawn around the outside of the boundary in the selected colour. The type of boundary reported to other plugins, such as Watchdog, will be of type 'Inclusion'.
  • Neither - The boundary will be drawn as a line with no interior or exterior fill. The type of boundary reported to other plugins, such as Watchdog, will be of type 'Neither'.
  • Please Note that these Types (exclusion, inclusion, neither) are Graphical only, and WatchDog does not use them in setting its internal alarms. We recommend that these graphic types be used appropriately to conform with the type of alarm that will be set from within WatchDog, however they will have NO EFFECT on the WD alarm type.
The type of boundary may change what other plugins do with the information, or how it is displayed. If using the Watchdog plugin and you set the boundary anchor watch the alarm will go off if you move outside of the boundary. If you are motoring/sailing and you have a proximity boundary watch set then the alarm will go off if you get closer than the specified distance. The first type of boundary should be an 'Inclusion' boundary and the second should be an 'Exclusion' boundary.

Note: A Boundary is a line joining multiple, 2 or more, Boundary Points together. As such, each Boundary Point can have the same capabilities as individual Boundary Points.

Boundary Point

This allows the placing of individual points on the chart. They are very similar to 'Marks' that can be dropped by OpenCPN. However, they have the capability of being 'Exclusion', 'Inclusion' and 'Neither' boundary points. This is demonstrated when Range Rings are Displayed.
  • Exclusion - The interior of the boundary point, from the biggest range ring, will have a cross hatch pattern of the selected colour. The type of boundary point reported to other plugins, such as Watchdog, will be of type 'Exclusion'.
  • Inclusion - A user defined width cross hatch pattern will be drawn around the outside of the largest range ring of the boundary point in the selected colour. The type of boundary point reported to other plugins, such as Watchdog, will be of type 'Inclusion'.
  • Neither - The boundary range rings will be drawn as a line with no interior or exterior fill. The type of boundary point reported to other plugins, such as Watchdog, will be of type 'Neither'.
  • Please Note that these Types (exclusion, inclusion, neither) are Graphical only, and WatchDog does not use them in setting its internal alarms. We recommend that these graphic types be used appropriately to conform with the type of alarm that will be set from within WatchDog, however they will have NO EFFECT on the WD alarm type.
Boundary Points continue to be placed on the chart until the drawing create mode is terminated. This allows the placing of as many points with single mouse left clicks as the user wishes.

Text Point

This allows the placing of individual Text Points on the chart. They appear very similar to Boundary Points, but they allow the displaying of multi-line text in the desired font. They can have range rings, but these cannot be filled.

The text top left corner of the text is the reference point. There are 7 provided locations:
  • Top - which puts the text over the top of the point aligned to the left edge of the icon with the bottom just clear of the icon
  • Top Centre - which puts the text over the top of the point with the centre of the text aligned to the centre of the icon
  • Bottom - which puts the top edge just underneath the point aligned to the left edge of the icon. If you displace the point name the text should drop enough to show it
  • Bottom Centre - which puts the text underneath the point with the centre of the text aligned to the centre of the icon
  • Centre - which puts the text horizontal and vertical centre over the icon.
  • Right - which puts the top edge aligned with the top of the icon, the left hand edge of the text just clear of the right hand side of the icon
  • Left - which puts the top edge aligned with the top of the icon, the text to the left of the icon with the right hand end of the text box just clear of the icon
The amount the box edge is offset is controlled by 8 settings in the opencpn ini/conf file. You will find them called:
DefaultTextTopOffsetX, DefaultTextTopOffsetY
DefaultTextBottomOffsetX, DefaultTextBottomOffsetY
DefaultTextRightOffsetX, DefaultTextRightOffsetY
DefaultTextLeftOffsetX, DefaultTextLeftOffsetY

These are not in any dialog box as they are very unlikely to be modified.

Changing the font in the properties box does not apply the font until the OK button is pressed on the properties box. The word 'Example' should change to show you the font selected.
I will look and see if I can make the background box a little bigger. The information for the size of the box is obtained from the system depending on the font used, so I may have to make that an attribute of either the font (may be difficult) or of the point itself.
Changing the font in the properties box does not apply the font until the OK button is pressed on the properties box. The word 'Example' should change to show you the font selected.

When a Text Point is created the 'natural' scale at which it is created is stored. This is then used to determine what to show when scaling to larger scales. Currently at twice the natural scale the text gets hidden and at 8x the natural scale the text box gets hidden. This is currently hard coded.

To display text for the Text Point you will need to open the properties for the Text Point and fill in the 'Display Text' tab. This is simple text and does not allow individual formating of different parts of the text. You can pick the font and the font metrics to use for all the text associated with one text point.


The EBL always starts attached to the boat with the far end of the line being placed by left clicking the chart. The default action for the end point is set in the main properties dialog. The end point can either be fixed to a Latitude and Longitude or move along with the boat. This allows the EBL to show the boat moving against a fixed point, i.e. passing a reef, or to show other objects moving relative to the boat, i.e. when the boat can tack to get around a bouy.

The EBL can be detached from the boat to allow placing of the start point where the user left clicks. The EBL can also then have the start point centred on the boat but not move or re-attached to the boat.

Variable Range Markers (VRM's) can be displayed as part of the EBL, by checking a box on the EBL properties (or set the default on the OD properties) and a range ring will be drawn based on the start point. If the end point of the EBL is moved the range ring will move with that point. This allows easily setting up of safety rings around a boat. The plugin provides additional information when moving the end point of an EBL/VRM

End Points A & B of an EBL can be in several states:
1. Associated with Boat position (boat lat long) - Moving with the boat.
2. Associated with a fixed position (lat long) - Not Moving with the boat.
3. When offset Point B is associated with Boat position (lat long) it moves relative to the boat position and stays at the same angle.

Right click selections for EBL are
1. When the EBL start point is attached to the boat... Pick a new start point.
2. When the EBL start point is not on the boat.. Center on moving boat or Center on Lat/Lon (not fixed to the boat)
This flexibilty is useful for DR to have "Fixed" EBL markers.

The default colour is the same as for a 'Boundary Point' and it will draw 1 range ring. If you want to change that then you will need to get to the start point properties (double click the EBL and double click the first point), or if the first point is clearly visible, just go to its properties (right click the point and select properties) and you can change the number of rings, the colours (you cannot fill them at the moment).

The VRM colour, by default is set to the same as the EBL, but once you change the VRM colour to be different from the EBL then it will stay this way, unless you select the match option in the right click menu.

There are two ways of changing the VRM colour:
  1. Under properties for the EBL with the VRM showing. Change the EBL colour and the VRM colour will also change.
  2. Under properties for the EBL with the VRM showing get the properties of the 'boat'/'start' point and change the colour.
It may seem strange at first to use an EBL to give you the VRM, but it makes the coding/logic easier and allowed building on the 'path/point' concept that is at the heart of this plugin. From a user perspective it should make selecting the VRM easier so that it can be dragged to the size required as there is a well defined point that can be selected. This is particularly true if you have many VRM's at one time.

It is not necessary to loop through the preferences to enable the VRM for one EBL - the settings pop-up double clicking the EBL has all the necessary entries.

Reverse bearing has been added to the rollover popup for EBL's.

The main properties dialog in the general tab sets whether to use magnetic bearings or true. If magnetic is used then if you have the World Magnetic Model installed the variation will be used from that plugin. If not you will, currently, need to set 'UserMagVariation=0.00' in the ocpn_draw_pi section of the config file (there is no setting in the properties dialog for this yet). There is, currently, no way to get at the value set in the opencpn mainline properties that will work on all platforms which may require another plugin-api change to enable this to be made available.


This draws a Dead Reckoning line with multiple points along it starting at the boats current location. As mentioned above, this tool does not use the mouse click to draw on the chart, rather it uses it to display a dialog box where the DR information can be entered. When the 'OK' button is clicked the DR will be created and drawn on the chart. At this point the line can be modified by changing the points that make it up. However, this may make the DR line not reflect what you expect as neither the time/distance between points is maintained, nor is the COG/SOG. So the DR line at that point becomes more of a line with possibly little meaning in the context of DR.

Properties dialogs

All objects that have been drawn have a properties dialog associated with them to allow changing of the objects attributes.

Boundary Properties

You can display the point properties by either double left mouse clicking on the particular line you want in the Points list or by right mouse clicking on the line, once it has been selected, and selecting 'Boundary Point Properties' from the popup menu.
If you want to remove a particluar point then left click the line to select it then right mouse click on the point and select 'Remove Selected' from the popup menu.

Boundary Point Properties


These are the properties for the selected Boundary Point. Any changes here will be made to the selected Boundary Point and, if the 'OK' button is clicked, will be preserved over a restart.


This allows you to stop displaying the Boundary Point on the screen and change the GUID if you want. You will need to click 'OK' to save the changes.

Text Point Properties


These are the properties for the selected Text Point. Any changes here will be made to the selected Text Point and, if the 'OK' button is clicked, will be preserved over a restart.

Display Text

This tab controls the text that is displayed for the Text Point. Any changes here will be made to the selected Text Point and, if the 'OK' button is clicked, will be preserved over a restart.


This is the same as for a Boundary Point


You can display the point properties by either double left mouse clicking on the particular line you want in the Points list or by right mouse clicking on the line, once it has been selected, and selecting 'EBL Point Properties' from the popup menu.
If you want to remove a particluar point then left click the line to select it then right mouse click on the point and select 'Remove Selected' from the popup menu.

EBL Point