FacePalm Pilot 1.0
Facebook Preview Generation Utility

Author: R. Seaverns (KØN×†ƷÐ)

---

## INTRODUCTION

FacePalm Pilot is a small desktop tool designed to help you
preview how a website link will appear when shared on Facebook.

When you post a link on Facebook, the platform reads special
metadata from the webpage called "OpenGraph tags". These tags
tell Facebook what title, description, and preview image to
display in the post.

Sometimes these previews appear incorrectly because:

• the website metadata is missing or incorrect
• Facebook cached an older version of the page
• the preview image was changed recently
• the webpage was updated but Facebook has not refreshed it

FacePalm Pilot lets you preview and inspect this information
before you share the link publicly.

This helps avoid broken or incorrect previews when posting
links to Facebook.

---

## BASIC WORKFLOW

The typical workflow is very simple.

1. Add the URLs you want to promote
2. Select a URL from the list
3. Review the preview information
4. Write your Facebook post text
5. Launch the Facebook share window

---

## ADDING A URL

To add a new website link:

1. Click "Add URL"
2. Enter a short name for the link
3. Enter the full URL (including http:// or https://)

Example:

Name:
My Project Page

URL:
https://example.com/my-project

After saving, the new entry will appear in the list of links.

FacePalm Pilot automatically keeps links sorted
alphabetically by their name.

This means:

Apple Site
Blog Post
My Project
Test Page

will always appear in correct alphabetical order.

---

## REMOVING A URL

To remove an entry:

1. Select the link in the list
2. Click "Remove Selected"
3. Confirm the removal

The link will immediately disappear from the list
and the configuration file will be updated.

---

## PREVIEWING A LINK

To generate a preview:

1. Click on a link in the list
2. FacePalm Pilot will scrape the webpage
3. The preview will appear on the right side

The preview includes:

• Page Title
• Description text
• Preview Image
• Canonical URL

This preview simulates how Facebook will build
the link card inside a post.

---

## WHAT TO LOOK FOR IN THE RESULTS

When checking a preview, verify the following:

1. The title is correct
   The title should clearly represent the page.

2. The description is readable
   Descriptions that are too long or poorly written
   may appear truncated in Facebook posts.

3. The preview image loads properly
   Facebook posts rely heavily on the preview image.
   A missing or incorrect image can reduce engagement.

4. The URL is correct
   Confirm the correct page is being referenced.

If any of these items look wrong, the problem is usually
in the website's metadata rather than the FacePalm Pilot tool.

---

## WHEN TO USE "REFRESH METADATA"

Use the Refresh option when:

• you recently edited your webpage
• you changed the OpenGraph image
• you updated the title or description
• you saved a page in a website editor
• you cleared website caching

Refreshing will re-scrape the webpage and rebuild
the preview with the newest data.

---

## FACEBOOK CACHING NOTE

Facebook often caches preview data.

If you recently updated a page and the preview
still looks wrong, the issue may be Facebook's cache.

FacePalm Pilot shows what the page currently
provides as metadata, which helps identify
whether the problem is with the page itself
or with Facebook's cached version.

---

## WRITING YOUR FACEBOOK POST

Above the preview area is a text box where you can
write the message that will accompany your link.

Example:

"Just released a new utility for testing Facebook
link previews before posting. Check it out!"

When ready, click:

Share to Facebook

This opens the official Facebook share window
with your link and message.

---

## KEYBOARD SHORTCUTS

CTRL + Enter
Open the Facebook share dialog

CTRL + R
Refresh metadata

ESC
Clear focus

---

## FINAL NOTES

FacePalm Pilot does not automate Facebook posting
and does not connect to Facebook accounts directly.

It simply prepares and previews link metadata
before you share it using Facebook's official
share interface.

This makes it a useful validation tool for:

• marketers
• website administrators
• developers
• SEO professionals
• content creators

---

## END OF FILE

