TikTok Bulk Video Caption Updater

WHAT IT DOES

This social media management tool revolutionizes TikTok video captioning by enabling bulk caption updates across multiple videos simultaneously. It scans your current TikTok creator video management page, extracting all visible videos including their titles, IDs, post dates, and current captions. You can then filter videos by title or caption text, select individual videos or use the select-all-filtered feature, and apply bulk caption updates with three operation modes: replace (overwrite existing caption), append (add new text to the end), or prepend (add new text to the beginning). The script supports hashtags and @mentions in captions and provides a template system for commonly used caption formats. The script handles the entire workflow automatically, opening each video's edit modal and applying caption updates through TikTok's own UI controls with proper event propagation.

WHERE IT RUNS

This script operates on TikTok creator video management pages at *://*.tiktok.com/creator/, *://*.tiktok.com/@/video/, and *://*.tiktok.com/upload. It integrates as a floating panel on the left side of your browser window when you navigate to your TikTok creator dashboard. The tool works with TikTok's dynamic React-based interface, detecting videos regardless of how they're rendered on the page and adapting to TikTok's frequent UI changes. The panel automatically detects your creator ID from the page context for per-creator settings persistence, including caption templates and hashtag sets.

HOW TO USE

Navigate to your TikTok creator video management page (any of the supported URLs).

The panel appears automatically on the left side of the screen.

Click "Refresh" to load all visible videos from the current page.

Use the filter input to search videos by title.

Use the caption filter to show only videos containing specific caption text.

Check the boxes next to videos you want to modify, or use "Select All Filtered".

Enter your new caption text in the caption input field.

Alternatively, select a template from the "Template" dropdown and click "Load".

Choose the operation mode: "Replace" (overwrites), "Append" (adds to end), or "Prepend" (adds to beginning).

Click "Apply Caption to Selected" to begin the batch update process.

The status bar shows progress and any errors encountered during processing.

REACT EVENT PROPAGATION MECHANISM

The tool succeeds where browser extensions fail because it operates directly within TikTok's own JavaScript context, bypassing cross-origin restrictions that prevent external extensions from accessing TikTok's internal React state. It uses React event propagation by dispatching both "input" and "change" events with proper bubbling flags (bubbles: true), ensuring TikTok's virtual DOM reconciles the caption changes correctly and persists the updates. The script implements a concurrency cap of 4 simultaneous operations with 300ms spacing between each, preventing TikTok's rate limiting from blocking requests while maintaining efficient throughput. The tool intelligently detects caption input fields by scanning for textarea elements with name attributes, placeholder text containing "caption", and data-testid attributes. The template system uses a per-creator history stored locally, automatically saving each caption you apply for quick reuse in future sessions.

THE PANEL

The floating panel is draggable to any position on screen and remembers its location between sessions using GM_setValue. It automatically collapses to a small icon when minimized and expands on hover or click. The panel is resizable to suit your workspace needs and can be dismissed with the Escape key. It snaps to the left edge by default but can be positioned anywhere, with position persisted across browsing sessions for consistent placement. All settings persist automatically across sessions, including your caption templates, hashtag sets, and mode preferences.

PLEASE NOTE

This script requires the free BotGentz extension to run user scripts on TikTok. TikTok frequently updates its creator interface, which may temporarily break functionality; updates are released regularly to maintain compatibility. The script only reads visible video information from the page and does not store or transmit any data externally. All processing occurs locally in your browser. Captions are applied exactly as configured; verify your text before bulk application to avoid unintended content. TikTok has a maximum caption length of 2200 characters; the script does not enforce this limit, so ensure your final captions comply with TikTok's terms of service. The script remembers your recently used caption templates and hashtag sets, making bulk captioning across multiple sessions efficient and consistent.