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

# Quickstart

> Configure NoteWise, process one YouTube video, and find the generated notes.

Start here after installing NoteWise. This page covers the first successful run only: create config, process one public YouTube video, and confirm the output file.

<Steps>
  <Step title="Create config">
    ```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
    notewise setup
    ```

    The setup wizard writes supported keys to `~/.notewise/config.env` unless `NOTEWISE_HOME` points somewhere else.
  </Step>

  <Step title="Process one video">
    ```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
    notewise process "https://youtu.be/VIDEO_ID"
    ```

    By default this uses `gemini/gemini-2.5-flash`, requests English transcripts, and writes Markdown into `./output`.
  </Step>

  <Step title="Check the result">
    ```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
    ls output
    ```

    The default file is a sanitized video title ending in `.md`.
  </Step>
</Steps>

## Next steps

After the first run works, use the focused guides instead of repeating setup here:

<CardGroup cols={2}>
  <Card title="Process options" href="/docs/use/process">
    Change output folders, formats, models, quizzes, transcripts, and dashboard behavior.
  </Card>

  <Card title="Provider setup" href="/docs/config/providers">
    Pick a LiteLLM provider and model string for future runs.
  </Card>

  <Card title="Playlists and batches" href="/docs/use/playlists-batches">
    Process full courses, URL lists, and reruns with cache-aware behavior.
  </Card>

  <Card title="Troubleshooting" href="/docs/operate/troubleshooting">
    Debug setup, YouTube, output, cache, and provider failures.
  </Card>
</CardGroup>

## If the first run fails

Start with the health check, then open the troubleshooting guide if it reports a problem:

```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
notewise doctor
```

Do not share API keys, OAuth tokens, cookies, raw prompts, or provider payloads when asking for help.