The jsonxlsx package

[Tags:mit, program]

json to xlsx converter

[Skip to Readme]


Dependencies aeson (>=, attoparsec, base (>=4.6 && <5), bytestring, containers, HUnit, old-time, optparse-applicative, scientific (>=0.3.3), string-qq, text, time, unordered-containers, vector, xlsx (==0.4.1) [details]
License MIT
Author Daniel Choi
Maintainer Mackey RMS
Category Text
Home page
Bug tracker
Source repository head: git clone
Uploaded Mon Mar 20 01:05:41 UTC 2017 by mackeyrms
Distributions NixOS:
Downloads 32 total (9 in the last 30 days)
0 []
Status Docs not available [build log]
Last success reported on 2017-03-20 [all 3 reports]


Maintainer's Corner

For package maintainers and hackage trustees

Readme for jsonxlsx

Readme for jsonxlsx-


Transforms a standard JSON format to a Excel xlsx document.

This project is experimental; jsonxlsx's xlsx output has not been tested with Excel, only with OpenOffice.


You must have a recent version of the Haskell Platform on your system.

A prerequisite is a the xlsx fork at, which must be added to the cabal sandbox before building jsonxlsx. Here are the steps

git clone
git clone
cd jsonxlsx
cabal update
cabal sandbox init
cabal sandbox add-source ../xlsx
cabal install --only-dependencies
cabal build

# Now copy dist/build/jsonxlsx/jsonxlsx to a location on your PATH



Usage: jsonxlsx [-a DELIM] FIELDS OUTFILE [--debug]
  Transform JSON object steam to XLSX. On STDIN provide an input stream of
  newline-separated JSON objects.

Available options:
  -h,--help                Show this help text
  -a DELIM                 Concatentated array elem delimiter. Defaults to
  FIELDS                   JSON keypath expressions
  OUTFILE                  Output file to write to. Use '-' to emit binary xlsx
                           data to STDOUT.
  --debug                  Debug keypaths


This is the input JSON object stream:


  "title": "Terminator 2: Judgement Day",
  "year": 1991,
  "stars": [
      "name": "Arnold Schwarzenegger"
      "name": "Linda Hamilton"
  "ratings": {
    "imdb": 8.5
  "title": "Interstellar",
  "year": 2014,
  "stars": [
      "name": "Matthew McConaughey"
      "name": "Anne Hathaway"
  "ratings": {
    "imdb": 8.9

This is the command to turn this stream into an XLSX file:

< sample.json jsonxlsx \
  'title:"Movie Title" year"Movie Actors""IMDB Score"' \

This is the output (movies.xlsx):


See the README for jsontsv to see how to use jq to generate JSON object streams from nested JSON data structures.

Future improvements

The xlsx library that jsonxlsx uses to generate Excel output seems to have ways to control the column widths and other characteristics of the Excel spreadsheet. Contributors are welcome to add ways of controlling these parameters to jsonxlsx.