FAQ

Where is my log file?

Read this explanation - Getting Started

Where is my config.ini file?

Read this explanation - Getting Started

Where can I download the User Manual?

It is downloaded with the software, so use “?” icon and then “Help”! It is also available on the Website Download page Then scroll to the bottom under ARCHIVES.

How to find all those files you are talking about?

A big contributing factor to this problem is that Windows default settings hides system files, and also by default, don't show file extensions.

  1. These settings can be changed however.
  2. In XP go to My Computer →Tools → Folder Options -View. Mark “Show hidden files and folders” and uncheck “Hide extensions for known file types”.
  3. Other versions of Windows are similar, but may not be exactly like this.

Now you should find the files we talked about in the previous paragraph.

Is there a compatible Hardware List?

Keeping an updated list of all the devices available is virtually impossible.

  1. As long as your device is able to produce NMEA 0183, OpenCPN most likely won't have any problem understanding it.
  2. Rather than looking for a list, which can't contain everything, ask in the support forum whether your equipment of choice is likely to work with OpenCPN before going shopping.
  3. If still looking for lists, you may like the following links

Trouble with Installation, finding Charts, and connecting GPS & Instruments.

  1. Installing Charts with Chart Downloader Plugin Chart Downloader
  2. Installing GPS GPS Setup and Status
  3. Instruments - Devices must provide NMEA 0183 data via Serial or Network with a range of protocols and settings available. The description for connecting to hardware is in the Options > Data Connections section. Connections and for additional assistance NMEA Sentences

OpenCPN crashes, what should I do?

  1. It is highly unlikely that uninstalling and reinstalling OpenCPN is going to resolve anything, really. But if you can't resist the temptation, help yourself, it is equally unlikely that it makes the things worse.
  2. You should have a look into the logfile to find out whether it contains some clues that could help isolate the problem. If the crash is related to displaying a chart, try to isolate on which one and create the simplest possible scenario we could reproduce. You should try to get fresh charts.
  3. You should try disabling OpenGL if it is enabled or vice versa.
  4. While OpenCPN is not running, move the complete data folder (C:\ProgramData\opencpn on Windows, ~/.opencpn on Linux ~/Library/Preferences/opencpn / on Mac ) to a backup location and see whether something was rotten in your local OpenCPN data. Do not delete it if you want to keep your waypoints, routes and tracks!
  5. If on Linux, run opencpn from command line and see whether it produces a backtrace to help identify the cause of the crash.
  6. Still on Linux, you can use gdb or another debugger to get the backtrace and help identify the cause of the crash.

Why is recently updated OpenCPN performing badly?

  1. Look in the opencpn.log file. Try closing Opencpn, deleting the opencpn.log file and then reopening OpenCPN to create a new log file, then use Opencpn to cause the trouble again. Then look at the Log file to find messages that are associated with the problem.
  2. Verify the problem is not from an old and outdated opencpn.ini file. Rename your opencpn.ini file for possible reuse later, and restart Opencpn to create a fresh new opencpn.ini file. Test for the problem.
  3. Do you have Chart Display problems? Try turning on or off OpenGL and Running update of the Chart Database.
  4. Do you have a problem with paid charts? see Oesenc or ocharts.
  5. Do you have old plugins? Disable and uninstall all external plugins with the plugin uninstall program. Test OpenCPN and then download new updated plugins and install them one at a time and test.
  6. Final Resort: Try starting over by uninstalling Opencpn following this approach.
    • Go to the ProgramFiles “OpenCPN” folder, and use the uninstall programs, preferably starting with the plugins, and ending with the OpenCPN.
    • Check that the “opencpn” initialization folder of program data has been removed. Otherwise, do it manually.
    • Use the CCleaner software to clean the PC Windows registry in particular. (option)
    • Download OpenCPN again and all the plugins you need.
    • Install OpenCPN.
    • Run OpenCPN to verify that the operation is correct.
    • Install, one by one, the plugins you need.
    • Run each plugin before installing another one

I have a problem so I reinstalled, but that did not help.

- Try this approach instead - Troubleshoot Installation

