Box Of Synths manual

Box Of Synths manualReference

Messages and errors

The messages Box Of Synths shows on screen, grouped by where they appear, with what each one means and what to do.

This page lists the messages you can see in the app. It is grouped by where a message appears. The text of each message is in bold, exactly as the app writes it. A word in square brackets, such as [site], stands for text the app fills in.

Some of the app's short notices are not shown anywhere in the main view, so they are not listed here. If something seems to do nothing, look for the effect itself, such as a changed dial, a new line in the history table, or the red text on the design sheet. The sheet is the one place a design error always appears.

The design sheet

When you press Generate or Edit, a dark sheet covers the window while the designer works. It shows your words under YOUR REQUEST. If a design fails, or the designer answers in words, the sheet shows the message and a BACK key. Your words go back into the chat box and your sound has not changed.

While it works

Message What it means What to do
Designing your sound... A new sound is being designed. Wait. Press Esc or CANCEL to stop it.
Updating your sound... An edit is being applied to the sound you have. Wait, or cancel as above.
Waiting for response | [n] s The request has gone out and nothing has come back yet. The number counts the seconds. Wait. A design can take a while. If it takes too long, cancel and send it again.
Received [n] characters | [n] s The answer is arriving. Wait.
Database version ready. Your AI is still designing. With your own key, the free database sound came first. The sound from your AI is still on its way. Wait. Both versions end up in the history so you can compare them.
Takes ready. Choose one. A new sound came back as several takes. They wait on the Choose a take sheet, and nothing is on the synth yet. Play the takes and click Use this one on the one you want. See Takes.

When a design fails

The headline is Design could not be completed, with one of these lines under it in red.

Tokens

