A modern, opensource approach to maritime navigation.

This software package is supposed to run on your ship/car/plane/ufo's board computer.

Obligatory Warning: Do not use for navigational purposes!

Always have up to date paper maps and know how to use them!

• webui (compatible with all modern browsers)
• nmea bus parser
• offline (cached) moving seamap incl.
• openseamap
• openstreetmap
• openweathermap
• and lots of other useful layers

• Navigation, GRIB data (in charts)
• Navigation aides, planning
• Datalog, automated navigational data exchange
• Crew management, safety tools
• wireless crew network and general communications

Please research any bugs you find via our Github issue tracker for HFOS and report them if they're still unknown.

If you want to discuss (opensource) maritime technology in general incl. where we're heading, head over to our Github discussion forum ...which is cleverly disguised as a Github issue tracker.

Before doing anything with HFOS, be sure you have all the dependencies installed via your distribution's package manager. For Debian Unstable use this:

sudo apt-get install mongodb python3.4 python3-pip python3-grib \
                     python3-bson python3-pymongo python3-serial

If you want (and can), install the mongo and bson extensions:

sudo apt-get install python3-pymongo-ext python3-bson-ext

Setup the source folder and virtual environment for Python 3.4:

cd ~/src
git clone https://github.com/hackerfleet/hfos
cd hfos
virtualenv -p /usr/bin/python3.4 --system-site-packages

Activate venv and run setup.py:

source venv/bin/activate
python setup.py develop

Run hfos:

python scripts/hfos

You should see some info/debug output and the web engine as well as other components starting up. Currently it is set up to serve only on http://localhost:8055 - so point your browser there and explore HFOS.

Outdated - these do not work without some additional work Debian instructions:

If you're using Debian, we provide a skeleton to build a cleanly installable dpkg package:

sudo apt-get install dpkg-dev
dpkg-buildpackage

Run buildpackage in the top source directory to generate a debian package.

Lives in /etc/hfos/config.json after installation, but is currently not used.

We like to hang out on irc, if you want to chat or help out, join irc://freenode.org/hackerfleet :)

• Heiko 'riot' Weinen riot@hackerfleet.org
• Johannes 'ijon' Rundfeldt ijon@hackerfleet.org

A boatload of other libraries like Bootstrap or Leaflet are currently hosted in this repo, this will change when we're done splitting up client and node.

• Fabulous icons by iconmonstr.com and Hackerfleet contributors
• Tumbeasts from http://theoatmeal.com/pl/state_web_winter/tumblr for the error page (CC-BY)

Missing? Add yourself or ping us ;)

⛵ 👍