# Publish a song

Publishing uploads a rendered song to `dawnav.com`. It needs an account, network access and FFmpeg. Local composition, checks and ordinary renders work without an account.

## Connect the CLI

```sh
dawn login
dawn whoami
```

`dawn login` prints a device-approval URL at `publish.dawnav.com` and a code. Open that URL, check the displayed code and approve the computer. Browser log-in uses an email code; a new account also needs a username.

The CLI stores its publishing token in `~/.config/dawn/credentials` with file permissions `0600`. Keep this file out of song projects and version control.

## Publish the current project

```sh
dawn publish sketches --title "First light" --track-slug first-light
```

The first argument is the album slug. The command renders score JSON and AAC audio, then creates a muted video preview. It uploads these three files and prints the track URL, such as `dawnav.com/<username>/sketches/first-light`. The publish service draws the share images from the score when they are first requested.

Publishing the same album and track slug replaces that published track. Check the destination and listen to a local render before publishing a revision. Your local project files remain the editable source.

Publishing again also replaces the share images and the video preview, so a song published with an earlier release gets the current ones. A song published with DAWN 0.61 or earlier keeps the Opus audio and share images it uploaded until it is published again.

| Option                 | Effect                                                      |
| ---------------------- | ----------------------------------------------------------- |
| `--title <text>`       | Set the track title                                         |
| `--track-slug <slug>`  | Set its URL segment                                         |
| `--album-title <text>` | Set the album's display title                               |
| `--unlisted`           | Omit the track from album and user listings                 |
| `--assets <dir>`       | Supply `preview.mp4` from a directory instead of drawing it |

An unlisted track is still playable by anyone with its link. Use `dawn publish --help` for the installed release's exact options.

## Manage access and visibility

The [account page](https://publish.dawnav.com/account) lists published tracks and the computers authorized to publish. You can change a track's visibility, delete a published track or revoke a computer's token there.

```sh
dawn logout
```

`dawn logout` revokes this computer's publishing token and removes its saved credentials. If the service cannot be reached, it removes the local credential and tells you how to revoke the token from the account page.
