irail-cli

CLI for Belgian railways (NMBS/SNCB) via iRail API. No authentication required.

Quick Start

CODEBLOCK0

Authentication

None required. iRail API is public and free to use.

Core Rules

1. 1. Always use --json when parsing output programmatically
2. Station names are flexible - accepts partial matches, quotes for multi-word
3. Time format - HH:MM (24-hour), date format YYYY-MM-DD
4. Language options - nl, fr, en, de (default: nl)

Output Formats

Colors indicate: red = delays, yellow = platform changes.

Workflows

Liveboard (Departures/Arrivals)

CODEBLOCK1

Connections (Route Planning)

CODEBLOCK2

Stations

CODEBLOCK3

Vehicle (Train Info)

CODEBLOCK4

Composition (Train Cars)

CODEBLOCK5

Disturbances

CODEBLOCK6

Scripting Examples

CODEBLOCK7

Environment Variables

Language Options

CODEBLOCK8

Command Reference

Common Patterns

Check if train is delayed

CODEBLOCK9

Get connection with transfers

CODEBLOCK10

Find direct trains only

CODEBLOCK11

Guidelines

• - No authentication needed - API is public
• Be mindful of API usage in loops - add delays between requests
• Station names are case-insensitive and support partial matching
• Delay values are in seconds (divide by 60 for minutes)

Installation

CODEBLOCK12