GPS is not found by OpenCPN, but my GPS is working!

GPS is installed and I think its working, what next?

  1. Perhaps you'd like to download some charts? We suggest using Chart Downloader.

Charts used to show, but using 3.0.2 and later, they no longer work.

  1. OpenCPN used to display charts with an unknown projection as a Mercator chart. The same thing applies to an “UNKNOWN” or not recognized geodetic datum, where OpenCPN used to default to WGS84.
  2. This is no longer the case. If OpenCPN don't recognize the chart projection, it will not be displayed.
    • Potentially serious errors are thus avoided.
    • The event is logged in the opencpn.log.
    • Users may run into problems if a chart projection is stated as “UNKNOWN” even though it really is a prefect Mercator chart.
  3. Unfortunately, some conversion tools take a shortcut and don't enter the “PR” tag in the kap-chart-header correctly.
    • The projection of a chart can always be found, and the “PR=UNKNOWN” should always be avoided.

Official charts that OpenCPN really can't display, with a latitude < 70 degrees north/south, are very few indeed. Really only a handful of legacy, Gnomonic, large scale charts. Charts with “UNKNOWN” or blank geodetic datum are best avoided, they may be dangerously inaccurate.

Many error messages when starting OpenCPN from Linux command line.

Messages like:

are quite normal and have nothing to do with OpenCPN. Just ignore them!

Why doesn't the plugin work?

  1. It is best to keep OpenCPN and plugins updated to the most current version.
  2. If you are having trouble, it is likely you will be asked to update plugins and Opencpn to be current.

When will OpenCPN be ported to Android?

  1. There are two versions in the Google Play Store. We suggest you will be happiest with the paid version created by D. Register because it is updated regularly and is current. There is a forum at http://bigdumboat.com/aocpn/forum/.

Why do vector charts take so long to load?

  1. The behavior you see is expected for ENC charts. ENCs must be converted to internal SENC format before use for navigation. This takes a little bit of time, depending on your system capabilities. But it only has to be done once, and the converted SENCs are stored on your system for later use.
  2. All ECS systems must convert ENCs to SENCs. Some take longer, (like OpenCPN), so that subsequent access is faster. Some convert faster, leaving more work to do at the time of actual chart display. Its a design decision. OpenCPN is optimized for speed in real use, not for speed in conversion.

Why don't charts show at all zoom levels while quilting is enabled?

  1. If I turn off quilting, I can select the individual maps just fine and zoom to any level on them. No amount of clicking/hiding the maps using the map bar at the bottom of the screen show the maps. Only a zoom allows them to be seen. This problem of disappearing maps happens all over the country at different zoom levels.
  2. Answer: OpenGL is turned off. Without OpenGL, OpenCPN will not quilt Mercator and Transverse Mercator charts together. Try enabling OpenGL with Options (wrench tool icon)> Display> Advanced. Click on the box between “Graphics” and “Use Accelerated Graphics (OpenGL)” to put a checkmark in the box.
  3. When OpenGL is enabled, OpenCPN will quilt Mercator and Transverse Mercator charts (and some other projections).
  4. If “Texture Compression with Caching” is enabled under “OpenGL Options” there will be a delay before each chart is displayed for the first time. Subsequent display of the charts in the cache will be faster.

Whenever a specific chart is opened, OpenCPN crashes. What's going on?

What are all those 'U' s or '*' astericks in triangle all over my Vector Charts?

Most users just want to get rid of the triangles, but please refer to the Quality of Data Documentation.

  1. In Options > Charts > Vector Charts Tab when using Display Category “All”, Uncheck “Chart Information Objects” which hides the “U” symbols .
  2. In Options > Charts > Vector Charts Tab for a finer grain control when using Display Category “Mariners Standard”, In the selection List Box, Uncheck “Quality of Data” which hides the “U” symbols.

What are those acronyms on the charts?

To learn the acronyms used in this application search the S57 'Object and Attribute' catalog at: http://www.s-57.com/
Also, when viewing ENC charts:

  1. “U's” show up all over the charts
  2. Text detail seems to be missing ..like bouy identification ..Bridge names and clearances etc…
  3. Depth sounding seem to disappear zooming in and out.

