Skip to content

Commit

Permalink
Changes in Common Issues & Storage guide pages (#131)
Browse files Browse the repository at this point in the history
* Created "Storage location issues" section, added "Invalid location" portion, moved & reworded relevant issues

* Refinement

* Extra: Use better sentence from Common Issues version (and bold for the Common Issues one)

* Extra: Petition to remove this (imo) unhelpful line
  • Loading branch information
Smol-Ame authored Jan 13, 2025
1 parent 4f6b450 commit 4b9abcf
Show file tree
Hide file tree
Showing 2 changed files with 25 additions and 10 deletions.
2 changes: 1 addition & 1 deletion website/src/docs/faq/storage.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Mihon manages several things within a selected storage location, including autom
::: tip Selecting a storage location
Keep the following in mind when setting up your Storage location:
* Create a "Mihon" folder at the top-level of your storage (ex. `/Internal Storage/Mihon/`).
* **Do not** use your device's "Documents" or "Downloads" folder as your storage location, system folders restrict & cause issues when Mihon tries to access them.
* Do not use your device's system folders (such as "**Documents**" or "**Downloads**"), they are restricted by Android and will cause issues when Mihon tries to access them.
* When selecting your storage location during the setup process, give access to the "Mihon" folder, not the folders within.
:::

Expand Down
33 changes: 24 additions & 9 deletions website/src/docs/guides/troubleshooting/common-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,6 @@ Here's how to tackle common challenges.

## Basic issues

### `Cannot Access SD Card`
* Temporarily switch download location from SD card, then revert and restart the app.
* Long filenames trigger this. Android file manager doesn't support **>255** characters.
* If known, shorten the file/folder name via computer when SD card is connected.
* Else, delete **Mihon** downloads folder on SD card.

### Storage issues with Android 11+
See [this section](/docs/faq/storage) of the FAQ to learn how Scoped Storage affects **Mihon** in **Android 11+** and how to fix it.

### Slow loading
Sources being slow could stem from site slowness, your internet, or source-imposed rate limits/IP bans.

Expand All @@ -31,6 +22,30 @@ Sources being slow could stem from site slowness, your internet, or source-impos
### App not installed
Refer to "[Unable to install the app or extensions](/docs/guides/troubleshooting/#app-or-extension-installation-issues)" section.

## Storage access issues

### "Invalid location" error
This error indicates the selected storage location is invalid. Possible reasons include:
* The app lacks Storage permission.
* The app cannot access your Mihon storage location folder.

Try these solutions:
* **(For Android 9 and below)** In the Mihon app info or your Phone Settings, under the Permissions section, grant Mihon storage permission.
* Grant Mihon access to your desired storage location again.
* Navigate to <nav to="data-and-storage">, tap on "**Storage location**", go to your "Mihon" folder and give Mihon access to that folder.
* Create a new folder or move your existing "Mihon" outside of your device's system folders.
* Do not use your device's system folders (such as "**Documents**" or "**Downloads**"), they are restricted by Android and will cause issues when Mihon tries to access them.
* Refer to the [Storage FAQ](/docs/faq/storage) for more details.

### Storage issues with Android 11+
See the [Scoped Storage](/docs/faq/storage#scoped-storage) portion of the FAQ to learn how it affects **Mihon** in **Android 11+** and how to fix it.

### `Cannot Access SD Card`
* Temporarily change the Storage location from your SD card, then change it back to your original storage location and restart the app.
* Long filepath/filenames could also trigger this issue, as Android's file manager doesn't support **>255** characters:
* If possible, move your "Mihon" to the top-level of your SD card or shorten your "Mihon" folder name.
* Remember to set the Storage location after moving or changing your "Mihon" folder.

## Advanced errors

### `Java.lang Exception: Failed to bypass Cloudflare`
Expand Down

0 comments on commit 4b9abcf

Please sign in to comment.