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

# Custom Filename Formats

In the config.json file you can now specify some custom filename formats that will be used when downloading files. I have had to add 4 new fields to the auth.json file, these are:

* PaidPostFileNameFormat
* PostFileNameFormat
* PaidMessageFileNameFormat
* MessageFileNameFormat

I have had to do it this way as the names of fields from the API responses are different in some places so it would become a mess using 1 file format for everything, besides having separate formats can be useful if you only want posts to have a custom format and the rest just use the default filename.

Below are the names of the fields you can use in each format:

## PaidPostFileNameFormat

`id` - Id of the post

`postedAt` - The date when the post was made yyyy-mm-dd

`mediaId` - Id of the media

`mediaCreatedAt` - The date when the media was uploaded to OF yyyy-mm-dd

`filename` - The original filename e.g 0gy8cmw5jjjs5pt487b9g\_source.mp4 or 914x1706\_6b211f68a4e315125ecf70137bb75d8e.jpg

`username` - The username of the creator e.g onlyfans

`text` - The text of the post

## PostFileNameFormat

`id` - Id of the post

`postedAt` - The date when the post was made yyyy-mm-dd

`mediaId` - Id of the media

`mediaCreatedAt` - The date when the media was uploaded to OF yyyy-mm-dd

`filename` - The original filename e.g 0gy8cmw5jjjs5pt487b9g\_source.mp4 or 914x1706\_6b211f68a4e315125ecf70137bb75d8e.jpg

`username` - The username of the creator e.g onlyfans

`text` - The text of the post

`rawText` - The text of the post

## PaidMessageFileNameFormat

`id` - Id of the message

`createdAt` - The date when the message was sent yyyy-mm-dd

`mediaId` - Id of the media

`mediaCreatedAt` - The date when the media was uploaded to OF yyyy-mm-dd

`filename` - The original filename e.g 0gy8cmw5jjjs5pt487b9g\_source.mp4 or 914x1706\_6b211f68a4e315125ecf70137bb75d8e.jpg

`username` - The username of the creator e.g onlyfans

`text` - The text of the message

## MessageFileNameFormat

`id` - Id of the message

`createdAt` - The date when the message was sent yyyy-mm-dd

`mediaId` - Id of the media

`mediaCreatedAt` - The date when the media was uploaded to OF yyyy-mm-dd

`filename` - The original filename e.g 0gy8cmw5jjjs5pt487b9g\_source.mp4 or 914x1706\_6b211f68a4e315125ecf70137bb75d8e.jpg

`username` - The username of the creator e.g onlyfans

`text` - The text of the message

## Examples

`"PaidPostFileNameFormat": "{id}_{mediaid}_{filename}"`

`"PostFileNameFormat": "{username}_{id}_{mediaid}_{mediaCreatedAt}"`

`"PaidMessageFileNameFormat": "{id}_{mediaid}_{createdAt}"`

`"MessageFileNameFormat": "{id}_{mediaid}_{filename}"`