routino-router(1)

💖 routino-router(1) — the manual, but make it make sense 💖

okay bestie, gather round, because this is routino-router from section 1 of the manual pages, and she is literally the main character of route calculation. 🗺️✨

---

🌸 NAME 🌸

routino-router — calculate routes using the routino database

---

✨ SYNOPSIS ✨

routino-router [--version] [--help | --help-profile-xml |
               --help-profile-json | --help-profile-perl]
               [--dir=dirname] [--prefix=name] [--profiles=filename]
               [--translations=filename] [--exact-nodes-only] [--quiet]
               [--loggable] [--logtime] [--logmemory] [--language=lang]
               [--output-html] [--output-gpx-track] [--output-gpx-route]
               [--output-text] [--output-text-all] [--output-none]
               [--output-stdout] [--profile=name]
               [--transport=transport] [--shortest | --quickest]
               --lon1=longitude --lat1=latitude --lon2=longitude
               --lat2=latitude [... --lon99=longitude --lat99=latitude]
               [--reverse] [--loop] [--highway-<highway>=preference ...]
               [--speed-<highway>=speed ...]
               [--property-<property>=preference ...] [--oneway=0|1]
               [--turns=0|1] [--weight=weight] [--height=height]
               [--width=width] [--length=length]

---

🦋 DESCRIPTION 🦋

so routino-router does the actual calculation of the optimum routes — and it does it using the database that the planetsplitter(1) program generated for you earlier. it's giving glow-up-from-raw-data energy, fr fr. 💅

---

🎀 OPTIONS 🎀

