Placeholders

If you want to recheck files --metadata-update after updating the config

Windows path warning

\ should be escaped or replaced with a \\ or /

Not doing this could lead to an error

Examples:

C:\Users\John.config\ofscraper\bin\ffmpeg.exe => 

C:\Users\John.config\ofscraper\bin\ffmpeg.exe => 
C:/Users/John.config/ofscraper/bin/ffmpeg.exe

Example of generated filenames

The placeholders described below will substitute the {} values

Example Configs

"file_options": {
            "save_location": "/home/james/Data/ofscraper",
            "dir_format": "/{model_username}/{responsetype}/{mediatype}/",
            "file_format": "{filename}.{ext}",
            "textlength": 0,
            "space-replacer": " ",
            "date": "MM-DD-YYYY",
            "text_type_default": "letter",
            "truncation_default": true
        },

The generated filename based on the example config would be

/home/James/Data/ofscraper/{model_username}/{responsetype}/
{mediatype}/{filename}.{ext}

---

Placeholders are generally the same between options here

dir_path and filename

You may use placeholders without any underscores (_)

{response_type}=Posts,Messages,Paid,etc
{post_id}= ID of post
{media_id} =ID of media

{file_name} = the filename, videos wills include the quality i.e source,720
{only_file_name}= the filename,videos will not include quality
{original_filename}= filename as sent by onlyfans, may or may not include source

{media_type}=Images,Audios,Videos
{quality} = quality of the media, none videos will always be source

{value}=The content's value: Whether it's categorized as Paid or Free.

{model_id}= Unique identification number for model

{first_letter}= first letter of model's username

{site_name} = Onlyfans
{text} = The text within the media. Truncation of file names has been tested to fit within OS limits, 
still it's advisable to establish a text length limit.
{date}= The date of the post, outputed in the config date format

{model_username} = The model's username
{username} = The model's username
{profile} = The currently active profile
{my_username}=The authorized account's username
{my_id} = The identification number 
for the  authorized account
{label} = The label assigned to the post, if available
{download_type}= Indication of whether it's protected or normal, 
determined by the necessity for decryption

{current_price}= Free if current price is 0 dollars else paid
{regular_price}=Free if regular price is 0 dollars else paid
{promo_price}= Free if promo price is 0 dollars else paid
{renewal_price}= Free if renewal price is 0 dollars else paid
{args}= the passed arguments namespace, keys can be access 
with the dot (.) syntax
{config}= the config arguments dictionary, keys can be access 
with the [] syntax
{modelObj} = model data class via class folder, properties can be access 
via the dot (.) syntax
{configPath} = path to current config directory

dir_path

The relative directory path within the save location where files are stored

No unique placeholders

filename

The file's name segment in the saved file

When configuring filenames, ensure a unique element such as text, media ID, post ID, or filename is added to avoid naming conflict

{ext} = The file extension of the media

---

Text Placeholders

Text mediatype will most likely need a overwrite to work properly

Text files are based on posts and have access to all the same placeholders as other media except

- media_id 
- download type

Some placeholders will be changed

- filename is replace with text
- quality will always be Source
- media_type will always be "Text"

Downloading Text Files

Mediatype overwrites

---

metadata

Controls where metadata is save

Setting metadata path

---

response_type placeholder

Responsetype Placeholders