@fredlackey/devutils 0.0.1 → 0.0.3

package/src/installs/vlc.js

@@ -1,44 +1,821 @@
 #!/usr/bin/env node
 
 /**
- * @fileoverview Install VLC.
+ * @fileoverview Install VLC Media Player.
  * @module installs/vlc
+ *
+ * VLC is a free and open-source cross-platform multimedia player and framework
+ * developed by the VideoLAN project. It plays most multimedia files, DVDs,
+ * Audio CDs, VCDs, and various streaming protocols without requiring additional
+ * codec packs.
+ *
+ * This installer provides:
+ * - VLC via Homebrew cask for macOS
+ * - VLC via APT for Ubuntu/Debian and Raspberry Pi OS
+ * - VLC via DNF/YUM with RPM Fusion for Amazon Linux/RHEL
+ * - VLC via Chocolatey for Windows
+ * - VLC via APT for WSL (Ubuntu)
+ * - VLC via Windows installation (Chocolatey) for Git Bash
+ *
+ * IMPORTANT PLATFORM NOTES:
+ * - macOS: Installs VLC.app via Homebrew cask to /Applications
+ * - Ubuntu/Debian: Installs from official APT repositories
+ * - Raspberry Pi OS: Installs from official APT repositories (ARM compatible)
+ * - Amazon Linux/RHEL: Requires EPEL and RPM Fusion repositories
+ * - Windows: Installs via Chocolatey package manager
+ * - WSL: Installs via APT within WSL environment (requires WSLg for GUI)
+ * - Git Bash: Installs on Windows host via Chocolatey through PowerShell
  */
 
 const os = require('../utils/common/os');
