Troubleshooting and FAQ
Quick answers to the questions we hear most, from files that won't sync to a grid you can't edit on your phone.
Syncing with your BYOK
A file I made in Studio isn't on my BYOK
Only linked text files and scripts go to the device. Check the file's options under Device Sync, or Devices › Manage Files. If it's not there, link it (how), or turn on Auto-link new Studio files so new files go automatically. Then sync the BYOK (turn it off, choose Connections › Syncing › Sync Now, or press Ctrl+S on the device). Manuscripts, outlines, wikis, cards and grids don't go to the device; only text files and scripts do.
A file I deleted on my BYOK came back
It's still linked in Studio, so the next sync puts it back. Unlink it in Studio instead (right-click › Syncing, or Devices › Manage Files), and it's removed from the device on the next sync.
I can't rename a file
It's linked to a BYOK. Unlink it, let the BYOK sync once, rename it, and link it again. See Renaming synced files.
"File Conflict Detected"
The file changed on your BYOK and in Studio since the last sync, or your BYOK sent a new file with the same name as a Studio file that has text. Use View Content to compare the Server Version and the Device Version, then choose Keep Server Version, Keep Device Version or Keep Both. The version you don't keep is gone, so if you're unsure, choose Keep Both: the device's version becomes a separate file (and goes to your BYOK too).
My device writing has odd spacing, or shows # and \\ symbols
That's the Line breaks and Markdown on your BYOK settings on the Devices page. New paragraph per line suits prose; Lines stay together suits dialogue and Markdown. If you write Markdown on the device, turn Markdown on your BYOK on. See Device settings.
My captures didn't arrive
- Captures are read during Wi-Fi sync, not when you type
::in Studio or bring files in from the card. - The command must be on a line by itself, and a blank line ends it.
- Look in the Scratch Pad's Captures inbox (on mobile, Pad › Inbox). Unless auto-routing is on, captures wait there.
See Captures.
The desktop app doesn't see my BYOK
Connect the cable, choose Connections › Disk Mode on the BYOK (or use a card reader instead), and wait for it to appear as a drive; Disk Mode can take a little longer than usual. Studio recognizes a card by its Projects folder together with its sync data or at least two of its Scripts, Fonts and Updates folders. Click the BYOK pill if you closed the panel.
Studio and your account
My manuscript, outline or wiki is read-only
On the web and mobile, those files need Studio Premium. If your trial or subscription has ended, they open read-only with an Upgrade button; nothing is lost. In the desktop app every tool stays free on your computer. See If Premium ends.
My changes aren't showing on another device
- Both devices must be signed in to the same account. The web and mobile apps always share one library; the desktop app joins in only with Studio Premium.
- Check the save icon in the header. On the desktop app, Account › Sync shows changes Waiting to sync. On the web, N not saved yet means changes are kept in that browser and go up once it's back online.
- On your phone, changes made offline stay on the phone until it's back online, then save by themselves.
- Desktop in local mode (On this computer in the header) doesn't sync at all until you sign in.
The save icon says "not saved yet"
Those changes haven't reached your account yet, usually because the connection dropped. The web app keeps them in this browser, even if you reload or close the tab, and sends them by itself once you're back online. Studio asks before you close a tab with changes still waiting. Until the count is gone, don't clear the browser's site data, and in a private window keep the window open.
"This outline was changed on another device"
An outline, card stack, grid or wiki was saved somewhere else (another browser tab, your phone, another computer) while you were working on an older copy. Studio kept the newer version and saved your edits in the file's version history as Edits on an older copy. Open the history, compare, and restore or copy back what you need.
On your phone, This outline hadn't loaded when you edited it means the file opened empty while you were offline. What you typed is in its version history too, and the real file is untouched.
A "conflicted copy" appeared
The desktop app was offline while the same file changed somewhere else. Studio kept the version in your account and saved your offline edits beside it. Compare them and delete the one you don't need.
A BYOK Seal couldn't be made
- "You've made today's limit of BYOK Seals": you can make up to 100 Seals in 24 hours. Try again tomorrow, or export without one.
- "Studio couldn't make the BYOK Seal, so nothing was exported": usually a connection problem. Check your connection and try again, or export without it.
- "A BYOK Seal needs an account: turn on sync to add one.": the desktop app is in local mode. Seals need an account; see Turning on sync.
- "A BYOK Seal needs a connection.": you're offline. Try again when you're back online.
Script exports don't offer a Seal. See BYOK Seals.
I forgot my password
Click Forgot password? on the sign-in screen and follow the email. Changing your password signs Studio out on your other devices.
My project or file name is rejected
Names can't contain / \ ? % * : | " < >. Use a dash or a space instead.
The apps
Nothing happens when I open the desktop app
Studio runs one copy at a time, and opening it again brings the open window to the front. If no window appears, quit Studio completely (on a Mac, BYOK Studio › Quit BYOK Studio; on Windows, close it from the taskbar) and open it again. Also check that your Mac runs macOS 13 or later.
A file shows "This file hit a problem", or the window went blank
Click Reopen on the file. The rest of Studio keeps working, and everything saved before is safe. If the whole desktop window stops working, Studio reloads it by itself and says Studio stopped unexpectedly and reopened; the last few seconds of typing may be missing. If it keeps happening, report a bug and say what you were doing.
Typing ², }, @ or # makes a heading or opens New file (Windows)
On German, French, Spanish, Polish and similar keyboards, these characters are typed with AltGr, which Windows reports as Ctrl+Alt. Older versions of Studio took them for shortcuts. Update to the desktop app 1.3.2 (or reload the web app) and AltGr types the character again.
The Linux app won't open
An AppImage has to be allowed to run first: right-click it, open its properties and allow it to run as a program. Linux builds are for 64-bit Intel and AMD computers, so they won't start on ARM. If the .deb installs but stops with a symbol lookup error, run sudo apt install libasound2t64, then open it again. If it still won't open, report a bug or tell us on Discord. The Linux app is in beta, and that helps us fix it.
My BYOK doesn't appear on Linux
Open it once in your file manager so that Linux mounts it, then wait a few seconds. Studio looks for it under /media, /run/media and /mnt.
Windows says "Windows protected your PC"
Click More info, check that the publisher is BYOK LLC, and click Run anyway.
Correct words are underlined in red
Studio is checking them against the wrong language. In the desktop app on Windows or Linux, open Account › Spelling and tick the languages you write in. On a Mac, add them in System Settings › Keyboard › Text Input › Edit… › Spelling, or choose Automatic by Language. For names and invented words, right-click the word and choose Add to Dictionary. You can also switch spell checking off there. See Spelling.
I can't edit a grid on my phone
Update the Studio app from the App Store or Google Play: grids made with the new grid edit on mobile from version 1.1. Until then, edit them on the web or desktop.
Every "Rose" in my book is underlined
That's the wiki noticing a name. Open the entry and turn off Detect at the bottom to stop matching it. See Mentions.
My Google Drive backups lost their formatting
Drive backups are plain text by design. For formatted copies, export to Word or PDF.
Getting work back
- Changed something by mistake? Cmd+Z, then version history.
- Deleted a file? It's in the Trash until you empty it.
- Deleted a project? Projects are deleted permanently. If you use the desktop app, a library backup may have it.
Still need help?
- In Studio, choose Report Bug from the account menu (on mobile, Settings › Report a Bug). It includes your app version, and you can attach screenshots.
- Ideas go in the Suggestion Box, in the same menu.
- Or write to us from Contact Support, and join the community on Discord and r/TheBYOK.
Still stuck?
Send us a note from Contact Support, or choose Report Bug in Studio’s account menu so your app version comes along with it. For the device itself, see the BYOK device manual.
