> For the complete documentation index, see [llms.txt](https://cloakedkeys.gitbook.io/ofsc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cloakedkeys.gitbook.io/ofsc/faq.md).

# FAQ/Common Issues

## 1. <mark style="color:blue;">Missing Post</mark>

Certain models delete content, which restricts OF-Scraper from accessing this specific content.

***

## 2<mark style="color:blue;">. Number of users doesn't match account number</mark>

<https://github.com/datawhores/OF-Scraper/issues/224#issuecomment-1757367312>

Every time you scroll down, the API requests 10 names, but frequently, fewer than 10 names are returned

### Example

Account: 400 total subs

**Active Accounts**

This figure is expected to be more accurate, but it seems to update according to a schedule, so it might be slightly off until synchronization occurs.

**Expired and ALL**

The count here can be significantly impacted by expired subscriptions.

For instance, an account may indicate it has 400 subscribers, but as OnlyFans iterates through each offset \[0, 10, 20, 30,...390], some offsets won't return 10 numbers, ultimately reducing the final count.

***

## 3. <mark style="color:blue;">Missing Models</mark>

Before creating an issue, ensure that you're using the latest version available.

***

## 4. <mark style="color:blue;">Lots of tempvideo or tempaudio files</mark>

Ensure your CDM (Content Decryption Module) is set up correctly, and that ffmpeg 6 or newer is installed. Manual CDM is recommended

[CDM Options](/ofsc/cdm-options.md)

***

## 5. <mark style="color:blue;">Something is not working</mark>

Run the command to display the output in the console

```
ofscraper --output debug
```

Alternatively, run the command to output to your configuration folder.

```
ofscraper --log debug
```

Send the logs to a Discord channel or create a GitHub issue

***

## 6. <mark style="color:blue;">FFMPEG</mark>

ffmpeg 6 or newer is necessary for downloading protected content, and it is compatible across various platforms.

<https://ffmpeg.org/download.html>

#### Binaries

> ℹ️ **If manually downloading simply provide OF-Scraper with the full path to the program in the configuration file**

[Binaries Options](/ofsc/getting-started/config-options/options/binaries-options.md)

<details>

<summary>Copying path on windows<br></summary>

You can use the following software if windows does not provide an easy way to do this

<https://pathcopycopy.github.io/>

</details>

***

## 7. <mark style="color:blue;">ofscraper not found</mark>

This generally means that you need to update your PATH

***

## 8. <mark style="color:blue;">Can this download locked content</mark>

Yes.....if it was unlocked before.

***

## 9. <mark style="color:blue;">Status Down</mark>

This usually indicates that your authentication information is incorrect, or you've been signed out from OnlyFans

***

## 10. <mark style="color:blue;">404 Response</mark>

This could imply that the content you're attempting to scrape is no longer available. It might also signal that the model has deleted her account, making it inaccessible on the platform.

***

## 11. <mark style="color:blue;">Request taking a long time</mark>

If a request fails, OF-Scraper will pause and make several retry attempts. Frequent retries could extend the duration of certain runs.

> ℹ️ **Requests have a built in timelimit to prevent them from being stuck forever (the read timeout is 60 seconds)**\
> **You can change it with the `OFSC_READ_TIMEOUT` environment default**

***

## 12. <mark style="color:blue;">429 Response</mark>

* This error may stem from excessive requests, particularly when auto-liking/unliking.
* The maximum appears to be 1000 per day.

***

## 13. <mark style="color:blue;">409 Response</mark>

\
You might observe cases where content is unavailable on the OnlyFans site, often indicated by placeholders or non-loading media.

VPN users might experience this based on the VPN server they're connected to. Consequently, this also affects the API and OF-Scraper's ability to scrape content.

The most effective solution would be to switch VPN servers or allow some time for the situation to reset.

***

## 14. <mark style="color:blue;">Scrape entire paid page or --scape-paid should I do it</mark>

The amount of content you've purchased largely determines this

#### Does the regular scraper get purchased content?

Yes, if you've chosen "purchased," all purchased content for the selected models will be scraped. This is accomplished by using the models' usernames as input on the purchase page.

#### Then why the prompt

Certain models may have deleted accounts, making it necessary to scan the entire purchase page to access their purchases. Since they lack a name to use as input, a thorough scan becomes necessary.

#### When would you use to use it

Personally, I rarely use this setting. However, if your scans are infrequent, it might be a good idea to turn it on.

I'd also recommend using it during your initial scan.

#### When would you not use it

If you're conducting frequent scans, such as one per day, it's alright to turn it off for most scans

***

## 15. <mark style="color:blue;">FFmpeg shared library not found Error</mark>

Example: : version \`GLIBCXX\_3.4.29' not found

### Cause

Missing shared libraries

This issue appears to only affect Linux systems

### Fix

Obtain the GPL non-shared release version.

<https://github.com/BtbN/FFmpeg-Builds/releases>

### Some Info

* <https://superuser.com/questions/1712179/which-version-of-ffmpeg-is-the-latest>
* using the version in your Linux Repo may not work

***

## 16. <mark style="color:blue;">CDM Issues</mark>

[CDM issues](/ofsc/cdm-options/cdm-issues.md)

## 17. <mark style="color:blue;">Trouble login in</mark>

[Auth](/ofsc/getting-started/auth.md)

```
check formatting of auth file
```

Use `--auth-fail` to make a run quit on an auth error instead of prompting again.

[Advanced config options](/ofsc/getting-started/config-options/options/advanced-config-options.md)

```
change dynamic mode default
```

18. <mark style="color:blue;">Support For Network Drives</mark>

```
Network Drives are have limited support for storing Media, but are not supported
at all for config files are db. 

Those should be stored on a local drive
```

## 19. <mark style="color:blue;">"Double check auth info"</mark>

* Copy every value (`sess`, `auth_id`, `x-bc`, `user_agent`) again from the same browser while you're logged in to OnlyFans. They expire when you log out.
* `user_agent` must match that browser exactly.
* Make sure you're on the latest version of this fork.

***

## 20. <mark style="color:blue;">"No accounts found during scan"</mark>

Usually an auth problem, so check the answer above first. Then check you have an active subscription to the model, and that you aren't filtering it out with options like `--expired-subscription`.

***

## 21. <mark style="color:blue;">Files download fine but are counted as "failed"</mark>

Fixed in 3.15.0. This mostly happened when saving to a mapped or network drive. Update to the latest version.

***

## 22. <mark style="color:blue;">Some messages or new posts are missing</mark>

A bug that skipped messages when using `--after` is fixed in 3.15.0. Update, then run again. To rescan a date range, add `--after YYYY-MM-DD`. Add `--force-all` as well if you want files you already have downloaded again.

***

## 23. <mark style="color:blue;">ffmpeg isn't found even though it's installed</mark>

Put the full path to the ffmpeg program in `binary_options` → `ffmpeg` in your config, for example `C:\ffmpeg\bin\ffmpeg.exe`. An empty setting means "not set".

***

## 24. <mark style="color:blue;">It says to update to 3.14.7</mark>

That's upstream's PyPI version, which is older than this fork. Version 3.15.0 and later no longer show that message. From 3.16.2 the update check looks up the fork's own package, `ofscraper-community`, so it tells you about the fork's releases.

***

## 25. <mark style="color:blue;">Two files saved with the same name overwrote each other</mark>

Newer versions save the second one as `name_<media_id>` instead. To recover files lost to this in older versions, see Recover Filename Collisions.

[Recover Filename Collisions](/ofsc/using-the-scraper/recipes/recover-filename-collisions.md)

***

## 26. <mark style="color:blue;">Fansly login or download problems</mark>

See the Fansly page for how to get the token and user agent.

[Fansly](/ofsc/fansly.md)

***

## 27. <mark style="color:blue;">Downloads fail with 403 after a reconnect or VPN switch</mark>

OnlyFans download links are signed for the IP that fetched them. From 3.16.11, a link rejected with a 403 is fetched again and the download resumes from its `.part` file; 3.16.12 extends this to stories, highlights and DRM video. Update if every remaining download fails after your IP changes.

***

## 28. <mark style="color:blue;">Files skipped by the size limits or skip script come back</mark>

That's intended from 3.16.6: a skip is for this run only, so the file is tried again next run. To skip a file for good, have the skip download script print `skip-permanent`.

[Script Options](/ofsc/getting-started/config-options/options/script-options.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cloakedkeys.gitbook.io/ofsc/faq.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.