Installation

Download strayfiles

strayfiles is available for macOS. Download the latest version from our download page.

System Requirements

• macOS: 13.0 (Ventura) or later
• Architecture: Apple Silicon or Intel
• Disk Space: 50MB minimum

Installation Steps

1. Download the .dmg file from the download page
2. Open the downloaded file
3. Drag strayfiles to your Applications folder
4. Launch strayfiles from Applications

First Launch

On first launch, strayfiles will ask you to:

1. Select folders to index — Choose where your Markdown files live
2. Grant file access — Allow strayfiles to read your selected folders
3. Optional: Set up sync — Configure Git or cloud sync if desired

That’s it! strayfiles will begin indexing your Markdown files immediately.

Verifying Installation

Open strayfiles and check the status bar. You should see:

✓ Indexing complete: X files found

If you see any errors, check the troubleshooting guide or reach out on our community forum.