Bash JSON Viewer — jless & JQ_COLORS

Wanneer je een bash JSON-viewer nodig hebt voor interactieve verkenning in plaats van scripting, schiet de standaard jq . pipe tekort — de uitvoer scrollt voorbij de bovenkant van de terminal en je kunt niet terug navigeren door een API-response van 300 regels. Deze gids behandelt tools die speciaal zijn gebouwd voor interactief JSON bekijken in de terminal: jless (inklapbare boom met vim-navigatie), JQ_COLORSvoor aangepaste kleurthema's, jq -C | less -R voor gekleurd pagineren, shell-aliassen voor dagelijks gebruik en fx als Node.js-alternatief. Voor scripting, CI/CD en validatieworkflows zie de bijbehorende gids voor JSON formatteren in Bash. Voor een browser-viewer zonder installatie werkt de JSON Pretty Print tool direct. Voorbeelden zijn getest op Bash 5.x (macOS via Homebrew, Ubuntu 22.04+) en zijn compatibel met Bash 3.2+ (macOS systeemshell).

Interactief vs. Gescript JSON bekijken

JSON naar jq . pipen is de juiste keuze wanneer je geformatteerde uitvoer wilt voor een kleine payload, of wanneer het resultaat naar een ander commando gaat. Het is de verkeerde keuze wanneer je een API-response van 200 velden moet verkennen — de uitvoer vliegt voorbij het terminalvenster en laat je geen manier om te navigeren, secties in te klappen of naar een specifiek veld te zoeken zonder het commando opnieuw uit te voeren met een filter. Interactieve JSON-viewers renderen dezelfde geformatteerde, gekleurde uitvoer binnen een persistente pager waar jij de navigatie beheert. De data is identiek; het verschil zit in de interface.

# jq . — uitvoer scrollt buiten beeld bij grote responses
curl -s https://api.github.com/users/torvalds | jq .
# 300+ regels scrollen voorbij — je verliest direct de context

# jless — opent een interactieve pager, niets scrollt weg
curl -s https://api.github.com/users/torvalds | jless
# Volledig document zichtbaar, inklapbaar, doorzoekbaar met j/k/h/l

jless — Interactieve JSON-viewer

jless is een doelgebouwde terminal JSON-viewer. In tegenstelling tot een gewone jq-pipe rendert het het document als een persistente inklapbare boom: elk object en elke array kan onafhankelijk worden uitgevouwen of ingeklapt met l en h, navigatie gebruikt vim-stijl toetsen en incrementeel zoeken vindt elke sleutel of waarde direct. Het streamt invoer incrementeel, dus het opent grote bestanden en API-responses in minder dan een seconde ongeacht de grootte — waar jq het hele document buffert voor weergave. Ik grijp als eerste naar jless wanneer een API-response te groot is om in één oogopslag te scannen.

Installatie

# macOS
brew install jless

# Linux — voorgebouwd binair bestand van GitHub Releases
curl -sL https://github.com/PaulJuliusMartinez/jless/releases/latest/download/jless-x86_64-unknown-linux-gnu.tar.gz \
  | tar xz
sudo mv jless /usr/local/bin/

# Verifieer
jless --version

Basisgebruik

# Open een lokaal bestand — interactieve boomviewer start direct
jless api-response.json

# Pipe elke JSON-stream direct naar jless
curl -s https://api.github.com/users/torvalds | jless

# Open met alle nodes ingeklapt naar het hoogste niveau (handig startpunt voor grote documenten)
jless --mode line api-response.json

# Laad een specifiek array-element en bekijk het afzonderlijk
jq '.[0]' deployments.json | jless

Navigatie en zoeken in de praktijk

# Binnen jless:
#
#   j / ↓        omlaag
#   k / ↑        omhoog
#   l / →        node uitklappen (of Enter)
#   h / ←        node inklappen
#   H            huidige + alle siblings inklappen → overzicht op hoog niveau
#   L            alles recursief uitklappen
#
#   /            vooruit zoeken starten — typ een sleutelnaam en druk Enter
#   n / N        volgende / vorige zoektreffer
#
#   g / gg       spring naar begin
#   G            spring naar einde
#   q            afsluiten

Overzicht sneltoetsen jless

Alle sneltoetsen zijn direct beschikbaar na het openen van jless — geen configuratie nodig. Het navigatiemodel is opzettelijk identiek aan vim zodat bestaand spiergeheugen overdraagt.

