Troubleshooting
Where your projects, recovery copies and the log are, and what to check first.
Where your files are
| What | Where |
|---|---|
| Projects | The Buhayin folder inside Documents, or the folder you chose. Open the More menu on the projects window: its first line names the folder, and Projects folder… changes it. |
| A scene | Scene 1.bhy inside its project folder, with the pictures and sound it uses beside it. |
| Recovery copies | Beside the scene file, with .autosave added to its name, such as Scene 1.bhy.autosave. |
| Recovery copies of scenes never saved | In a recovery folder inside Buhayin's application data folder. |
| The log | buhayin.log. Choose Help > Show Log File to open its folder. |
| Reports of unexpected closes | Beside the log, named crash- and the date and time, such as crash-20261120-143005.txt. |
| Deleted projects | The system Trash. Buhayin never deletes a project outright. |
The app will not open
- macOS says it cannot check the app. Open System Settings > Privacy & Security, scroll to the message about Buhayin and choose Open Anyway.
- Buhayin quits straight away on first launch. You chose Quit on the Licence Agreement window, or closed it. Open Buhayin again and choose Agree.
- The download will not start. The download is tied to your account. Sign in on the site and try again.
- The Mac is too old. Buhayin needs a Mac with Apple silicon and macOS 14.2 or later.
Work that was not saved
Buhayin writes a recovery copy while you work: three seconds after your last change, and at the latest thirty seconds after the first change it has not yet written.
- Open the scene again.
- If the recovery copy is newer than the saved file, Buhayin says "has changes that weren't saved" and asks.
- Choose Restore to take the recovery copy, or Open Saved to open the scene as you last saved it.
A scene you never saved has no file to keep a copy beside. Buhayin keeps its copy in the recovery folder instead, and the next time you start it says "has changes that were never saved". Choose Restore or Discard.
Save with File > Save (Cmd+S). A recovery copy does not replace the scene until you restore it and save.
After Buhayin closes unexpectedly
If Buhayin closes unexpectedly, it keeps a report on your computer beside the log: the version, the system, where it stopped, and the last lines of the log. The next time you start Buhayin, after it offers back any unsaved work, it says "Buhayin closed unexpectedly last time." Show Report opens the report's folder and Dismiss closes the message. It says so once for each report. Nothing is sent anywhere.
"Open elsewhere"
If a scene is already open in another window, or in another copy of Buhayin, a window says the scene is open elsewhere and who holds it. Saving from both windows means the later save replaces the earlier one. Choose Cancel to leave it alone, or Open Anyway if you know the other window is closed or finished.
"Buhayin stopped the scene after a failure"
If something inside Buhayin fails, the scene takes no more edits and no more saves, so a half made change cannot be written over your file. Close the scene and open it again. Buhayin offers the recovery copy, which is the scene as it last was whole. The log says where the failure was.
Missing pictures, sound or movies
Choose Scene > Check Scene…. The window lists problems, which change what renders, and notes, which may be meant. Go to takes you to each one and Fix puts right what can be put right in one step.
File > Check Files… does the same for the pictures and sound the scene names but cannot find. If you edited a picture outside Buhayin, File > Read Changed Drawings (Cmd+;) reads the changes in.
The Export window also has a Check Scene button, so you can check before you write a movie.
Going back to an earlier state
- Edit > Undo (
Cmd+Z) takes back your last step, and Redo puts it back. - File > Save as New Version… keeps a named version of the scene.
- File > Version History… lists the versions you named and the saved states, shows a picture of the one you pick, and lets you Restore it or Open as Copy.
Free some disk space
Project > Clean Up Unused Files… lists the files a project no longer uses and their size. Move to Trash sends them to the Trash.
Read the log
The log records what Buhayin did and what went wrong. To read it inside the editor, open the Message Log view from the Window menu. Each line starts with a letter for its level: E error, W warning, I info, D debug and T trace. Clear Log only forgets the lines on screen. The file keeps them.
To open the log file's folder, choose Help > Show Log File. The log is made of up to five files of about one megabyte each, so the oldest lines roll away.