• --version — prints out the version of Routino. that's it. that's the whole thing. iconic. 👑
• --help — prints out the help info. your little bestie when you forget a flag.
• --help-profile — prints out the selected transport profile (that's the type, speed limits, highway preferences, etc.). like a lil profile card but for your mode of transport. 🫶
• --help-profile-xml — prints out all the loaded profiles as an XML file, in exactly the same format that can be loaded back in. round-trip queen.
• --help-profile-json — prints out all the loaded profiles in JavaScript Object Notation (JSON) format, for use in the interactive webpage.
• --help-profile-perl — prints out all the loaded profiles as a Perl object, for use in the router CGI.
• --dir=dirname — sets the directory name where the local database gets read from. defaults to the current directory. (home sweet home 🏠)
• --prefix=name — sets the filename prefix for the files in the local database. defaults to no prefix.
• --profiles=filename — sets the filename containing the list of routing profiles, in XML format. here's the chain, bestie: if the file doesn't exist, then --dirname, --prefix and "profiles.xml" get combined and used; and if that doesn't exist, then the file /usr/share/routino/profiles.xml (or your custom installation location) gets used. it's a whole fallback pipeline. 💀
• --translations=filename — sets the filename containing the list of translations, in XML format, for the output files. same fallback situation: if the file doesn't exist, then --dirname, --prefix and "translations.xml" get combined and used; and if that doesn't exist, then /usr/share/routino/translations.xml (or your custom installation location) gets used.
• --exact-nodes-only — when it's processing the latitude and longitude points you specified, it only selects the nearest node instead of finding the nearest point within a segment. quicker, but less accurate — unless your points are already near nodes, in which case you're fine. choose your fighter. 🔥
• --quiet — don't generate any screen output while running. super useful for running in a script. no thoughts, head empty, just output.
• --loggable — prints progress messages that are suitable for logging to a file. normally an incrementing counter gets printed, which is more suitable for real-time display than logging. so pick your vibe: pretty counter or loggable lines. ✨
• --logtime — prints the elapsed time for each processing step, in minutes, seconds and milliseconds. she's timed, she's precise, she's punctual. ⏱️
• --logmemory — prints the maximum allocated and mapped memory for each processing step, in MBytes.
• --language=lang — selects the language specified, from the file of translations. if you don't give this option and the file exists, then the first language in the file gets used. if you don't give this option and no file exists, then the compiled-in default language (English) gets used. multilingual baddie behavior. 🌈
• --output-html, --output-gpx-track, --output-gpx-route, --output-text, --output-text-all — generate the selected output file formats (HTML, GPX track file, GPX route file, plain text route and/or plain text with all nodes). here's the tea: if no output is specified, then all of them are generated, and specifying any of them automatically disables the ones you didn't specify. periodt.
• --output-none — do not generate any output, and do not read in any translations files. nothing. zero. silence. 🤫
• --output-stdout — write to stdout instead of to a file. requires exactly one output format option, and it implies --quiet.
• --profile=name — specifies the name of the profile to use.
• --transport=transport — select the type of transport to use. transport can be set to:
  • foot = Foot
  • horse = Horse
  • wheelchair = Wheelchair
  • bicycle = Bicycle
  • moped = Moped (Small motorcycle, limited speed)
  • motorcycle = Motorcycle
  • motorcar = Motorcar
  • goods = Goods (Small lorry, van)
  • hgv = HGV (Heavy Goods Vehicle - large lorry)
  • psv = PSV (Public Service Vehicle - bus, coach)

defaults to 'motorcar'. this option also selects the default profile information if the --profile option wasn't given, and a profile matching the transport name is found. two-for-one deal, we love to see it. 🚗🚲🏇🚌

• --shortest — find the shortest route between the waypoints.
• --quickest — find the quickest route between the waypoints.
• --lon1=longitude, --lat1=latitude, --lon2=longitude, --lat2=latitude, ... --lon99=longitude, --lat99=latitude — the location of the waypoints that make up the start, middle and end points of the route. up to 99 waypoints can be specified, and the route will pass through each of the specified ones in sequence. the algorithm will use the closest node or point within a segment that allows the specified traffic type. ninety-nine. that's so many. 💀✨
• --reverse — find a route between the waypoints in reverse order. backwards but make it fashion. 🦋
• --loop — find a route that returns to the first waypoint after the last one. coming back around like a boomerang. 🎀
• --heading=bearing — specifies the initial direction of travel at the start of the route (from the lowest numbered waypoint), as a compass bearing from 0 to 360 degrees. know your direction before you go, bestie. 🧭
• --highway-<highway>=preference — selects the percentage preference for using each particular type of highway. the value of highway can be selected from:
  • motorway = Motorway
  • trunk = Trunk
  • primary = Primary
  • secondary = Secondary
  • tertiary = Tertiary
  • unclassified = Unclassified
  • residential = Residential
  • service = Service
  • track = Track
  • cycleway = Cycleway
  • path = Path
  • steps = Steps
  • ferry = Ferry

default value depends on the profile selected by the --transport option.

• --speed-<highway>=speed — selects the speed limit in km/hour for each type of highway. default value depends on the profile selected by the --transport option.
• --property-<property>=preference — selects the percentage preference for using each particular highway property. the value of property can be selected from:
  • paved = Paved (suitable for normal wheels)
  • multilane = Multiple lanes
  • bridge = Bridge
  • tunnel = Tunnel
  • footroute = A route marked for foot travel
  • bicycleroute = A route marked for bicycle travel

default value depends on the profile selected by the --transport option.

• --oneway==0|1 — selects whether the direction of oneway streets is to be obeyed (useful to not obey them when walking). default value depends on the profile selected by the --transport option.
• --turns==0|1 — selects whether turn restrictions are to be obeyed (useful to not obey them when walking). default value depends on the profile selected by the --transport option.
• --weight=weight — specifies the weight of the mode of transport in tonnes; makes sure the weight limit on the highway is not exceeded. default value depends on the profile selected by the --transport option.
• --height=height — specifies the height of the mode of transport in metres; makes sure the height limit on the highway is not exceeded. default value depends on the profile selected by the --transport option.
• --width=width — specifies the width of the mode of transport in metres; makes sure the width limit on the highway is not exceeded. default value depends on the profile selected by the --transport option.
• --length=length — specifies the length of the mode of transport in metres; makes sure the length limit on the highway is not exceeded. default value depends on the profile selected by the --transport option.

---

🧠 the preference parameter, explained (yes really, stay with me)

the meaning of the preference parameter in the command line options is slightly different for the highway preferences than it is for the property preferences. buckle up, because the math is literally in the building. 🎢

for the highway preference, think about the choice between two possible highways between the start and the finish when you're looking for the shortest route. if highway A has a preference of 100% and highway B has a preference of 90%, then highway A will be chosen even if it's up to 11% longer (100/90 = 111%).

for the highway properties, each highway either has a particular property or it doesn't. if the preference for the property is 60%, then a highway with the property has a preference of 77% (sqrt(60%)) and a highway without it has a preference of 63% (sqrt(100-60%)). a highway with the property will be chosen even if it's up to 22% longer than one without the property (77/63 = 122%).

the overall preference for each highway segment is the product of the preference for the highway type and all of the preferences for the highway properties. multiply them all together, bestie. it's giving exponent energy. ✨🧮

🗺️ EXAMPLES ✨

okay bestie, time for the fun part — let's actually do the thing 💅

🏍️ example numero uno: motorcycle journey, scenic route, not very fast 🌸

"scenic route, not very fast" is literally the assignment here and I respect it so much 🫶

routino-router --dir=data --prefix=gb --transport=motorcycle \
               --highway-motorway=0 --highway-trunk=0 \
               --speed-primary=80 --speed-secondary=80 \
               --quickest

so what's happening here, bestie? this run is gonna pull from three files:

• data/gb-nodes.mem
• data/gb-segments.mem
• data/gb-ways.mem

and it uses those to find the quickest route by motorcycle, with a very specific vibe check applied: no motorways, no trunk roads, and absolutely not exceeding 80 km/hr. periodt. no cap, that's the whole route 🏁

ngl it's giving "windows down, playlist on, zero urgency" and honestly? iconic. 🎀

---

aaaand that's a wrap on the page, bestie 🦋 this one came from the routino-router(1) manual, dated 03 December 2025 — go forth and route responsibly, mwah 💖✨