+const shell = require('../utils/common/shell');
+const brew = require('../utils/macos/brew');
+const macosApps = require('../utils/macos/apps');
+const apt = require('../utils/ubuntu/apt');
+const choco = require('../utils/windows/choco');
+
+/**
+ * Indicates whether this installer requires a desktop environment.
+ * VLC is a GUI media player and requires a display.
+ * @type {boolean}
+ */
+const REQUIRES_DESKTOP = true;
+
+/**
+ * The Homebrew cask name for VLC on macOS.
+ * This installs the full VLC.app to /Applications.
+ */
+const HOMEBREW_CASK_NAME = 'vlc';
+
+/**
+ * The APT package name for VLC on Debian-based systems.
+ */
+const APT_PACKAGE_NAME = 'vlc';
+
+/**
+ * The Chocolatey package name for VLC on Windows.
+ */
+const CHOCO_PACKAGE_NAME = 'vlc';
+
+/**
+ * The macOS application name for VLC.
+ * Used to check if VLC is already installed in /Applications.
+ */
+const MACOS_APP_NAME = 'VLC';
+
+/**
+ * Check if VLC is installed by verifying the 'vlc' command exists.
+ *
+ * This check works on Linux and Windows where VLC adds itself to PATH.
+ * For macOS, use the macosApps utility to check for VLC.app instead.
+ *
+ * @returns {boolean} True if the vlc command is available, false otherwise
+ */
+function isVLCCommandAvailable() {
+  return shell.commandExists('vlc');
+}
+
+/**
+ * Check if VLC is installed and get the version.
+ *
+ * Executes 'vlc --version' to verify VLC is properly installed
+ * and operational. Returns the version string if successful.
+ *
+ * @returns {Promise<string|null>} VLC version string, or null if not installed
+ */
+async function getVLCVersion() {
+  // First check if the command exists to avoid unnecessary process spawning
+  if (!isVLCCommandAvailable()) {
+    return null;
+  }
+
+  // Execute vlc --version to get version information
+  // The output format is typically: "VLC media player X.Y.Z Vetinari..."
+  const result = await shell.exec('vlc --version');
+  if (result.code === 0 && result.stdout) {
+    // Parse version from output like: "VLC media player 3.0.21 Vetinari..."
+    const match = result.stdout.match(/VLC media player\s+([^\s]+)/);
+    return match ? match[1] : result.stdout.split('\n')[0].trim();
+  }
+  return null;
+}
+
+/**
+ * Install VLC on macOS using Homebrew cask.
+ *
+ * Prerequisites:
+ * - macOS 10.15 (Catalina) or later
+ * - Homebrew package manager installed
+ * - At least 200 MB free disk space
+ *
+ * Homebrew installs VLC.app to /Applications. On first launch, macOS may
+ * display a Gatekeeper warning that requires right-clicking the app and
+ * selecting "Open" to bypass.
+ *
+ * @returns {Promise<void>}
+ * @throws {Error} If Homebrew is not installed or installation fails
+ */
+async function install_macos() {
+  console.log('Checking if VLC is already installed...');
+
+  // Check if VLC.app exists in /Applications
+  const isAppInstalled = macosApps.isAppInstalled(MACOS_APP_NAME);
+  if (isAppInstalled) {
+    const version = macosApps.getAppVersion(MACOS_APP_NAME);
+    if (version) {
+      console.log(`VLC ${version} is already installed, skipping installation.`);
+    } else {
+      console.log('VLC is already installed, skipping installation.');
+    }
+    return;
+  }
+
+  // Also check if the cask is installed via Homebrew
+  // (VLC may be installed but not detected in Applications for some reason)
+  const caskInstalled = await brew.isCaskInstalled(HOMEBREW_CASK_NAME);
+  if (caskInstalled) {
+    console.log('VLC is already installed via Homebrew, skipping installation.');
+    console.log('');
+    console.log('NOTE: If VLC is not appearing in Applications, try:');
+    console.log('  brew reinstall --cask vlc');
+    return;
+  }
+
+  // Verify Homebrew is available
+  if (!brew.isInstalled()) {
+    throw new Error(
+      'Homebrew is not installed. Please install Homebrew first using:\n' +
+      '  dev install homebrew\n' +
+      'Then retry installing VLC.'
+    );
+  }
+
+  console.log('Installing VLC via Homebrew...');
+
+  // Install VLC cask with --quiet flag for cleaner output
+  const result = await shell.exec('brew install --quiet --cask vlc');
+
+  if (result.code !== 0) {
+    throw new Error(
+      `Failed to install VLC via Homebrew.\n` +
+      `Output: ${result.stderr || result.stdout}\n\n` +
+      `Troubleshooting:\n` +
+      `  1. Run 'brew update && brew cleanup' and retry\n` +
+      `  2. Check for Homebrew issues: brew doctor\n` +
+      `  3. Try manual installation: brew install --cask vlc`
+    );
+  }
+
+  // Verify installation succeeded by checking for VLC.app
+  const verified = macosApps.isAppInstalled(MACOS_APP_NAME);
+  if (!verified) {
+    throw new Error(
+      'Installation appeared to complete but VLC.app was not found.\n\n' +
+      'Please try:\n' +
+      '  1. Check /Applications/VLC.app exists\n' +
+      '  2. Run: brew reinstall --cask vlc'
+    );
+  }
+
+  const installedVersion = macosApps.getAppVersion(MACOS_APP_NAME);
+  console.log(`VLC ${installedVersion || ''} installed successfully.`);
+  console.log('');
+  console.log('You can launch VLC from:');
+  console.log('  - Applications folder');
+  console.log('  - Spotlight (Cmd+Space, type "VLC")');
+  console.log('  - Terminal: open -a VLC');
+  console.log('');
+  console.log('NOTE: On first launch, you may see a Gatekeeper warning.');
+  console.log('Right-click VLC in Applications and select "Open" to bypass.');
+}
+
+/**
+ * Install VLC on Ubuntu/Debian using APT.
+ *
+ * Prerequisites:
+ * - Ubuntu 20.04 LTS or later, or Debian 11 (Bullseye) or later
+ * - sudo privileges
+ * - At least 500 MB free disk space (including dependencies)
+ *
+ * The version available in Ubuntu/Debian repositories may not be the absolute
+ * latest. For most use cases, the repository version is sufficient and receives
+ * security updates.
+ *
+ * @returns {Promise<void>}
+ * @throws {Error} If installation fails
+ */
+async function install_ubuntu() {
+  console.log('Checking if VLC is already installed...');
+
+  // Check if VLC is already installed via dpkg
+  const isInstalled = await apt.isPackageInstalled(APT_PACKAGE_NAME);
+  if (isInstalled) {
+    const version = await apt.getPackageVersion(APT_PACKAGE_NAME);
+    if (version) {
+      console.log(`VLC ${version} is already installed, skipping installation.`);
+    } else {
+      console.log('VLC is already installed, skipping installation.');
+    }
+    return;
+  }
+
+  // Update package index before installing
+  console.log('Updating package index...');
+  const updateResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
+  if (updateResult.code !== 0) {
+    console.log('Warning: Could not update package index, continuing anyway...');
+  }
+
+  // Install VLC via APT
+  console.log('Installing VLC via APT...');
+  const installResult = await shell.exec(
+    'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y vlc'
+  );
+
+  if (installResult.code !== 0) {
+    throw new Error(
+      `Failed to install VLC via APT.\n` +
+      `Output: ${installResult.stderr}\n\n` +
+      `Troubleshooting:\n` +
+      `  1. Run 'sudo apt-get update' and retry\n` +
+      `  2. Check available packages: apt-cache search vlc\n` +
+      `  3. Try manual installation: sudo apt-get install vlc`
+    );
+  }
+
+  // Verify installation succeeded
+  const version = await getVLCVersion();
+  if (!version) {
+    throw new Error(
+      'Installation appeared to complete but VLC was not found.\n\n' +
+      'Please try:\n' +
+      '  1. Restart your terminal session\n' +
+      '  2. Run: vlc --version'
+    );
+  }
+
+  console.log(`VLC ${version} installed successfully.`);
+  console.log('');
+  console.log('You can launch VLC from:');
+  console.log('  - Applications menu');
+  console.log('  - Terminal: vlc');
+  console.log('  - Headless/CLI mode: cvlc');
+  console.log('');
+  console.log('NOTE: The repository version may not be the latest.');
+  console.log('For newer versions, consider the VideoLAN PPA.');
+}
+
+/**
+ * Install VLC on Raspberry Pi OS using APT.
+ *
+ * Prerequisites:
+ * - Raspberry Pi OS (Bookworm or Bullseye), 32-bit or 64-bit
+ * - Raspberry Pi 3 or later recommended (earlier models have limited performance)
+ * - sudo privileges
+ * - At least 500 MB free disk space
+ *
+ * NOTE: Raspberry Pi OS (full desktop version) typically comes with VLC
+ * pre-installed. This installer handles cases where VLC was removed or
+ * on Raspberry Pi OS Lite.
+ *
+ * The Raspberry Pi OS repositories contain VLC builds optimized for ARM
+ * processors with hardware acceleration patches for the Raspberry Pi's GPU.
+ *
+ * @returns {Promise<void>}
+ * @throws {Error} If installation fails
+ */
+async function install_raspbian() {
+  console.log('Checking if VLC is already installed...');
+
+  // Check if VLC is already installed via dpkg
+  const isInstalled = await apt.isPackageInstalled(APT_PACKAGE_NAME);
+  if (isInstalled) {
+    const version = await apt.getPackageVersion(APT_PACKAGE_NAME);
+    if (version) {
+      console.log(`VLC ${version} is already installed, skipping installation.`);
+    } else {
+      console.log('VLC is already installed, skipping installation.');
+    }
+    return;
+  }
+
+  // Update package index before installing
+  console.log('Updating package index...');
+  const updateResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
+  if (updateResult.code !== 0) {
+    console.log('Warning: Could not update package index, continuing anyway...');
+  }
+
+  // Install VLC via APT
+  console.log('Installing VLC via APT...');
+  const installResult = await shell.exec(
+    'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y vlc'
+  );
+
+  if (installResult.code !== 0) {
+    throw new Error(
+      `Failed to install VLC via APT.\n` +
+      `Output: ${installResult.stderr}\n\n` +
+      `Troubleshooting:\n` +
+      `  1. Run 'sudo apt-get update' and retry\n` +
+      `  2. Check available packages: apt-cache search vlc\n` +
+      `  3. Try manual installation: sudo apt-get install vlc`
+    );
+  }
+
+  // Verify installation succeeded
+  const version = await getVLCVersion();
+  if (!version) {
+    throw new Error(
+      'Installation appeared to complete but VLC was not found.\n\n' +
+      'Please try:\n' +
+      '  1. Restart your terminal session\n' +
+      '  2. Run: vlc --version'
+    );
+  }
+
+  console.log(`VLC ${version} installed successfully.`);
+  console.log('');
+  console.log('You can launch VLC from:');
+  console.log('  - Desktop menu (under Sound & Video)');
+  console.log('  - Terminal: vlc');
+  console.log('  - Headless/CLI mode: cvlc');
+  console.log('');
+  console.log('RASPBERRY PI NOTES:');
+  console.log('  - Hardware acceleration is available for better performance');
+  console.log('  - Use MMAL codec for H.264: cvlc --codec=mmal_codec video.mp4');
+  console.log('  - For headless streaming, install vlc-nox: sudo apt install vlc-nox');
+}
 
 /**
- * Install VLC across supported platforms.
+ * Install VLC on Amazon Linux/RHEL using DNF/YUM with RPM Fusion.
+ *
+ * Prerequisites:
+ * - Amazon Linux 2023 (AL2023), Amazon Linux 2 (AL2), or RHEL 8/9
+ * - sudo privileges
+ * - At least 500 MB free disk space
+ *
+ * IMPORTANT: VLC is not available in the standard Amazon Linux or RHEL
+ * repositories. This function enables the EPEL (Extra Packages for Enterprise
+ * Linux) and RPM Fusion repositories to install VLC.
+ *
+ * @returns {Promise<void>}
+ * @throws {Error} If installation fails
+ */
+async function install_amazon_linux() {
+  console.log('Checking if VLC is already installed...');
+
+  // Check if VLC is already installed
+  const existingVersion = await getVLCVersion();
+  if (existingVersion) {
+    console.log(`VLC ${existingVersion} is already installed, skipping installation.`);
+    return;
+  }
+
+  // Detect package manager (dnf for AL2023/RHEL9, yum for AL2/RHEL8)
+  const hasDnf = shell.commandExists('dnf');
+  const hasYum = shell.commandExists('yum');
+  const packageManager = hasDnf ? 'dnf' : (hasYum ? 'yum' : null);
+
+  if (!packageManager) {
+    throw new Error(
+      'Neither dnf nor yum package manager found.\n' +
+      'This installer supports Amazon Linux 2023 (dnf), Amazon Linux 2 (yum), and RHEL 8/9.'
+    );
+  }
+
+  console.log(`Detected package manager: ${packageManager}`);
+
+  // Determine the RHEL version for repository URLs
+  // AL2023 is based on Fedora and compatible with RHEL 9 repos
+  // AL2 and RHEL 8 use version 8 repos
+  console.log('Detecting system version...');
+  const versionResult = await shell.exec('rpm -E %rhel');
+  let rhelVersion = versionResult.stdout.trim();
+
+  // If rpm -E %rhel returns empty or just "%rhel", try to detect from os-release
+  if (!rhelVersion || rhelVersion === '%rhel') {
+    if (hasDnf) {
+      // Amazon Linux 2023 is compatible with RHEL 9
+      rhelVersion = '9';
+    } else {
+      // Amazon Linux 2 is compatible with RHEL 8
+      rhelVersion = '8';
+    }
+  }
+
+  console.log(`Using RHEL ${rhelVersion} compatible repositories...`);
+
+  // Install EPEL repository (required dependency for RPM Fusion)
+  console.log('Installing EPEL repository...');
+  const epelUrl = `https://dl.fedoraproject.org/pub/epel/epel-release-latest-${rhelVersion}.noarch.rpm`;
+  const epelResult = await shell.exec(`sudo ${packageManager} install -y ${epelUrl}`);
+  if (epelResult.code !== 0) {
+    // EPEL might already be installed, continue anyway
+    console.log('Note: EPEL may already be installed, continuing...');
+  }
+
+  // Install RPM Fusion Free repository (contains VLC)
+  console.log('Installing RPM Fusion Free repository...');
+  const rpmfusionUrl = `https://download1.rpmfusion.org/free/el/rpmfusion-free-release-${rhelVersion}.noarch.rpm`;
+  const rpmfusionResult = await shell.exec(`sudo ${packageManager} install -y ${rpmfusionUrl}`);
+  if (rpmfusionResult.code !== 0) {
+    throw new Error(
+      `Failed to install RPM Fusion repository.\n` +
+      `Output: ${rpmfusionResult.stderr}\n\n` +
+      `Troubleshooting:\n` +
+      `  1. Check your internet connection\n` +
+      `  2. Verify the repository URL is accessible\n` +
+      `  3. Try manually: sudo ${packageManager} install -y ${rpmfusionUrl}`
+    );
+  }
+
+  // Install VLC
+  console.log('Installing VLC...');
+  const installResult = await shell.exec(`sudo ${packageManager} install -y vlc`);
+
+  if (installResult.code !== 0) {
+    throw new Error(
+      `Failed to install VLC.\n` +
+      `Output: ${installResult.stderr}\n\n` +
+      `Troubleshooting:\n` +
+      `  1. Verify RPM Fusion is enabled: ${packageManager} repolist\n` +
+      `  2. Clean package cache: sudo ${packageManager} clean all\n` +
+      `  3. Try manual installation: sudo ${packageManager} install vlc`
+    );
+  }
+
+  // Verify installation succeeded
+  const version = await getVLCVersion();
+  if (!version) {
+    throw new Error(
+      'Installation appeared to complete but VLC was not found.\n\n' +
+      'Please try:\n' +
+      '  1. Restart your terminal session\n' +
+      '  2. Run: vlc --version'
+    );
+  }
+
+  console.log(`VLC ${version} installed successfully.`);
+  console.log('');
+  console.log('You can launch VLC from:');
+  console.log('  - Terminal: vlc');
+  console.log('  - Headless/CLI mode: cvlc');
+  console.log('');
+  console.log('NOTE: VLC was installed from RPM Fusion repository.');
+  console.log('For headless server use (streaming/transcoding): cvlc --no-video');
+}
+
+/**
+ * Install VLC on Windows using Chocolatey.
+ *
+ * Prerequisites:
+ * - Windows 10 or later (32-bit or 64-bit), or Windows 11
+ * - Administrator PowerShell or Command Prompt
+ * - Chocolatey package manager installed
+ * - At least 200 MB free disk space
+ *
+ * Chocolatey downloads VLC from the official VideoLAN servers and handles
+ * the installation silently. VLC will be added to the system PATH.
+ *
+ * @returns {Promise<void>}
+ * @throws {Error} If Chocolatey is not installed or installation fails
+ */
+async function install_windows() {
+  console.log('Checking if VLC is already installed...');
+
+  // Check if VLC is already installed
+  const existingVersion = await getVLCVersion();
+  if (existingVersion) {
+    console.log(`VLC ${existingVersion} is already installed, skipping installation.`);
+    return;
+  }
+
+  // Check if VLC package is installed via Chocolatey
+  const packageInstalled = await choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
+  if (packageInstalled) {
+    console.log('VLC is already installed via Chocolatey, skipping installation.');
+    console.log('');
+    console.log('NOTE: If VLC commands are not working, open a new terminal window');
+    console.log('to refresh your PATH, or run: refreshenv');
+    return;
+  }
+
+  // Verify Chocolatey is available
+  if (!choco.isInstalled()) {
+    throw new Error(
+      'Chocolatey is not installed. Please install Chocolatey first:\n\n' +
+      'Run the following in an Administrator PowerShell:\n' +
+      '  Set-ExecutionPolicy Bypass -Scope Process -Force; ' +
+      '[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; ' +
+      'iex ((New-Object System.Net.WebClient).DownloadString(\'https://community.chocolatey.org/install.ps1\'))\n\n' +
+      'Then retry installing VLC.'
+    );
+  }
+
+  console.log('Installing VLC via Chocolatey...');
+  console.log('This may take a few minutes...');
+
+  // Install VLC using Chocolatey
+  const result = await choco.install(CHOCO_PACKAGE_NAME);
+
+  if (!result.success) {
+    throw new Error(
+      `Failed to install VLC via Chocolatey.\n` +
+      `Output: ${result.output}\n\n` +
+      `Troubleshooting:\n` +
+      `  1. Ensure you are running as Administrator\n` +
+      `  2. Try manual installation: choco install vlc -y\n` +
+      `  3. Check Chocolatey logs for details`
+    );
+  }
+
+  console.log('VLC installed successfully.');
+  console.log('');
+  console.log('IMPORTANT: Open a new terminal window to refresh your PATH.');
+  console.log('Alternatively, run: refreshenv');
+  console.log('');
+  console.log('You can launch VLC from:');
+  console.log('  - Start Menu');
+  console.log('  - Command line: vlc');
+  console.log('  - File path: "C:\\Program Files\\VideoLAN\\VLC\\vlc.exe"');
+  console.log('');
+  console.log('Verify installation with: vlc --version');
+}
+
+/**
+ * Install VLC on Ubuntu running in WSL (Windows Subsystem for Linux).
+ *
+ * Prerequisites:
+ * - Windows 10 Build 19044 or higher, or Windows 11
+ * - WSL 2 enabled with Ubuntu distribution installed
+ * - WSLg enabled for GUI application support (Windows 11 or Windows 10 with updates)
+ * - sudo privileges within WSL
+ *
+ * IMPORTANT: VLC is a graphical application. Running VLC in WSL requires
+ * GUI support through WSLg (Windows Subsystem for Linux GUI). Windows 11
+ * includes WSLg by default. For headless operation, use cvlc or vlc-nox.
+ *
+ * @returns {Promise<void>}
+ * @throws {Error} If installation fails
+ */
+async function install_ubuntu_wsl() {
+  console.log('Detected Ubuntu running in WSL (Windows Subsystem for Linux).');
+  console.log('');
+  console.log('Installing VLC within WSL environment...');
+  console.log('');
+
+  // Check if VLC is already installed
+  const isInstalled = await apt.isPackageInstalled(APT_PACKAGE_NAME);
+  if (isInstalled) {
+    const version = await apt.getPackageVersion(APT_PACKAGE_NAME);
+    if (version) {
+      console.log(`VLC ${version} is already installed, skipping installation.`);
+    } else {
+      console.log('VLC is already installed, skipping installation.');
+    }
+    return;
+  }
+
+  // Update package index before installing
+  console.log('Updating package index...');
+  const updateResult = await shell.exec('sudo DEBIAN_FRONTEND=noninteractive apt-get update -y');
+  if (updateResult.code !== 0) {
+    console.log('Warning: Could not update package index, continuing anyway...');
+  }
+
+  // Install VLC via APT
+  console.log('Installing VLC via APT...');
+  const installResult = await shell.exec(
+    'sudo DEBIAN_FRONTEND=noninteractive apt-get install -y vlc'
+  );
+
+  if (installResult.code !== 0) {
+    throw new Error(
+      `Failed to install VLC via APT.\n` +
+      `Output: ${installResult.stderr}\n\n` +
+      `Troubleshooting:\n` +
+      `  1. If you see DNS errors, try:\n` +
+      `     echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf\n` +
+      `  2. Run 'sudo apt-get update' and retry\n` +
+      `  3. Try manual installation: sudo apt-get install vlc`
+    );
+  }
+
+  // Verify installation succeeded
+  const version = await getVLCVersion();
+  if (!version) {
+    throw new Error(
+      'Installation appeared to complete but VLC was not found.\n\n' +
+      'Please try:\n' +
+      '  1. Restart your WSL session\n' +
+      '  2. Run: vlc --version'
+    );
+  }
+
+  console.log(`VLC ${version} installed successfully.`);
+  console.log('');
+  console.log('WSL NOTES:');
+  console.log('');
+  console.log('1. GUI support requires WSLg:');
+  console.log('   - Windows 11: WSLg is included by default');
+  console.log('   - Windows 10: Requires specific builds and updates');
+  console.log('   - Test with: vlc &');
+  console.log('');
+  console.log('2. If you see "cannot open display" errors:');
+  console.log('   - Restart WSL: wsl --shutdown (from PowerShell)');
+  console.log('   - Then reopen your WSL terminal');
+  console.log('');
+  console.log('3. For headless operation (streaming/transcoding):');
+  console.log('   - Use cvlc: cvlc --no-video /path/to/media.mp4');
+  console.log('');
+  console.log('4. To access Windows files:');
+  console.log('   - cvlc /mnt/c/Users/YourName/Videos/movie.mp4');
+}
+
+/**
+ * Install VLC from Git Bash on Windows.
+ *
+ * Git Bash runs in a MinGW environment on Windows. This function installs
+ * VLC on the Windows host using Chocolatey via PowerShell interop.
+ * Once installed, VLC will be accessible from Git Bash through the Windows PATH.
+ *
+ * Prerequisites:
+ * - Windows 10 or later (64-bit)
+ * - Git Bash installed (comes with Git for Windows)
+ * - Chocolatey package manager installed on Windows
+ * - Administrator privileges
+ *
+ * @returns {Promise<void>}
+ * @throws {Error} If installation fails
+ */
+async function install_gitbash() {
+  console.log('Detected Git Bash on Windows.');
+  console.log('Installing VLC on the Windows host...');
+  console.log('');
+
+  // Check if VLC is already available
+  const existingVersion = await getVLCVersion();
+  if (existingVersion) {
+    console.log(`VLC ${existingVersion} is already installed, skipping installation.`);
+    return;
+  }
+
+  // Check if VLC executable exists in common Windows location
+  const vlcExistsResult = await shell.exec('ls "/c/Program Files/VideoLAN/VLC/vlc.exe" 2>/dev/null');
+  if (vlcExistsResult.code === 0) {
+    console.log('VLC is already installed on Windows, skipping installation.');
+    console.log('');
+    console.log('If VLC is not in your PATH, add it with:');
+    console.log('  echo \'export PATH="$PATH:/c/Program Files/VideoLAN/VLC"\' >> ~/.bashrc');
+    console.log('  source ~/.bashrc');
+    return;
+  }
+
+  // Install via PowerShell using Chocolatey
+  console.log('Installing VLC via Chocolatey...');
+  console.log('This may take a few minutes...');
+
+  const installResult = await shell.exec(
+    'powershell.exe -NoProfile -Command "choco install vlc -y"'
+  );
+
+  if (installResult.code !== 0) {
+    throw new Error(
+      `Failed to install VLC.\n` +
+      `Output: ${installResult.stdout || installResult.stderr}\n\n` +
+      `Troubleshooting:\n` +
+      `  1. Ensure Chocolatey is installed on Windows\n` +
+      `  2. Run Git Bash as Administrator and retry\n` +
+      `  3. Try installing directly from PowerShell:\n` +
+      `     choco install vlc -y`
+    );
+  }
+
+  console.log('VLC installed successfully.');
+  console.log('');
+  console.log('Git Bash notes:');
+  console.log('');
+  console.log('1. Restart Git Bash or run: source ~/.bashrc');
+  console.log('');
+  console.log('2. If vlc is not found, add to PATH:');
+  console.log('   echo \'export PATH="$PATH:/c/Program Files/VideoLAN/VLC"\' >> ~/.bashrc');
+  console.log('   source ~/.bashrc');
+  console.log('');
+  console.log('3. To launch VLC:');
+  console.log('   vlc &');
+  console.log('   # or with full path:');
+  console.log('   "/c/Program Files/VideoLAN/VLC/vlc.exe" &');
+  console.log('');
+  console.log('4. When passing file paths, use Windows-style or double slashes:');
+  console.log('   vlc "C:/Users/YourName/Videos/movie.mp4"');
+}
+
+/**
+ * Check if VLC is installed on the current system.
+ * @returns {Promise<boolean>} True if VLC is installed
+ */
+async function isInstalled() {
+  const platform = os.detect();
+  if (platform.type === 'macos') {
+    return brew.isCaskInstalled(HOMEBREW_CASK_NAME);
+  }
+  if (platform.type === 'windows') {
+    return choco.isPackageInstalled(CHOCO_PACKAGE_NAME);
+  }
+  if (['ubuntu', 'debian', 'raspbian'].includes(platform.type)) {
+    return apt.isPackageInstalled(APT_PACKAGE_NAME);
+  }
+  return isVLCCommandAvailable();
+}
+
+/**
+ * Check if this installer is supported on the current platform.
+ * VLC is supported on all major platforms.
+ * @returns {boolean} True if installation is supported on this platform
+ */
+function isEligible() {
+  const platform = os.detect();
+
+  // First check if the platform is supported
+  const supportedPlatforms = ['macos', 'ubuntu', 'debian', 'wsl', 'raspbian', 'amazon_linux', 'rhel', 'fedora', 'windows', 'gitbash'];
+  if (!supportedPlatforms.includes(platform.type)) {
+    return false;
+  }
+
+  // This installer requires a desktop environment
+  if (REQUIRES_DESKTOP && !os.isDesktopAvailable()) {
+    return false;
+  }
+
+  return true;
+}
+
+/**
+ * Main installation entry point.
+ *
+ * Detects the current platform and runs the appropriate installer function.
+ * Handles platform-specific mappings to ensure all supported platforms
+ * have appropriate installation logic.
+ *
+ * Supported platforms:
+ * - macOS: VLC via Homebrew cask
+ * - Ubuntu/Debian: VLC via APT
+ * - Raspberry Pi OS: VLC via APT
+ * - Amazon Linux/RHEL: VLC via DNF/YUM with RPM Fusion
+ * - Windows: VLC via Chocolatey
+ * - WSL (Ubuntu): VLC via APT within WSL
+ * - Git Bash: VLC on Windows host via Chocolatey
  *
  * @returns {Promise<void>}
  */
 async function install() {
   const platform = os.detect();
 
-  switch (platform.type) {
-    case 'macos':
-      // TODO: Implement macOS installation
-      break;
-    case 'debian':
-      // TODO: Implement Debian/Ubuntu installation
-      break;
-    case 'rhel':
-      // TODO: Implement RHEL/Amazon Linux installation
-      break;
-    case 'windows-wsl':
-      // TODO: Implement WSL installation
-      break;
-    case 'windows':
-      // TODO: Implement Windows installation
-      break;
-    default:
-      console.error(`Unsupported platform: ${platform.type}`);
-      process.exit(1);
-  }
-}
-
-module.exports = { install };
+  // Map platform types to their installer functions
+  // This mapping handles aliases (e.g., debian maps to ubuntu installer)
+  const installers = {
+    'macos': install_macos,
+    'ubuntu': install_ubuntu,
+    'debian': install_ubuntu,
+    'wsl': install_ubuntu_wsl,
+    'raspbian': install_raspbian,
+    'amazon_linux': install_amazon_linux,
+    'rhel': install_amazon_linux,
+    'fedora': install_amazon_linux,
+    'windows': install_windows,
+    'gitbash': install_gitbash
+  };
+
+  const installer = installers[platform.type];
+
+  if (!installer) {
+    console.log(`VLC is not available for ${platform.type}.`);
+    return;
+  }
+
+  await installer();
+}
+
+// Export all functions for use as a module and for testing
+module.exports = {
+  REQUIRES_DESKTOP,
+  install,
+  isInstalled,
+  isEligible,
+  install_macos,
+  install_ubuntu,
+  install_ubuntu_wsl,
+  install_raspbian,
+  install_amazon_linux,
+  install_windows,
+  install_gitbash
+};
 
+// Allow direct execution: node vlc.js
 if (require.main === module) {
-  install();
+  install().catch(err => {
+    console.error(err.message);
+    process.exit(1);
+  });
 }