Troubleshooting and questions#
The badge says "My PC: offline"#
Start Start_Agent.bat on your PC and keep its window open. If it was disconnected, connect it again from
Settings → My PC.
"There is no API key for this AI"#
Put the key in Film_Studio\.env on the PC (or Settings → Your API keys for films made on the server),
then Settings → API keys → Test.
The film stopped: daily limit#
Free and new Gemini keys have a daily limit. The page counts down; press Resume when it ends. Turning on billing in Google AI Studio raises the limits.
The film stopped: budget#
Raise Budget limit on the settings page and resume. Finished work is kept.
The voice does not sound natural#
In Bangla choose a Gemini or Sarvam voice (see Voices). Changing the voice records only the narration again (cents); the pictures stay.
A picture is wrong#
Shots page → Remake picture, or give your own picture. Changing a character's look on the Characters page redraws its portrait; remake the shots that should follow it.
No subtitles in the video#
The ffmpeg on the PC lacks subtitle support: Settings → This PC says so. Install the full build:
winget install Gyan.FFmpeg.
The listening samples do not play#
They are made once with run.bat voices --samples (on a server, copy Film_Studio/assets/voice_samples too).
The film name is not in the font I chose#
- The font has no letters of the film's language: then the language's own font is used (only fitting fonts
are offered, if the PC can check them — run
setup.batonce so it can). - The film was made before the font was chosen: press Make again (no AI cost).
- Settings → My PC shows Update next to your PC: update it first.
"Python is not installed" when starting the agent#
Install Python 3.13 from python.org/downloads, ticking “Add python.exe to
PATH”, then double-click Start_Agent.bat again.
Settings → My PC says the film maker on this PC differs#
The website has a newer film maker than the PC. Installed from the download: press Update. Your own folders:
run copy_film_maker.bat and git on the PC where you develop, or git pull on the other PC.
A shot's narration says something that is not in the text#
The AI that listens records such a shot once more by itself. If the Shots page still shows The narration differs from the text under it, listen, and use Record voice again. If it keeps happening, rephrase the sentence a little on the Script page.
"The update is not signed with your release key"#
The agent refused an update that was not signed. On the PC that holds the release key run copy_film_maker.bat,
then git push, update the website, and press Update again.
"The font … was not found"#
The video used another font. On the settings page choose the font again from the list (it shows the names the video finds), or add the font file in Settings → Fonts, then Make again.
publish.bat stopped#
It stops at the step that went wrong and nothing after it is done. Quick check: a test failed — send its
lines from FAIL: to AssertionError. git push: check the internet and that git can log in. ssh: check
PI_SSH in env.web and the Pi's password, or run bash deploy/update.sh on the Pi yourself.
The style cards show colours, not example pictures#
The examples are made once on the PC with run.bat styles --examples, then publish.bat and update.sh take
them to the website. On the PC that runs the studio itself, close and start the studio again after an update.
A line of my own recitation is in the wrong place#
Open Where the lines were found in your recording on the settings page. Usually the reciter did not pause there,
or said a word that is not in the text: correct the text (one line a line, an empty line between stanzas). Or
change the times in work\<poem>\04_recitation.json on the PC, add "fixed": true, and make the film again.
A stanza is not recited the way I want#
Shots page → A note for the reciter under that stanza ("slower, almost a whisper") → Record this stanza again with the note, then make the film again. Only that stanza is recorded (and paid) again. Tick the box to make it a lesson of the reciter for every later film.
A word in my pronunciation list is still said wrong#
The list changes only what the voice hears, starting with films made (or made again) after the change. Write the
word as it is written in the text — it is found at the start of a word; end it with ! for the whole word only
(ছুটিল! = ছুটিলো). A PC with the Studio Agent needs the update
from 13 November 2026 or later (Settings → My PC → Update).
Can I sell or post the films?#
The pictures and voices are yours to use under the AI services' terms. The story and the music must be free to use or licensed to you. YouTube asks you to mark altered or synthetic content only when pictures look like real camera footage of real people or places.
Where is my film on the PC?#
Film_Studio\output\<story>\ — the video, subtitles, translation and the publish\ folder.