Installation Guide

This chapter guides you through installing SingClaw on different operating systems.

System Requirements

Before installing SingClaw, ensure your system meets the following minimum requirements:

Hardware Requirements

Minimum Requirements

• Processor (CPU): Intel Core i5 or equivalent AMD processor (4 cores or more recommended) / Apple Silicon / ARM64 (e.g., M1 / M2 / M3)
• Memory (RAM): At least 8 GB (16 GB recommended for a smoother experience)
• Storage: At least 2 GB of available disk space (SSD recommended)

---

Recommended Requirements

• Processor (CPU): Intel Core i7 / AMD Ryzen 5 or higher / Apple Silicon / ARM64 (e.g., M1 / M2 / M3)
• Memory (RAM): 16 GB or more
• Storage: SSD with 5 GB or more available
• GPU: Dedicated graphics card preferred

Software Requirements

• Operating System:
  • Windows 10 or later (64-bit)
  • macOS 12 or later (64-bit)
  • Ubuntu Desktop 20.04 or later (64-bit)

Windows Installation

Method 1: Installer (Recommended)

1. Download the Installer

   • Visit the SingClaw official website
   • Click the "Download for Windows" button
   • Save the SingClaw-Setup-0.x.x.exe file locally (e.g., SingClaw-Setup-0.1.1.exe)

2. Run the Installer

   • Double-click the SingClaw-Setup-0.x.x.exe file
   • If a security warning appears, click "More info" → "Run anyway"
   • If prompted with "Smart App Control has blocked an app that may be unsafe," temporarily disable Smart App Control

   Temporarily disable "Smart App Control"

   Note: This step requires caution. Once disabled, you may not be able to re-enable it without reinstalling the system.

   • Open Windows Security.
   • Click App & browser control.
   • Click Smart App Control settings.
   • You can set it to Off (Please note: If it is currently in "Evaluation" mode or "On", disabling it may prevent you from restoring it to its original state).
   • Follow the installation wizard to complete the setup

3. Installation Options

   • Installation location: Default is C:\Users\<username>\AppData\Local\Programs\Singclaw
   • Create desktop shortcut: Recommended
   • Create Start Menu folder: Checked by default

4. Complete Installation

   • After installation, you can choose to launch SingClaw immediately
   • The first launch will perform initial configuration

macOS Installation

Method 1: DMG Package

1. Download the Package

   • Download the SingClaw.dmg file from the official website
   • Open the downloaded DMG file

2. Install the Application

   • Drag the SingClaw icon to the "Applications" folder
   • Wait for the copy to complete

3. First Launch

   • Open the "Applications" folder
   • Right-click SingClaw → "Open"
   • If a security warning appears, click "Open"

Linux Installation

Ubuntu/Debian

Method 1: DEB Package

# Download the DEB package
wget https://packages.singclaw.com/linux/singclaw_1.0.0_amd64.deb

# Install
sudo dpkg -i singclaw_1.0.0_amd64.deb

# Fix dependencies if needed
sudo apt install -f

Common Installation Issues

Windows Issues

Issue 1: Installer Blocked

Solution:

1. Right-click the installer → Properties
2. At the bottom of the "General" tab, check "Unblock"
3. Click "OK" and re-run the installer

Issue 2: Still Not Working After the Above Steps

Solution: Temporarily disable Smart App Control

Note: This step requires caution — once disabled, it may not be possible to re-enable without reinstalling the OS.

Steps:

1. Open Windows Security Center
2. Click "App & browser control"
3. Click "Smart App Control settings"
4. Set it to "Off"

macOS Issues

Issue: "Cannot be opened because the developer cannot be verified"

Solution:

1. Open "System Preferences" → "Security & Privacy"
2. In the "General" tab, click "Open Anyway"
3. Enter your administrator password to confirm

Issue: Gatekeeper Blocking

Solution:

# Temporarily disable Gatekeeper (not recommended)
sudo spctl --master-disable

# Or add an exception for the specific app
sudo xattr -rd com.apple.quarantine /Applications/SingClaw.app

Next Steps

After installation, try the Core Features to get started.