Hit Text: The A+ button. To show text.

How to remove those pink crosses (isolated anger symbology)?

This isolated danger symbology is a part of the new ENC S57 presentation standard which OpenCPN complies with, get used to it. OR You can try to cover them with your depth setting. Look at the manual Vector Display Tab > Shallow, Safety & Deep Depths Safety Contour”, where you will find an example of just how depth is taken into account when displaying the magenta cross.

Kap files are no longer displayed correctly. Why?

  1. Old versions of OpenCPN were correcting broken KAPs on the fly. (They work on 3.2 but not on any 4. release ) The new ones don't do it anymore as the number of damaged charts circulating around decreased significantly and we gained some extra performance during chart loading. Refer to these sections of the User Documentation too.
  2. To fix your charts, run bdbfix on them.

What causes spurious waypoints which must be deleted?

  1. Condition: Multitude of repeated waypoints, which get copied when a waypoint is dragged. Sometimes a route WP is shifted, two routes are made, one with the name, the other unnamed.
  2. Possible Solutions: Determine if the addition of waypoints are from inadvertantly hitting the wrong keys on the keyboard, or the mouse.
  3. The other possiblity is that the navobj change file is corrupted. Close O and try to delete the change file In W8.1 it is found in C:\ProgramData\opencpn/navobj.xml.changes. Normally, after that O will work again.

Can I use my Seaclear wci or OziCharts?

See Use-seaclear-wci-charts and Oziexplorer to Opencpn Also see Not supported formats that can be converted and Map2Kap and WCI Charts

Can I import SeaClear routes and waypoints into OpenCPN?

How to synchronize Routes, Waypoints & Marks with another computer?

Three ways to synchronize:

The navobj.xml file resides in the same folder as the opencpn.ini settings file, under the OpenCPN User folder. For windows this is usually “C:\programdata\opencpn\”. The navobject.xml file is in in fact a .gpx file containing all waypoints/routes/tracks. See Navigation Data Backup for more information.

Jumping GPS!

GPS AIVDO Boat Position is Jumping many miles away.

Charts jump while Using Follow Ship Offset, Look Ahead & North up Modes

Chart Rotation Smoothing. When follow ship, offset mode, look ahead mode and north up mode are all turned on, the goal of the look ahead is to position the ship about 2/3 away from the farthest point directly ahead of the ship. Because the screen is a rectangle, the ship's position on the screen keeps changing, since the farthest point ahead is changing rapidly. Use Options > Display > Advanced Chart Rotation Averaging Time [new title] or Course-up Update Period _Time [old title] to smooth the chart rotation. It is actually another “always on” COG filter that smooths VP rotation and makes the chart much less jumpy. In conjunction with NMEA course and speed filtering the chart moves slowly in a nice way.

AIS Targets HDG and COG may be wildly different

The TRUE Heading reported in the target query is always as actually reported by the target. We do not apply variation to that value before presentation. So, what you see is no error. Of course, in situations with strong cross currents, or maneuvering, the reported HDG and COG may be wildly different.

How can a SART Alarm be disabled or ignored?

MOB SART has been tested extensively. The methods for deactivation should work. See SART. Also Disable SART When Alert is active, find the Alert's MMSI number in the AIS Target List. Then Add a “New” MMSI number in Options→Ships→MMSI. Then Edit the Options→Ships→MMSI Properties to “ignore” this target. Then close the Options Dialog. Then “Acknowledge” the SART alert one more time, and no further alerts will be seen. If you restart OCPN, you will never get alerts for this target again.

How to send routes to GPS via USB or via NMEA Serial connection

There are so many GPS models that the answer is a bit complicated. A lot depends on which GPS model you have. OpenCPN can communicate with many GPS receivers via a serial connection. Some GPS receivers have a serial connector that can be wired to a DB-9 serial connector. Newer ones have a USB port that will appear like a serial connection to your computer. Still newer ones appear to your computer like an external drive.

