---
name: "File::HomeDir::Darwin::Cocoa"
section: "3pm"
platform: "linux"
package: "perl-file-homedir"
version: "1.006-8"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/File::HomeDir::Darwin::Cocoa"
---

# File::HomeDir::Darwin::Cocoa(3pm)

Find your home and other directories on Darwin (OS X)

## NAME

File::HomeDir::Darwin::Cocoa - Find your home and other directories on Darwin (OS X)

## DESCRIPTION

This module provides Darwin-specific implementations for determining common user directories using Cocoa API through Mac::SystemDirectory.  In normal usage this module will always be used via File::HomeDir.

Theoretically, this should return the same paths as both of the other Darwin drivers.

Because this module requires Mac::SystemDirectory, if the module is not installed, File::HomeDir will fall back to File::HomeDir::Darwin.

## SYNOPSIS

```
  use File::HomeDir;

  # Find directories for the current user
  $home    = File::HomeDir->my_home;      # /Users/mylogin
  $desktop = File::HomeDir->my_desktop;   # /Users/mylogin/Desktop
  $docs    = File::HomeDir->my_documents; # /Users/mylogin/Documents
  $music   = File::HomeDir->my_music;     # /Users/mylogin/Music
  $pics    = File::HomeDir->my_pictures;  # /Users/mylogin/Pictures
  $videos  = File::HomeDir->my_videos;    # /Users/mylogin/Movies
  $data    = File::HomeDir->my_data;      # /Users/mylogin/Library/Application Support
```

## COPYRIGHT

Copyright 2009 - 2011 Adam Kennedy.

Copyright 2017 - 2020 Jens Rehsack