jq -C | less -R — Gekleurd pagineren zonder extra tools

Als jless niet geïnstalleerd is en je een scrollbare, gekleurde weergave van een JSON-response nodig hebt, is jq -C . | less -R een goede terugvaloptie. De vlag -C forceert ANSI-kleurcodes zelfs wanneer stdout een pipe is (normaal verwijdert jq ze) en -R vertelt less die codes te renderen in plaats van ze als letterlijke tekst af te drukken. Het resultaat is een volledig gekleurd, scrollbaar document — zonder de interactieve boomstructuur van jless. Navigatie binnen less gebruikt pijltoetsen of vim-stijl j/k, en / activeert de ingebouwde tekstzoekfunctie van less.

# Basis gekleurde pager
jq -C . response.json | less -R

# Vanuit een curl-response — -s voorkomt dat voortgangsbalk de JSON-stream beschadigt
curl -s https://api.github.com/repos/jqlang/jq | jq -C . | less -R

# Sorteer sleutels voor gemakkelijker visueel scannen, dan pagineer
jq -CS . config.json | less -R
# -C = forceer kleur, -S = sorteer sleutels (beide vlaggen gecombineerd)

# Voeg een alias toe zodat je de volledige pipe niet steeds hoeft in te typen
alias jqv='jq -C . | less -R'
# Gebruik: cat response.json | jqv
#    of: curl -s https://api.example.com/status | jqv

JQ_COLORS — Aangepaste kleurthema's

JQ_COLORS is een omgevingsvariabele die het standaard ANSI-kleurschema van jq overschrijft. Het accepteert een door dubbele punten gescheiden string van zeven ANSI attribute;color codes, één per JSON-type in deze vaste volgorde: null : false : true : getallen : strings : arrays : objecten. Elke code heeft het formaat attribuut;kleurwaarbij attribuut 0 (normaal), 1 (vet), 2 (dim) of 4 (onderstreept) is en kleur een standaard ANSI-kleurnummer (30–37 = standaard, 90–97 = helder).

# ANSI-kleurreferentie voor het bouwen van JQ_COLORS:
#   Attributen:  0=normaal  1=vet  2=dim  4=onderstreept
#   Kleuren:     30=zwart  31=rood  32=groen  33=geel
#                34=blauw  35=magenta  36=cyaan  37=wit
#   Helder:      90=helder-zwart  91=helder-rood  92=helder-groen  93=helder-geel
#                94=helder-blauw  95=helder-magenta  96=helder-cyaan  97=helder-wit
#
# Volgorde: null : false : true : getallen : strings : arrays : objecten

# Hoog-contrast thema voor donkere terminals (aanbevolen)
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"
# null=dim-grijs, false=helder-rood, true=helder-groen,
# numbers=helder-geel, strings=groen, arrays=vet-cyaan, objects=vet-cyaan

# Solarized-stijl thema
export JQ_COLORS="2;37:0;35:0;35:0;36:0;33:1;34:1;34"
# null=dim-wit, false=magenta, true=magenta,
# numbers=cyaan, strings=geel, arrays=vet-blauw, objects=vet-blauw

# Minimaal (alleen vetgedrukte sleutels, de rest normaal)
export JQ_COLORS="0;90:0;39:0;39:0;39:0;39:1;39:1;39"

# Voeg je gekozen thema toe aan ~/.bashrc of ~/.zshrc zodat het op elk jq-aanroep wordt toegepast
echo 'export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"' >> ~/.bashrc
source ~/.bashrc

# Test het thema
echo '{"active":true,"errors":null,"count":42,"tags":["api","v2"],"meta":{"version":"1.0"}}' | jq .

Shell-aliassen voor dagelijks JSON bekijken

De commando's voor interactief JSON bekijken zijn standaard omslachtig. Een kleine set aliassen in ~/.bashrc of ~/.zshrcmaakt jless en gekleurd pagineren tot éénwoordige commando's die van nature passen in elke workflow. De onderstaande aliassen componeren — jv en jvp accepteren beide gepipede invoer of een bestandsnaam als eerste argument.

# Voeg toe aan ~/.bashrc of ~/.zshrc

# jv — interactieve viewer (jless indien beschikbaar, gekleurde pager als terugval)
jv() {
  if command -v jless &>/dev/null; then
    jless "$@"
  else
    jq -C . "$@" | less -R
  fi
}

