> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screenjson.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Convert a screenplay to ScreenJSON in under a minute.

## 1. Install the free reference CLI

<Tabs>
  <Tab title="Download">
    Download a platform binary from the [releases page](https://github.com/screenjson/screenjson-export/releases/tag/v1.0.0):

    * macOS · Apple Silicon — `screenjson-export_Darwin_arm64.tar.gz`
    * macOS · Intel — `screenjson-export_Darwin_x86_64.tar.gz`
    * Linux · amd64 — `screenjson-export_Linux_x86_64.tar.gz`
    * Linux · arm64 — `screenjson-export_Linux_arm64.tar.gz`
    * Windows · amd64 — `screenjson-export_Windows_x86_64.zip`
    * Windows · arm64 — `screenjson-export_Windows_arm64.zip`

    ```bash theme={null}
    tar -xzf screenjson-export_*.tar.gz
    sudo mv screenjson-export /usr/local/bin/
    ```
  </Tab>

  <Tab title="Docker">
    ```bash theme={null}
    docker pull screenjson/export:latest
    ```
  </Tab>

  <Tab title="Source">
    ```bash theme={null}
    git clone https://github.com/screenjson/screenjson-export.git
    cd screenjson-export
    go build -o screenjson-export ./cmd/screenjson-export
    sudo mv screenjson-export /usr/local/bin/
    ```
  </Tab>
</Tabs>

## 2. Convert a file

```bash theme={null}
screenjson-export -i screenplay.fdx -o screenplay.json
```

Or in Docker:

```bash theme={null}
docker run --rm -v "$PWD:/data" screenjson/export -i /data/screenplay.fdx
```

Fountain and FadeIn are auto-detected from the file extension:

```bash theme={null}
screenjson-export -i script.fountain -o script.json
screenjson-export -i script.fadein   -o script.json
```

## 3. Inspect the output

```bash theme={null}
screenjson-export -i script.fdx | jq '.title.en'
screenjson-export -i script.fdx | jq '.document.scenes | length'
screenjson-export -i script.fdx | jq '.characters[].name'
```

## Next steps

<CardGroup cols={2}>
  <Card title="Full CLI" icon="terminal" href="/tools/cli/overview">
    Export to every format, run a REST API, and more.
  </Card>

  <Card title="Try it in the browser" icon="play" href="https://screenjson.com/try/">
    Paste a URL or drop a file — convert without installing anything.
  </Card>

  <Card title="Specification" icon="file-lines" href="/specification/overview">
    The shape of a ScreenJSON document.
  </Card>

  <Card title="REST API" icon="plug" href="/api-reference/cli/introduction">
    Endpoints exposed by `screenjson serve`.
  </Card>
</CardGroup>