Message What it means What to do
Sign in to design on your tokens. Your patch has not changed. You chose Box Of Synths as the source, but this computer is not signed in to an account. Sign in under Settings, Account, or choose another source. See Settings: Account and privacy.
Cannot connect to the token service. Nothing was charged. The app could not reach the token service. Check your connection and try again. You can also choose the built-in database, which works offline.
The site does not accept this plugin's API key any more. Paste a fresh one in settings (SITE). Your patch has not changed. The account key stored on this computer has been replaced or removed. Sign in again under Settings, Account. See Settings: Account and privacy.
Box of Synths is unavailable. Your patch has not changed. Our site has switched the hosted designer off for now. Try again later. The built-in database still designs.
The site did not answer in time. Send the same words again: a sound that was already made comes back without a second token. The request went out but no answer came back. Send the same words again. A sound that was already made comes back without costing another token.
The connection ended before the result was confirmed. Check your account before retrying. The connection dropped before the app heard the result. Look at your token balance under Settings, Account, then send the words again if you need to.
[the site's own message] and Reference: [ref] The site refused the request and gave its own reason. Read the reason. If you ask for help, give the reference.

Your own AI key and a local model

Each of the first six lines is followed by It said: [the reason, up to 160 characters] when the service gave a reason, and then Your sound has not changed.

Message What it means What to do
Your AI service did not accept the key (HTTP [n]). Check the key in Settings, Designer: it may be mistyped, expired, revoked or from a different account. The service refused the key. Open Settings, Designer, and paste the key again. See Settings: Designer, source by source.
Your AI service says the account cannot pay for this request (HTTP 402). Check its billing, or choose another source. The service says your account cannot pay for the request. Look at your billing with the service, or choose another source.
Your AI service does not know that model (HTTP 404). Check the model name in Settings, Designer. The model name is wrong or no longer exists. Pick a model from the Model list, or type its name again.
Your AI service is limiting requests or the account is out of quota (HTTP 429). Wait a moment and try again. Too many requests, or the quota is used up. Wait, then try again.
Your AI service is having trouble (HTTP [n]). Try again shortly. The service had an error on its side. Try again shortly.
Your AI service refused the request (HTTP [n]). The service said no for another reason. Read the It said line, if there is one.
The base URL must be https (or this machine). Nothing was sent. The endpoint in Settings is not a secure web address. Correct the Endpoint in Settings, Designer.
No reply from [url] within [n] s. The model may still have been thinking; try again, or a smaller request. Nothing came back in time. Try again, or ask for something simpler.
Empty reply: [the first 300 characters] The service answered with nothing usable. Try again.
Your AI service stopped part way: [reason] The reply was cut short. Try again.
The model ran out of room before the patch was complete. Try again, or ask for something simpler. The reply hit the reply cap. Ask for something simpler, or raise Max reply tokens on your own key in Settings: Advanced.
The model declined this request. Your patch has not changed. The model refused. Reword your request.
The model did not return a usable patch. It said: [the first 160 characters] The model answered in words, not with a sound. Read what it said, then try again.
The provider did not answer. The request failed and the service gave no reason. Check the endpoint and your connection, then try again.
The service's streaming reply ended before its final frame. No partial design was used. A local model stopped mid reply. Try again.

A failed call also saves a record of the exchange in the Errors folder of your library. See Files and folders.

When the designer answers in words

These show on the sheet in plain text, with no headline. Your sound is not changed.

Message What it means What to do
I kept your sound: I could not tell how to change it from those words. Try louder, darker, fatter, less glide, more reverb, an octave up, make it mono, or undo. For a new sound, switch to GENERATE. The built-in database could not read your edit. Use words like the examples, or switch to Generate for a new sound.
I kept your sound: I could not tell how to change it from those words. Try words like brighter, darker, fatter, wider, punchier, softer or more reverb, or name a new sound to start again. The same, for an edit that matched nothing. Use words like the examples, or name a new sound.

If you ask for something that is not a sound, such as a beat or a question, the sheet shows a plain answer in words.

The sign-in card

When you choose Box Of Synths as the source with no account, a card called WAITING FOR YOUR BROWSER opens with a code. The line along its foot says how it is going.

Message What it means What to do
The link lasts fifteen minutes. The card is waiting. Finish signing in on the page in your browser.
Asking the site for a link... The app is asking the site for a sign-in page. Wait.
Your browser has the page. Sign in there and press CONNECT. The sign-in page is open in your browser. Sign in on that page and press CONNECT. The card fills itself in.
The site is not answering; try again in a moment. The site did not answer. The line shows the site's own message instead if it sent one. Press CANCEL and start again in a moment.
No connection to the site just now; still waiting. The app lost the connection while it waits. Check your connection. The card keeps trying.
Link copied. You pressed COPY THE LINK. Paste the link into a browser.

The stamp card

When choosing a take earns a stamp on your loyalty card, a small card slides in under the header, then goes by itself after about two and a half seconds. It takes no clicks. The count under the first line reads, for example, 3 / 4.

Message What it means What to do
A stamp for that Your choice earned one stamp. Nothing. The card in Settings has moved on too.
Two stamps for that Your choice earned more than one stamp. Nothing.
Card full: one free token The last place on the card is filled. You have earned a free token. Nothing. See Settings: Account and privacy.

Settings

These lines are inside the Settings sheet.

The save status word

The word beside the title says where your changes are. Saved, Editing, Checking and Check notes are explained in Settings: Designer.

Under Taste and guidance

Message What it means What to do
Sound and taste guidance is checked automatically. The starting line. Nothing.
Edit these instructions to check and save them. You have changed the note and it is not checked yet. Click away or press Return.
Checking that with the site... The note holds a word that needs a second look, so it is being checked. Wait a moment.
Saved. It goes with every design request. The note passed and is in use. Nothing.
Saved. The note is kept. Nothing.
Cleared. You emptied the box, so there is no note. Nothing.
Put back. Revert restored the previous settings. Nothing.
Keep it under 600 characters. This is a note about taste, not a document. The note is too long. Shorten it to 600 characters.
That reads like a message to the model rather than a note about your taste. Say what you like to hear. The note looks like an instruction, not a taste. Describe the sound you like.
I can only take notes about sound: eras, textures, what you like and do not like. Nothing about how I work. The note was refused. Write about sound and taste only.
I could not reach the site to check that. The note is held until I can. The check could not run. The note is kept but not used. Check your connection. It is used once the check passes.

A note that is refused turns the status word to Check notes, and the box keeps your words so you can fix them. If the site refuses a note, its own reason shows here.

The model list

Under the Model box on the Designer tab, for your own key and for a local model.

Message What it means What to do
Asking the service for its models... The list is loading. Wait.
Loading installed models... The same, for a local model. Wait.
[n] installed model. or [n] installed models. The local app listed what it has. Pick one.
[n] model. Pick it, or type a name. or [n] models. Pick one, or type a name. The service listed its models. Pick one, or type a name.
Add your key and its models are listed here. You can type a model name too. There is no key yet. Paste your key.
No installed models found. The local app has no model installed. Install a model in that app, then press Refresh.
The service listed no models. The service gave an empty list. Type a model name.
The service did not accept the key, so it would not list its models. The key is wrong, expired or from another account. Paste the key again.
The service did not return a model list. You can still type a model name. The service gave no list. Type the model name.
The service is unreachable at this endpoint. Nothing answered at that address. A local app gives the same message with its own name in place of "the service". Check the Endpoint, that the local app is open, and your connection.
The base URL must be https (or this machine). Nothing was sent. The endpoint is not a secure web address. Correct the Endpoint.

The database page

Under Database options on the Designer tab, when Built-in database is the source.

Message What it means What to do
Asking the site for the free packs... Download free packs has started. Wait.
Downloading [name]... A pack is coming down. Wait.
[n] packs, [n] records, in the folder. The download finished. The words are 1 pack when there is one. Nothing.
No packs came down. Try again in a minute. The site listed no packs you can have. Try again in a minute.
The site did not answer. Check the SITE address and try again. The site did not reply. Check your connection and try again.
[n] record added. or [n] records added. Your own file was added to the database. Nothing.
No records found in that file. One JSON object a line, or an array. The file holds no records in a shape the app reads. Check the file. Use one JSON object a line, or an array.
Could not copy that file into the folder. The app could not copy your file into the database folder. Check that the folder exists and can be written to.
Folder set. You chose a new database folder under Library. It is shown here, on the Designer tab. Nothing.

On the Account tab

Message What it means What to do
Asking the site... Check site is running. Wait.
Up. Talking to [site] The site answered and is up. Nothing.
DOWN: [message] The site is down, with its own reason. Try again later. The built-in database still designs.

On the Library tab

Message What it means What to do
A plan keeps your library on Box Of Synths. Cloud sync needs a plan, and none is in use. See Settings: Library and folders.
a plan keeps it: [n] of [n] sounds, [n] MB Your plan's use of its allowance. Nothing.

On the Advanced tab

Message What it means What to do
Copied. Copy diagnostics put the block on your clipboard. Paste it into your message.
Dialog warnings restored. Reset dialog warnings brought back the two warnings you had switched off. Nothing.

Cards and dialogs

These cards ask before something is lost or changed. Press Return for the main button and Esc to cancel. A click outside a card cancels it too. The first-run cards, the tokens agreement and the own-key agreement are on Agreements and confirmations.

Card Text What to do
Create a new patch? The synth on the rack goes to CHATS and a fresh one takes its place. Buttons Create and Keep this one. Create starts a new synth. The old one is kept in the history.
Switch synth? Are you sure you want to switch? Undo can restore the current sound. If you have unsent work, Your unsubmitted text, drawing and context will be cleared. Choose Switch or Cancel. Tick Do not ask again to stop the card.
Leave this new synth? The same words and keys, with Leave and Cancel. As above.
Delete [title]? The chat goes for good. The sounds it made stay in your library. Delete removes only the chat.
Move this version? It becomes v1.0 in a new synth and leaves this history. Undo restores it. Move or cancel.
Delete this version from history? Its saved sound is kept, and Undo restores the history entry. Delete or cancel.
Delete branch [v]? Remove [n] version(s) from this history? Their saved sounds are kept, and Undo restores the branch. Delete branch or cancel.
Flatten [v]? Keep the sound of [label] as [root] and remove [n] other history versions in this scope. Saved sound files are kept. Undo restores the previous sound and history. Flatten or cancel.
THE SAME WORDS AGAIN You asked for exactly this recently. Spend [n] more token(s) on a fresh take? The site may word it its own way. SPEND AGAIN sends it once more. CANCEL keeps your tokens. The earlier result is in the history.
THREE TAKES ON YOUR OWN KEY Each new sound will send three requests to your own AI provider, not one. Whatever that provider charges for them is yours to pay. Box Of Rules does not see or cap that spend. TURN ON switches on the takes. CANCEL leaves them off. A click outside the card cancels. See Takes.
Save this rack Rack name: with the name of the synth filled in. Opened by Cmd or Ctrl and S. Press Return to save, or Esc to cancel.

The history and the browser

Message Where What it means
No chats yet. They are saved as you design. The History tab. You have no saved chats yet.
Nothing matches "[words]". The History tab search. No chat matches your search words.
What would you like to make? The empty page of a new chat. Type what you want in the box and press Return.
BOX OF SYNTHS IS DOWN [MESSAGE] THE DATABASE STILL DESIGNS. A red band under the header. Our site is down. Designs from the built-in database still work. The band goes when the site is back.

The composer and the synth

Message Where What it means
Describe the sound to build… The chat box in Generate. The box is ready for a new sound.
What needs improving The chat box in Edit. The box is ready for a change.
Describe the effects to add… The chat box after Generate on the add menu of the effects. The next send asks for effects only.
Designing… The chat box while a design runs. The box is grey until the design is done.
Queued, one moment The chat box. Your request waits behind another.
Designing… and Queued Over the Macros heading. The same two states.
This macro reaches nothing yet. The macro detail. The macro has no links. Ask the designer for a new set of macros.
Set wave to Harmonic to draw partials The harmonics area, on any other wave. Click it to switch the wave to Harmonic.
Everything is on the row already The effects add menu. All fifteen effects are in the chain.
No sample yet The Granular card. The sound has no sample file. Press NEW FILE.