# jvp — bekijk met sleutels alfabetisch gesorteerd (handig voor vergelijking van responses)
alias jvp='jq -CS . | less -R'

# jvc — bekijk vanuit klembord (macOS)
alias jvc='pbpaste | jless'

# jvf — bekijk en filter: jvf '.users[0]' response.json
jvf() {
  local filter="$1"; shift
  jq -C "$filter" "$@" | less -R
}

# Herladen zonder terminal opnieuw te starten
source ~/.bashrc

# Gebruiksvoorbeelden na het toevoegen van bovenstaande aliassen

# Bekijk elk bestand of gepipede response
jv deployment-config.json
curl -s https://api.github.com/users/torvalds | jv

# Bekijk gesorteerd (gemakkelijk alfabetisch te scannen)
cat feature-flags.json | jvp

# Duik interactief in een subdocument
jvf '.database' infra/app-config.json
jvf '.users[] | select(.role == "admin")' users.json

bat — JSON-bestanden bekijken met syntaxismarkering

bat is een vervanging voor cat met syntaxismarkering, regelnummers en een ingebouwde pager. Voor JSON-bestanden op schijf biedt het een overzichtelijke, redacteurachtige leeservaring zonder een volledige teksteditor te openen. In tegenstelling tot jless rendert bat het bestand als statische tekst — geen inklappen, geen zoeken, geen navigatie buiten scrollen. Zijn kracht is visuele duidelijkheid voor middelgrote statische bestanden (configs, fixtures, testpayloads) waar je syntaxismarkering en regelnummers wilt maar geen interactieve boomnavigatie nodig hebt.

# macOS
brew install bat

# Debian / Ubuntu (binary kan batcat heten)
apt-get install -y bat
# alias bat=batcat   # voeg toe aan ~/.bashrc indien nodig op Ubuntu

# Bekijk een JSON-bestand met syntaxismarkering en regelnummers
bat config/feature-flags.json

# Pager uitschakelen — direct naar terminal afdrukken (handig in scripts)
bat --paging=never api-response.json

# Combineer met jq: formatteren met jq, bekijken met bat (behoudt JSON-markering)
jq '.' response.json | bat --language=json --paging=never

fx — Interactieve Node.js JSON-verkenner

fx is een interactieve JSON-viewer gebouwd op Node.js. De interface is vergelijkbaar met jless — inklapbare boom, toetsenbordnavigatie, zoeken — maar voegt twee functies toe die jless mist: muisondersteuning (klik om nodes uit/in te klappen) en de mogelijkheid om een JavaScript-expressie in de onderste balk te typen om het document in realtime te filteren. Voor teams die al Node.js gebruiken is fx een natuurlijke keuze en vereist geen apart binair bestand. Voor pure terminalomgevingen zonder Node is jless de lichtere keuze.

# Globaal installeren via npm
npm install -g fx

# Of uitvoeren zonder installeren (npx cachet het pakket)
curl -s https://api.github.com/users/torvalds | npx fx

# Basis interactief gebruik
fx api-response.json
curl -s https://api.github.com/repos/jqlang/jq | fx

# In fx: pijltoetsen navigeren, Enter klapt uit/in, / zoekt
# Onderste balk accepteert JavaScript-expressies voor live filteren:
#   .name           → toon alleen het "name"-veld
#   .repos.slice(0,5) → eerste 5 repos

# fx werkt ook als niet-interactieve formatter (zoals jq . maar met JS-syntaxis)
# Geef een JavaScript-expressie als argument — geen interactieve modus
echo '{"users":[{"id":1,"name":"Sarah Chen"},{"id":2,"name":"Marcus Osei"}]}' \
  | fx '.users[0].name'
# Sarah Chen

# Ketting met map voor array-transformaties
cat deployments.json | fx '.items.map(d => ({id: d.deploy_id, status: d.state}))'

Veelgemaakte fouten

Deze vier fouten komen steeds opnieuw voor wanneer ontwikkelaars terminal JSON-viewers beginnen te gebruiken — elke heeft een duidelijke oplossing zodra je begrijpt waarom het gebeurt.

# 300-regels API-response — bovenste 280 regels scrollen direct weg
curl -s https://api.github.com/users/torvalds | jq .
# Alleen het onderste deel van de uitvoer is zichtbaar — kan niet terug

