wp_gallery_upload.py<\/strong> \u2014 the main upload script<\/h2>\n\n\n\n#!\/usr\/bin\/env python3\n\"\"\"\nWordPress Gallery Uploader\n==========================\nUploads a folder of JPEG images to WordPress via the REST API\nand creates a draft blog post with a Gutenberg gallery block.\n\nSetup:\n 1. In WordPress admin, go to Users ? Profile ? scroll to the bottom\n 2. Under \"Application Passwords\", type a name (e.g. \"Lightroom Upload\")\n and click \"Add New Application Password\"\n 3. Copy the password shown (with spaces is fine \u2014 paste it as-is below)\n 4. Fill in your details in the CONFIGURATION section below\n\nUsage:\n python3 wp_gallery_upload.py \/path\/to\/your\/exported\/images\n python3 wp_gallery_upload.py \/path\/to\/images --title \"My Gallery Post\"\n\nRequirements:\n pip3 install requests Pillow\n\"\"\"\n\nimport argparse\nimport sys\n\nimport json\nimport os\nimport sys\nimport time\nfrom pathlib import Path\n\n# ?????????????????????????????????????????????\n# CONFIGURATION \u2014 fill these in before running\n# ?????????????????????????????????????????????\n\nWP_URL = \"https:\/\/your-site.com\" # Your WordPress site URL (no trailing slash)\nWP_USERNAME = \"your_username\" # Your WordPress username\nWP_APP_PASS = \"xxxx xxxx xxxx xxxx xxxx xxxx\" # Application Password from WordPress profile\n\n# ?????????????????????????????????????????????\n# OPTIONS \u2014 adjust if needed\n# ?????????????????????????????????????????????\n\nPOST_STATUS = \"draft\" # \"draft\" or \"publish\"\nIMAGE_QUALITY = 85 # JPEG quality for re-save check (0\u2013100)\nSUPPORTED_EXTS = {\".jpg\", \".jpeg\", \".JPG\", \".JPEG\"}\nPAUSE_BETWEEN = 0.5 # Seconds to pause between uploads (be kind to your server)\n\n# ?????????????????????????????????????????????\n\n\ndef get_session(username: str, app_password: str):\n \"\"\"Return a requests Session with Basic Auth configured.\"\"\"\n import requests\n from requests.auth import HTTPBasicAuth\n session = requests.Session()\n session.auth = HTTPBasicAuth(username, app_password.replace(\" \", \"\"))\n session.headers.update({\"User-Agent\": \"WP-Gallery-Uploader\/1.0\"})\n return session\n\n\ndef check_connection(session, wp_url: str) -> bool:\n \"\"\"Verify we can reach the WordPress REST API and authenticate.\"\"\"\n import requests\n url = f\"{wp_url}\/wp-json\/wp\/v2\/users\/me\"\n try:\n r = session.get(url, timeout=15)\n if r.status_code == 200:\n name = r.json().get(\"name\", \"Unknown\")\n print(f\"? Connected to WordPress as: {name}\", flush=True)\n return True\n elif r.status_code == 401:\n print(\"? Authentication failed. Check your username and Application Password.\", flush=True)\n else:\n print(f\"? Unexpected response ({r.status_code}). Check your WP_URL.\", flush=True)\n return False\n except requests.exceptions.ConnectionError:\n print(f\"? Could not connect to {wp_url}. Check the URL and your internet connection.\", flush=True)\n return False\n\n\ndef get_image_files(folder: Path) -> list[Path]:\n \"\"\"Return sorted list of JPEG files in the folder.\"\"\"\n files = sorted([\n f for f in folder.iterdir()\n if f.is_file() and f.suffix in SUPPORTED_EXTS\n ])\n return files\n\n\ndef upload_image(session, wp_url: str, image_path: Path) -> dict | None:\n \"\"\"Upload a single image to the WordPress Media Library.\"\"\"\n import requests\n\n url = f\"{wp_url}\/wp-json\/wp\/v2\/media\"\n filename = image_path.name\n\n with open(image_path, \"rb\") as f:\n image_data = f.read()\n\n headers = {\n \"Content-Disposition\": f'attachment; filename=\"{filename}\"',\n \"Content-Type\": \"image\/jpeg\",\n }\n\n try:\n r = session.post(url, headers=headers, data=image_data, timeout=60)\n if r.status_code == 201:\n media = r.json()\n print(f\" ? Uploaded: {filename} (ID: {media['id']})\", flush=True)\n return media\n else:\n print(f\" ? Failed to upload {filename}: {r.status_code} \u2014 {r.text[:200]}\", flush=True)\n return None\n except requests.exceptions.Timeout:\n print(f\" ? Timeout uploading {filename}. Try a smaller image or check your server.\", flush=True)\n return None\n\n\ndef build_gallery_block(media_items: list[dict]) -> str:\n \"\"\"Build a Gutenberg gallery block from a list of uploaded media items.\"\"\"\n\n # Build individual image blocks inside the gallery\n image_blocks = []\n for media in media_items:\n media_id = media[\"id\"]\n media_url = media[\"source_url\"]\n media_link = media.get(\"link\", \"\")\n alt_text = media.get(\"alt_text\", \"\")\n caption = media.get(\"caption\", {}).get(\"raw\", \"\")\n\n img_block = (\n f'<!-- wp:image {{\"id\":{media_id},'\n f'\"sizeSlug\":\"large\",\"linkDestination\":\"media\"}} -->\\n'\n f'<figure class=\"wp-block-image size-large\">'\n f'<a href=\"{media_url}\">'\n f'<img src=\"{media_url}\" alt=\"{alt_text}\" class=\"wp-image-{media_id}\"\/>'\n f'<\/a>'\n f'{\"<figcaption class=\\'wp-element-caption\\'>\" + caption + \"<\/figcaption>\" if caption else \"\"}'\n f'<\/figure>\\n'\n f'<!-- \/wp:image -->'\n )\n image_blocks.append(img_block)\n\n ids_list = \",\".join(str(m[\"id\"]) for m in media_items)\n images_joined = \"\\n\".join(image_blocks)\n\n gallery_block = (\n f'<!-- wp:gallery {{\"ids\":[{ids_list}],'\n f'\"columns\":3,\"imageCrop\":false,'\n f'\"linkTo\":\"media\",\"sizeSlug\":\"large\"}} -->\\n'\n f'<figure class=\"wp-block-gallery has-nested-images '\n f'columns-3 is-cropped\">\\n'\n f'{images_joined}\\n'\n f'<\/figure>\\n'\n f'<!-- \/wp:gallery -->'\n )\n\n return gallery_block\n\n\ndef create_draft_post(session, wp_url: str, title: str,\n gallery_block: str, status: str) -> dict | None:\n \"\"\"Create a WordPress post containing the gallery block.\"\"\"\n import requests\n\n url = f\"{wp_url}\/wp-json\/wp\/v2\/posts\"\n\n # Add a placeholder paragraph before the gallery for your text\n content = (\n f'<!-- wp:paragraph -->\\n'\n f'<p>Add your post text here...<\/p>\\n'\n f'<!-- \/wp:paragraph -->\\n\\n'\n f'{gallery_block}'\n )\n\n payload = {\n \"title\": title,\n \"content\": content,\n \"status\": status,\n }\n\n try:\n r = session.post(url, json=payload, timeout=30)\n if r.status_code == 201:\n return r.json()\n else:\n print(f\"? Failed to create post: {r.status_code} \u2014 {r.text[:300]}\", flush=True)\n return None\n except requests.exceptions.Timeout:\n print(\"? Timeout creating post.\", flush=True)\n return None\n\n\ndef main():\n parser = argparse.ArgumentParser(\n description=\"Upload a folder of images to WordPress and create a gallery post.\"\n )\n parser.add_argument(\n \"folder\",\n help=\"Path to the folder containing your exported JPEG images\"\n )\n parser.add_argument(\n \"--title\",\n default=\"\",\n help='Title for the new blog post (default: folder name)'\n )\n args = parser.parse_args()\n\n # ?? Validate folder ??????????????????????????????????????????????\n folder = Path(args.folder).expanduser().resolve()\n if not folder.exists() or not folder.is_dir():\n print(f\"? Folder not found: {folder}\", flush=True)\n sys.exit(1)\n\n post_title = args.title or folder.name\n\n # ?? Check config ?????????????????????????????????????????????????\n if \"your-site.com\" in WP_URL or \"your_username\" in WP_USERNAME:\n print(\"? Please edit the CONFIGURATION section at the top of this script\", flush=True)\n print(\" and fill in your WP_URL, WP_USERNAME, and WP_APP_PASS.\", flush=True)\n sys.exit(1)\n\n # ?? Check requests is installed ??????????????????????????????????\n try:\n import requests # noqa: F401\n except ImportError:\n print(\"? The 'requests' library is not installed.\", flush=True)\n print(\" Run: pip3 install requests\", flush=True)\n sys.exit(1)\n\n # ?? Find images ??????????????????????????????????????????????????\n images = get_image_files(folder)\n if not images:\n print(f\"? No JPEG files found in: {folder}\", flush=True)\n sys.exit(1)\n\n print(f\"\\n{'?'*50}\", flush=True)\n print(f\" WordPress Gallery Uploader\", flush=True)\n print(f\"{'?'*50}\", flush=True)\n print(f\" Folder : {folder}\", flush=True)\n print(f\" Images : {len(images)} found\", flush=True)\n print(f' Post : \"{post_title}\" ({POST_STATUS}, flush=True)')\n print(f\" Site : {WP_URL}\", flush=True)\n print(f\"{'?'*50}\\n\", flush=True)\n\n # ?? Connect ??????????????????????????????????????????????????????\n session = get_session(WP_USERNAME, WP_APP_PASS)\n if not check_connection(session, WP_URL):\n sys.exit(1)\n\n # ?? Upload images ????????????????????????????????????????????????\n print(f\"\\nUploading {len(images, flush=True)} image(s)...\\n\")\n uploaded_media = []\n\n for i, image_path in enumerate(images, 1):\n print(f\" [{i}\/{len(images, flush=True)}] {image_path.name}\")\n media = upload_image(session, WP_URL, image_path)\n if media:\n uploaded_media.append(media)\n if i < len(images):\n time.sleep(PAUSE_BETWEEN)\n\n if not uploaded_media:\n print(\"\\n? No images were uploaded successfully. Aborting post creation.\", flush=True)\n sys.exit(1)\n\n print(f\"\\n? {len(uploaded_media, flush=True)}\/{len(images)} images uploaded successfully.\\n\")\n\n # ?? Build gallery and create post ????????????????????????????????\n print(\"Creating gallery post...\", flush=True)\n gallery_block = build_gallery_block(uploaded_media)\n post = create_draft_post(session, WP_URL, post_title, gallery_block, POST_STATUS)\n\n if post:\n post_id = post[\"id\"]\n edit_link = f\"{WP_URL}\/wp-admin\/post.php?post={post_id}&action=edit\"\n print(f\"\\n{'?'*50}\", flush=True)\n print(f\" ? Post created successfully!\", flush=True)\n print(f\" Title : {post['title']['rendered']}\", flush=True)\n print(f\" Status : {post['status']}\", flush=True)\n print(f\" Edit : {edit_link}\", flush=True)\n print(f\"{'?'*50}\\n\", flush=True)\n print(\"Next steps:\", flush=True)\n print(\" 1. Open the edit link above in your browser\", flush=True)\n print(\" 2. Replace the placeholder paragraph with your post text\", flush=True)\n print(\" 3. Click Publish when you're ready\\n\", flush=True)\n else:\n print(\"\\n? Post creation failed. Your images were uploaded to the Media Library.\", flush=True)\n print(f\" You can create a post manually using them in WordPress admin.\\n\", flush=True)\n\n\nif __name__ == \"__main__\":\n main()\n<\/pre>\n\n\n\nwpgallery.sh<\/strong> \u2014 the optional Raycast Script Command wrapper<\/em><\/p>\n\n\n\n#!\/bin\/bash\n\n# Required parameters:\n# @raycast.schemaVersion 1\n# @raycast.title WordPress Gallery Upload\n# @raycast.mode fullOutput\n\n# Optional parameters:\n# @raycast.icon ?\n# @raycast.packageName WordPress Tools\n# @raycast.description Upload a folder of images to WordPress and create a draft gallery post\n\n# Arguments:\n# @raycast.argument1 { \"type\": \"text\", \"placeholder\": \"Subfolder name (e.g. Tamron300samples)\" }\n# @raycast.argument2 { \"type\": \"text\", \"placeholder\": \"Post title (optional \u2014 uses folder name if blank)\", \"optional\": true }\n\n# ?? SET YOUR BASE FOLDER HERE ??????????????????????????????????????\nBASE_FOLDER=\"$HOME\/Pictures\"\n# ??????????????????????????????????????????????????????????????????\n\nSUBFOLDER=\"$1\"\nTITLE=\"$2\"\n\n# If the argument looks like a full path (starts with \/ or ~), use it directly.\n# Otherwise treat it as a subfolder name inside BASE_FOLDER.\n# This means you can type just \"Tamron300samples\" for ~\/Pictures\/the617\/Tamron300samples\n# or override with a full path like ~\/Pictures\/other-folder if needed.\nif [[ \"$SUBFOLDER\" == \/* ]] || [[ \"$SUBFOLDER\" == ~* ]]; then\n FOLDER=\"${SUBFOLDER\/#\\~\/$HOME}\"\nelse\n FOLDER=\"$BASE_FOLDER\/$SUBFOLDER\"\nfi\n\n# Activate the virtual environment\nsource ~\/wp-uploader-env\/bin\/activate\n\n# Run the Python script, passing title only if one was provided\nif [ -n \"$TITLE\" ]; then\n python3 -u ~\/Documents\/coding\/wordpress\/wp_gallery_upload.py \"$FOLDER\" --title \"$TITLE\"\nelse\n python3 -u ~\/Documents\/coding\/wordpress\/wp_gallery_upload.py \"$FOLDER\"\nfi\n<\/pre>\n","protected":false},"excerpt":{"rendered":"If you use Adobe Lightroom Classic and run a self-hosted WordPress site, you’ve probably looked at the various plugins that promise to wire the two together \u2014 only to find they all want a recurring subscription fee. For a personal blog where you just want to post the occasional gallery,<\/p>\n","protected":false},"author":2,"featured_media":14213,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11,4],"tags":[],"class_list":["post-14209","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-lightroom-software","category-software","comments-off"],"_links":{"self":[{"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/posts\/14209","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/comments?post=14209"}],"version-history":[{"count":6,"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/posts\/14209\/revisions"}],"predecessor-version":[{"id":14218,"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/posts\/14209\/revisions\/14218"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/media\/14213"}],"wp:attachment":[{"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/media?parent=14209"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/categories?post=14209"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.rjt.org.uk\/home\/wp-json\/wp\/v2\/tags?post=14209"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"\"](\"https:\/\/www.rjt.org.uk\/home\/wp-content\/uploads\/2026\/04\/image.png\")
<\/a><\/figure>\n\n\n\n