# Scripts Collection — Master Index

This wiki documents a personal collection of automation scripts primarily focused on **VGMdb (Video Game Music Database) collection management**, with tools for web scraping, audio file handling, URL management, file organization, and more.

**Total scripts documented:** 40 | **Last updated:** 2026-05-01

---

## Categories

| # | Category | Pages | Description |
|---|----------|-------|-------------|
| 1 | [VGMdb Scrapers](#vgmdb-scrapers) | 6 | Web scrapers and crawlers for VGMdb |
| 2 | [Audio & CUE Tools](#audio--cue-tools) | 5 | CUE sheet creation, fixing, and audio splitting |
| 3 | [URL Management](#url-management) | 5 | Extracting, cleaning, and organizing URL shortcuts |
| 4 | [File Organization](#file-organization) | 7 | Folder renaming, restructuring, and sorting |
| 5 | [Data Extraction](#data-extraction) | 6 | Pulling metadata from files, HTML, and JSON exports |
| 6 | [Format Conversion](#format-conversion) | 2 | CSV encoding conversion tools |
| 7 | [Web Apps](#web-apps) | 2 | Flask-based web applications |
| 8 | [Browser Extensions](#browser-extensions) | 3 | Chrome and Firefox extensions for VGMdb |
| 9 | [Deprecated / Archive](#deprecated--archive) | 4 | Superseded scripts kept for reference |

---

## VGMdb Scrapers

Tools for scraping and crawling the VGMdb website to extract collection data, reprint relationships, and album metadata.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [VGMdb Collection Scraper (Docker)](vgmdb-scrapers/docker-vgmdb-scraper.md) | Python 3 / Flask | Active | Web app that scrapes a VGMdb user's collection and exports to Excel |
| [Reprint Finder v6](vgmdb-scrapers/reprintfinder-v6.md) | Python 3 | Active | Recursive reprint chain crawler with Excel output and persistent history |
| [Reprint Finder v5](vgmdb-scrapers/reprintfinder-v5.md) | Python 3 | Superseded | Earlier version of the reprint crawler (no persistent history) |
| [VGMPP Cookie Tagger](vgmdb-scrapers/vgmpp-cookie.md) | Python 3 | Active | Tags FLAC files with VGMdb metadata using persistent session cookies |
| [Extract URLs Final](vgmdb-scrapers/extract-urls-final.md) | Python 3 | Active | Recursively finds `.url` shortcut files and extracts their URLs with curses UI |
| [Grab URLs](vgmdb-scrapers/graburls.md) | Python 3 | Active | Extracts VGMdb URLs from a local HTML collection export |

---

## Audio & CUE Tools

Scripts for creating, fixing, and splitting CUE sheets and working with audio file metadata.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [Beets CUE Maker](audio-cue-tools/beets-cuemaker.md) | Python 3 | Active | Generates `.cue` files from audio filenames or a track listing `input.txt` |
| [Beets Find Brackets](audio-cue-tools/beets-find-brackets.md) | Python 3 | Active | Finds folders with bracketed catalog numbers in their names |
| [VGMdb CUE Fixer](audio-cue-tools/vgmdb-cuefixer.md) | Python 3 | Active | Updates `FILE` directives in `.cue` files to match actual audio files present |
| [VGMdb CUE Fixer Reverse](audio-cue-tools/vgmdb-cuefixer-reverse.md) | Python 3 | Active | Restores `.cue` files from `.cue.bak` backups made by CUE Fixer |
| [VGMdb CUE Splitter](audio-cue-tools/vgmdb-cuesplitter.md) | Python 3 | Active | Recursively splits audio files using CUE sheets via `ffcuesplitter` |

---

## URL Management

PowerShell and Python scripts for working with Windows `.url` shortcut files and VGMdb URL lists.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [VGMdb URL to List](url-management/vgmdb-url2list.md) | PowerShell | Active | Scans folder trees and exports `.url` shortcut paths/URLs to CSV |
| [VGMdb Compare URL](url-management/vgmdb-compareurl.md) | PowerShell | Active | Scans multiple drives for VGMdb `.url` shortcuts and upgrades HTTP to HTTPS |
| [VGMdb URL Cleaner](url-management/vgmdb-urlcleaner.md) | PowerShell + Python | Active | Strips `.url` files to minimal `[InternetShortcut]` + `URL=` format |
| [URL Cleaner v4](url-management/url-cleaner-v4.md) | Python 3 | Active | Python standalone version of the URL cleaner with live progress display |
| [VGMdb URLs](url-management/vgmdb-urls.md) | PowerShell | Active | Creates `Album info.url` shortcut files from a pipe-delimited URL list |

---

## File Organization

Scripts that rename, sort, and restructure music collection folders.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [LOG+CUE Folder Renamer](file-organization/vgmdb-logcue-folderrename.md) | Python 3 | Active | Renames folders based on metadata extracted from `.log` and `.cue` files |
| [Renamer Wildcard](file-organization/vgmdb-renamer-wildcard.md) | PowerShell | Active | Renames folders using wildcard patterns from a pipe-delimited input file |
| [VGMdb Restructure (2-step)](file-organization/vgmdb-restructure.md) | Python 3 | Active | Two-step pipeline: scan `.url` files → scrape VGMdb → output restructure CSV |
| [VGMdb Restructure Combined](file-organization/vgmdb-restructure-combined.md) | Python 3 | Active | Single-script version of the restructure pipeline with interactive confirmation |
| [URL Rename Combo](file-organization/vgmdb-url-rename-combo-python.md) | Python 3 | Active | Renames folders and creates `.url` shortcuts from a pipe-delimited input file |
| [Doujin Subfolders](file-organization/vgmdb-doujin-subfolders.md) | Python 3 | ⚠️ Quarantined | Organises doujin albums into publisher subfolders using FLAC tags |
| [Dummy Folders](file-organization/vgmdb-dummyfolders.md) | PowerShell | Active | Seeds target folders with copies of a template folder structure |

---

## Data Extraction

Scripts that pull structured data from HTML exports, JSON files, and audio metadata.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [VGMdb HTML Extractors](data-extraction/extract.md) | Python 3 | Active | Extracts catalog numbers and HTTP addresses from VGMdb HTML collection pages |
| [Nicotine+ Shares Extractor](data-extraction/vgmdb-nicotineshares.md) | Python 3 | Active | Extracts catalog numbers from Nicotine+ share JSON exports |
| [Redbook Check](data-extraction/vgmdb-redbookcheck.md) | Python 3 | Active | Checks VGMdb search URLs for Touhou keyword presence |
| [Redbook Dummy](data-extraction/vgmdb-redbookdummy.md) | Python 3 | Active | Creates dummy file structures from Usenet share JSON exports |
| [AGM Catalog Puller](data-extraction/agm.md) | PowerShell | Active | Pulls catalog numbers from folder names and exports to CSV |
| [Folder Image Creator](data-extraction/vgmdb-folder-image-creator.md) | Python 3 | Active | Auto-creates `folder.jpg` thumbnails from album scan images |

---

## Format Conversion

Utilities for converting file encodings, primarily Japanese character sets to UTF-8.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [Sony Bank CSV Converter](format-conversion/actual-sonybank.md) | Python 3 | Active | Converts Sony Bank `FutsuRireki.csv` from Shift-JIS to UTF-8 |
| [CSV Encoding Converter](format-conversion/csvconvert.md) | Python 3 | Active | Batch converts Japanese CSV files (Shift-JIS / EUC-JP) to UTF-8 |

---

## Web Apps

Flask-based web applications.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [Jog Japan Tracker](web-apps/jog-japan.md) | Python 3 / Flask | Active | Progress tracker for a virtual jogging route through Japan with interactive map |
| [VGMdb Collection Scraper](web-apps/docker-vgmdb-scraper.md) | Python 3 / Flask | Active | See [VGMdb Scrapers](vgmdb-scrapers/docker-vgmdb-scraper.md) |

---

## Browser Extensions

Chrome and Firefox browser extensions for VGMdb integration.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [VGMdb Chrome Script](browser-extensions/vgmdb-chrome-script.md) | JavaScript (MV3) | Active | Chrome extension for syncing VGMdb album data to a Google Sheets spreadsheet |
| [VGMdb Collection Extension](browser-extensions/vgmdb-collection-extension.md) | JavaScript (MV3) | Active | Updated Chrome extension variant with an added close button |
| [VGMdb Firefox Script](browser-extensions/vgmdb-firefox-script.md) | JavaScript (.xpi) | Active | Firefox version of the VGMdb browser extension |

---

## Deprecated / Archive

Scripts that have been superseded or archived. Documented for reference.

| Script | Language | Status | Description |
|--------|----------|--------|-------------|
| [Reprint Finder (Deprecated)](deprecated/vgmdbcrawl-reprintfinder-deprecated.md) | Python 3 | Deprecated | Original reprint crawler; superseded by v5 and then v6 |
| [Reprint Finder (ChatGPT)](deprecated/vgmdbcrawl-reprint-chatgpt.md) | Python 3 | Deprecated | Experimental ChatGPT-assisted reprint crawler (v3/v4) |
| [XX — Other Scripts Archive](deprecated/xx-other-scripts.md) | Python 3 | Archive | Collection of earlier VgmdbScraper versions and experimental tools |
| [XX — Backups & Outputs](deprecated/xx-backups-outputs.md) | — | Archive | Backup and output archive directories (no executable scripts) |

---

## Quick Reference: Dependency Install Commands

| Tools needed | Install command |
|---|---|
| Web scraping | `pip install requests beautifulsoup4` |
| Excel output | `pip install openpyxl` |
| Audio metadata | `pip install mutagen` |
| Image processing | `pip install Pillow` |
| Progress bars | `pip install tqdm` |
| Terminal color | `pip install colorama` |
| Encoding detection | `pip install chardet` |
| Flask web apps | `pip install flask flask-session flask-sqlalchemy` |
| Data / scraping combo | `pip install requests beautifulsoup4 openpyxl tqdm pandas` |
| CUE splitting | `pip install ffcuesplitter` + install [FFmpeg](https://ffmpeg.org/) |