To get filenames or other metadata as a text file

[HalBenHB]

This toolkit has been very useful to me so I would like to start by thanking you. I was wondering if it is possible to get a “summary” of my files in Google Photos as .txt or .json using this toolkit. I mean something like a list of filenames in the simplest form. If possible, it would be much better if it has details like file size, date or which albums it is in along with the filename. Then I will use it to compare with local files on my device for bulk processing. Google Photos Library API no longer allows to view the library. I couldn't find any other official alternative, I have a belief that the safest and fastest solution lies in this toolkit, but I couldn't figure out the API and what functions I should use.

[HalBenHB]

Ok, by the help of Gemini 2.5 Pro I figured it out. Following scripts, run by DevTools Console, will download a csv file with these columns:
Filename,Description,Date_Taken,Date_Uploaded,Size_Bytes,Takes_Up_Space,Space_Consumed_Bytes,Is_Original_Quality,Timezone_Offset,Media_Key

This first script is album-based. You can either use it by one album, multiple albums, and all albums. It will download a csv file per album.

/**
 * A universal script to retrieve comprehensive metadata for photos in Google Photos albums
 * and download the results as separate CSV files.
 *
 * It can operate in three modes: 'single', 'multiple', or 'all' albums.
 * This version uses only the core `gptkApi` for maximum reliability.
 */

// ---
// --- STEP 1: CONFIGURE THE SCRIPT MODE AND ALBUM NAMES HERE ---
// ---
const CONFIG = {
  /**
   * CHOOSE YOUR MODE:
   * 'single'   - For one specific album.
   * 'multiple' - For a custom list of specific albums.
   * 'all'      - For every album in your account.
   */
  mode: 'multiple', // <-- SET YOUR DESIRED MODE HERE

  // Provide the album name(s) based on the mode you chose:
  albumName: 'Your Album Name Here',      // Used only if mode is 'single'
  albumNames: ['Test', '1 Haziran Tekne Partisi', 'Çikolata Sergisi'], // Used only if mode is 'multiple'
};
// ---

const INFO_CHUNK_SIZE = 5000; // API limit for getBatchMediaInfo.

/**
 * The main function to orchestrate the entire export process based on the CONFIG.
 */
async function exportAlbumInfo() {
  if (!window.gptkApi) {
    console.error("Google-Photos-Toolkit core API (`gptkApi`) not found. Make sure the userscript is running.");
    return;
  }

  console.log(`Starting export process in '${CONFIG.mode}' mode.`);

  // --- Start of Core Logic ---
  try {
    // Fetch all albums once at the beginning
    console.log("Fetching a complete list of your albums...");
    const allAlbums = await fetchAllPages(gptkApi.getAlbums);
    if (!allAlbums || allAlbums.length === 0) {
      console.error("Could not fetch any albums. The process cannot continue.");
      return;
    }
    console.log(`Found a total of ${allAlbums.length} albums.`);

    let albumsToProcess = [];

    // Determine which albums to process based on the configured mode
    switch (CONFIG.mode) {
      case 'single':
        const singleAlbum = allAlbums.find(a => a.title === CONFIG.albumName);
        if (singleAlbum) {
          albumsToProcess.push(singleAlbum);
        } else {
          console.error(`The specified album was not found: "${CONFIG.albumName}"`);
        }
        break;

      case 'multiple':
        albumsToProcess = CONFIG.albumNames.map(name => {
          const foundAlbum = allAlbums.find(a => a.title === name);
          if (!foundAlbum) {
            console.warn(`Warning: Album "${name}" was not found and will be skipped.`);
          }
          return foundAlbum;
        }).filter(Boolean); // Filter out any not found (null) entries
        break;

      case 'all':
        console.warn("You have chosen to process ALL albums. This may trigger multiple file downloads. If prompted by your browser, please allow them.");
        albumsToProcess = allAlbums;
        break;

      default:
        console.error(`Invalid mode specified in CONFIG: '${CONFIG.mode}'. Please use 'single', 'multiple', or 'all'.`);
        return;
    }

    // Process the selected albums
    if (albumsToProcess.length > 0) {
      console.log(`Ready to process ${albumsToProcess.length} album(s).`);
      for (const album of albumsToProcess) {
        // Using 'await' ensures albums are processed one by one, making logs clearer
        // and preventing the browser from being overwhelmed.
        await processSingleAlbum(album);
      }
    } else {
      console.log("No albums matched the criteria. Nothing to process.");
    }

    console.log("--- All tasks complete! ---");

  } catch (error) {
    console.error("A critical error occurred during the main process:", error);
  }
}


// --- HELPER FUNCTIONS (No need to edit below this line) ---

