Skip to content

Publish a song

View Markdown
For agents

Give your agent this page’s Markdown link, or choose a collection.

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.

Terminal window
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.

Terminal window
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.

The account page 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.

Terminal window
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.

Documentation drafted with AI and checked against the product source.