Getting Started

Installing Cosmil

Download, install, and activate Cosmil on your Mac in under two minutes.

Under Construction

For now, the documentation is still mostly under construction. As the developer, I can tell you building a file explorer as one person takes a lot of work — that's where the vast majority of my time has been consumed. I'll finish up and make more thorough these docs as fast as I can. Thank you for your patience.

Requirements#

Cosmil supports both Apple Silicon and Intel Macs running macOS Sonoma (14) or greater.

Download and install#

  1. Download the latest release of Cosmil.
  2. Open the downloaded .dmg and drag Cosmil into your Applications folder.
  3. Launch Cosmil from Applications or Spotlight.

Activate your license#

After launching Cosmil for the first time, you will be prompted to provide a license key to activate your installation. You can find your generated license key in the email you provided at checkout—it was sent directly after your purchase. Copy, then paste this key into the prompt and press Activate.

Grant Full Disk Access#

This is a very important step. If you don’t grant Cosmil Full Disk Access you may not be able to access all your files within Cosmil (for example, without full disk access you won’t be able to see what’s in your Trash Bin).

You should be prompted to open the relevant security settings but in case you accidentally skip the prompt here’s how you can do it manually:

  1. Open System Settings
  2. Navigate to Privacy and Security
  3. Click Full Disk Access (you might need to scroll down first)
  4. Click the switch for Cosmil to the on position
    • If you don’t see Cosmil in the list click the + button at the bottom left right below the list, select Cosmil within your Applications folder, and click Open — then Cosmil should be visible in the list.

Uninstalling#

Quit Cosmil and delete it from ~/Applications — that’s it. Cosmil runs no background services and leaves nothing behind.