/**
 * Fetches data for one album, formats it, and triggers the CSV download.
 * @param {object} album - The album object from the gptkApi.
 */
async function processSingleAlbum(album) {
  console.log(`--- Processing album: "${album.title}" ---`);
  try {
    // Get all media items from the album.
    const mediaItems = await fetchAllPages(gptkApi.getAlbumPage, album.mediaKey);
    if (!mediaItems || mediaItems.length === 0) {
      console.log(`Album "${album.title}" is empty. Skipping.`);
      return;
    }

    // Get detailed information in chunks.
    console.log(`Fetching detailed information for ${mediaItems.length} items...`);
    const mediaKeys = mediaItems.map(item => item.mediaKey);
    const mediaKeyChunks = splitIntoChunks(mediaKeys, INFO_CHUNK_SIZE);
    const promises = mediaKeyChunks.map(chunk => gptkApi.getBatchMediaInfo(chunk));
    const allMediaInfo = (await Promise.all(promises)).flat();
    console.log("Successfully fetched detailed information.");

    // Format the data with user-friendly headers and values.
    const formattedData = allMediaInfo.map(item => ({
      "Filename": item.fileName,
      "Description": item.descriptionFull,
      "Date_Taken": item.timestamp ? new Date(item.timestamp).toISOString() : null,
      "Date_Uploaded": item.creationTimestamp ? new Date(item.creationTimestamp).toISOString() : null,
      "Size_Bytes": item.size,
      "Takes_Up_Space": item.takesUpSpace,
      "Space_Consumed_Bytes": item.spaceTaken,
      "Is_Original_Quality": item.isOriginalQuality,
      "Timezone_Offset": item.timezoneOffset,
      "Media_Key": item.mediaKey
    }));

    // Convert to CSV and trigger download.
    const csvContent = convertToCsv(formattedData);
    const safeFilename = album.title.replace(/[/\\?%*:|"<>]/g, '_') + '.csv';
    downloadAsFile(safeFilename, csvContent, 'data:text/csv;charset=utf-8;');
    console.log(`Successfully processed and triggered download for "${album.title}".`);

  } catch (error) {
    console.error(`An error occurred while processing the album "${album.title}":`, error);
  }
}

/**
 * A generic helper to fetch all pages for a given API method.
 */
async function fetchAllPages(apiMethod, ...args) {
  const allItems = [];
  let nextPageId = null;
  do {
    const page = await apiMethod.call(gptkApi, ...args, nextPageId);
    if (page?.items?.length > 0) allItems.push(...page.items);
    nextPageId = page?.nextPageId;
  } while (nextPageId);
  return allItems;
}

/**
 * Splits an array into smaller arrays of a specified size.
 */
function splitIntoChunks(array, chunkSize) {
  const chunks = [];
  for (let i = 0; i < array.length; i += chunkSize) chunks.push(array.slice(i, i + chunkSize));
  return chunks;
}

/**
 * Converts an array of objects into a CSV-formatted string.
 */
function convertToCsv(data) {
  if (data.length === 0) return "";
  const headers = Object.keys(data[0]);
  const rows = data.map(obj =>
    headers.map(header => {
      let value = obj[header];
      if (value === null || value === undefined) return '';
      let stringValue = String(value);
      if (stringValue.includes(',') || stringValue.includes('"') || stringValue.includes('\n')) {
        return `"${stringValue.replace(/"/g, '""')}"`;
      }
      return stringValue;
    }).join(',')
  );
  return [headers.join(','), ...rows].join('\n');
}

/**
 * Triggers a browser download for the given text content.
 */
function downloadAsFile(filename, text, mimeType) {
  const element = document.createElement('a');
  element.setAttribute('href', `${mimeType},` + encodeURIComponent(text));
  element.setAttribute('download', filename);
  element.style.display = 'none';
  document.body.appendChild(element);
  element.click();
  document.body.removeChild(element);
}

// --- Execute the Main Function ---
exportAlbumInfo();

This second script will download a csv file for ALL LIBRARY.

/**
 * A comprehensive script to retrieve metadata for ALL photos in your
 * entire Google Photos library and download the result as a single, large CSV file.
 *
 * WARNING: This process can be very time-consuming and network-intensive for large libraries.
 * Do not close the browser tab while it is running.
 *
 * This version uses only the core `gptkApi` for maximum reliability.
 */
async function exportEntireLibrary() {
  const INFO_CHUNK_SIZE = 5000; // API limit for getBatchMediaInfo.

  if (!window.gptkApi) {
    console.error("Google-Photos-Toolkit core API (`gptkApi`) not found. Make sure the userscript is running.");
    return;
  }

  // --- Start of Core Logic ---
  try {
    console.log("--- Starting Full Library Export ---");
    console.warn("This process will take a long time for large libraries. Please be patient and do not close this tab.");

    // Step 1: Fetch ALL media items from the entire library, page by page.
    const allLibraryItems = await fetchAllLibraryItems();
    if (!allLibraryItems || allLibraryItems.length === 0) {
      console.log("Your library appears to be empty. Nothing to export.");
      return;
    }

    // Step 2: Get detailed information for every item in chunks.
    console.log(`--- Fetching detailed metadata for ${allLibraryItems.length} items ---`);
    console.log("This is the longest step. Progress will be logged for each chunk.");

    const mediaKeys = allLibraryItems.map(item => item.mediaKey);
    const mediaKeyChunks = splitIntoChunks(mediaKeys, INFO_CHUNK_SIZE);
    console.log(`Data will be fetched in ${mediaKeyChunks.length} chunk(s).`);

    let allMediaInfo = [];
    for (let i = 0; i < mediaKeyChunks.length; i++) {
      console.log(`Fetching details for chunk ${i + 1} of ${mediaKeyChunks.length}...`);
      const chunk = mediaKeyChunks[i];
      const chunkResult = await gptkApi.getBatchMediaInfo(chunk);
      allMediaInfo.push(...chunkResult);
    }
    console.log("Successfully fetched all detailed information.");

    // Step 3: Format the comprehensive data for CSV export.
    console.log("Formatting data into CSV format...");
    const formattedData = allMediaInfo.map(item => ({
      "Filename": item.fileName,
      "Description": item.descriptionFull,
      "Date_Taken": item.timestamp ? new Date(item.timestamp).toISOString() : null,
      "Date_Uploaded": item.creationTimestamp ? new Date(item.creationTimestamp).toISOString() : null,
      "Size_Bytes": item.size,
      "Takes_Up_Space": item.takesUpSpace,
      "Space_Consumed_Bytes": item.spaceTaken,
      "Is_Original_Quality": item.isOriginalQuality,
      "Timezone_Offset": item.timezoneOffset,
      "Media_Key": item.mediaKey
    }));

    // Step 4: Convert to CSV and trigger the download.
    const csvContent = convertToCsv(formattedData);
    const filename = 'Google_Photos_Library_Export.csv';

    console.log("Final data prepared. Triggering file download...");
    downloadAsFile(filename, csvContent, 'data:text/csv;charset=utf-8;');

    console.log("--- ✅ Full Library Export Process Complete! ---");

  } catch (error) {
    console.error("A critical error occurred during the library export process:", error);
  }
}

// --- HELPER FUNCTIONS (No need to edit below this line) ---

/**
 * Fetches all items from the main library by paginating through the results
 * using the most reliable "upload date" endpoint.
 */
async function fetchAllLibraryItems() {
  const allItems = [];
  let nextPageId = null;
  let pageCount = 0;
  console.log("Starting to fetch all library items page by page...");

  do {
    pageCount++;
    const page = await gptkApi.getItemsByUploadedDate(nextPageId);
    if (page?.items?.length > 0) {
      console.log(`  - Fetched page ${pageCount} with ${page.items.length} items. Total so far: ${allItems.length + page.items.length}`);
      allItems.push(...page.items);
    }
    nextPageId = page?.nextPageId;
  } while (nextPageId);

  console.log(`Finished fetching all library pages. Found a total of ${allItems.length} items.`);
  return allItems;
}

/**
 * Splits an array into smaller arrays of a specified size.
 */
function splitIntoChunks(array, chunkSize) {
  const chunks = [];
  for (let i = 0; i < array.length; i += chunkSize) chunks.push(array.slice(i, i + chunkSize));
  return chunks;
}

/**
 * Converts an array of objects into a CSV-formatted string.
 */
function convertToCsv(data) {
  if (data.length === 0) return "";
  const headers = Object.keys(data[0]);
  const rows = data.map(obj =>
    headers.map(header => {
      let value = obj[header];
      if (value === null || value === undefined) return '';
      let stringValue = String(value);
      if (stringValue.includes(',') || stringValue.includes('"') || stringValue.includes('\n')) {
        return `"${stringValue.replace(/"/g, '""')}"`;
      }
      return stringValue;
    }).join(',')
  );
  return [headers.join(','), ...rows].join('\n');
}

/**
 * Triggers a browser download for the given text content.
 */
function downloadAsFile(filename, text, mimeType) {
  const element = document.createElement('a');
  element.setAttribute('href', `${mimeType},` + encodeURIComponent(text));
  element.setAttribute('download', filename);
  element.style.display = 'none';
  document.body.appendChild(element);
  element.click();
  document.body.removeChild(element);
}

// --- Execute the Main Function ---
exportEntireLibrary();