WP Media Sync logo WordPress plugin + desktop companion app

WP Media Sync

Manage your WordPress Media Library from your desktop. WP Media Sync connects a local folder to WordPress so media files, replacements, trash, and metadata can be handled from one focused workspace.

Also available for Windows, Linux AppImage, Linux DEB, Linux RPM .

0.1.0
MVP Version
Local
Sync Engine
Tauri
Desktop App
WP Media Sync
studio.example.com
Synced
Local Sync Folder
~/Sites/media-sync/uploads
hero-product.jpg
Synced
lookbook-cover.png
Local only
team-photo.webp
Remote only
logo-mark.svg
Changed

Built for Real Media Workflows

The first version focuses on the core loop: connect WordPress, mirror media locally, review changes, and safely push or pull updates.

Local Folder Sync

Create or connect a local folder and mirror WordPress media into a desktop workflow your team already understands.

Upload Local Additions

Drop new files into the sync folder, review them in the companion app, then upload them as proper WordPress attachments.

Safe Media Replacement

Replace an existing attachment while preserving the WordPress attachment ID, metadata, and URL whenever possible.

Metadata Editing

Update alt text, captions, and descriptions from the desktop app without opening the WordPress media modal.

Trash and Restore

Review trashed attachments, restore them, or permanently delete them with explicit confirmation flows.

Activity History

Track uploads, downloads, replacements, metadata edits, and sync decisions from a dedicated activity view.

How It Works

WP Media Sync keeps the WordPress plugin thin and puts the sync engine in the desktop app. That keeps the base workflow local-first, direct, and usable without a required cloud account.

1

Install the WordPress connector

Activate the lightweight WP Media Sync plugin so the desktop app can list, upload, replace, delete, and update media through REST endpoints.

2

Connect the desktop app

Use your site URL, WordPress username, and an Application Password. Credentials are stored through the operating system credential store.

3

Choose a local sync folder

The companion app creates the sync workspace, stores state locally, and compares local files with WordPress media records.

4

Review and sync changes

Push local files to WordPress, pull remote media down, replace files safely, edit metadata, and handle deleted media with clear prompts.

Local-First by Design

The companion app stores sync state in local SQLite, uses the OS credential store for WordPress Application Passwords, and talks directly to the site through the plugin REST API.

Thin WordPress Plugin

Exposes a focused REST API and lets WordPress handle authentication, uploads, attachment records, and media metadata.

Desktop Companion

Runs the sync interface, local scans, drag-and-drop imports, replacement dialogs, and site-specific sync settings.

Local Sync State

Uses SQLite to track file hashes, statuses, activity, trash state, and the relationship between local files and attachments.