CINXE.COM
jq
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>jq</title> <meta name="viewport" content="width=device-width, initial-scale=1"> <meta property="og:title" content="jq"> <meta property="og:description" content="jq is a lightweight and flexible command-line JSON processor"> <meta property="og:type" content="website"> <meta property="og:image" content="https://jqlang.org/icon.png"> <meta property="og:url" content="https://jqlang.org/"> <link rel="icon" href="/icon.svg" type="image/svg+xml"> <link rel="apple-touch-icon" href="/icon.png" type="image/png"> <link rel="canonical" href="https://jqlang.org/"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootswatch@5.3.1/dist/cosmo/bootstrap.min.css" integrity="sha384-dulfW0vmzZ638jigSgZXvDxMmd70GCnIv6oa+riKq6Kk4E0MKf7qmBfwP02wltv5" crossorigin="anonymous"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.5/font/bootstrap-icons.css" integrity="sha384-Ay26V7L8bsJTsX9Sxclnvsn+hkdiwRnrjZJXqKmkIDobPgIIWBOVguEcQQLDuhfN" crossorigin="anonymous"> <link rel="stylesheet" href="/css/style.css" type="text/css"> <script> (function() { function setTheme(mediaQuery) { document.documentElement.setAttribute('data-bs-theme', document.documentElement.style.colorScheme = mediaQuery.matches ? 'dark' : 'light'); } const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)'); setTheme(mediaQuery); mediaQuery.addEventListener('change', setTheme); })(); </script> </head> <body> <div class="container visually-hidden-focusable"> <a class="d-inline-flex p-2" href="#main">Skip to main content</a> </div> <header class="navbar navbar-expand-md sticky-top bg-body-tertiary d-print-none"> <nav class="container-lg" aria-label="Page navigation"> <button type="button" class="navbar-toggler" data-bs-toggle="offcanvas" data-bs-target="#navbar-collapse" aria-controls="navbar-collapse" aria-expanded="false" aria-label="Toggle page navigation"> <span class="navbar-toggler-icon"></span> </button> <a class="navbar-brand" href="/" aria-label="Top page"><img src="/jq.svg" alt="jq logo" style="height:1.5rem"></a> <div id="navbar-collapse" class="offcanvas offcanvas-start navbar-collapse w-auto" aria-labelledby="navbar-title"> <div class="offcanvas-header"> <h3 id="navbar-title" class="me-3">jq</h3> <button type="button" class="d-md-none btn-close" data-bs-dismiss="offcanvas" aria-label="Close page navigation"></button> </div> <ul class="offcanvas-body navbar-nav me-auto text-nowrap"> <li class="nav-item d-md-none"><a class="nav-link active" aria-current="page" href="/">Top page</a></li> <li class="nav-item"><a class="nav-link" href="/tutorial/">Tutorial</a></li> <li class="nav-item"><a class="nav-link" href="/download/">Download</a></li> <li class="nav-item"><a class="nav-link" href="/manual/">Manual</a></li> <li class="nav-item"><a class="nav-link" href="https://github.com/jqlang/jq" target="_blank" rel="noopener">GitHub</a></li> <li class="nav-item"><a class="nav-link" href="https://github.com/jqlang/jq/issues" target="_blank" rel="noopener">Issues</a></li> <li class="nav-item"><a class="nav-link" href="https://jqplay.org" target="_blank" rel="noopener">Try online!</a></li> <li class="nav-item"><a class="nav-link" href="https://raw.githubusercontent.com/jqlang/jq/master/NEWS.md" target="_blank" rel="noopener">News</a></li> </ul> </div> <a class="d-md-none bi bi-github fs-4 text-body" href="https://github.com/jqlang/jq" target="_blank" rel="noopener" aria-label="GitHub"></a> </nav> </header> <main id="main" class="container-lg"> <div class="row"> <div class="col-md-6 text-center p-3"> <h1><img src="/jq.svg" class="img-fluid" alt="jq" width="400" height="220"></h1> </div> <div class="col-md-6 d-flex flex-column justify-content-center text-center align-items-center"> <h2 class="px-1" style="width:16em"> jq is a lightweight and flexible command-line JSON processor. </h2> <div class="btn-group d-print-none" role="group"> <button type="button" class="btn btn-primary dropdown-toggle text-nowrap" data-bs-toggle="dropdown" aria-expanded="false"> Download jq 1.7.1 <span class="caret"></span> </button> <ul class="dropdown-menu"> <li><a class="dropdown-item" href="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-amd64" aria-label="Link to download executable: Linux (AMD64)"><span class="bi bi-download me-2" aria-hidden="true"></span>Linux (AMD64)</a></li> <li><a class="dropdown-item" href="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-arm64" aria-label="Link to download executable: Linux (ARM64)"><span class="bi bi-download me-2" aria-hidden="true"></span>Linux (ARM64)</a></li> <li><a class="dropdown-item" href="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-macos-amd64" aria-label="Link to download executable: macOS (AMD64)"><span class="bi bi-download me-2" aria-hidden="true"></span>macOS (AMD64)</a></li> <li><a class="dropdown-item" href="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-macos-arm64" aria-label="Link to download executable: macOS (ARM64)"><span class="bi bi-download me-2" aria-hidden="true"></span>macOS (ARM64)</a></li> <li><a class="dropdown-item" href="https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-windows-amd64.exe" aria-label="Link to download executable: Windows (AMD64)"><span class="bi bi-download me-2" aria-hidden="true"></span>Windows (AMD64)</a></li> <li><a class="dropdown-item" href="/download/">Other platforms, older versions, and source</a></li> </ul> <a class="btn btn-primary text-nowrap" href="https://jqplay.org" target="_blank" rel="noopener"> Try online at jqplay.org!<span class="bi bi-box-arrow-up-right ms-1" aria-hidden="true"></span> </a> </div> </div> </div> <div class="row my-3"> <div class="col-md-4"><p>jq is like <code>sed</code> for JSON data - you can use it to slice and filter and map and transform structured data with the same ease that <code>sed</code>, <code>awk</code>, <code>grep</code> and friends let you play with text.</p></div> <div class="col-md-4"><p>jq is written in portable C, and it has zero runtime dependencies. You can download a single binary, <code>scp</code> it to a far away machine of the same type, and expect it to work.</p></div> <div class="col-md-4"><p>jq can mangle the data format that you have into the one that you want with very little effort, and the program to do so is often shorter and simpler than you'd expect.</p></div> </div> <div class="text-center my-3"> <p>Go read the <a href="./tutorial/">tutorial</a> for more, or the <a href="./manual/">manual</a> for <em>way</em> more.</p> <p>Have a question related to jq? You can seek answers on <a href="https://stackoverflow.com/">Stack Overflow</a> by using the <a href="https://stackoverflow.com/questions/tagged/jq">jq tag</a>, or in the <a href="https://web.libera.chat/#jq">#jq channel</a> on <a href="https://libera.chat/">Libera.Chat</a>. For more interactive discussions, feel free to join our <a href="https://discord.gg/yg6yjNmgAC">Discord server</a>.</p> </div> <h2>News</h2> <ul> <li> <span class="fst-italic">13 December 2023</span> <p>jq 1.7.1 released. Security (CVE-2023-50246, CVE-2023-50268) and bug fixes. See <a href="https://github.com/jqlang/jq/releases/tag/jq-1.7.1">release notes</a> for details.</p> </li> <li> <span class="fst-italic">7 September 2023</span> <p>After a five-year hiatus, we've returned with a revitalized <a href="https://github.com/jqlang">GitHub organization</a> and a much-anticipated 1.7 release, thanks to our new admins and maintainers. Check out the <a href="./download/">download</a> page for installation options and see the <a href="https://github.com/jqlang/jq/releases/tag/jq-1.7">release notes</a> for details.</p> </li> <li> <span class="fst-italic">1 November 2018</span> <p>jq 1.6 released. See installation options on the <a href="./download/">download</a> page, and the <a href="https://github.com/jqlang/jq/releases/tag/jq-1.6">release notes</a> for details.</p> </li> <li> <span class="fst-italic">15 August 2015</span> <p>jq 1.5 released, including new datetime, math, and regexp functions, try/catch syntax, array and object destructuring, a streaming parser, and a module system. See installation options on the <a href="./download/">download</a> page, and the <a href="https://github.com/jqlang/jq/releases/tag/jq-1.5">release notes</a> for details.</p> </li> <li> <span class="fst-italic">26 July 2015</span> <p>jq 1.5rc2 is available. Get it on the <a href="https://github.com/jqlang/jq/releases">releases</a> page.</p> </li> <li> <span class="fst-italic">01 January 2015</span> <p>jq 1.5rc1 is available. Get it on the <a href="https://github.com/jqlang/jq/releases">releases</a> page.</p> </li> <li> <span class="fst-italic">09 June 2014</span> <p>jq 1.4 (finally) released! Get it on the <a href="./download/">download</a> page.</p> </li> <li> <span class="fst-italic">19 May 2013</span> <p>jq 1.3 released.</p> </li> </ul> </main> <footer class="bd-footer bg-body-tertiary"> <div class="py-3 text-center"> <p> This website is made with <a href="https://getbootstrap.com" target="_blank" rel="noopener">Bootstrap</a>, themed with <a href="https://bootswatch.com" target="_blank" rel="noopener">Bootswatch</a>. </p> <p> jq is licensed under the MIT license (code) and the <a href="https://creativecommons.org/licenses/by/3.0/" target="_blank" rel="noopener">CC-BY-3.0</a> license (docs). </p> </div> </footer> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.1/dist/js/bootstrap.bundle.min.js" integrity="sha384-HwwvtgBNo3bZJJLYd8oVXjrBZt8cqVSpeBNS5n7C8IVInixGAoxmnlMuBnhbgrkm" crossorigin="anonymous"></script> </body> </html>