Customizing Download Filenames

You can control how Social Saver names your downloaded files. Instead of just using the video title, you can create your own pattern.

Turning On Custom Filenames

1. Open Social Saver and click Settings (⚙️ icon).
2. Go to the Filenames tab.
3. Find the switch labeled "Use Custom Filename Template" and turn it ON.

How to Build Your Template

In the "Filename Template" box, type the structure you want. You can use normal text (like `-` or `[]`) and special variables that look like ${variable_name}. Social Saver will replace these variables with the actual information from the media file.

Example: If you type ${uploader} - ${title}.${ext}, a downloaded file might be named Awesome Channel - Cool Video.mp4.

Available Variables

You can use these placeholders in your template:

${title}

The video or song title.

${id}

The unique ID (like from YouTube).

${uploader}

The channel or artist name.

${channel}

Usually the YouTube channel name.

${upload_date}

When it was uploaded (e.g., `2023-10-27`). Format can be changed in settings.

${timestamp}

The exact time of download (as a number).

${duration}

Length in seconds.

${view_count}

Number of views (if known).

${like_count}

Number of likes (if known).

${resolution}

Video size (e.g., `1080p`) or audio quality (e.g., `192k`).

${ext}

File extension (e.g., `mp4`, `mp3`).

${format_id}

Internal ID of the format you chose.

${quality}

Quality setting used (e.g., `high`).

${type}

Download type (`video`, `audio`, `combined`).

${artist}

Music artist name.

${album}

Music album name.

${track}

Music track name or number.

Note: Not every website provides all this information.

Other Filename Options

• Sanitize Filenames: (Recommended: ON) Removes characters like `/ \ : * ? " ≶ > |` which aren't allowed in filenames. Replaces them with `_`.
• Handle Duplicate Filenames: (Recommended: ON) If `My Video.mp4` already exists, the next download with the same name will automatically be saved as `My Video (1).mp4` instead of failing.
• Max Filename Length: Limits how long the filename can be (before the `.mp4` part). `0` means no limit (your operating system still has one, usually 255 characters).
• Date Format: Choose how the `$upload_date` looks (e.g., `YYYY-MM-DD`).

Preview Your Template

Check the "Filename Preview" box at the bottom of the Filenames tab. It shows an example filename using your current settings.

More Template Examples

• Simple Title: ${title}.${ext}
  Result: Cool Video Title.mp4
• Uploader First: ${uploader} - ${title} [${resolution}].${ext}
  Result: Example Channel - Cool Video Title [1080p].mp4
• Organize Music by Artist/Album: ${artist}/${album}/${track}. ${title}.${ext}
  Result: Creates folders like Band Name/Album Name/01. Song Name.mp3

Remember to click "Save Settings" after you set up your template!