🚃 irail-cli - iRail (NMBS/SNCB) in your terminal

CLI for Belgian railway (NMBS/SNCB) real-time data via iRail API.

Installation

Homebrew (macOS/Linux)

brew install dedene/tap/irail

Go Install

go install github.com/dedene/irail-cli/cmd/irail@latest

Binary

Download from Releases.

Usage

Liveboard

Show departures from a station:

irail liveboard Brugge
irail liveboard "Brussel-Centraal"
irail liveboard Brugge --arrivals
irail liveboard Brugge --time 09:00 --date 2025-02-15

Connections

Find routes between stations:

irail connections Brugge Leuven
irail connections Brugge Leuven --time 09:00
irail connections Brugge Leuven --arrive-by  # time is arrival time
irail connections Brugge Leuven --results 10

Stations

List or search stations:

irail stations
irail stations --search bruss

Vehicle

Show train information:

irail vehicle IC1832
irail vehicle IC1832 --stops  # show all stops

Composition

Show train composition (seats, amenities):

irail composition S51507

Disturbances

Show service disruptions:

irail disturbances
irail disturbances --type planned    # only planned works
irail disturbances --type disturbance  # only disruptions

Options

Flag	Description
--json	Output JSON
--lang	Language: nl, fr, en, de
--no-color	Disable colors

Environment Variables

• IRAIL_LANG - Default language
• IRAIL_JSON - Default to JSON output
• NO_COLOR - Disable colors

Features

• Real-time departures and arrivals
• Connection planning with transfers
• Delay highlighting (red for delays)
• Platform change warnings (yellow ⚠️)
• Occupancy indicators
• Clickable train links (in supported terminals)
• Shell completions (bash, zsh, fish)

Shell Completions

# Bash
irail completion bash > /etc/bash_completion.d/irail

# Zsh
irail completion zsh > "${fpath[1]}/_irail"

# Fish
irail completion fish > ~/.config/fish/completions/irail.fish

License

MIT