# Volledig document toegankelijk in jless — niets gaat verloren
curl -s https://api.github.com/users/torvalds | jless
# j/k om te scrollen, h/l om in/uit te klappen, / om te zoeken

# Slechts 6 waarden — jq gebruikt stilzwijgend standaarden, geen indicatie waarom
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96"
echo '{"ok":true}' | jq .  # kleuren ongewijzigd — geen fout getoond

# Exact 7 waarden — 6 dubbele punten
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"

# Verifieer het aantal voordat je het toevoegt aan het shell-profiel
echo "$JQ_COLORS" | tr -cd ':' | wc -c   # moet 6 weergeven

# jless-uitvoer is voor menselijke ogen — pipen produceert rommel
jless response.json | grep "request_id"
# Uitvoer: ANSI escape-codes en cursor-sequences, geen schone tekst

# Gebruik jq voor programmatische extractie — schoon, composeerbaar
jq -r '.request_id' response.json | grep "req_"

# Gebruik jless alleen als eindpunt in de terminal — niets daarna
jless response.json

# -C zonder -R: escape-sequences worden als ruwe tekst afgedrukt
jq -C . response.json | less
# Uitvoer: ^[[1;34m"status"^[[0m: ^[[0;32m"ok"^[[0m ...

# -C met -R: ANSI-codes worden als echte kleuren gerenderd
jq -C . response.json | less -R
# Uitvoer: gekleurd JSON, schoon en leesbaar

jless vs jq vs bat vs fx — Vergelijking interactieve viewers

Alle vier tools renderen gekleurd JSON, maar hun interactieve mogelijkheden verschillen aanzienlijk. Kies op basis van of je inklapbare navigatie, zoeken of muisondersteuning nodig hebt — en of Node.js al in je omgeving aanwezig is.

Voor de meeste situaties: installeer jless één keer en gebruik het als standaard interactieve viewer. Houd jq -C . | less -R als terugval voor omgevingen waar je geen extra binaries kunt installeren. Voeg fx toe als je team primair Node.js gebruikt en muisnavigatie of live JavaScript-filtering waardeert.

Veelgestelde vragen

# Open bestand in jless, druk daarna op / om te zoeken
jless api-response.json
# In jless: typ /  →  "request_id"  →  Enter  →  n voor volgende treffer

# jq-alternatief: extraheer en druk alle overeenkomende sleutels af
jq '.. | objects | with_entries(select(.key == "request_id"))' api-response.json

# Open de response in jless
curl -s https://api.github.com/repos/jqlang/jq | jless
# In jless:
#   H            → klap alle sleutels op het hoogste niveau in
#   j/k          → navigeer naar de gewenste sleutel
#   l            → klap alleen die tak uit
#   gg           → terug naar root
#   G            → spring naar laatste element

# Hoog-contrast thema voor donkere terminals — voeg toe aan ~/.bashrc of ~/.zshrc
export JQ_COLORS="1;30:0;91:0;92:0;93:0;32:1;96:1;96"
# null=grijs, false=helderblauw, true=heldergroen,
# numbers=heldergeel, strings=groen, arrays/objects=heldercyaan

# Test direct zonder shell te herladen
echo '{"active":true,"errors":0,"tags":["api","v2"]}' | jq .

# Kleine payload — jq . is prima
echo '{"status":"ok","version":"2.4.1"}' | jq .

# Grote of geneste response — jless is beter
curl -s https://api.github.com/repos/jqlang/jq | jless
# → interactieve boom, niets scrollt buiten beeld

# Interactieve verkenning met jless
curl -s https://api.github.com/users/torvalds | jless

# Gekleurde pager als terugval (geen inklappen, maar wel scrollbaar met kleur)
curl -s https://api.github.com/users/torvalds | jq -C . | less -R

# tmux naast elkaar: horizontaal splitsen, dan jless in elk venster
tmux split-window -h
# Linkervenster:  jless response-v1.json
# Rechtervenster: jless response-v2.json

# Of diff op jq-genormaliseerde uitvoer voor tekstuele vergelijking
diff <(jq -S . response-v1.json) <(jq -S . response-v2.json)

Gerelateerde tools

De JSON Pretty Print tool geeft je dezelfde inklapbare, gekleurde weergave als jless — direct in de browser, zonder installatie en zonder terminal.