If your GPS receiver shows up as a serial connection on your computer chances are you can upload routes and waypoints directly to it from within OpenCPN. The GPS and OpenCPN have to be set to the same communication protocol. If you normally have them set to NMEA (for updating the OpenCPN chart display with position data from the GPS) you may need to change a Garmin GPS to the GRMN proprietary protocol to upload routes, waypoints, and tracks. If your GPS doesn't show up as a serial connection you may still be able to transfer routes and waypoints to it outside of OpenCPN. If the GPS appears as an external drive on your computer try this. Use OpenCPN to export your routes and waypoints to a GPX file (read the User Manual section on the Route & Mark Manager for more details). Then use your operating system to copy the GPX file from your hard drive to your GPS. If that doesn't work, try GPSBabel or EasyGPS for the transfer.

Depending on your GPS model and the way the route was created in OpenCPN you may wind up with a route on your GPS or just a list of waypoints. The route points may or may not appear as waypoints on the GPS.

Night time Mode Title bar is too bright in Windows

How are fonts adjusted in the User Interface?

How are fonts adjusted for the AIS Target List?

How are font sizes for vector chart Depth Soundings adjusted?

Out of the box, the “Depth” notation is unreadable.

  1. Opening the properties page, and adding a link to a JPG-image works fine. If I now edit the link, the image will no longer be displayed.
    1. The button “Edit” changes state. You click on it to switch the links above to “edit mode”, each click on any of the links opens the dialog allowing you to change it's parameters. After editing the link, you have to click on the button again and then a click on the links will again start opening whatever they link to. What will happen when you click on the link is explained in the text bellow the buttons and changes according to the “Edit button”. If it says “Links are opened in the default browser”, the linked file or internet address should open, given it exists, which gets us to..
  2. Similarily, if I export a waypoint with a link to another computer, the link will not open.
    1. The link is just a link, the file you link to is NOT “included” in the waypoint. When you transfer the waypoints to another computer, for links to local files to keep working, the files you link to would have to exist on the exactly same place on your disk there. Eg. The file that on computer A is C:\MyDocuments\MyPicture.jpg would have to exist with exactly the same file name, in the exactly same folder, on the exactly same disk on computer B.

OpenCPN and Great Circle Navigation

  1. There is a Route Plugin for Great Circles.
  2. Raster charts display bearings and headings as straight, measurable lines on the chart. Similarly, Vector ENC's are rendered as Mercator projections in OpenCPN and most other ECS's for the same reason.
  3. For typical coastal navigation, errors which occur using rhumb line instead of great circle calculations are small for the distances usually covered by one chart.
  4. Mercator Charts and Mercator navigation is the standard for most navigational purposes. Other terms used instead of “Mercator Sailing” is “Loxodrome Sailing” or “Rhumb Line Sailing”.

OpenCPN 3.2.0 forward handles Great Circles directly

Why aren't settings saved properly when I close Opencpn?

Not saving settings when exiting -due to Inland ECDIS is checked
European Inland Waterways ECDIS Mode

Issue just started with 4.8.0 where on exit doesn't save * Units * Configuration of toolbar * Starts in night mode I searched the opencpn.ini for these settings but not sure what I am looking for TBH. I also backed up this file and exited the program forming a new ini file, same issue. Any ideas?

OpenCPN is probably set to use settings for Inland ECDIS European Inland Waterways ECDIS

Right-click > Navigate > To Here has a problem

The new Active Route always disappears and I try to recreate it and it disappears again.

How exactly does NMEA 0183 HDG Sentence work?

If HDG message also contains the variation and E/W flags then O will use that. If not then it will look in RMC message for a variation. If nothing there it will use WMM plugin unless user has selected the variation manually in options.

How do I save many waypoints to a Layer?

Question: Layers is a good feature, however I need a tool to create a layer with many waypoints (say 200 waypoints in Fiji). I'd like create a layer of all visible waypoints in a chart area that I have zoomed into. After creating the layer, I'd like to delete them from the waypoints list with a single command.

Answer: Using the Route & Mark Manager