routino-router-slim(1)

📦
version 3.4.3 · 5 versions
, in ubuntu resolute, ubuntu stonking

💖 routino-router-slim(1) 💖

okay bestie, welcome to the manual page for routino-router-slim(1) — it's giving route-calculator, it's giving main character, and yes we're gonna read the whole thing together. no skimming, no cap. 🫶

✨ NAME ✨

routino-router-slim — calculate routes using the routino database 🗺️💅

🌸 SYNOPSIS 🌸

routino-router-slim [--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 like, routino-router-slim is the one that actually does the math and figures out the optimum routes, using the database that the planetsplitter(1) program already built for you. it literally vibes off that database, no notes. 🔥

🔥 OPTIONS 🔥

  • --version — prints out the version of Routino. iconic, short, slays. ✨
  • --help — prints out the help information. bestie behaviour honestly. 🫶
  • --help-profile — prints out the selected transport profile — that's the type, the speed limits, the highway preferences, all of it. the whole ✨ dossier ✨.
  • --help-profile-xml — dumps every loaded profile as an XML file, in the exact same format it can be loaded back in. round trip, no data lost, queen shit. 👑
  • --help-profile-json — dumps all the loaded profiles in JavaScript Object Notation (JSON) format, for using in the interactive webpage. 🌈
  • --help-profile-perl — dumps all the loaded profiles as a Perl object, for using in the router CGI. we love a cross-language moment. 💜
  • --dir=dirname — sets the directory name to read the local database from. defaults to the current directory. (so like, if you don't say anything, it just looks right where you're standing 🏠)
  • --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. if the file doesn't exist then --dirname, --prefix and "profiles.xml" get combined and used instead; and if that doesn't exist then the file /usr/share/routino/profiles.xml (or wherever your custom installation lives) gets used. it's a whole fallback chain, she's prepared. 💅
  • --translations=filename — sets the filename containing the list of translations in XML format for the output files. if the file doesn't exist then --dirname, --prefix and "translations.xml" get combined and used; and if that doesn't exist either, then /usr/share/routino/translations.xml (or your custom installation location) is used. same energy, different file. 🌍
  • --exact-nodes-only — when processing the latitude and longitude points you specified, it only picks the nearest node instead of hunting for the nearest point within a segment. quicker, yeah, but less accurate — unless your points are already chilling right near nodes. 😭
  • --quiet — don't generate any screen output while running. super useful for running inside a script, where nobody wants your chatter. 🤫
  • --loggable — prints progress messages that are actually suitable for logging to a file. normally you'd get an incrementing counter instead, which is better suited to real-time display than to logging. iykyk. 📝
  • --logtime — prints the elapsed time for each processing step, in minutes, seconds and milliseconds. ⏱️
  • --logmemory — prints the maximum allocated and mapped memory for each processing step, in MBytes. 🧠
  • --language=lang — selects the language you name from the file of translations. if you don't pass this option but the file does exist, the first language in the file gets used. if you don't pass it and no file exists at all, the compiled-in default language (English) gets used. 🇬🇧
  • --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. if you don't specify any output at all, then all of them get generated; and specifying any of them automatically disables the ones you didn't name. it's giving all-or-specify. 🎀
  • --output-none — do not generate any output, and do not read in any translations files. nothing. zero. void. 💀
  • --output-stdout — write to stdout instead of to a file. this one needs exactly one output format option, and it implies --quiet. ⚡
  • --profile=name — specifies the name of the profile you want to use. 🪪
  • --transport=transport — selects 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'. also, this option picks the default profile information if you didn't pass --profile — as long as a profile matching the transport name is actually found. 🚗🚲🐎

  • --shortest — find the shortest route between the waypoints. distance girlie. 📏
  • --quickest — find the quickest route between the waypoints. time girlie. ⏰
  • --lon1=longitude, --lat1=latitude, --lon2=longitude, --lat2=latitude, … --lon99=longitude, --lat99=latitude — the location of the waypoints that make up the start, the middle and the end points of the route. you can specify up to 99 waypoints, and the route will pass through each of the ones you specified, in sequence. the algorithm uses the closest node, or the closest point within a segment, that allows the traffic type you asked for. 📍
  • --reverse — find a route between the waypoints, but in reverse order. 🔄
  • --loop — find a route that returns to the first waypoint after the last one. come back home bestie 🏡
  • --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. 🧭
  • --highway-<highway>=preference — selects the percentage preference for using each particular type of highway. 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

The 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. the default value depends on the profile selected by the --transport option. 🏎️
  • --property-<property>=preference — selects the percentage preference for using each particular highway property. 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

The 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. (handy when you don't wanna obey them, like when you're walking.) the default value depends on the profile selected by the --transport option. 🚫➡️
  • --turns==0|1 — selects whether turn restrictions are to be obeyed. (again, super handy when you don't wanna obey them and you're just walking.) the default value depends on the profile selected by the --transport option. ↩️
  • --weight=weight — specifies the weight of the mode of transport in tonnes; this makes sure the weight limit on the highway isn't exceeded. the default value depends on the profile selected by the --transport option. ⚖️
  • --height=height — specifies the height of the mode of transport in metres; this makes sure the height limit on the highway isn't exceeded. the default value depends on the profile selected by the --transport option. 📐
  • --width=width — specifies the width of the mode of transport in metres; this makes sure the width limit on the highway isn't exceeded. the default value depends on the profile selected by the --transport option. ↔️
  • --length=length — specifies the length of the mode of transport in metres; this makes sure the length limit on the highway isn't exceeded. the default value depends on the profile selected by the --transport option. 📏

okay so the meaning of that preference parameter in the command line options is slightly different depending on whether we're talking highway preferences or property preferences, and this is the part where you gotta lock in bestie 🔒✨

For the highway preference, imagine you're choosing between two possible highways between the start and the finish while 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%). she's worth the detour. 💅

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 one 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%). 🧮

And the overall preference for each highway segment? That's the product of the preference for the highway type and all of the preferences for the highway properties. stack 'em, multiply 'em, done. 🔥

✨ EXAMPLES ✨

okay bestie let's actually do the thing 💅 here's a real example — a motorcycle journey, scenic route vibes, not very fast:

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

so what's going on here?? let me break it down for you 🫶

this is gonna pull from the files data/gb-nodes.mem, data/gb-segments.mem and data/gb-ways.mem to find the quickest route by 🏍️ motorcycle that's not using motorways or trunk roads, and not exceeding 80 km/hr. scenic queen behavior fr fr, no cap. it's giving "vibes over velocity" ✨

like, look at the flags doing their lil jobs:

  • --dir=data + --prefix=gb → that's where those .mem files come from 👑
  • --transport=motorcycle → bestie is on two wheels 🏍️
  • --highway-motorway=0 and --highway-trunk=0 → nope, not touching those roads 🙅
  • --speed-primary=80 and --speed-secondary=80 → capping it at 80 km/hr 💀
  • --quickest → fastest route pls, main character energy only ⭐

and that's the whole page, gorgeous 🌸 go route something iconic, and remember: read the docs, slay the day, periodt 💖

this lil manual page is from the Routino router-slim source and its version, dated 03 December 2025 — she's serving routino-router-slim(1) and honestly?? iconic. mwah 🎀

📦 where this page comes from