Installation

Get FilesDesk up and running on your Windows PC or Mac.

System Requirements

Windows

• Operating System: Windows 10/11 (64-bit)
• RAM: 4GB minimum, 8GB recommended
• Storage: 200MB free space
• Internet: Required for cloud AI features (optional for local AI)

macOS

• Operating System: macOS 12 (Monterey) or later
• Processor: Intel x64 (Apple Silicon via Rosetta 2)
• RAM: 4GB minimum, 8GB recommended
• Storage: 200MB free space
• Internet: Required for cloud AI features (optional for local AI)

Download & Install

Windows

Option 1: Microsoft Store (Recommended)

1. Visit the Microsoft Store
2. Click Get or Install
3. FilesDesk will install automatically with auto-updates enabled

Option 2: Direct Download

1. Visit filesdesk.app/download
2. Click Get from Microsoft Store button
3. Or download the .exe installer directly from GitHub releases

Installation Steps (Direct Download)

1. Run the Installer - Double-click the downloaded .exe file. If prompted by Windows Defender, click "More info" → "Run anyway"
2. Accept License Agreement - Read and accept the terms of service
3. Choose Installation Location - Default: C:\Program Files\FilesDesk or select a custom location
4. Complete Installation - Click "Install" and wait for completion, then click "Finish" to launch FilesDesk

macOS

Download

1. Visit filesdesk.app/download
2. Click Download for Mac button
3. The .dmg file will download to your Downloads folder

Intel Mac & Apple Silicon

The current release is built for Intel Macs (x64). It runs on Apple Silicon Macs (M1/M2/M3/M4) via Rosetta 2, which macOS installs automatically when needed.

Installation Steps

1. Open the DMG - Double-click FilesDesk_1.0.1_x64.dmg in your Downloads folder
2. Drag to Applications - Drag the FilesDesk icon to the Applications folder
3. First Launch - Open FilesDesk from Applications or Spotlight. If you see "FilesDesk cannot be opened because it is from an unidentified developer", go to System Settings → Privacy & Security → click Open Anyway
4. Grant Permissions - Click Allow when prompted for file access

First Launch

On first launch, you'll need to:

1. Create an account or sign in
2. Configure your AI provider (OpenAI, Anthropic, Google, or local Ollama)
3. Set up your first watch folder (optional)

Troubleshooting

Windows

"Windows protected your PC" message

Click "More info" then "Run anyway". This appears because the app is new and building trust with Microsoft SmartScreen.

Installation fails

Ensure you have administrator rights. Try running the installer as Administrator (right-click → Run as administrator). You may also need to disable antivirus temporarily during installation.

macOS

"App is damaged and can't be opened"

Open Terminal and run: xattr -cr /Applications/FilesDesk.app, then try opening the app again.

"FilesDesk wants to access files in your Documents folder"

Click Allow to enable file renaming functionality. You can manage permissions in System Settings → Privacy & Security → Files and Folders.

Rosetta 2 prompt (Apple Silicon)

If prompted to install Rosetta, click Install. This is a one-time setup for running Intel apps on Apple Silicon.

Uninstallation

Windows

1. Open Settings → Apps → Installed apps
2. Find FilesDesk and click Uninstall
3. Follow the prompts to remove the application

macOS

1. Open Finder → Applications
2. Drag FilesDesk to the Trash
3. Empty Trash to complete removal

To remove preferences:

rm -rf ~/Library/Application\ Support/FilesDesk
rm -rf ~/Library/Preferences/com.filesdesk.*

Next Steps

• Quick Start Guide - Learn the basics in 5 minutes
• Basic Concepts - Understand how FilesDesk works
• AI Providers Guide - Configure your preferred AI