@fredlackey/devutils 0.0.1 → 0.0.3

package/src/installs/messenger.md

@@ -0,0 +1,900 @@
+# Installing Messenger (Facebook Messenger Desktop Application)
+
+## Dependencies
+
+### macOS (Homebrew)
+- **Required:**
+  - Homebrew package manager - Install via `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
+- **Optional:** None
+- **Auto-installed:** None (Caprine cask is self-contained)
+
+### Ubuntu (APT/Snap)
+- **Required:**
+  - snapd (Snap package manager) - Install via `sudo apt-get update && sudo apt-get install -y snapd`
+- **Optional:** None
+- **Auto-installed:** All Caprine dependencies (Electron framework, GTK libraries, notification libraries) are handled automatically by Snap
+
+### Raspberry Pi OS (APT/Snap)
+- **Required:**
+  - git - Install via `sudo apt-get update && sudo apt-get install -y git`
+  - wget - Install via `sudo apt-get update && sudo apt-get install -y wget` (usually pre-installed)
+  - ARM architecture (aarch64 or armv7l) - Verify with `uname -m`
+- **Optional:** None
+- **Auto-installed:** All Caprine dependencies (Electron framework, GTK libraries) are handled automatically by Pi-Apps
+
+### Amazon Linux (DNF/YUM)
+- **Required:**
+  - FUSE and fuse-libs (for AppImage execution) - Install via `sudo dnf install -y fuse fuse-libs` (AL2023) or `sudo yum install -y fuse fuse-libs` (AL2)
+  - curl - Install via `sudo dnf install -y curl` or `sudo yum install -y curl` (usually pre-installed)
+- **Optional:**
+  - Desktop environment (GNOME, MATE, etc.) - Install via `sudo dnf groupinstall -y "Server with GUI"` (required for GUI applications)
+  - GTK3 libraries - Install via `sudo dnf install -y gtk3 at-spi2-atk libXScrnSaver` (may be required for AppImage execution)
+- **Auto-installed:** None (AppImage is self-contained once FUSE is available)
+
+### Windows (Chocolatey/winget)
+- **Required:**
+  - winget package manager - Pre-installed on Windows 10 1809+ and Windows 11; if missing, install "App Installer" from Microsoft Store
+- **Optional:** None
+- **Auto-installed:** All Caprine dependencies (Electron framework, Visual C++ Redistributables) are handled automatically by winget
+
+### Git Bash (Manual/Portable)
+- **Required:**
+  - winget on Windows host - Pre-installed on Windows 10 1809+ and Windows 11; if missing, install "App Installer" from Microsoft Store
+  - Git for Windows (provides Git Bash) - Download from https://git-scm.com/download/win
+- **Optional:** None
+- **Auto-installed:** All Caprine dependencies are handled automatically by winget on the Windows host
+
+## Overview
+
+Messenger (formerly Facebook Messenger) is Meta's instant messaging platform that allows users to send text messages, make voice and video calls, share files, photos, and videos, and communicate with Facebook friends and contacts. While Meta provides an official desktop application for macOS and Windows, Linux users must rely on third-party alternatives.
+
+**Important Platform Notes**:
+- **macOS**: Official Messenger app available via Homebrew (though currently disabled in Homebrew due to distribution changes)
+- **Windows**: Official Messenger available as a Progressive Web App (PWA) via Microsoft Store; Chocolatey package deprecated
+- **Linux (Ubuntu, Raspberry Pi, Amazon Linux)**: No official Meta desktop application; use **Caprine**, an open-source, privacy-focused Messenger client
+- **Caprine** is the recommended third-party solution for all Linux platforms, providing native desktop experience with additional privacy features
+
+This guide documents the installation of the official Messenger app where available, and Caprine as the definitive alternative for platforms without official support.
+
+## Prerequisites
+
+Before installing Messenger or Caprine on any platform, ensure:
+
+1. **Facebook/Meta account** - Required to log in and use Messenger
+2. **Internet connectivity** - Required for all Messenger functionality
+3. **Administrative privileges** - Required on most platforms for installation
+
+## Platform-Specific Installation
+
+### macOS (Homebrew)
+
+#### Prerequisites
+
+- macOS 12 (Monterey) or later
+- Homebrew package manager installed
+- Apple Silicon (M1/M2/M3/M4) or Intel processor
+
+**Note**: The official Messenger Homebrew cask has been disabled due to distribution changes by Meta. This guide documents the installation of **Caprine**, the recommended third-party Messenger client for macOS.
+
+If Homebrew is not installed, install it first:
+
+```bash
+NONINTERACTIVE=1 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+#### Installation Steps
+
+Run the following command to install Caprine, the privacy-focused Facebook Messenger desktop app:
+
+```bash
+brew install --quiet --cask caprine
+```
+
+The `--quiet` flag suppresses non-essential output, making the command suitable for automation scripts. The `--cask` flag specifies this is a macOS application.
+
+#### Verification
+
+Confirm the installation succeeded by launching the application:
+
+```bash
+open -a Caprine
+```
+
+Alternatively, verify the application exists:
+
+```bash
+ls /Applications/Caprine.app
+```
+
+Expected output:
+
+```
+/Applications/Caprine.app
+```
+
+#### Troubleshooting
+
+**Problem**: `brew: command not found`
+
+**Solution**: Homebrew is not installed or not in PATH. Install Homebrew or add it to your PATH:
+
+```bash
+eval "$(/opt/homebrew/bin/brew shellenv)"
+```
+
+**Problem**: App shows "Caprine can't be opened because Apple cannot check it for malicious software"
+
+**Solution**: This can occur on first launch. Right-click the app in Applications and select "Open", then click "Open" in the dialog. Alternatively, clear the quarantine flag:
+
+```bash
+xattr -cr /Applications/Caprine.app
+```
+
+**Problem**: Cannot log in to Facebook within Caprine
+
+**Solution**: Clear the application data and try again. Open Caprine, go to Help > Clear All Data, then restart the app.
+
+**Problem**: "Caprine is not responding" after update
+
+**Solution**: Force quit and restart:
+
+```bash
+killall Caprine
+open -a Caprine
+```
+
+---
+
+### Ubuntu/Debian (Snap)
+
+#### Prerequisites
+
+- Ubuntu 18.04 or later, or Debian 10 or later (64-bit x86_64)
+- snapd service installed and running (pre-installed on Ubuntu 16.04+)
+- sudo privileges
+- Active internet connection
+
+**Important**: Meta does not provide an official Messenger desktop application for Linux. This guide documents the installation of **Caprine**, an open-source, privacy-focused Facebook Messenger client that provides a native desktop experience.
+
+#### Installation Steps
+
+Run the following command to install Caprine:
+
+```bash
+sudo snap install caprine
+```
+
+Snap handles all dependencies automatically and provides automatic updates.
+
+**Note**: After installation, you may need to log out and log back in, or restart your terminal, for the application to appear in your application menu.
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+snap list caprine
+```
+
+Expected output (version may vary):
+
+```
+Name     Version  Rev    Tracking       Publisher        Notes
+caprine  2.59.3   xxx    latest/stable  AHC              -
+```
+
+Launch the application:
+
+```bash
+caprine &
+```
+
+Or find "Caprine" in your application menu under Internet or Communication.
+
+#### Troubleshooting
+
+**Problem**: `snap: command not found`
+
+**Solution**: Install snapd first:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
+```
+
+Then restart your terminal or log out and log back in.
+
+**Problem**: Application fails to start with graphics errors
+
+**Solution**: The Electron-based app may have issues with certain graphics drivers. Try running with software rendering:
+
+```bash
+caprine --disable-gpu &
+```
+
+**Problem**: Cannot log in to Facebook within Caprine
+
+**Solution**: Clear the application data and try again:
+
+```bash
+rm -rf ~/snap/caprine/current/.config/Caprine
+```
+
+**Problem**: "caprine" not found after installation
+
+**Solution**: The snap bin directory may not be in PATH. Add it:
+
+```bash
+export PATH=$PATH:/snap/bin
+```
+
+Add this line to `~/.bashrc` for persistence.
+
+**Problem**: Notifications not working
+
+**Solution**: Grant notification permissions:
+
+```bash
+snap connect caprine:desktop
+snap connect caprine:desktop-legacy
+```
+
+---
+
+### Raspberry Pi OS (Snap/Pi-Apps)
+
+#### Prerequisites
+
+- Raspberry Pi OS (64-bit recommended) - Bookworm or Bullseye
+- Raspberry Pi 4 or later with 2GB+ RAM (4GB recommended)
+- sudo privileges
+- Desktop environment configured
+
+**Important**: Meta does not provide an official Messenger desktop application for Raspberry Pi or any Linux ARM platform. This guide documents the installation of **Caprine** using Pi-Apps, which properly handles ARM64 builds.
+
+Verify your architecture:
+
+```bash
+uname -m
+```
+
+- `aarch64` = 64-bit ARM (recommended, full support)
+- `armv7l` = 32-bit ARM (limited support via Pi-Apps)
+
+**Note**: The Snap version of Caprine only supports amd64 (x86_64) architecture and will not work on Raspberry Pi. Use Pi-Apps for ARM installation.
+
+#### Installation Steps
+
+**Step 1: Install Pi-Apps**
+
+Pi-Apps is an application installer for Raspberry Pi that handles ARM-specific builds:
+
+```bash
+wget -qO- https://raw.githubusercontent.com/Botspot/pi-apps/master/install | bash
+```
+
+This command downloads and runs the Pi-Apps installer non-interactively.
+
+**Step 2: Install Caprine via Pi-Apps CLI**
+
+```bash
+/home/$USER/pi-apps/manage install Caprine
+```
+
+Alternatively, launch Pi-Apps from the start menu, navigate to Internet > Communication > Caprine, and click Install.
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+ls /opt/Caprine/caprine
+```
+
+Expected output:
+
+```
+/opt/Caprine/caprine
+```
+
+Launch the application:
+
+```bash
+/opt/Caprine/caprine &
+```
+
+Or find "Caprine" in your application menu under Internet.
+
+#### Troubleshooting
+
+**Problem**: Pi-Apps installation fails
+
+**Solution**: Ensure you have internet connectivity and git is installed:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y git
+```
+
+Then retry the Pi-Apps installation.
+
+**Problem**: Caprine runs slowly or crashes
+
+**Solution**: Raspberry Pi may have limited resources for Electron apps. Close other applications and ensure you have at least 2GB RAM. Consider increasing swap space:
+
+```bash
+sudo dphys-swapfile swapoff
+sudo sed -i 's/CONF_SWAPSIZE=.*/CONF_SWAPSIZE=2048/' /etc/dphys-swapfile
+sudo dphys-swapfile setup
+sudo dphys-swapfile swapon
+```
+
+**Problem**: Graphics rendering issues
+
+**Solution**: Try running with software rendering:
+
+```bash
+/opt/Caprine/caprine --disable-gpu &
+```
+
+**Problem**: "Cannot open shared object file" errors
+
+**Solution**: Install required dependencies:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils libatspi2.0-0 libuuid1 libsecret-1-0
+```
+
+---
+
+### Amazon Linux (DNF/YUM)
+
+#### Prerequisites
+
+- Amazon Linux 2023 (AL2023) or Amazon Linux 2 (AL2)
+- Desktop environment installed (GNOME, MATE, or similar)
+- sudo privileges
+- Active internet connection
+
+**Important**: Meta does not provide an official Messenger desktop application for Amazon Linux or any Linux distribution. For desktop environments, use **Caprine** via AppImage. For headless server environments, use the web interface.
+
+Amazon Linux is typically used as a server OS. If you need a graphical Messenger client, ensure you have a desktop environment installed first.
+
+#### Installation Steps
+
+**Step 1: Install FUSE (required for AppImage)**
+
+For Amazon Linux 2023:
+
+```bash
+sudo dnf install -y fuse fuse-libs
+```
+
+For Amazon Linux 2:
+
+```bash
+sudo yum install -y fuse fuse-libs
+```
+
+**Step 2: Download and Install Caprine AppImage**
+
+```bash
+# Create applications directory
+mkdir -p ~/.local/bin
+
+# Download the latest Caprine AppImage
+curl -L -o ~/.local/bin/Caprine.AppImage "https://github.com/sindresorhus/caprine/releases/download/v2.61.0/Caprine-2.61.0.AppImage"
+
+# Make it executable
+chmod +x ~/.local/bin/Caprine.AppImage
+```
+
+**Step 3: Add to PATH (if not already)**
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+#### Verification
+
+Confirm the installation succeeded:
+
+```bash
+ls -la ~/.local/bin/Caprine.AppImage
+```
+
+Expected output shows the executable file:
+
+```
+-rwxr-xr-x. 1 user user 95000000 Jan  2 12:00 /home/user/.local/bin/Caprine.AppImage
+```
+
+Launch the application:
+
+```bash
+~/.local/bin/Caprine.AppImage &
+```
+
+#### Troubleshooting
+
+**Problem**: No graphical display available
+
+**Solution**: Amazon Linux is typically a server OS without a desktop environment. Install a desktop environment first:
+
+```bash
+# For Amazon Linux 2023
+sudo dnf groupinstall -y "Server with GUI"
+sudo systemctl set-default graphical.target
+sudo reboot
+```
+
+Or use the web interface at https://messenger.com from any browser.
+
+**Problem**: AppImage fails with "FUSE not available"
+
+**Solution**: Ensure FUSE is installed:
+
+```bash
+sudo dnf install -y fuse fuse-libs
+```
+
+Or extract and run the AppImage directly:
+
+```bash
+~/.local/bin/Caprine.AppImage --appimage-extract
+~/squashfs-root/caprine &
+```
+
+**Problem**: "libatk-bridge-2.0.so.0: cannot open shared object file"
+
+**Solution**: Install GTK dependencies:
+
+```bash
+sudo dnf install -y gtk3 at-spi2-atk libXScrnSaver
+```
+
+**Problem**: SELinux blocks the AppImage
+
+**Solution**: Allow the AppImage to run:
+
+```bash
+sudo semanage fcontext -a -t bin_t ~/.local/bin/Caprine.AppImage
+sudo restorecon -v ~/.local/bin/Caprine.AppImage
+```
+
+---
+
+### Windows (winget)
+
+#### Prerequisites
+
+- Windows 10 version 1809 or later, or Windows 11
+- winget package manager (pre-installed on Windows 10 1809+ and Windows 11)
+- Administrator privileges recommended
+- Active internet connection
+
+**Important**: Meta has deprecated the traditional Windows desktop application in favor of a Progressive Web App (PWA) distributed via the Microsoft Store. The Chocolatey package for Messenger has also been deprecated. This guide documents the installation of **Caprine** as the recommended desktop Messenger client for Windows.
+
+#### Installation Steps
+
+Run the following command in an Administrator PowerShell or Command Prompt:
+
+```powershell
+winget install --id Caprine.Caprine --silent --accept-package-agreements --accept-source-agreements
+```
+
+This command:
+- `--id Caprine.Caprine` - Specifies the winget package ID for Caprine
+- `--silent` - Runs without user prompts
+- `--accept-package-agreements` - Automatically accepts package license agreements
+- `--accept-source-agreements` - Automatically accepts source license agreements
+
+#### Verification
+
+Open a new PowerShell or Command Prompt window (required for PATH to update), then verify the installation:
+
+```powershell
+winget list --id Caprine.Caprine
+```
+
+Expected output:
+
+```
+Name     Id               Version Source
+-----------------------------------------
+Caprine  Caprine.Caprine  2.61.0  winget
+```
+
+Launch the application from the Start Menu by searching for "Caprine", or:
+
+```powershell
+start "" "Caprine"
+```
+
+#### Troubleshooting
+
+**Problem**: `winget: The term 'winget' is not recognized`
+
+**Solution**: winget may not be installed or PATH may not be updated. Install App Installer from the Microsoft Store:
+
+```powershell
+start ms-windows-store://pdp/?productid=9NBLGGH4NNS1
+```
+
+After installation, open a new terminal window.
+
+**Problem**: Installation fails with "No applicable installer found"
+
+**Solution**: Your Windows version may be too old. Check your version:
+
+```powershell
+winver
+```
+
+Windows 10 version 1809 (October 2018 Update) or later is required.
+
+**Problem**: "Administrator privileges required"
+
+**Solution**: Right-click PowerShell or Command Prompt and select "Run as administrator", then retry the installation command.
+
+**Problem**: Caprine installed but cannot find it
+
+**Solution**: The installation may have completed but the Start Menu not yet updated. Try running directly:
+
+```powershell
+& "$env:LOCALAPPDATA\Programs\Caprine\Caprine.exe"
+```
+
+**Problem**: Cannot log in to Facebook
+
+**Solution**: Clear application data by going to Help > Clear All Data within Caprine, or delete the configuration folder:
+
+```powershell
+Remove-Item -Recurse -Force "$env:APPDATA\Caprine"
+```
+
+---
+
+### WSL (Ubuntu)
+
+#### Prerequisites
+
+- Windows Subsystem for Linux with Ubuntu installed
+- WSL 2 recommended for best performance
+- WSLg support (Windows 11) for native Linux GUI apps
+- sudo privileges within WSL
+
+**Important**: Caprine is a GUI application and requires a display. WSL 2 with WSLg (Windows 11) supports Linux GUI applications natively. For WSL on Windows 10, additional X server configuration is required.
+
+#### Installation Steps
+
+**Recommended Approach - Use Windows Caprine Installation**:
+
+The simplest approach is to install Caprine on Windows (see Windows section above) and access it from WSL through Windows interop:
+
+```bash
+# Install wslu for Windows integration
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wslu
+
+# Open Messenger web interface in Windows browser
+wslview https://messenger.com
+```
+
+**Alternative Approach - Linux Snap in WSL (WSL 2 + WSLg required)**:
+
+For WSL 2 on Windows 11 with WSLg, you can run Linux GUI applications natively.
+
+First, ensure systemd is enabled in WSL. Edit `/etc/wsl.conf`:
+
+```bash
+sudo tee /etc/wsl.conf > /dev/null << 'EOF'
+[boot]
+systemd=true
+EOF
+```
+
+Restart WSL from PowerShell:
+
+```powershell
+wsl --shutdown
+```
+
+Then reopen WSL and install Caprine via Snap:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y snapd
+sudo snap install caprine
+```
+
+#### Verification
+
+For the Windows browser approach:
+
+```bash
+wslview https://messenger.com
+```
+
+This should open Messenger in your Windows browser.
+
+For the Linux Snap approach (WSL 2 + WSLg):
+
+```bash
+snap list caprine
+```
+
+Launch the application:
+
+```bash
+caprine &
+```
+
+The Caprine window should appear on your Windows desktop via WSLg.
+
+#### Troubleshooting
+
+**Problem**: GUI applications do not display
+
+**Solution**: WSLg requires Windows 11 or later. For Windows 10, install an X server like VcXsrv:
+
+1. Install VcXsrv on Windows from https://sourceforge.net/projects/vcxsrv/
+2. Launch XLaunch with "Multiple windows" and "Disable access control"
+3. In WSL, set the display:
+
+```bash
+export DISPLAY=$(grep nameserver /etc/resolv.conf | awk '{print $2}'):0.0
+```
+
+Add to `~/.bashrc` for persistence.
+
+**Problem**: systemctl commands fail
+
+**Solution**: systemd may not be enabled. Edit `/etc/wsl.conf` as shown above and restart WSL.
+
+**Problem**: Snap installation hangs or fails
+
+**Solution**: Snap may have issues in WSL. Use the Windows Caprine installation or web interface instead:
+
+```bash
+wslview https://messenger.com
+```
+
+**Problem**: `wslview: command not found`
+
+**Solution**: Install wslu utilities:
+
+```bash
+sudo DEBIAN_FRONTEND=noninteractive apt-get update -y && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y wslu
+```
+
+---
+
+### Git Bash (Windows)
+
+#### Prerequisites
+
+- Windows 10 version 1809 or later, or Windows 11
+- Git Bash installed (comes with Git for Windows)
+- Caprine installed on Windows (see Windows section above)
+
+**Note**: Git Bash on Windows runs within the Windows environment and inherits the Windows PATH. Once Caprine is installed on Windows, it is accessible from Git Bash through Windows application launching.
+
+#### Installation Steps
+
+Git Bash can execute Windows commands directly. Install Caprine using winget:
+
+```bash
+winget.exe install --id Caprine.Caprine --silent --accept-package-agreements --accept-source-agreements
+```
+
+After installation, close and reopen Git Bash for the Start Menu shortcuts to update.
+
+#### Verification
+
+Verify Caprine is installed by checking winget:
+
+```bash
+winget.exe list --id Caprine.Caprine
+```
+
+Launch Caprine from Git Bash:
+
+```bash
+start "" "Caprine"
+```
+
+Or open the web interface:
+
+```bash
+start https://messenger.com
+```
+
+#### Troubleshooting
+
+**Problem**: `winget.exe: command not found`
+
+**Solution**: winget may not be in the Git Bash PATH. Use the full path:
+
+```bash
+/c/Users/$USER/AppData/Local/Microsoft/WindowsApps/winget.exe install --id Caprine.Caprine --silent --accept-package-agreements --accept-source-agreements
+```
+
+**Problem**: `start: command not found`
+
+**Solution**: In Git Bash, use `cmd.exe` to run Windows commands:
+
+```bash
+cmd.exe /c start "" "Caprine"
+```
+
+**Problem**: Installation fails with permission errors
+
+**Solution**: Git Bash may need to be run as Administrator. Right-click Git Bash and select "Run as administrator", then retry the installation.
+
+**Problem**: Caprine installed but cannot launch from Git Bash
+
+**Solution**: Use the Windows `start` command through cmd:
+
+```bash
+cmd.exe /c start "" "$LOCALAPPDATA/Programs/Caprine/Caprine.exe"
+```
+
+Or simply access the web interface:
+
+```bash
+cmd.exe /c start https://messenger.com
+```
+
+---
+
+## Post-Installation Configuration
+
+### First-Time Setup
+
+After installing and launching Caprine on any platform:
+
+1. **Sign in** - Log in with your Facebook account credentials
+2. **Grant permissions** - Allow notifications when prompted for real-time message alerts
+3. **Configure privacy settings** - Caprine offers privacy features not available in the official app
+
+### Caprine Privacy Features
+
+Caprine provides several privacy-enhancing features. Access them via the application menu:
+
+| Feature | Description | Location |
+|---------|-------------|----------|
+| Block Seen Receipts | Prevent others from knowing you read messages | File/Caprine > Preferences |
+| Block Typing Indicator | Hide when you are typing | File/Caprine > Preferences |
+| Link Tracking Prevention | Remove Facebook tracking from links | Enabled by default |
+| Dark Mode | Reduce eye strain and improve privacy in public | View menu or Ctrl/Cmd+D |
+
+### Keyboard Shortcuts
+
+| Platform | Toggle Dark Mode | Hide on Close | Preferences |
+|----------|-----------------|---------------|-------------|
+| macOS | Cmd + D | Cmd + H | Cmd + , |
+| Windows/Linux | Ctrl + D | Minimize to tray | Ctrl + , |
+
+### Configuring Notifications
+
+To ensure you receive message notifications:
+
+**Linux (Snap)**:
+```bash
+snap connect caprine:desktop
+snap connect caprine:desktop-legacy
+```
+
+**Windows**:
+Ensure notifications are enabled in Windows Settings > System > Notifications.
+
+**macOS**:
+Grant notification permissions in System Settings > Notifications > Caprine.
+
+---
+
+## Common Issues
+
+### Issue: Cannot Log In to Facebook
+
+**Symptoms**: Login page shows error or loops endlessly.
+
+**Solutions**:
+
+1. Clear application data:
+   - In Caprine, go to Help > Clear All Data
+   - Restart the application
+
+2. Check if Facebook requires additional verification:
+   - Log in via browser at https://facebook.com first
+   - Complete any security checks
+   - Then try Caprine again
+
+3. Check your network:
+   - Ensure you have internet connectivity
+   - Try disabling VPN if active
+
+### Issue: Messages Not Syncing
+
+**Symptoms**: New messages do not appear or sent messages do not show.
+
+**Solutions**:
+
+1. Refresh the connection:
+   - Press F5 or Cmd/Ctrl+R to reload
+
+2. Check Facebook Messenger status:
+   - Visit https://downdetector.com/status/facebook-messenger/
+   - If there are known outages, wait for resolution
+
+3. Sign out and sign back in within Caprine
+
+### Issue: High Memory Usage
+
+**Symptoms**: Caprine consumes excessive system resources.
+
+**Solutions**:
+
+Caprine is built with Electron, which can consume significant memory. To reduce usage:
+
+1. Close and restart Caprine periodically
+2. Avoid leaving many conversations open
+3. Disable unnecessary features in Preferences
+
+On Linux, check memory usage:
+
+```bash
+ps aux | grep -i caprine
+```
+
+### Issue: No Notifications
+
+**Symptoms**: Not receiving notifications for new messages.
+
+**Solutions**:
+
+1. Verify notifications are enabled in Caprine preferences
+2. Check system notification settings
+3. On Linux, ensure the notification daemon is running:
+
+```bash
+# For GNOME
+systemctl --user status gsd-* | grep notif
+```
+
+### Issue: Dark Mode Not Working
+
+**Symptoms**: Dark mode toggle has no effect.
+
+**Solutions**:
+
+1. Press Ctrl+D (Windows/Linux) or Cmd+D (macOS) to toggle
+2. Go to View > Toggle Dark Mode
+3. If still not working, reset preferences:
+   - Help > Clear All Data
+   - Restart and reconfigure
+
+### Issue: "Messenger is Currently Unavailable" Error
+
+**Symptoms**: Caprine shows an error that Messenger is unavailable.
+
+**Solutions**:
+
+1. This usually indicates a Facebook/Meta service issue
+2. Wait and try again later
+3. Check https://downdetector.com/status/facebook-messenger/
+4. Try accessing https://messenger.com in a regular browser to confirm
+
+---
+
+## References
+
+- [Caprine Official Website](https://sindresorhus.com/caprine/)
+- [Caprine GitHub Repository](https://github.com/sindresorhus/caprine)
+- [Caprine Releases (AppImage, DEB, RPM)](https://github.com/sindresorhus/caprine/releases)
+- [Caprine Snap Package](https://snapcraft.io/caprine)
+- [Caprine Chocolatey Package](https://community.chocolatey.org/packages/caprine)
+- [Caprine winget Package](https://winget.run/pkg/Caprine/Caprine)
+- [Pi-Apps for Raspberry Pi](https://pi-apps.io/)
+- [Pi-Apps Caprine Installation](https://pi-apps.io/install-app/install-caprine-on-linux-arm-device/)
+- [Messenger Homebrew Cask (Disabled)](https://formulae.brew.sh/cask/messenger)
+- [Facebook Messenger Web](https://messenger.com)
+- [Meta Messenger Official Page](https://www.messenger.com/)