Check your setup with showreel doctor
One command that checks everything Showreel Studio needs on your Mac, and what to do about each problem.
When something does not work, start here. showreel doctor checks your Mac, your sign-in and the project you are in, and says what is wrong. It runs even without a licence.
Run it
In your project folder:
showreel doctorEach line starts with a mark: ✓ for fine, ✗ for a problem, and · for a note. If anything is marked ✗, the command ends with a failure code.
What it checks, and how to fix each
| Line | If it shows ✗ |
|---|---|
node | Install Node 22 or later. |
ffmpeg, ffprobe | Install ffmpeg, which brings both: brew install ffmpeg. |
chrome | Install Google Chrome, or check it opens. |
gcloud | Install the Google Cloud CLI. The voice needs it. |
gcloud account | Sign in to Google Cloud: gcloud auth login. |
signed in | Sign in to Showreel Studio: showreel login --service https://app.showreelstudio.app. |
licence | The reason is shown. See Your licence. |
project | A note, not a problem: this folder has no showreel.json. Run showreel init to start a project here. |
kit | The project's kit cannot be found or is incomplete. Run showreel kits sync, or choose another kit. |
app | The project has no app profile. See Connect your app. |
cloud | The project has no cloud connection. See Connect your Google Cloud. |
The project lines appear only inside a project folder.