[Share] Add Random Tag to Selected Items

[bloomingseed]

Description

This script adds a randomized tag to all currently selected items in Zotero for purposes such as tracking, batch processing, or temporary marking.

• Supports two random tag styles:
  • Hex code (e.g., 📝7F) default
  • Timestamp (e.g., 📝2025-07-25T14:30)
• Optional emoji prefix (default: 📝) for visual cue.
• Easy to customize tag format.
• Works in all views:
  • Standard collections
  • Saved searches
  • Trash bin
  • Group libraries

Event

None

Operation

Script

Data

/**
 * Add Random Tag to Selected Items Script for Zotero
 * @author Zotero Community
 * @usage Add a random tag to all currently selected Zotero items. Easy manual customizable with emoji prefix and tag style.
 * @link https://github.com/windingwind/zotero-actions-tags/discussions/509
 * @see https://github.com/windingwind/zotero-actions-tags/discussions/509
 */
if(item) return; 	// Only execute the script once

// === Config ===
const emoji = "📝"; // Emoji prefix
const useEmoji = true; // Set false if you want no emoji
const randomTextStyle = 'hex'; // Options: 'hex' or 'timestamp'

// === Utilities ===
function getTimestampTag() {
  const now = new Date();
  const year = now.getFullYear();
  const month = String(now.getMonth() + 1).padStart(2, '0');
  const day = String(now.getDate()).padStart(2, '0');
  const hours = String(now.getHours()).padStart(2, '0');
  const minutes = String(now.getMinutes()).padStart(2, '0');
  return `${year}-${month}-${day}T${hours}:${minutes}`;
}

function getRandomHexTag() {
  const buffer = new Uint8Array(1);
  crypto.getRandomValues(buffer);
  return Array.from(buffer)
    .map(byte => byte.toString(16).padStart(2, '0'))
    .join('')
    .toUpperCase();
}

function generateTag() {
  const base = (randomTextStyle === 'timestamp') ? getTimestampTag() : getRandomHexTag();
  return useEmoji ? `${emoji}${base}` : base;
}

// === Main ===
const tag = generateTag();

for (const item of items) {
  item.addTag(tag);
  item.saveTx(); // Save changes
}

Anything else

No response