Publish a song
For agents
Give your agent this page’s Markdown link, or choose a collection.
- Documentation indexFind a guide and its Markdown link.
- Full documentationRead all curated guides in one text file.
- Machine manifestFind page metadata, Markdown URLs and checksums.
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
Section titled “Connect the CLI”dawn logindawn whoamidawn 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
Section titled “Publish the current project”dawn publish sketches --title "First light" --track-slug first-lightThe 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
Section titled “Manage access and visibility”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.
dawn logoutdawn 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.