Troubleshooting

File problems are usually caused by missing paths, permissions, or untitled files.

• A file does not open: confirm it still exists.
• A file cannot be saved: check folder permissions.
• Autosave does not save an untitled file: save it with a path first.
• Configuration storage is not writable: use the %LOCALAPPDATA% fallback.

Run problems usually involve the interpreter, script behavior, or stdin.

• Python cannot be found: choose a valid interpreter.
• Wrong interpreter selected: select the Python that has your packages.
• Nothing appears in output: the script may exit silently.
• A script requires input: use stdin support or external console.
• A running script does not stop: close child processes if needed.

External console launch failures come from missing tools or invalid paths.

• Windows Terminal is not installed.
• PowerShell 7 is not installed.
• A custom terminal path is invalid.

PyInstaller build problems should be read from the build output.

• PyInstaller is missing.
• Build fails.
• Generated EXE misses a dependency.
• Antivirus flags an EXE.

Project actions depend on a valid active project folder.

• Project folder does not open.
• Search returns no results.
• File action is unavailable.

AI assistant issues often mean required context or permission is missing.

• Allow pyIDE Control is disabled.
• No active project folder is open.
• No text is selected.
• A path is rejected because it leaves the project root.
• A feature is not yet available because development is incomplete.

Website issues involve localization, theme storage, screenshots, or links.

• Language selection does not update content: ensure JavaScript is enabled.
• A translation falls back to English: the English key is used safely.
• Theme selection does not persist: check localStorage.
• A screenshot falls back to English: localized image is unavailable.
• A screenshot fails to load: the English fallback is used.