Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions docs/Camera-Permission-Troubleshooting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Camera Permission Troubleshooting

This guide explains why camera access may become permanently blocked in PictoPy on Windows, and how to recover from it.

## Why Camera Permission Gets Stuck

When you click **"Don't Allow"** on the camera permission prompt in PictoPy, the denial is **not** stored in Settings. Instead, it's stored by the app's internal web engine (WebView2) at the Chromium layer.

---

## Recovery Steps

### Windows:

!!! warning "This is a destructive workaround"

> Deleting the WebView2 data folder will reset:
>
> - Camera permission (allowing re-prompt)
> - Onboarding state
> - Avatar/name selection
> - Any other local webview data
>
> Use this as a **last resort** only.

#### Step 1: Close PictoPy

Make sure PictoPy is completely closed before proceeding.

#### Step 2: Locate the WebView2 Data Folder

Open **File Explorer** and navigate to:

```
%LOCALAPPDATA%\org.aossie.pictopy
```
Comment on lines +34 to +36
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Add language identifier to the fenced code block.

The code block should specify a language identifier for proper syntax highlighting in the documentation.

📝 Proposed fix
-```
+```text
 %LOCALAPPDATA%\org.aossie.pictopy
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 Tools
🪛 markdownlint-cli2 (0.18.1)

34-34: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
In @docs/Camera-Permission-Troubleshooting.md around lines 34 - 36, The fenced
code block that shows the path "%LOCALAPPDATA%\org.aossie.pictopy" lacks a
language identifier; update the markdown by adding a language tag (e.g., "text")
after the opening triple backticks for that code block so it becomes ```text and
enables proper syntax highlighting for the shown path.


You can paste this path directly into the File Explorer address bar.

#### Step 3: Delete the `EBWebView` Folder

Right-click the `EBWebView` folder and select **Delete**.

#### Step 4: Restart PictoPy

Launch PictoPy again. When you try to use the webcam feature, you'll be prompted for camera permission again.

---

## Still Need Help?

If you're still experiencing issues after following these steps, please [open an issue on GitHub](https://github.com/aossie-org/PictoPy/issues/new?template=bug.yml) with:

- Your Platform (Windows, Linux, macOS)
- Steps you've already tried
- Any error messages you see
46 changes: 36 additions & 10 deletions frontend/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions frontend/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@
"@tauri-apps/plugin-dialog": "^2.2.0",
"@tauri-apps/plugin-fs": "^2.2.0",
"@tauri-apps/plugin-opener": "^2.5.2",
"@tauri-apps/plugin-os": "^2.2.0",
"@tauri-apps/plugin-process": "^2.3.0",
"@tauri-apps/plugin-shell": "^2.2.0",
"@tauri-apps/plugin-store": "^2.2.0",
Expand Down
Loading